source: x/installing/xorg-server.xml@ 8ddea36

10.0 10.1 11.0 11.1 7.10 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 8ddea36 was 8ddea36, checked in by Fernando de Oliveira <fernando@…>, 7 years ago

Fix Xorg-Server-1.17.1: do not build systemd-logind support.

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

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