source: x/installing/xorg-server.xml@ 33568fea

systemd-13485
Last change on this file since 33568fea was 33568fea, checked in by Douglas R. Reno <renodr@…>, 8 years ago

Some typo fixes
Finish tagging Xorg

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