source: x/installing/xorg-server.xml@ 2b2de3bd

10.0 10.1 11.0 11.1 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 2b2de3bd was 2b2de3bd, checked in by Bruce Dubbs <bdubbs@…>, 5 years ago

Update to xorg-server 1.19.3

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

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