source: x/installing/xorg-server.xml@ 170a6f8

10.0 10.1 11.0 11.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 170a6f8 was 170a6f8, checked in by Ken Moffat <ken@…>, 5 years ago

Xorg security updates, and libdrm.

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

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