aboutsummaryrefslogtreecommitdiffstats
path: root/archive/x7driver-intel.xml
blob: a6a017f618f12e6354df521f3c908ea91bcc77aa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
<?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 "20230223">

  <!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        "875adabe0d053856b43bbdd77e728cc7">
  <!ENTITY xorg-intel-driver-size          "948 KB">
  <!ENTITY xorg-intel-driver-buildsize     "72 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>

      &lfs113_checked;

      <note>
        <para>
          This driver is for Intel integrated GPU, and a development
          version is needed to work properly with the latest hardware.
          This version is now one year old and has some problems. The
          <quote>Kernel Modes Setting (KMS)</quote> driver shipped along
          with Xorg Server is said to give better results.
        </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>

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