source: x/installing/x7driver-intel.xml@ fce3067

<?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-intel-driver-download-http "&xorg-download-http;/driver/xf86-video-intel-&xorg-intel-driver-version;.tar.bz2">
  <!ENTITY xorg-intel-driver-download-ftp  "&xorg-download-ftp;/driver/xf86-video-intel-&xorg-intel-driver-version;.tar.bz2">-->
  
  <!-- git clone git://anongit.freedesktop.org/xorg/driver/xf86-video-intel
       as of 2016-09-02 -->

  <!--<!ENTITY xorg-intel-driver-version "2.99.917">-->
  <!ENTITY xorg-intel-driver-version "20170216">

  <!ENTITY xorg-intel-driver-download-http "&sources-anduin-http;/xf86-video-intel/xf86-video-intel-&xorg-intel-driver-version;.tar.xz">
  <!ENTITY xorg-intel-driver-download-ftp  "&sources-anduin-ftp;/xf86-video-intel/xf86-video-intel-&xorg-intel-driver-version;.tar.xz">
  <!ENTITY xorg-intel-driver-md5sum        "797c06a33bd1b3fb5a33468fbc84518d">
  <!ENTITY xorg-intel-driver-size          "15 MB">
  <!ENTITY xorg-intel-driver-buildsize     "92 MB">
  <!ENTITY xorg-intel-driver-time          "0.6 SBU">
]>

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

  <sect2info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect2info>

    <title>Xorg Intel Driver-&xorg-intel-driver-version;</title>

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

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

      <para>
        The <application>Xorg Intel Driver</application> package contains the X.Org
        Video Driver for Intel integrated video cards including 8xx, 9xx, Gxx, Qxx
        and HD graphics processors (SandyBridge, IvyBridge and Haswell).
      </para>

      &lfs80_checked;

      <note><para>This is a development version of the Intel driver
      which is needed to work properly with the latest hardware.</para></note>

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

      <bridgehead renderas="sect4">Xorg Intel Driver Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="xcb-util"/> and
        <xref linkend="xorg-server"/>
      </para>

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

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

    <para>
      Enable the following options in the kernel configuration. Only one of
      the lines <quote>Intel I810</quote> or <quote>Intel 8xx/9xx...</quote>
      needs to be selected. If you select the latter, <quote>Enable
      modesetting...</quote> is needed too. 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; Intel I810                                          [CONFIG_DRM_I810]
   &lt;*&gt; Intel 8xx/9xx/G3x/G4x/HD Graphics                   [CONFIG_DRM_I915]</literal></screen>

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

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

      <para>
        Install <application>Xorg Intel Driver</application> by running the following
        commands:
      </para>

<screen><userinput>./configure $XORG_CONFIG --enable-kms-only --enable-uxa &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 &amp;&amp;
mv -v /usr/share/man/man4/intel-virtual-output.4 \
      /usr/share/man/man1/intel-virtual-output.1 &amp;&amp;
sed -i '/\.TH/s/4/1/' /usr/share/man/man1/intel-virtual-output.1</userinput></screen>

    </sect3>

    <sect3>
      <title>Working around problems with the Intel driver</title>

      <para>
        The SandyBridge New Acceleration (SNA) code is intended to replace the
        old UXA (UMA Acceleration Architecture), but it is a large body of code
        and sometimes causes problems. In particular, when a system is built
        with gcc-5 and kernel headers from linux-4.0, trying to run this driver
        using SNA has been known to segfault on some of the supported chips.
        However, the version of the code in the version control system listed
        above has been tested successfully with both SNA and UXA capabilities.
      </para>

      <para>
        To work around this problem, as well as enabling support for UXA, it is
        necessary to force UXA to be used by creating a configuration file.  If
        this problem applies to you, 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/20-intel.conf &lt;&lt; "EOF"
<literal>Section "Device"
        Identifier "Intel Graphics"
        Driver "intel"
        Option "AccelMethod" "uxa"
EndSection</literal>
EOF</userinput></screen>

    </sect3>

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

      <para>
        <parameter>--enable-kms-only</parameter>: This switch omits the UMS
        (User Mode Setting) code.
      </para>

      <para>
        <parameter>--enable-uxa</parameter>: This switch allows the old UXA code
        to be compiled in addition to the default SNA.
      </para>

    </sect3>

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

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

        <seglistitem>
          <seg>
            intel-virtual-output
          </seg>
          <seg>
            libIntelXvMC.so
          </seg>
          <seg>
            intel_drv.so
          </seg>
        </seglistitem>
      </segmentedlist>

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

        <varlistentry id="intel_drv">
          <term><filename class="libraryfile">intel_drv.so</filename></term>
          <listitem>
            <para>
              is an Xorg video driver for Intel integrated graphics chipsets.
            </para>
            <indexterm zone="xorg-intel-driver intel_drv">
              <primary sortas="c-intel_drv">intel_drv.so</primary>
            </indexterm>
          </listitem>
        </varlistentry>

      </variablelist>

    </sect3>

  </sect2>
  <!-- End Xorg Intel Driver -->