source: x/installing/xorg-server.xml@ 73db5703

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 73db5703 was 73db5703, checked in by Bruce Dubbs <bdubbs@…>, 19 months ago

Update to xorg-server-1.20.8.
Update to xfce4-terminal-0.8.9.2.

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