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

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 e8fac12 was e8fac12, checked in by Bruce Dubbs <bdubbs@…>, 7 years ago

Update to xorg-server-1.19.0

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17982 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 13.4 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 "6a4d01e4e5047ab8f556960424ba1fa9">
10 <!ENTITY xorg-server-size "5.8 MB">
11 <!ENTITY xorg-server-buildsize "553 MB (with tests)">
12 <!ENTITY xorg-server-time "2.2 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 &lfs7a_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 </itemizedlist>
82
83 <bridgehead renderas="sect3">Xorg Server Dependencies</bridgehead>
84
85 <bridgehead renderas="sect4">Required</bridgehead>
86 <para role="required">
87 <xref linkend="openssl"/> or
88 <xref linkend="nettle"/> or
89 <xref linkend="libgcrypt"/>,
90 <xref linkend="pixman"/>, and at runtime:
91 <xref linkend="xorg7-font"/> and
92 <xref linkend="xkeyboard-config"/>
93 </para>
94
95 <bridgehead renderas="sect4">Recommended</bridgehead>
96 <para role="recommended" revision="sysv">
97 <xref linkend="libepoxy"/> (required for glamor, see command
98 explanations below)
99 </para>
100 <para role="recommended" revision="systemd">
101 <xref linkend="libepoxy"/> (needed for glamor and Xwayland),
102 <xref linkend="wayland"/> (needed for Xwayland), and
103 <xref linkend="systemd"/>
104 </para>
105
106 <bridgehead renderas="sect4">Optional</bridgehead>
107 <para role="optional">
108 <xref linkend="acpid"/> (runtime),
109 <xref linkend="doxygen"/> (to build API documentation),
110 <xref linkend="fop"/>, (to build documentation),
111 <xref linkend="gs"/> (to build documentation),
112 <xref linkend="xcb-util-keysyms"/>,
113 <xref linkend="xcb-util-image"/>,
114 <xref linkend="xcb-util-renderutil"/>,
115 <xref linkend="xcb-util-wm"/> (all three to build Xephyr),
116 <phrase revision="sysv">and</phrase>
117 <xref linkend="xmlto"/>
118 (to build documentation)<phrase revision="systemd">, and
119 <ulink url="http://download.savannah.gnu.org/releases/libunwind">libunwind</ulink></phrase>
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 Install the server by running the following commands:
139 </para>
140
141<screen revision="sysv"><userinput>./configure $XORG_CONFIG \
142 --enable-glamor \
143 --enable-install-setuid \
144 --enable-suid-wrapper \
145 --disable-systemd-logind \
146 --with-xkb-output=/var/lib/xkb &amp;&amp;
147make</userinput></screen>
148
149<screen revision="systemd"><userinput>./configure $XORG_CONFIG \
150 --enable-glamor \
151 --enable-suid-wrapper \
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>. You
157 will need to run <command>ldconfig</command> as the <systemitem
158 class="username">root</systemitem> user first or some tests may fail.
159 </para>
160
161 <para>
162 Now as the <systemitem class="username">root</systemitem>
163 user:
164 </para>
165
166<screen role="root" revision="sysv"><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<screen role="root" revision="systemd"><userinput>make install &amp;&amp;
174mkdir -pv /etc/X11/xorg.conf.d</userinput></screen>
175
176 </sect2>
177
178 <sect2 role="commands">
179 <title>Command Explanations</title>
180
181 <para>
182 <parameter>--enable-glamor</parameter>: Build the Glamor DIX (Device
183 Independent X) module which is currently required for Southern Islands and
184 Sea Islands radeon video chipsets, optional for some other radeons, and
185 also optional for the intel driver. It is also used by the modesetting
186 driver (which is part of this package) for hardware using KMS which
187 offers acceleration.
188 </para>
189
190 <para revision="sysv">
191 <parameter>--enable-install-setuid</parameter>: The Xorg binary must run
192 as the root user. This switch ensures that the binary is installed
193 setuid when <command>make</command> is run by an unprivileged user.
194 </para>
195
196 <para>
197 <parameter>--enable-suid-wrapper</parameter>: Build suid-root wrapper for
198 legacy driver support on rootless xserver systems.
199 </para>
200
201 <para revision="sysv">
202 <parameter>--disable-systemd-logind</parameter>: Do not build
203 systemd-logind support, otherwise, an error (EE), logged in
204 <filename>/var/log/Xorg.0.log</filename>, occurs when starting the X
205 server. Systemd is not supported by BLFS.
206 </para>
207
208 <para revision="systemd">
209 <option>--disable-systemd-logind --enable-install-setuid</option>:
210 These switches disable systemd-logind integration and restore the setuid
211 bit to the Xorg executable, allowing Xorg Server to work
212 without having the systemd PAM module installed and set up.
213 </para>
214
215 <para revision="sysv">
216 <command>cat &gt;&gt; /etc/sysconfig/createfiles...</command>: This
217 command creates the <filename class="directory">/tmp/.ICE-unix</filename>
218 and <filename class="directory">/tmp/.X11-unix</filename> directories at
219 startup, and ensures that the permissions and ownership are correct as
220 required by the server.
221 </para>
222
223 <para>
224 <option>--enable-dmx</option>: Build DMX (Distributed Multihead X)
225 server.
226 </para>
227
228 <para>
229 <option>--enable-kdrive</option>: this option allows the
230 <command>configure</command> script to enable Xephyr if its dependencies
231 are met.
232 </para>
233
234 </sect2>
235
236 <sect2 role="content">
237 <title>Contents</title>
238
239 <segmentedlist>
240 <segtitle>Installed Programs</segtitle>
241 <segtitle>Installed Libraries</segtitle>
242 <segtitle>Installed Directories</segtitle>
243
244 <seglistitem>
245 <seg>
246 cvt, gtf, X, Xnest, Xorg, and Xvfb; optional: dmxaddinput,
247 dmxaddscreen, dmxinfo, dmxreconfig, dmxresize, dmxrminput,
248 dmxrmscreen, dmxtodmx, dmxwininfo, vdltodmx, Xdmx, xdmxconfig, Xephyr,
249 and Xfbdev
250 </seg>
251 <seg>
252 several under $XORG_PREFIX/lib/xorg/modules/{,drivers,extensions}
253 including modesetting_drv.so
254 </seg>
255 <seg>
256 $XORG_PREFIX/{include/xorg,lib/xorg,share/X11/xorg.conf.d} and
257 /var/lib/xkb
258 </seg>
259 </seglistitem>
260 </segmentedlist>
261
262 <variablelist>
263 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
264 <?dbfo list-presentation="list"?>
265 <?dbhtml list-presentation="table"?>
266
267 <varlistentry id="cvt-x7">
268 <term><command>cvt</command></term>
269 <listitem>
270 <para>
271 calculates VESA CVT mode lines.
272 </para>
273 <indexterm zone="xorg-server cvt-x7">
274 <primary sortas="b-cvt">cvt</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="dmx-x7">
280 <term><command>dmx*</command></term>
281 <listitem>
282 <para>
283 are various tools used for manipulating the dmx server.
284 </para>
285 <indexterm zone="xorg-server dmx-x7">
286 <primary sortas="b-dmx">dmx*</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="gtf-x7">
292 <term><command>gtf</command></term>
293 <listitem>
294 <para>
295 calculates VESA GTF mode lines.
296 </para>
297 <indexterm zone="xorg-server gtf-x7">
298 <primary sortas="b-gtf">gtf</primary>
299 </indexterm>
300 </listitem>
301 </varlistentry>
302
303 <varlistentry id="vdltodmx-x7">
304 <term><command>vdltodmx</command></term>
305 <listitem>
306 <para>
307 is a tool used to convert VDL config files to DMX config
308 files.
309 </para>
310 <indexterm zone="xorg-server vdltodmx-x7">
311 <primary sortas="b-vdltodmx">vdltodmx</primary>
312 </indexterm>
313 </listitem>
314 </varlistentry>
315
316 <varlistentry id="X-x7">
317 <term><command>X</command></term>
318 <listitem>
319 <para>
320 is a symbolic link to Xorg.
321 </para>
322 <indexterm zone="xorg-server X-x7">
323 <primary sortas="b-X">X</primary>
324 </indexterm>
325 </listitem>
326 </varlistentry>
327
328 <varlistentry id="Xdmx">
329 <term><command>Xdmx</command></term>
330 <listitem>
331 <para>
332 is a proxy X server that uses one or more other X servers as
333 its display devices.
334 </para>
335 <indexterm zone="xorg-server Xdmx">
336 <primary sortas="b-Xdmx">Xdmx</primary>
337 </indexterm>
338 </listitem>
339 </varlistentry>
340
341 <varlistentry id="Xephyr-x7">
342 <term><command>Xephyr</command></term>
343 <listitem>
344 <para>
345 is a nested X server which supports modern X extensions.
346 </para>
347 <indexterm zone="xorg-server Xephyr-x7">
348 <primary sortas="b-Xephyr">Xephyr</primary>
349 </indexterm>
350 </listitem>
351 </varlistentry>
352
353 <varlistentry id="Xnest-x7">
354 <term><command>Xnest</command></term>
355 <listitem>
356 <para>
357 is a nested X server.
358 </para>
359 <indexterm zone="xorg-server Xnest-x7">
360 <primary sortas="b-Xnest">Xnest</primary>
361 </indexterm>
362 </listitem>
363 </varlistentry>
364
365 <varlistentry id="Xorg-x7">
366 <term><command>Xorg</command></term>
367 <listitem>
368 <para>
369 is the X11R7 X Server.
370 </para>
371 <indexterm zone="xorg-server Xorg-x7">
372 <primary sortas="b-Xorg">Xorg</primary>
373 </indexterm>
374 </listitem>
375 </varlistentry>
376
377 <varlistentry id="Xvfb-x7">
378 <term><command>Xvfb</command></term>
379 <listitem>
380 <para>
381 is the virtual framebuffer X server for X Version 11.
382 </para>
383 <indexterm zone="xorg-server Xvfb-x7">
384 <primary sortas="b-Xvfb">Xvfb</primary>
385 </indexterm>
386 </listitem>
387 </varlistentry>
388
389 <varlistentry id="xdmxconfig-x7">
390 <term><command>xdmxconfig</command></term>
391 <listitem>
392 <para>
393 is a graphical configuration utility for the dmx server.
394 </para>
395 <indexterm zone="xorg-server xdmxconfig-x7">
396 <primary sortas="b-xdmxconfig">xdmxconfig</primary>
397 </indexterm>
398 </listitem>
399 </varlistentry>
400
401 <varlistentry id="modesetting_drv-x7">
402 <term><filename class="libraryfile">modesetting_drv.so</filename></term>
403 <listitem>
404 <para>
405 provides a video driver for machines using Kernel Mode Setting (KMS).
406 This will use glamor if that has been enabled and the hardware offers
407 acceleration.
408 </para>
409 <indexterm zone="xorg-server modesetting_drv-x7">
410 <primary sortas="c-modesetting_drv">modesetting_drv.so</primary>
411 </indexterm>
412 </listitem>
413 </varlistentry>
414
415 </variablelist>
416
417 </sect2>
418
419</sect1>
Note: See TracBrowser for help on using the repository browser.