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

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

  <!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        "8795a5d17ece4dea4763e61be7805882">
  <!ENTITY xorg-intel-driver-size          "948 KB">
  <!ENTITY xorg-intel-driver-buildsize     "77 MB">
  <!ENTITY xorg-intel-driver-time          "0.6 SBU">
]>

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

    <sect2info>
      <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>

      &lfs110a_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>

<!-- appears to be in the current git version, but commenting since I do not have an 32-bit
      <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-virtual-output">
          <term><command>intel-virtual-output</command></term>
          <listitem>
            <para>
              is a utility to connect the integrated Intel GPU to discrete
              outputs on hybrid systems
            </para>
            <indexterm zone="xorg-intel-driver intel-virtual-output">
              <primary sortas="b-intel-virtual-output">intel-virtual-output</primary>
            </indexterm>
          </listitem>
        </varlistentry>

        <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>