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

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since ba717478 was ba717478, checked in by Bruce Dubbs <bdubbs@…>, 8 years ago

Revert lfs79 tags

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