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

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since b1a4b4a7 was b1a4b4a7, checked in by Douglas R. Reno <renodr@…>, 14 months ago

Update to libX11-1.6.11
Fix CVE-2020-14347 in xorg-server

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23492 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 "a770aec600116444a953ff632f51f839">
10 <!ENTITY xorg-server-size "6.0 MB">
11 <!ENTITY xorg-server-buildsize "257 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 &lfs91_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"/> (only font-util), 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 First, apply a fix for a security vulnerability identified upstream:
137 </para>
138
139<screen><userinput remap="pre">sed -i 's/malloc(pScreen/calloc(1, pScreen/' dix/pixmap.c</userinput></screen>
140
141 <para>
142 Install the server by running the following commands:
143 </para>
144
145<screen><userinput>./configure $XORG_CONFIG \
146 --enable-glamor \
147 --enable-suid-wrapper \
148 --with-xkb-output=/var/lib/xkb &amp;&amp;
149make</userinput></screen>
150
151 <para>
152 To test the results, issue: <command>make check</command>. You
153 will need to run <command>ldconfig</command> as the <systemitem
154 class="username">root</systemitem> user first or some tests may fail.
155 </para>
156
157 <para>
158 Now as the <systemitem class="username">root</systemitem>
159 user:
160 </para>
161
162<screen role="root" revision="sysv"><userinput>make install &amp;&amp;
163mkdir -pv /etc/X11/xorg.conf.d &amp;&amp;
164cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"
165<literal>/tmp/.ICE-unix dir 1777 root root
166/tmp/.X11-unix dir 1777 root root</literal>
167EOF</userinput></screen>
168
169<screen role="root" revision="systemd"><userinput>make install &amp;&amp;
170mkdir -pv /etc/X11/xorg.conf.d</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 used by: R600 or later radeon
180 video chipsets, the modesetting driver (which is part of this package)
181 for hardware using KMS which offers acceleration, and (optionally) the
182 intel driver.
183 </para>
184
185 <para>
186 <parameter>--enable-suid-wrapper</parameter>: Build suid-root wrapper for
187 legacy driver support on rootless xserver systems.
188 </para>
189
190 <para>
191 <option>--disable-systemd-logind</option>:
192 This switch disables <phrase revision="systemd">systemd-logind</phrase>
193 <phrase revision="sysv">elogind</phrase> integration allowing Xorg Server
194 to work without having the <phrase revision="systemd">systemd</phrase>
195 <phrase revision="elogind">elogind</phrase> PAM module configured.
196 </para>
197
198 <para>
199 <option>--enable-install-setuid</option>:
200 This switch restores the setuid bit to the Xorg executable allowing Xorg
201 Server to work with a virtual terminal designated on the
202 <command>startx</command> command line.
203 </para>
204
205 <para revision="sysv">
206 <command>cat &gt;&gt; /etc/sysconfig/createfiles...</command>: This
207 command creates the <filename class="directory">/tmp/.ICE-unix</filename>
208 and <filename class="directory">/tmp/.X11-unix</filename> directories at
209 startup, and ensures that the permissions and ownership are correct as
210 required by the server.
211 </para>
212
213 <para>
214 <option>--enable-dmx</option>: Build DMX (Distributed Multihead X)
215 server.
216 </para>
217
218 <para>
219 <option>--enable-kdrive</option>: this option allows the
220 <command>configure</command> script to enable Xephyr if its dependencies
221 are met.
222 </para>
223
224 </sect2>
225
226 <sect2 role="content">
227 <title>Contents</title>
228
229 <segmentedlist>
230 <segtitle>Installed Programs</segtitle>
231 <segtitle>Installed Libraries</segtitle>
232 <segtitle>Installed Directories</segtitle>
233
234 <seglistitem>
235 <seg>
236 cvt, gtf, X, Xnest, Xorg, and Xvfb; optional: dmxaddinput,
237 dmxaddscreen, dmxinfo, dmxreconfig, dmxresize, dmxrminput,
238 dmxrmscreen, dmxtodmx, dmxwininfo, vdltodmx, Xdmx, xdmxconfig, Xephyr,
239 Xfbdev and Xwayland
240 </seg>
241 <seg>
242 several under $XORG_PREFIX/lib/xorg/modules/{,drivers,extensions}
243 including modesetting_drv.so
244 </seg>
245 <seg>
246 $XORG_PREFIX/{include/xorg,lib/xorg,share/X11/xorg.conf.d} and
247 /var/lib/xkb
248 </seg>
249 </seglistitem>
250 </segmentedlist>
251
252 <variablelist>
253 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
254 <?dbfo list-presentation="list"?>
255 <?dbhtml list-presentation="table"?>
256
257 <varlistentry id="cvt-x7">
258 <term><command>cvt</command></term>
259 <listitem>
260 <para>
261 calculates VESA CVT mode lines.
262 </para>
263 <indexterm zone="xorg-server cvt-x7">
264 <primary sortas="b-cvt">cvt</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268
269 <varlistentry id="dmx-x7">
270 <term><command>dmx*</command></term>
271 <listitem>
272 <para>
273 are various tools used for manipulating the dmx server.
274 </para>
275 <indexterm zone="xorg-server dmx-x7">
276 <primary sortas="b-dmx">dmx*</primary>
277 </indexterm>
278 </listitem>
279 </varlistentry>
280
281 <varlistentry id="gtf-x7">
282 <term><command>gtf</command></term>
283 <listitem>
284 <para>
285 calculates VESA GTF mode lines.
286 </para>
287 <indexterm zone="xorg-server gtf-x7">
288 <primary sortas="b-gtf">gtf</primary>
289 </indexterm>
290 </listitem>
291 </varlistentry>
292
293 <varlistentry id="vdltodmx-x7">
294 <term><command>vdltodmx</command></term>
295 <listitem>
296 <para>
297 is a tool used to convert VDL config files to DMX config
298 files.
299 </para>
300 <indexterm zone="xorg-server vdltodmx-x7">
301 <primary sortas="b-vdltodmx">vdltodmx</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 <varlistentry id="X-x7">
307 <term><command>X</command></term>
308 <listitem>
309 <para>
310 is a symbolic link to Xorg.
311 </para>
312 <indexterm zone="xorg-server X-x7">
313 <primary sortas="b-X">X</primary>
314 </indexterm>
315 </listitem>
316 </varlistentry>
317
318 <varlistentry id="Xdmx">
319 <term><command>Xdmx</command></term>
320 <listitem>
321 <para>
322 is a proxy X server that uses one or more other X servers as
323 its display devices.
324 </para>
325 <indexterm zone="xorg-server Xdmx">
326 <primary sortas="b-Xdmx">Xdmx</primary>
327 </indexterm>
328 </listitem>
329 </varlistentry>
330
331 <varlistentry id="Xephyr-x7">
332 <term><command>Xephyr</command></term>
333 <listitem>
334 <para>
335 is a nested X server which supports modern X extensions.
336 </para>
337 <indexterm zone="xorg-server Xephyr-x7">
338 <primary sortas="b-Xephyr">Xephyr</primary>
339 </indexterm>
340 </listitem>
341 </varlistentry>
342
343 <varlistentry id="Xnest-x7">
344 <term><command>Xnest</command></term>
345 <listitem>
346 <para>
347 is a nested X server.
348 </para>
349 <indexterm zone="xorg-server Xnest-x7">
350 <primary sortas="b-Xnest">Xnest</primary>
351 </indexterm>
352 </listitem>
353 </varlistentry>
354
355 <varlistentry id="Xorg-x7">
356 <term><command>Xorg</command></term>
357 <listitem>
358 <para>
359 is the X11R7 X Server.
360 </para>
361 <indexterm zone="xorg-server Xorg-x7">
362 <primary sortas="b-Xorg">Xorg</primary>
363 </indexterm>
364 </listitem>
365 </varlistentry>
366
367 <varlistentry id="Xvfb-x7">
368 <term><command>Xvfb</command></term>
369 <listitem>
370 <para>
371 is the virtual framebuffer X server for X Version 11.
372 </para>
373 <indexterm zone="xorg-server Xvfb-x7">
374 <primary sortas="b-Xvfb">Xvfb</primary>
375 </indexterm>
376 </listitem>
377 </varlistentry>
378
379 <varlistentry id="xdmxconfig-x7">
380 <term><command>xdmxconfig</command></term>
381 <listitem>
382 <para>
383 is a graphical configuration utility for the dmx server.
384 </para>
385 <indexterm zone="xorg-server xdmxconfig-x7">
386 <primary sortas="b-xdmxconfig">xdmxconfig</primary>
387 </indexterm>
388 </listitem>
389 </varlistentry>
390
391 <varlistentry id="Xwayland-x7">
392 <term><command>Xwayland</command></term>
393 <listitem>
394 <para>
395 allows the X server to run X clients under wayland (i.e. wayland
396 provides the input devices and handles the presentation of the
397 windows).
398 </para>
399 <indexterm zone="xorg-server Xwayland-x7">
400 <primary sortas="b-Xwayland">Xwayland</primary>
401 </indexterm>
402 </listitem>
403 </varlistentry>
404
405 <varlistentry id="modesetting_drv-x7">
406 <term><filename class="libraryfile">modesetting_drv.so</filename></term>
407 <listitem>
408 <para>
409 provides a video driver for machines using Kernel Mode Setting (KMS).
410 This will use glamor if that has been enabled and the hardware offers
411 acceleration.
412 </para>
413 <indexterm zone="xorg-server modesetting_drv-x7">
414 <primary sortas="c-modesetting_drv">modesetting_drv.so</primary>
415 </indexterm>
416 </listitem>
417 </varlistentry>
418
419 </variablelist>
420
421 </sect2>
422
423</sect1>
Note: See TracBrowser for help on using the repository browser.