source: x/installing/xorg-server.xml@ 9ea9aa7

systemd-13485
Last change on this file since 9ea9aa7 was 9ea9aa7, checked in by DJ Lucas <dj@…>, 8 years ago

Merges from trunk to r17100.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@17231 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 12.9 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 "052fc1b4b12a5df0a3e35a1b46a52db3">
10 <!ENTITY xorg-server-size "5.6 MB">
11 <!ENTITY xorg-server-buildsize "544 MB (with tests)">
12 <!ENTITY xorg-server-time "1.8 SBU (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 &lfs79_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 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
74 <itemizedlist spacing="compact">
75 <listitem>
76 <para>
77 Optional patch:
78 <ulink url="&patch-root;/xorg-server-&xorg-server-version;-add_prime_support-1.patch"/>
79 </para>
80 </listitem>
81<!-- Seems to have been included in version 1.18.2
82 <listitem>
83 <para>
84 Recommended patch (required by <xref linkend="wayland"/>):
85 <ulink url="&patch-root;/xorg-server-&xorg-server-version;-wayland_190-1.patch"/>
86 </para>
87 </listitem>-->
88 </itemizedlist>
89
90 <bridgehead renderas="sect3">Xorg Server Dependencies</bridgehead>
91
92 <bridgehead renderas="sect4">Required</bridgehead>
93 <para role="required">
94 <xref linkend="nettle"/> or
95 <xref linkend="libgcrypt"/> or
96 <xref linkend="openssl"/>,
97 <xref linkend="libpciaccess"/>,
98 <xref linkend="pixman"/>,
99 <xref linkend="xorg7-font"/> and
100 <xref linkend="xkeyboard-config"/>
101 </para>
102
103 <bridgehead renderas="sect4">Recommended</bridgehead>
104 <para role="recommended">
105 <xref linkend="libepoxy"/> (required to build Glamor),
106 <xref linkend="wayland"/> (both for <command>Xwayland</command>),
107 <xref linkend="systemd"/> and
108 <xref linkend="xcb-util-keysyms"/> (used by <command>Xnest</command>)
109 </para>
110
111 <bridgehead renderas="sect4">Optional</bridgehead>
112 <para role="optional">
113 <xref linkend="acpid"/> (runtime),
114 <xref linkend="doxygen"/> (to build API documentation),
115 <xref linkend="fop"/>, (to build documentation),
116 <xref linkend="gs"/> (to build documentation),
117 <xref linkend="xcb-util-keysyms"/> (used by Xnest),
118 <xref linkend="xcb-util-image"/>,
119 <xref linkend="xcb-util-renderutil"/>,
120 <xref linkend="xcb-util-wm"/> (all three to build <command>Xephyr</command>),
121 <xref linkend="xmlto"/>, (to build documentation) and
122 <ulink url="http://download.savannah.gnu.org/releases/libunwind/">libunwind</ulink>
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
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 If you have downloaded the recommended patch, apply it by running the
142 following command:
143 </para>
144
145<screen><userinput>patch -Np1 -i ../xorg-server-&xorg-server-version;-wayland_190-1.patch</userinput></screen>
146
147 <para>
148 Install the server by running the following commands:
149 </para>
150
151<screen><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>.
159 </para>
160
161 <para>
162 Now as the <systemitem class="username">root</systemitem>
163 user:
164 </para>
165
166<screen role="root"><userinput>make install &amp;&amp;
167mkdir -pv /etc/X11/xorg.conf.d</userinput></screen>
168
169 </sect2>
170
171 <sect2 role="commands">
172 <title>Command Explanations</title>
173
174 <para>
175 <parameter>--enable-glamor</parameter>: This switch enables building
176 of the Glamor DIX module which is required by some drivers and
177 <command>Xwayland</command>. Remove it if you don't want to install
178 <application>libepoxy</application> and are not going to need
179 <command>Xwayland</command> or you don't have any hardware that
180 requires Glamor (Radeon "Southern Islands" and later GPUs). It is
181 also required to build the modesetting driver, which is a generic
182 Xorg Video driver for hardware that has a KMS driver.
183 </para>
184
185 <para>
186 <parameter>--enable-suid-wrapper</parameter>: This switch enables building
187 of the suid-root wrapper for legacy driver support on rootless xserver
188 systems.
189 </para>
190
191 <para>
192 <option>--enable-dmx</option>: This switch enables building of the DMX
193 (Distributed Multihead X) server. Use it if you want to build DMX.
194 </para>
195
196 <para>
197 <option>--enable-kdrive</option>: This switch enables building of the
198 kdrive servers such as <command>Xephyr</command> and
199 <command>Xfbdev</command>. Use it if you have installed optional
200 xcb-util packages and want to build the mentioned programs.
201 </para>
202
203 <para>
204 <option>--disable-systemd-logind --enable-install-setuid</option>: These
205 switches disable <command>systemd-logind</command> integration and
206 restore the setuid bit to the <command>Xorg</command> executable,
207 allowing <application>Xorg Server</application> to work without having
208 the <application>systemd</application> PAM module installed and set up.
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 Xorg Driver</segtitle>
220 <segtitle>Installed Directories</segtitle>
221
222 <seglistitem>
223 <seg>
224 cvt, gtf, X, Xnest, Xorg, and Xvfb; optional: dmxaddinput,
225 dmxaddscreen, dmxinfo, dmxreconfig, dmxresize, dmxrminput,
226 dmxrmscreen, dmxtodmx, dmxwininfo, vdltodmx, Xdmx, xdmxconfig, Xephyr,
227 and Xfbdev
228 </seg>
229 <seg>
230 None
231 </seg>
232 <seg>
233 modesetting_drv.so
234 </seg>
235 <seg>
236 $XORG_PREFIX/include/xorg,
237 $XORG_PREFIX/lib/xorg,
238 $XORG_PREFIX/share/X11/xorg.conf.d and
239 /var/lib/xkb
240 </seg>
241 </seglistitem>
242 </segmentedlist>
243
244 <variablelist>
245 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
246 <?dbfo list-presentation="list"?>
247 <?dbhtml list-presentation="table"?>
248
249 <varlistentry id="cvt-x7">
250 <term><command>cvt</command></term>
251 <listitem>
252 <para>
253 calculates VESA CVT mode lines.
254 </para>
255 <indexterm zone="xorg-server cvt-x7">
256 <primary sortas="b-cvt">cvt</primary>
257 </indexterm>
258 </listitem>
259 </varlistentry>
260
261 <varlistentry id="dmx-x7">
262 <term><command>dmx*</command></term>
263 <listitem>
264 <para>
265 are various tools used for manipulating the dmx server.
266 </para>
267 <indexterm zone="xorg-server dmx-x7">
268 <primary sortas="b-dmx">dmx*</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272
273 <varlistentry id="gtf-x7">
274 <term><command>gtf</command></term>
275 <listitem>
276 <para>
277 calculates VESA GTF mode lines.
278 </para>
279 <indexterm zone="xorg-server gtf-x7">
280 <primary sortas="b-gtf">gtf</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 <varlistentry id="vdltodmx-x7">
286 <term><command>vdltodmx</command></term>
287 <listitem>
288 <para>
289 is a tool used to convert VDL config files to DMX config
290 files.
291 </para>
292 <indexterm zone="xorg-server vdltodmx-x7">
293 <primary sortas="b-vdltodmx">vdltodmx</primary>
294 </indexterm>
295 </listitem>
296 </varlistentry>
297
298 <varlistentry id="X-x7">
299 <term><command>X</command></term>
300 <listitem>
301 <para>
302 is a symbolic link to Xorg.
303 </para>
304 <indexterm zone="xorg-server X-x7">
305 <primary sortas="b-X">X</primary>
306 </indexterm>
307 </listitem>
308 </varlistentry>
309
310 <varlistentry id="Xdmx-x7">
311 <term><command>Xdmx</command></term>
312 <listitem>
313 <para>
314 is a distributed multi-head X server.
315 </para>
316 <indexterm zone="xorg-server Xdmx-x7">
317 <primary sortas="b-Xdmx">Xdmx</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321
322 <varlistentry id="Xdmx">
323 <term><command>Xdmx</command></term>
324 <listitem>
325 <para>
326 is a proxy X server that uses one or more other X servers as
327 its display devices.
328 </para>
329 <indexterm zone="xorg-server Xdmx">
330 <primary sortas="b-Xdmx">Xdmx</primary>
331 </indexterm>
332 </listitem>
333 </varlistentry>
334
335 <varlistentry id="Xephyr-x7">
336 <term><command>Xephyr</command></term>
337 <listitem>
338 <para>
339 is a nested X server that supports modern
340 X extensions.
341 </para>
342 <indexterm zone="xorg-server Xephyr-x7">
343 <primary sortas="b-Xephyr">Xephyr</primary>
344 </indexterm>
345 </listitem>
346 </varlistentry>
347
348 <varlistentry id="Xnest-x7">
349 <term><command>Xnest</command></term>
350 <listitem>
351 <para>
352 is a nested X server.
353 </para>
354 <indexterm zone="xorg-server Xnest-x7">
355 <primary sortas="b-Xnest">Xnest</primary>
356 </indexterm>
357 </listitem>
358 </varlistentry>
359
360 <varlistentry id="Xorg-x7">
361 <term><command>Xorg</command></term>
362 <listitem>
363 <para>
364 is the X11R7 X Server.
365 </para>
366 <indexterm zone="xorg-server Xorg-x7">
367 <primary sortas="b-Xorg">Xorg</primary>
368 </indexterm>
369 </listitem>
370 </varlistentry>
371
372 <varlistentry id="Xvfb-x7">
373 <term><command>Xvfb</command></term>
374 <listitem>
375 <para>
376 is the virtual framebuffer X server for X Version 11.
377 </para>
378 <indexterm zone="xorg-server Xvfb-x7">
379 <primary sortas="b-Xvfb">Xvfb</primary>
380 </indexterm>
381 </listitem>
382 </varlistentry>
383
384 <varlistentry id="xdmxconfig-x7">
385 <term><command>xdmxconfig</command></term>
386 <listitem>
387 <para>
388 is a graphical configuration utility for the dmx server.
389 </para>
390 <indexterm zone="xorg-server xdmxconfig-x7">
391 <primary sortas="b-xdmxconfig">xdmxconfig</primary>
392 </indexterm>
393 </listitem>
394 </varlistentry>
395
396 <varlistentry id="modesetting_drv-x7">
397 <term><filename class="libraryfile">modesetting_drv.so</filename></term>
398 <listitem>
399 <para>
400 is a Xorg video driver for machines using Kernel Mode Setting (KMS).
401 It will use Glamor for 2D acceleration if it has been enabled and
402 the hardware has proper 3D support.
403 </para>
404 <indexterm zone="xorg-server modesetting_drv-x7">
405 <primary sortas="c-modesetting_drv">modesetting_drv.so</primary>
406 </indexterm>
407 </listitem>
408 </varlistentry>
409
410 </variablelist>
411
412 </sect2>
413
414</sect1>
Note: See TracBrowser for help on using the repository browser.