glfs/x/installing/x7driver-nouveau.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 xorg-nouveau-driver-version "1.0.17">

  <!ENTITY xorg-nouveau-driver-download-http "&xorg-download-http;/driver/xf86-video-nouveau-&xorg-nouveau-driver-version;.tar.bz2">
  <!ENTITY xorg-nouveau-driver-download-ftp  "&xorg-download-ftp;/driver/xf86-video-nouveau-&xorg-nouveau-driver-version;.tar.bz2">
  <!ENTITY xorg-nouveau-driver-md5sum        "b08633be9af9ee819077c278dfc55648">
  <!ENTITY xorg-nouveau-driver-size          "620 KB">
  <!ENTITY xorg-nouveau-driver-buildsize     "14 MB">
  <!ENTITY xorg-nouveau-driver-time          "0.1 SBU">
]>

 <!-- Begin Xorg Nouveau Driver -->
  <sect2 id="xorg-nouveau-driver" xreflabel="Xorg Nouveau Driver-&xorg-nouveau-driver-version;">

  <sect2info>
    <date>$Date$</date>
  </sect2info>

    <title>Xorg Nouveau Driver-&xorg-nouveau-driver-version;</title>

    <indexterm zone="xorg-nouveau-driver">
      <primary sortas="a-xorg-nouveau-driver">xorg-nouveau-driver</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to Xorg Nouveau Driver</title>

      <para>
        The <application>Xorg Nouveau Driver</application> package contains the
        X.Org Video Driver for NVidia Cards including RIVA TNT, RIVA TNT2,
        GeForce 256, QUADRO, GeForce2, QUADRO2, GeForce3, QUADRO DDC,
        nForce, nForce2, GeForce4, QUADRO4, GeForce FX, QUADRO FX, GeForce 6XXX and
        GeForce 7xxx chipsets.
      </para>

      &lfs110a_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&xorg-nouveau-driver-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&xorg-nouveau-driver-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &xorg-nouveau-driver-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &xorg-nouveau-driver-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &xorg-nouveau-driver-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &xorg-nouveau-driver-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">Xorg Nouveau Drivers Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="xorg-server"/> (recommended to be built with glamor enabled)
      </para>

      <note>
        <para>
          The new <quote>Maxwell</quote> and <quote>Pascal</quote>
          GPUs require Glamor to be built with the Xorg server.
          <!-- I tested this driver with a GTX 1050ti - the above note is true. -->
        </para>
      </note>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/xorg-nouveau-driver"/>
      </para>
    </sect3>

    <sect3 role="kernel" id="xorg-nouveau-driver-kernel">
      <title>Kernel Configuration</title>

    <para>
      Enable the following options in the kernel configuration and recompile the
      kernel if necessary:
    </para>

<screen><literal>Device Drivers  ---&gt;
  Graphics support ---&gt;
   &lt;*&gt; Direct Rendering Manager (XFree86 ... support) ---&gt; [CONFIG_DRM]
   &lt;*&gt; Nouveau (NVIDIA) cards                              [CONFIG_DRM_NOUVEAU]
      [*]   Support for backlight control                     [CONFIG_DRM_NOUVEAU_BACKLIGHT]</literal></screen>

      <indexterm zone="xorg-nouveau-driver xorg-nouveau-driver-kernel">
        <primary sortas="d-xorg-nouveau-driver">xorg-nouveau-driver</primary>
      </indexterm>
    </sect3>

    <sect3 role="installation">
      <title>Installation of Xorg Nouveau Driver</title>

      <para>
        First, fix the <application>Xorg Nouveau Driver</application> to build
        with the latest Xorg Server:
      </para>

<screen><userinput remap="pre">grep -rl slave | xargs sed -i s/slave/secondary/</userinput></screen>
 
      <para>
        Install <application>Xorg Nouveau Driver</application> by running the following
        commands:
      </para>

<screen><userinput>./configure $XORG_CONFIG &amp;&amp;
make</userinput></screen>

      <para>
        This package does not come with a test suite.
      </para>

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

<screen role="root"><userinput>make install</userinput></screen>
    </sect3>
<!--
    Glamor has been removed from the nouveau driver.

    <sect3>
      <title>Glamor Acceleration</title>

      <para>
        Glamor is an acceleration library which uses cards' 3D capabilities
        to accelerate 2D rendering. Glamor acceleration is enabled by default
        for the new <quote>Maxwell</quote> GPU's. According to the
        documentation, Glamor acceleration can be used with other chips as
        well, but that does not seem functional yet.
      </para>

      <para>
        If you want anyway to try to enable Glamor for GPU's other than the new
        <quote>Maxwell</quote> ones, create the following file as
        the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>cat &gt;&gt; /etc/X11/xorg.conf.d/nvidia.conf &lt;&lt; "EOF"
<literal>Section "Device"
        Identifier "nvidia"
        Driver "nouveau"
        Option "AccelMethod" "glamor"
EndSection</literal>
EOF</userinput></screen>

    </sect3>
-->
    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Xorg Driver</segtitle>

        <seglistitem>
          <seg>
            nouveau_drv.so
          </seg>
        </seglistitem>
      </segmentedlist>

      <variablelist>
        <bridgehead renderas="sect4">Short Descriptions</bridgehead>
        <?dbfo list-presentation="list"?>
        <?dbhtml list-presentation="table"?>

        <varlistentry id="nouveau_drv">
          <term><filename class="libraryfile">nouveau_drv.so</filename></term>
          <listitem>
            <para>
              is an Xorg video driver for nVidia video cards
            </para>
            <indexterm zone="xorg-nouveau-driver nouveau_drv">
              <primary sortas="c-nouveau_drv">nouveau_drv.so</primary>
            </indexterm>
          </listitem>
        </varlistentry>

      </variablelist>

    </sect3>

  </sect2>