source: x/installing/xorg-server.xml@ 597ac4bd

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 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 597ac4bd was 597ac4bd, checked in by Douglas R. Reno <renodr@…>, 8 years ago

Update to libdrm-2.4.69
Restored Xorg-Server dependencies and systemd specific info to systemd
Added seds to subversion, libva, and libX11 to silence more libtool warnings
Typo fixes

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