source: x/installing/x7driver-intel.xml@ 11db9792

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

  <!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        "3bffa543c146e801a7f2674865c34331">
  <!ENTITY xorg-intel-driver-size          "942 KB">
  <!ENTITY xorg-intel-driver-buildsize     "84 MB">
  <!ENTITY xorg-intel-driver-time          "0.6 SBU">
]>

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

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

<!--
  Note: Check if -fcommon is still required on versions gtr 20200218
        Its a "hack" for gcc-10
-->
<screen><userinput>CFLAGS="$CFLAGS -fcommon" ./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>