source: x/installing/xorg-server.xml@ 6dd40f9

10.0 10.1 11.0 11.1 7.10 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 6dd40f9 was 6dd40f9, checked in by Pierre Labastie <pieere@…>, 7 years ago

Patch the modesetting video driver for 32 bit machine and software
mouse pointer

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@15589 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 12.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY xorg-server-download-http "&xorg-download-http;/xserver/xorg-server-&xorg-server-version;.tar.bz2">
8 <!ENTITY xorg-server-download-ftp "&xorg-download-ftp;/xserver/xorg-server-&xorg-server-version;.tar.bz2">
9 <!ENTITY xorg-server-md5sum "5986510d59e394a50126a8e2833e79d3">
10 <!ENTITY xorg-server-size "5.6 MB">
11 <!ENTITY xorg-server-buildsize "410 MB">
12 <!ENTITY xorg-server-time "1.6 SBU">
13]>
14
15<sect1 id="xorg-server" xreflabel="Xorg-Server-&xorg-server-version;">
16 <?dbhtml filename="xorg-server.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Xorg-Server-&xorg-server-version;</title>
24
25 <indexterm zone="xorg-server">
26 <primary sortas="a-xorg-server">xorg-server</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Xorg Server</title>
31
32 <para>
33 The <application>Xorg</application> Server is the core
34 of the X Window system.
35 </para>
36
37 &lfs77_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&xorg-server-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&xorg-server-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &xorg-server-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &xorg-server-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &xorg-server-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &xorg-server-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
74 <itemizedlist spacing="compact">
75 <listitem>
76 <para>
77 Optional patch:
78 <ulink url="&patch-root;/xorg-server-&xorg-server-version;-add_prime_support-1.patch"/>
79 </para>
80 </listitem>
81 <listitem>
82 <para>
83 Optional patch:
84 <ulink url="&patch-root;/xorg-server-&xorg-server-version;-fix_modesetting-1.patch"/>
85 </para>
86 </listitem>
87 </itemizedlist>
88
89 <bridgehead renderas="sect3">Xorg Server Dependencies</bridgehead>
90
91 <bridgehead renderas="sect4">Required</bridgehead>
92 <para role="required">
93 <xref linkend="openssl"/> or
94 <xref linkend="nettle"/> or
95 <xref linkend="libgcrypt"/>,
96 <xref linkend="pixman"/>,
97 <xref linkend="xorg7-font"/>, and
98 <xref linkend="xkeyboard-config"/>
99 </para>
100
101 <bridgehead renderas="sect4">Recommended</bridgehead>
102 <para role="recommended">
103 <xref linkend="libepoxy"/> (required for glamor, see command
104 explanations below)
105 <xref linkend="xcb-util-keysyms"/> (used by Xnest)
106 </para>
107
108 <bridgehead renderas="sect4">Optional</bridgehead>
109 <para role="optional">
110 <xref linkend="acpid"/> (runtime),
111 <xref linkend="doxygen"/> (to build API documentation),
112 <xref linkend="fop"/>, (to build documentation),
113 <xref linkend="gs"/> (to build documentation),
114 <xref linkend="xcb-util-image"/>,
115 <xref linkend="xcb-util-renderutil"/>,
116 <xref linkend="xcb-util-wm"/> (all three to build Xephyr) and
117 <xref linkend="xmlto"/> (to build documentation)
118 </para>
119
120 <para condition="html" role="usernotes">User Notes:
121 <ulink url='&blfs-wiki;/Xorg7Server'/>
122 </para>
123 </sect2>
124
125 <sect2 role="installation">
126 <title>Installation of Xorg Server</title>
127
128 <para>
129 If you have downloaded the first optional patch, apply it by running
130 the following command:
131 </para>
132
133<screen><userinput>patch -Np1 -i ../xorg-server-&xorg-server-version;-add_prime_support-1.patch</userinput></screen>
134
135 <para>
136 The <application>modesetting</application> video driver is now included
137 in the tarball (since version 1.17). It needs to be fixed for 32-bit
138 machines and for cards which do not support an hardware mouse pointer.
139 If you plan to use the modesetting video driver, run the
140 following command:
141 </para>
142
143<screen><userinput>patch -Np1 -i ../xorg-server-&xorg-server-version;-fix_modesetting-1.patch</userinput></screen>
144
145 <para>
146 Install the server by running the following commands:
147 </para>
148
149<screen><userinput>./configure $XORG_CONFIG \
150 --with-xkb-output=/var/lib/xkb \
151 --enable-glamor \
152 --enable-install-setuid \
153 --enable-suid-wrapper &amp;&amp;
154make</userinput></screen>
155
156 <para>
157 To test the results, issue: <command>make check</command>.
158 </para>
159
160 <para>
161 Now as the <systemitem class="username">root</systemitem>
162 user:
163 </para>
164
165<screen role="root"><userinput>make install &amp;&amp;
166mkdir -pv /etc/X11/xorg.conf.d &amp;&amp;
167cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"
168<literal>/tmp/.ICE-unix dir 1777 root root
169/tmp/.X11-unix dir 1777 root root</literal>
170EOF</userinput></screen>
171
172 </sect2>
173
174 <sect2 role="commands">
175 <title>Command Explanations</title>
176
177 <para>
178 <parameter>--enable-glamor</parameter>: Build the Glamor DIX (Device
179 Independent X) module which is currently required for Southern Islands and
180 Sea Islands radeon video chipsets, optional for some other radeons, and
181 also optional for the intel driver. It is also used by the modesetting
182 driver (which is part of this package) for on hardware using KMS and which
183 offers acceleration.
184 </para>
185
186 <para>
187 <parameter>--enable-install-setuid</parameter>: The Xorg binary must run
188 as the root user. This switch ensures that the binary is installed
189 setuid when <command>make</command> is run by an unprivileged user.
190 </para>
191
192 <para>
193 <parameter>--enable-suid-wrapper</parameter>: Build suid-root wrapper for
194 legacy driver support on rootless xserver systems.
195 </para>
196
197 <para>
198 <command>cat &gt;&gt; /etc/sysconfig/createfiles...</command>: This
199 command creates the <filename class="directory">/tmp/.ICE-unix</filename>
200 and <filename class="directory">/tmp/.X11-unix</filename> directories at
201 startup, and ensures that the permissions and ownership are correct as
202 required by the server.
203 </para>
204
205 <para>
206 <option>--enable-dmx</option>: Build DMX (Distributed Multihead X)
207 server.
208 </para>
209
210 <para>
211 <option>--enable-kdrive</option>: this option allows the
212 <command>configure</command> script to enable Xephyr if its dependencies
213 are met.
214 </para>
215
216 </sect2>
217
218 <sect2 role="content">
219 <title>Contents</title>
220
221 <segmentedlist>
222 <segtitle>Installed Programs</segtitle>
223 <segtitle>Installed Libraries</segtitle>
224 <segtitle>Installed Directories</segtitle>
225
226 <seglistitem>
227 <seg>
228 cvt, dmxaddinput, dmxaddscreen, dmxinfo, dmxreconfig, dmxresize,
229 dmxrminput, dmxrmscreen, dmxtodmx, dmxwininfo, gtf, vdltodmx, X,
230 Xdmx, xdmxconfig, Xephyr, Xnest, Xorg, and Xvfb
231 </seg>
232 <seg>
233 several under $XORG_PREFIX/lib/xorg/modules/{,drivers,extensions}
234 including modesetting_drv.so
235 </seg>
236 <seg>
237 $XORG_PREFIX/include/xorg,
238 $XORG_PREFIX/lib/xorg,
239 $XORG_PREFIX/share/X11/xorg.conf.d, and
240 /var/lib/xkb
241 </seg>
242 </seglistitem>
243 </segmentedlist>
244
245 <variablelist>
246 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
247 <?dbfo list-presentation="list"?>
248 <?dbhtml list-presentation="table"?>
249
250 <varlistentry id="cvt-x7">
251 <term><command>cvt</command></term>
252 <listitem>
253 <para>
254 calculates VESA CVT mode lines.
255 </para>
256 <indexterm zone="xorg-server cvt-x7">
257 <primary sortas="b-cvt">cvt</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="dmx-x7">
263 <term><command>dmx*</command></term>
264 <listitem>
265 <para>
266 are various tools used for manipulating the dmx server.
267 </para>
268 <indexterm zone="xorg-server dmx-x7">
269 <primary sortas="b-dmx">dmx*</primary>
270 </indexterm>
271 </listitem>
272 </varlistentry>
273
274 <varlistentry id="gtf-x7">
275 <term><command>gtf</command></term>
276 <listitem>
277 <para>
278 calculates VESA GTF mode lines.
279 </para>
280 <indexterm zone="xorg-server gtf-x7">
281 <primary sortas="b-gtf">gtf</primary>
282 </indexterm>
283 </listitem>
284 </varlistentry>
285
286 <varlistentry id="vdltodmx-x7">
287 <term><command>vdltodmx</command></term>
288 <listitem>
289 <para>
290 is a tool used to convert VDL config files to DMX config
291 files.
292 </para>
293 <indexterm zone="xorg-server vdltodmx-x7">
294 <primary sortas="b-vdltodmx">vdltodmx</primary>
295 </indexterm>
296 </listitem>
297 </varlistentry>
298
299 <varlistentry id="X-x7">
300 <term><command>X</command></term>
301 <listitem>
302 <para>
303 is a symbolic link to Xorg.
304 </para>
305 <indexterm zone="xorg-server X-x7">
306 <primary sortas="b-X">X</primary>
307 </indexterm>
308 </listitem>
309 </varlistentry>
310
311 <varlistentry id="Xephyr-x7">
312 <term><command>Xephyr</command></term>
313 <listitem>
314 <para>
315 is a nested X server which supports modern X extensions.
316 </para>
317 <indexterm zone="xorg-server Xephyr-x7">
318 <primary sortas="b-Xephyr">Xephyr</primary>
319 </indexterm>
320 </listitem>
321 </varlistentry>
322
323 <varlistentry id="Xnest-x7">
324 <term><command>Xnest</command></term>
325 <listitem>
326 <para>
327 is a nested X server.
328 </para>
329 <indexterm zone="xorg-server Xnest-x7">
330 <primary sortas="b-Xnest">Xnest</primary>
331 </indexterm>
332 </listitem>
333 </varlistentry>
334
335 <varlistentry id="Xorg-x7">
336 <term><command>Xorg</command></term>
337 <listitem>
338 <para>
339 is the X11R7 X Server.
340 </para>
341 <indexterm zone="xorg-server Xorg-x7">
342 <primary sortas="b-Xorg">Xorg</primary>
343 </indexterm>
344 </listitem>
345 </varlistentry>
346
347 <varlistentry id="Xvfb-x7">
348 <term><command>Xvfb</command></term>
349 <listitem>
350 <para>
351 is the virtual framebuffer X server for X Version 11.
352 </para>
353 <indexterm zone="xorg-server Xvfb-x7">
354 <primary sortas="b-Xvfb">Xvfb</primary>
355 </indexterm>
356 </listitem>
357 </varlistentry>
358
359 <varlistentry id="xdmxconfig-x7">
360 <term><command>xdmxconfig</command></term>
361 <listitem>
362 <para>
363 is a graphical configuration utility for the dmx server.
364 </para>
365 <indexterm zone="xorg-server xdmxconfig-x7">
366 <primary sortas="b-xdmxconfig">xdmxconfig</primary>
367 </indexterm>
368 </listitem>
369 </varlistentry>
370
371 <varlistentry id="modesetting_drv-x7">
372 <term><filename class="libraryfile">modesetting_drv.so</filename></term>
373 <listitem>
374 <para>
375 provides a video driver for machines using Kernel Mode Setting (KMS).
376 This will use glamor if that has been enabled and the hardware offers
377 acceleration.
378 </para>
379 <indexterm zone="xorg-server modesetting_drv-x7">
380 <primary sortas="c-modesetting_drv">modesetting_drv.so</primary>
381 </indexterm>
382 </listitem>
383 </varlistentry>
384
385 </variablelist>
386
387 </sect2>
388
389</sect1>
Note: See TracBrowser for help on using the repository browser.