glfs/x/installing/x7driver.xml
DJ Lucas 153a834eb7 Fix building of s3 and xgi drivers
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@7982 af4574ff-66df-0310-9fd7-8a98e5e911e0
2009-08-25 06:12:05 +00:00

221 lines
7.6 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY x7drivers-download-http "http://xorg.freedesktop.org/releases/individual/driver/">
<!ENTITY x7drivers-download-ftp "ftp://ftp.x.org/pub/individual/driver/">
<!ENTITY x7drivers-wget "&files-anduin;/xorg/driver-&xorg7-version;.wget">
<!ENTITY x7drivers-md5sum "&files-anduin;/xorg/driver-&xorg7-version;.md5">
<!ENTITY x7drivers-size "16.7 MB">
<!ENTITY x7drivers-buildsize "60.3 MB">
<!ENTITY x7drivers-time "6.9 SBU">
]>
<sect1 id="xorg7-driver" xreflabel="Xorg Drivers">
<?dbhtml filename="x7driver.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>Xorg Drivers</title>
<indexterm zone="xorg7-driver">
<primary sortas="a-xorg7-driver">Xorg Drivers</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Xorg Drivers</title>
<para>The <application>Xorg</application> drivers provide the means
for the xserver to take advantage of installed hardware.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&x7drivers-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&x7drivers-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: <ulink url="&x7drivers-md5sum;"/></para>
</listitem>
<listitem>
<para>Download size: &x7drivers-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &x7drivers-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &x7drivers-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Required download list: <ulink url="&x7drivers-wget;"/></para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Xorg Drivers Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="xorg7-server"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="mesalib"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url='&blfs-wiki;/Xorg7Drivers'/></para>
</sect2>
<sect2>
<title>Downloading Xorg Drivers</title>
<para>To download the needed files using <application>wget</application>,
use the following commands:</para>
<screen><userinput>mkdir driver &amp;&amp;
cd driver &amp;&amp;
grep -v '^#' ../driver-&xorg7-version;.wget | wget -i- -c \
-B http://xorg.freedesktop.org/releases/individual/driver/ &amp;&amp;
md5sum -c ../driver-&xorg7-version;.md5</userinput></screen>
</sect2>
<sect2 role="installation">
<title>Installation of Xorg Drivers</title>
<warning><para>It is very important not to build display drivers that
cannot be used with your hardware. For instance, do not build Sun drivers
for an x86 PC as the Sun drivers will expect to see SPARC symbols
exported from the kernel. Failure to follow this warning will result
in a display lockup, which requires a hard reboot, when configuring
<application>Xorg</application> for the first time. For this reason,
these drivers have been commented out in the wget file.</para></warning>
<para>Install the drivers by running the following commands for each
package:</para>
<screen><userinput>case $(basename "$PWD") in
xf86-input-evdev-[0-9]* | xf86-video-ati-[0-9]* | \
xf86-video-fbdev-[0-9]* | xf86-video-glint-[0-9]* | \
xf86-video-newport-[0-9]* )
sed -i -e "s/\xc3\xb8/\\\\[\/o]/" \
-e "s/\xc3\xa4/\\\\[:a]/" \
-e "s/\xc3\x9c/\\\\[:U]/" man/*.man
;;
esac &amp;&amp;
case $(basename "$PWD") in
xf86-video-s3-[0-9]* | xf86-video-xgi-[0-9]* )
for file in `grep -Rl "xf86Version.h" *`
do
sed 's@xf86Version.h@xorgVersion.h@g' -i "$file"
done
;;
esac &amp;&amp;
./configure $XORG_CONFIG \
--with-xorg-module-dir=$XORG_PREFIX/lib/X11/modules &amp;&amp;
make</userinput></screen>
<para>These packages do not provide test suites.</para>
<para>Now as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>sed -i ... man/*.man</command>: A few packages install
man pages in UTF-8 encoding, and they will not display correctly
using <application>Man-DB</application>. This command converts the
offending characters to ones that <command>man</command> can properly
display.</para>
<para><parameter>--with-xorg-module-dir=...</parameter>: This switch
ensures that the drivers are installed into the correct directory.</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libI810XvMC.so, libIntelXvMC.so, libchromeXvMC.so, and
libchromeXvMCPro.so</seg>
<seg><envar>$XORG_PREFIX</envar>/lib/X11/modules/{drivers,input}</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libI810XvMC-x7">
<term><filename class='libraryfile'>libI810XvMC.so</filename></term>
<listitem>
<para>is the X-Video Motion Compensation client library for the
Intel i810 video driver.</para>
<indexterm zone="xorg7-driver libI810XvMC-x7">
<primary sortas="c-libI810XvMC">libI810XvMC.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libIntelXvMC-x7">
<term><filename class='libraryfile'>libIntelXvMC.so</filename></term>
<listitem>
<para>is the X-Video Motion Compensation client library for the
Intel video driver.</para>
<indexterm zone="xorg7-driver libIntelXvMC-x7">
<primary sortas="c-libIntelXvMC">libIntelXvMC.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libviaXvMC-x7">
<term><filename class='libraryfile'>libchromeXvMC.so</filename></term>
<listitem>
<para>is the X-Video Motion Compensation client library for the
VIA Unichrome video driver.</para>
<indexterm zone="xorg7-driver libviaXvMC-x7">
<primary sortas="c-libviaXvMC">libviaXvMC.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libviaXvMCPro-x7">
<term><filename class='libraryfile'>libchromeXvMCPro.so</filename></term>
<listitem>
<para>is the X-Video Motion Compensation client library for the
VIA Unichrome Pro video driver.</para>
<indexterm zone="xorg7-driver libviaXvMCPro-x7">
<primary sortas="c-libviaXvMCPro">libviaXvMCPro.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>