source: x/installing/xorg-server.xml@ 27373006

10.0 10.1 11.0 9.0 9.1 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 27373006 was 27373006, checked in by Bruce Dubbs <bdubbs@…>, 2 years ago

Modify xorg-server and xinit instructions to
avoid using the suid bit on the Xorg application. Add a note
to xinit on why using Xorg with the suid bit set may be useful.

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

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