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

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.7 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 c60a17aa was a2c6cd2, checked in by Pierre Labastie <pieere@…>, 9 years ago

add two seds in xorg-server instructions:

  • allows the modesetting driver to start on i686
  • prevents the mouse pointer to disappear on 32 and 64 bit machine, with

the modesetting driver

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