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

10.0 10.1 11.0 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since a22e8cdb was a22e8cdb, checked in by Bruce Dubbs <bdubbs@…>, 4 years ago

Fix md5sum

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

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