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

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since dabc4886 was dabc4886, checked in by Igor Živković <igor@…>, 6 years ago

Update to thunderbird-38.7.2.
Update to harfbuzz-1.2.5.
Update to xorg-server-1.18.3.

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

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