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

<?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 "20190208">

  <!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        "f107c6b3ab5f5bc2ac8f601a63db8fe9">
  <!ENTITY xorg-intel-driver-size          "944 KB">
  <!ENTITY xorg-intel-driver-buildsize     "83 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 chips including 8xx, 9xx, Gxx, Qxx,
        HD, Iris, and Iris Pro graphics processors.
      </para>

      &lfs84_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. 
      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 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>
        If you are building on i686, apply a sed to fix a type mismatch.
      </para>

<screen><userinput remap="pre">case $(uname -m) in
   i?86) sed -i "s/#define force_inline inline __attribute__((always_inline))/#define force_inline inline/" src/sna/compiler.h
         ;;
esac</userinput></screen>

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

      <screen><userinput>./autogen.sh $XORG_CONFIG     \
            --enable-kms-only \
            --enable-uxa      \
            --mandir=/usr/share/man &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 may cause problems.  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 and modify it as
        needed:
      </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     "DRI" "2"            # DRI3 is default
        #Option     "AccelMethod"  "sna" # default
        #Option     "AccelMethod"  "uxa" # fallback
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 -->