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

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.8 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 2717491 was 2717491, checked in by Ken Moffat <ken@…>, 9 years ago

mdadm, qt4, xorg-server: add gcc-5 fixes to the book.

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