source: x/installing/xorg-server.xml@ 7810f94

10.0 10.1 11.0 11.1 8.4 9.0 9.1 bdubbs/svn elogind lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 7810f94 was 7810f94, checked in by Ken Moffat <ken@…>, 4 years ago

xorg-server-1.20.3 : Fix trivially-easy local privilege escalation.

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

  • Property mode set to 100644
File size: 14.1 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 "8ee29e8b24cef6b3cfa747ec01b9155a">
10 <!ENTITY xorg-server-size "5.9 MB">
11 <!ENTITY xorg-server-buildsize "333 MB (with tests)">
12 <!ENTITY xorg-server-time "0.9 SBU (using parallelism=4; with tests)">
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 &lfs83_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<!-- Prime support is now automatically added in DRI3, and this patch
73 may break things on some setups.
74 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
75 <itemizedlist spacing="compact">
76 <listitem>
77 <para>
78 Optional patch:
79 <ulink url="&patch-root;/xorg-server-&xorg-server-version;-add_prime_support-1.patch"/>
80 </para>
81 </listitem>
82 </itemizedlist>-->
83
84 <bridgehead renderas="sect3">Xorg Server Dependencies</bridgehead>
85
86 <bridgehead renderas="sect4">Required</bridgehead>
87 <para role="required">
88 <xref linkend="pixman"/> and
89 <xref linkend="xorg7-font"/> (for the font-util package), and at runtime:
90 <xref role="runtime" linkend="xkeyboard-config"/>
91 </para>
92
93 <bridgehead renderas="sect4">Recommended</bridgehead>
94 <para role="recommended" revision="sysv">
95 <xref linkend="libepoxy"/> (required for glamor, see command
96 explanations below)
97 </para>
98 <para role="recommended" revision="systemd">
99 <xref linkend="libepoxy"/> (needed for glamor and Xwayland),
100 <xref linkend="wayland"/> (needed for Xwayland),
101 <xref linkend="wayland-protocols"/>, and
102 <xref linkend="systemd"/>
103 </para>
104
105 <bridgehead renderas="sect4">Optional</bridgehead>
106 <para role="optional">
107 <xref role="runtime" linkend="acpid"/> (runtime),
108 <xref linkend="doxygen"/> (to build API documentation),
109 <xref linkend="fop"/> (to build documentation),
110 <xref linkend="nettle"/>,
111 <xref linkend="libgcrypt"/>,
112 <xref linkend="xcb-util-keysyms"/>,
113 <xref linkend="xcb-util-image"/>,
114 <xref linkend="xcb-util-renderutil"/>,
115 <xref linkend="xcb-util-wm"/> (all three to build Xephyr),
116 <xref linkend="xmlto"/> (to build documentation),
117 <phrase revision="sysv"><xref linkend="wayland"/> (needed for Xwayland),
118 <xref linkend="wayland-protocols"/>,</phrase>
119 <ulink url="http://download.savannah.gnu.org/releases/libunwind">libunwind</ulink>, and
120 <ulink url="https://www.x.org/archive/individual/doc/">xorg-sgml-doctools</ulink> (to build documentation)
121 </para>
122
123 <para condition="html" role="usernotes">User Notes:
124 <ulink url='&blfs-wiki;/Xorg7Server'/>
125 </para>
126 </sect2>
127
128 <sect2 role="installation">
129 <title>Installation of Xorg Server</title>
130<!-- Patch removed
131 <para>
132 If you have downloaded the optional patch, apply it by running the
133 following command:
134 </para>
135
136<screen><userinput>patch -Np1 -i ../xorg-server-&xorg-server-version;-add_prime_support-1.patch</userinput></screen>-->
137
138 <para>
139 Install the server by running the following commands:
140 </para>
141
142<screen revision="sysv"><userinput>./configure $XORG_CONFIG \
143 --enable-glamor \
144 --enable-install-setuid \
145 --enable-suid-wrapper \
146 --disable-systemd-logind \
147 --with-xkb-output=/var/lib/xkb &amp;&amp;
148make</userinput></screen>
149
150<screen revision="systemd"><userinput>./configure $XORG_CONFIG \
151 --enable-glamor \
152 --enable-suid-wrapper \
153 --with-xkb-output=/var/lib/xkb &amp;&amp;
154make</userinput></screen>
155
156 <para>
157 To test the results, issue: <command>make check</command>. You
158 will need to run <command>ldconfig</command> as the <systemitem
159 class="username">root</systemitem> user first or some tests may fail.
160 </para>
161
162 <para>
163 Now as the <systemitem class="username">root</systemitem>
164 user:
165 </para>
166
167<screen role="root" revision="sysv"><userinput>make install &amp;&amp;
168mkdir -pv /etc/X11/xorg.conf.d &amp;&amp;
169cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"
170<literal>/tmp/.ICE-unix dir 1777 root root
171/tmp/.X11-unix dir 1777 root root</literal>
172EOF</userinput></screen>
173
174<screen role="root" revision="systemd"><userinput>make install &amp;&amp;
175mkdir -pv /etc/X11/xorg.conf.d</userinput></screen>
176
177 </sect2>
178
179 <sect2 role="commands">
180 <title>Command Explanations</title>
181
182 <para>
183 <parameter>--enable-glamor</parameter>: Build the Glamor DIX (Device
184 Independent X) module which is currently used by: R600 or later radeon
185 video chipsets, the modesetting driver (which is part of this package)
186 for hardware using KMS which offers acceleration, and (optionally) the
187 intel driver.
188 </para>
189
190 <para revision="sysv">
191 <parameter>--enable-install-setuid</parameter>: The Xorg binary must run
192 as the root user. This switch ensures that the binary is installed
193 setuid when <command>make</command> is run by an unprivileged user.
194 </para>
195
196 <para>
197 <parameter>--enable-suid-wrapper</parameter>: Build suid-root wrapper for
198 legacy driver support on rootless xserver systems.
199 </para>
200
201 <para revision="sysv">
202 <parameter>--disable-systemd-logind</parameter>: Do not build
203 systemd-logind support, otherwise, an error (EE), logged in
204 <filename>/var/log/Xorg.0.log</filename>, occurs when starting the X
205 server. Systemd is not supported by this (sysv) version of BLFS.
206 </para>
207
208 <para revision="systemd">
209 <option>--disable-systemd-logind --enable-install-setuid</option>:
210 These switches disable systemd-logind integration and restore the setuid
211 bit to the Xorg executable, allowing Xorg Server to work
212 without having the systemd PAM module installed and set up.
213 </para>
214
215 <para revision="sysv">
216 <command>cat &gt;&gt; /etc/sysconfig/createfiles...</command>: This
217 command creates the <filename class="directory">/tmp/.ICE-unix</filename>
218 and <filename class="directory">/tmp/.X11-unix</filename> directories at
219 startup, and ensures that the permissions and ownership are correct as
220 required by the server.
221 </para>
222
223 <para>
224 <option>--enable-dmx</option>: Build DMX (Distributed Multihead X)
225 server.
226 </para>
227
228 <para>
229 <option>--enable-kdrive</option>: this option allows the
230 <command>configure</command> script to enable Xephyr if its dependencies
231 are met.
232 </para>
233
234 </sect2>
235
236 <sect2 role="content">
237 <title>Contents</title>
238
239 <segmentedlist>
240 <segtitle>Installed Programs</segtitle>
241 <segtitle>Installed Libraries</segtitle>
242 <segtitle>Installed Directories</segtitle>
243
244 <seglistitem>
245 <seg>
246 cvt, gtf, X, Xnest, Xorg, and Xvfb; optional: dmxaddinput,
247 dmxaddscreen, dmxinfo, dmxreconfig, dmxresize, dmxrminput,
248 dmxrmscreen, dmxtodmx, dmxwininfo, vdltodmx, Xdmx, xdmxconfig, Xephyr,
249 Xfbdev and Xwayland
250 </seg>
251 <seg>
252 several under $XORG_PREFIX/lib/xorg/modules/{,drivers,extensions}
253 including modesetting_drv.so
254 </seg>
255 <seg>
256 $XORG_PREFIX/{include/xorg,lib/xorg,share/X11/xorg.conf.d} and
257 /var/lib/xkb
258 </seg>
259 </seglistitem>
260 </segmentedlist>
261
262 <variablelist>
263 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
264 <?dbfo list-presentation="list"?>
265 <?dbhtml list-presentation="table"?>
266
267 <varlistentry id="cvt-x7">
268 <term><command>cvt</command></term>
269 <listitem>
270 <para>
271 calculates VESA CVT mode lines.
272 </para>
273 <indexterm zone="xorg-server cvt-x7">
274 <primary sortas="b-cvt">cvt</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="dmx-x7">
280 <term><command>dmx*</command></term>
281 <listitem>
282 <para>
283 are various tools used for manipulating the dmx server.
284 </para>
285 <indexterm zone="xorg-server dmx-x7">
286 <primary sortas="b-dmx">dmx*</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="gtf-x7">
292 <term><command>gtf</command></term>
293 <listitem>
294 <para>
295 calculates VESA GTF mode lines.
296 </para>
297 <indexterm zone="xorg-server gtf-x7">
298 <primary sortas="b-gtf">gtf</primary>
299 </indexterm>
300 </listitem>
301 </varlistentry>
302
303 <varlistentry id="vdltodmx-x7">
304 <term><command>vdltodmx</command></term>
305 <listitem>
306 <para>
307 is a tool used to convert VDL config files to DMX config
308 files.
309 </para>
310 <indexterm zone="xorg-server vdltodmx-x7">
311 <primary sortas="b-vdltodmx">vdltodmx</primary>
312 </indexterm>
313 </listitem>
314 </varlistentry>
315
316 <varlistentry id="X-x7">
317 <term><command>X</command></term>
318 <listitem>
319 <para>
320 is a symbolic link to Xorg.
321 </para>
322 <indexterm zone="xorg-server X-x7">
323 <primary sortas="b-X">X</primary>
324 </indexterm>
325 </listitem>
326 </varlistentry>
327
328 <varlistentry id="Xdmx">
329 <term><command>Xdmx</command></term>
330 <listitem>
331 <para>
332 is a proxy X server that uses one or more other X servers as
333 its display devices.
334 </para>
335 <indexterm zone="xorg-server Xdmx">
336 <primary sortas="b-Xdmx">Xdmx</primary>
337 </indexterm>
338 </listitem>
339 </varlistentry>
340
341 <varlistentry id="Xephyr-x7">
342 <term><command>Xephyr</command></term>
343 <listitem>
344 <para>
345 is a nested X server which supports modern X extensions.
346 </para>
347 <indexterm zone="xorg-server Xephyr-x7">
348 <primary sortas="b-Xephyr">Xephyr</primary>
349 </indexterm>
350 </listitem>
351 </varlistentry>
352
353 <varlistentry id="Xnest-x7">
354 <term><command>Xnest</command></term>
355 <listitem>
356 <para>
357 is a nested X server.
358 </para>
359 <indexterm zone="xorg-server Xnest-x7">
360 <primary sortas="b-Xnest">Xnest</primary>
361 </indexterm>
362 </listitem>
363 </varlistentry>
364
365 <varlistentry id="Xorg-x7">
366 <term><command>Xorg</command></term>
367 <listitem>
368 <para>
369 is the X11R7 X Server.
370 </para>
371 <indexterm zone="xorg-server Xorg-x7">
372 <primary sortas="b-Xorg">Xorg</primary>
373 </indexterm>
374 </listitem>
375 </varlistentry>
376
377 <varlistentry id="Xvfb-x7">
378 <term><command>Xvfb</command></term>
379 <listitem>
380 <para>
381 is the virtual framebuffer X server for X Version 11.
382 </para>
383 <indexterm zone="xorg-server Xvfb-x7">
384 <primary sortas="b-Xvfb">Xvfb</primary>
385 </indexterm>
386 </listitem>
387 </varlistentry>
388
389 <varlistentry id="xdmxconfig-x7">
390 <term><command>xdmxconfig</command></term>
391 <listitem>
392 <para>
393 is a graphical configuration utility for the dmx server.
394 </para>
395 <indexterm zone="xorg-server xdmxconfig-x7">
396 <primary sortas="b-xdmxconfig">xdmxconfig</primary>
397 </indexterm>
398 </listitem>
399 </varlistentry>
400
401 <varlistentry id="Xwayland-x7">
402 <term><command>Xwayland</command></term>
403 <listitem>
404 <para>
405 allows the X server to run X clients under wayland (i.e. wayland
406 provides the input devices and handles the presentation of the
407 windows).
408 </para>
409 <indexterm zone="xorg-server Xwayland-x7">
410 <primary sortas="b-Xwayland">Xwayland</primary>
411 </indexterm>
412 </listitem>
413 </varlistentry>
414
415 <varlistentry id="modesetting_drv-x7">
416 <term><filename class="libraryfile">modesetting_drv.so</filename></term>
417 <listitem>
418 <para>
419 provides a video driver for machines using Kernel Mode Setting (KMS).
420 This will use glamor if that has been enabled and the hardware offers
421 acceleration.
422 </para>
423 <indexterm zone="xorg-server modesetting_drv-x7">
424 <primary sortas="c-modesetting_drv">modesetting_drv.so</primary>
425 </indexterm>
426 </listitem>
427 </varlistentry>
428
429 </variablelist>
430
431 </sect2>
432
433</sect1>
Note: See TracBrowser for help on using the repository browser.