source: x/installing/x7driver.xml@ e257101

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/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  "">
  <!ENTITY x7drivers-md5sum        "http://anduin.linuxfromscratch.org/sources/BLFS/svn/x/files/md5sums">
  <!ENTITY x7drivers-size          "17.3 MB">
  <!ENTITY x7drivers-buildsize     "53.8 MB">
  <!ENTITY x7drivers-time          "4.6 SBU">

]>

<sect1 id="xorg7-driver" xreflabel="Xorg Drivers">
  <?dbhtml filename="x7driver.html"?>

  <sect1info>
    <othername>$LastChangedBy: dj $</othername>
    <date>$Date: 2006-04-15 23:04:51 -0500 (Sat, 15 Apr 2006) $</date>
<!--    <keywordset>
      <keyword role="package">X11R&xorg7-version;-src.tar</keyword>
      <keyword role="ftpdir">Xorg7</keyword>
    </keywordset>
########## Need a way to fix this on the mirrors ##########
##### Maybe a single tarball is the way to handle it ######
-->


  </sect1info>

  <title>Xorg Drivers</title>

  <indexterm zone="xorg7-driver">
    <primary sortas="a-xorg7-driver">Xorg Drivers</primary>
  </indexterm>

  <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">Xorg Drivers Dependencies</bridgehead>

  <bridgehead renderas="sect4">Required</bridgehead>
  <para role="required"><xref linkend="xorg7-server"/></para>

  <bridgehead renderas="sect4">Optional</bridgehead>
  <para><xref linkend="mesalib"/></para>

  <sect2>
    <title>Downloading Xorg Drivers</title>

    <para>To download the needed files using <application>wget</application>,
    use the following commands:</para>

<screen><userinput>wget http://anduin.linuxfromscratch.org/sources/BLFS/svn/x/wget/driver.wget &amp;&amp;
mkdir driver &amp;&amp;
cd driver &amp;&amp;
wget -B http://xorg.freedesktop.org/releases/individual/driver/ -i ../driver.wget</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.</para></warning>

    <para>Install the drivers by running the following commands for each
    package:</para>

<screen><userinput>./configure $XORG_CONFIG \
    --with-xorg-module-dir=$XORG_PREFIX/lib/X11/modules &amp;&amp;
make</userinput></screen>

    <para>Now as the <systemitem class="username">root</systemitem>
    user:</para>

<screen><userinput role="root">make install</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para><parameter>--with-xorg-module-dir=...</parameter>: This switch
    ensures that the drivers are installed into the correct directory.</para>

  </sect2>

</sect1>