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

elogind
Last change on this file since e7d893b was e7d893b, checked in by DJ Lucas <dj@…>, 5 years ago

Merge to HEAD 21602.

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