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

11.3 12.0 12.1 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/llvm18 xry111/xf86-video-removal
Last change on this file since e5324803 was 3f2db3a6, checked in by Pierre Labastie <pierre.labastie@…>, 17 months ago

Remove sect1info tags

They only contain a date tag that is nowhere used.
  • Property mode set to 100644
File size: 13.6 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.xz">
8 <!ENTITY xorg-server-download-ftp "&xorg-download-ftp;/xserver/xorg-server-&xorg-server-version;.tar.xz">
9 <!ENTITY xorg-server-md5sum "1fee73752bc08a9d364d5e39f19f464f">
10 <!ENTITY xorg-server-size "4.7 MB">
11 <!ENTITY xorg-server-buildsize "186 MB (with tests)">
12 <!ENTITY xorg-server-time "0.5 SBU (using parallelism=4; with tests)">
13]>
14
15<sect1 id="xorg-server" xreflabel="Xorg-Server-&xorg-server-version;">
16 <?dbhtml filename="xorg-server.html"?>
17
18
19 <title>Xorg-Server-&xorg-server-version;</title>
20
21 <indexterm zone="xorg-server">
22 <primary sortas="a-xorg-server">xorg-server</primary>
23 </indexterm>
24
25 <sect2 role="package">
26 <title>Introduction to Xorg Server</title>
27
28 <para>
29 The <application>Xorg</application> Server is the core
30 of the X Window system.
31 </para>
32
33 &lfs112_checked;
34
35 <bridgehead renderas="sect3">Package Information</bridgehead>
36 <itemizedlist spacing="compact">
37 <listitem>
38 <para>
39 Download (HTTP): <ulink url="&xorg-server-download-http;"/>
40 </para>
41 </listitem>
42 <listitem>
43 <para>
44 Download (FTP): <ulink url="&xorg-server-download-ftp;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download MD5 sum: &xorg-server-md5sum;
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download size: &xorg-server-size;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Estimated disk space required: &xorg-server-buildsize;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated build time: &xorg-server-time;
65 </para>
66 </listitem>
67 </itemizedlist>
68
69<!-- Prime support is now automatically added in DRI3, and this patch
70 may break things on some setups.
71 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
72 <itemizedlist spacing="compact">
73 <listitem>
74 <para>
75 Optional patch:
76 <ulink url="&patch-root;/xorg-server-&xorg-server-version;-add_prime_support-1.patch"/>
77 </para>
78 </listitem>
79 </itemizedlist>-->
80
81 <bridgehead renderas="sect3">Xorg Server Dependencies</bridgehead>
82
83 <bridgehead renderas="sect4">Required</bridgehead>
84 <para role="required">
85 <xref linkend="libxcvt"/>,
86 <xref linkend="pixman"/>,
87 <xref linkend="xorg7-font"/> (only font-util), and at runtime:
88 <xref role="runtime" linkend="xkeyboard-config"/>
89 </para>
90
91 <bridgehead renderas="sect4">Recommended</bridgehead>
92 <para role="recommended">
93 <phrase revision="sysv"><xref linkend="elogind"/>,</phrase>
94 <xref linkend="libepoxy"/> (needed for glamor),
95 <xref linkend="libtirpc"/>, and
96 <phrase revision="sysv"><xref role="runtime"
97 linkend="polkit"/> (runtime)</phrase>
98 <phrase revision="systemd"><xref linkend="systemd"/></phrase>
99 </para>
100
101 <bridgehead renderas="sect4">Optional</bridgehead>
102 <para role="optional">
103 <xref role="runtime" linkend="acpid"/> (runtime),
104 <xref linkend="doxygen"/> (to build API documentation),
105 <xref linkend="fop"/> (to build documentation),
106 <xref linkend="libunwind"/>,
107 <xref linkend="nettle"/>,
108 <xref linkend="libgcrypt"/>,
109 <xref linkend="xcb-util-keysyms"/>,
110 <xref linkend="xcb-util-image"/>,
111 <xref linkend="xcb-util-renderutil"/>,
112 <xref linkend="xcb-util-wm"/> (all four to build Xephyr),
113 <xref linkend="xmlto"/> (to build documentation),
114 <xref linkend="xkeyboard-config"/> (for tests),
115 <ulink url="https://gitlab.freedesktop.org/xorg/test/rendercheck">rendercheck</ulink> (for tests), and
116 <ulink url="https://www.x.org/archive/individual/doc/">xorg-sgml-doctools</ulink> (to build documentation)
117 </para>
118
119 <para condition="html" role="usernotes">User Notes:
120 <ulink url='&blfs-wiki;/Xorg7Server'/>
121 </para>
122 </sect2>
123
124 <sect2 role="installation">
125 <title>Installation of Xorg Server</title>
126<!-- Patch removed
127 <para>
128 If you have downloaded the optional patch, apply it by running the
129 following command:
130 </para>
131
132<screen><userinput>patch -Np1 -i ../xorg-server-&xorg-server-version;-add_prime_support-1.patch</userinput></screen>-->
133
134<!-- Not needed with 21.1.4
135 <para>
136 Fix an issue with gcc-12 and later:
137 </para>
138
139<screen><userinput>sed -i '/(SourcePictPtr)/s/sizeof([^)]*)/sizeof(SourcePict)/' render/picture.c</userinput></screen>
140-->
141
142 <para>
143 Install the server by running the following commands:
144 </para>
145
146<screen><userinput>mkdir build &amp;&amp;
147cd build &amp;&amp;
148
149meson --prefix=$XORG_PREFIX \
150 --localstatedir=/var \
151 -Dsuid_wrapper=true \
152 -Dxkb_output_dir=/var/lib/xkb &amp;&amp;
153ninja</userinput></screen>
154
155 <para>
156 To test the results, issue: <command>ninja test</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>ninja 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>ninja 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<!-- built by default now
181 <para>
182 <parameter>- -enable-glamor</parameter>: Build the Glamor DIX (Device
183 Independent X) module which is currently used by: R600 or later radeon
184 video chipsets, the modesetting driver (which is part of this package)
185 for hardware using KMS which offers acceleration, and (optionally) the
186 intel driver.
187 </para>
188-->
189 <para>
190 <parameter>-Dsuid_wrapper=true</parameter>: Builds the suid-root
191 wrapper for legacy driver support on rootless xserver systems.
192 </para>
193
194 <para>
195 <option>-Dsystemd_logind=false</option>:
196 This switch disables <phrase revision="systemd">systemd-logind</phrase>
197 <phrase revision="sysv">elogind</phrase> integration, allowing Xorg Server
198 to work without having the <phrase revision="systemd">systemd</phrase>
199 <phrase revision="elogind">elogind</phrase> PAM module configured.
200 </para>
201<!-- seems to be completely removed with meson build:
202 <para>
203 <option>- -enable-install-setuid</option>:
204 This switch restores the setuid bit to the Xorg executable allowing Xorg
205 Server to work with a virtual terminal designated on the
206 <command>startx</command> command line.
207 </para>
208-->
209 <para revision="sysv">
210 <command>cat &gt;&gt; /etc/sysconfig/createfiles...</command>: This
211 command creates the <filename class="directory">/tmp/.ICE-unix</filename>
212 and <filename class="directory">/tmp/.X11-unix</filename> directories at
213 startup, and ensures that the permissions and ownership are correct as
214 required by the server.
215 </para>
216
217 <para>
218 <option>-Dxephyr=true</option>: This option allows building Xephyr if its
219 dependencies are met.
220 </para>
221
222 </sect2>
223
224 <sect2 role="content">
225 <title>Contents</title>
226
227 <segmentedlist>
228 <segtitle>Installed Programs</segtitle>
229 <segtitle>Installed Libraries</segtitle>
230 <segtitle>Installed Directories</segtitle>
231
232 <seglistitem>
233 <seg>
234 gtf, X, Xnest, Xorg, Xvfb, and optionally Xephyr
235 </seg>
236 <seg>
237 several under $XORG_PREFIX/lib/xorg/modules/ including the
238 <filename class="libraryfile">modesetting_drv.so</filename>
239 driver
240 </seg>
241 <seg>
242 /etc/X11/xorg.conf.d,
243 $XORG_PREFIX/include/xorg,
244 $XORG_PREFIX/lib/xorg, and
245 $XORG_PREFIX/share/X11/xorg.conf.d
246 </seg>
247
248 </seglistitem>
249 </segmentedlist>
250
251 <variablelist>
252 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
253 <?dbfo list-presentation="list"?>
254 <?dbhtml list-presentation="table"?>
255<!-- Now in libxcvt:
256 <varlistentry id="cvt-x7">
257 <term><command>cvt</command></term>
258 <listitem>
259 <para>
260 calculates VESA CVT mode lines
261 </para>
262 <indexterm zone="xorg-server cvt-x7">
263 <primary sortas="b-cvt">cvt</primary>
264 </indexterm>
265 </listitem>
266 </varlistentry>
267Removed in this release:
268 <varlistentry id="dmx-x7">
269 <term><command>dmx*</command></term>
270 <listitem>
271 <para>
272 are various tools used for manipulating the dmx server
273 </para>
274 <indexterm zone="xorg-server dmx-x7">
275 <primary sortas="b-dmx">dmx*</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279-->
280 <varlistentry id="gtf-x7">
281 <term><command>gtf</command></term>
282 <listitem>
283 <para>
284 calculates VESA GTF mode lines
285 </para>
286 <indexterm zone="xorg-server gtf-x7">
287 <primary sortas="b-gtf">gtf</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291<!-- No dmx in this release
292 <varlistentry id="vdltodmx-x7">
293 <term><command>vdltodmx</command></term>
294 <listitem>
295 <para>
296 is a tool used to convert VDL config files to DMX config
297 files
298 </para>
299 <indexterm zone="xorg-server vdltodmx-x7">
300 <primary sortas="b-vdltodmx">vdltodmx</primary>
301 </indexterm>
302 </listitem>
303 </varlistentry>
304-->
305 <varlistentry id="X-x7">
306 <term><command>X</command></term>
307 <listitem>
308 <para>
309 is a symbolic link to Xorg
310 </para>
311 <indexterm zone="xorg-server X-x7">
312 <primary sortas="b-X">X</primary>
313 </indexterm>
314 </listitem>
315 </varlistentry>
316<!-- No dmx in this release
317 <varlistentry id="Xdmx">
318 <term><command>Xdmx</command></term>
319 <listitem>
320 <para>
321 is a proxy X server that uses one or more other X servers as
322 its display devices
323 </para>
324 <indexterm zone="xorg-server Xdmx">
325 <primary sortas="b-Xdmx">Xdmx</primary>
326 </indexterm>
327 </listitem>
328 </varlistentry>
329-->
330 <varlistentry id="Xephyr-x7">
331 <term><command>Xephyr</command></term>
332 <listitem>
333 <para>
334 is a nested X server which supports modern X extensions
335 </para>
336 <indexterm zone="xorg-server Xephyr-x7">
337 <primary sortas="b-Xephyr">Xephyr</primary>
338 </indexterm>
339 </listitem>
340 </varlistentry>
341
342 <varlistentry id="Xnest-x7">
343 <term><command>Xnest</command></term>
344 <listitem>
345 <para>
346 is a nested X server
347 </para>
348 <indexterm zone="xorg-server Xnest-x7">
349 <primary sortas="b-Xnest">Xnest</primary>
350 </indexterm>
351 </listitem>
352 </varlistentry>
353
354 <varlistentry id="Xorg-x7">
355 <term><command>Xorg</command></term>
356 <listitem>
357 <para>
358 is the X11R7 X Server
359 </para>
360 <indexterm zone="xorg-server Xorg-x7">
361 <primary sortas="b-Xorg">Xorg</primary>
362 </indexterm>
363 </listitem>
364 </varlistentry>
365
366 <varlistentry id="Xvfb-x7">
367 <term><command>Xvfb</command></term>
368 <listitem>
369 <para>
370 is the virtual framebuffer X server for X Version 11
371 </para>
372 <indexterm zone="xorg-server Xvfb-x7">
373 <primary sortas="b-Xvfb">Xvfb</primary>
374 </indexterm>
375 </listitem>
376 </varlistentry>
377<!-- No dmx in this release
378 <varlistentry id="xdmxconfig-x7">
379 <term><command>xdmxconfig</command></term>
380 <listitem>
381 <para>
382 is a graphical configuration utility for the dmx server
383 </para>
384 <indexterm zone="xorg-server xdmxconfig-x7">
385 <primary sortas="b-xdmxconfig">xdmxconfig</primary>
386 </indexterm>
387 </listitem>
388 </varlistentry>
389Xwayland has been separated to xwayland package
390 <varlistentry id="Xwayland-x7">
391 <term><command>Xwayland</command></term>
392 <listitem>
393 <para>
394 allows the X server to run X clients under wayland (i.e. wayland
395 provides the input devices and handles the presentation of the
396 windows)
397 </para>
398 <indexterm zone="xorg-server Xwayland-x7">
399 <primary sortas="b-Xwayland">Xwayland</primary>
400 </indexterm>
401 </listitem>
402 </varlistentry>
403-->
404 <varlistentry id="modesetting_drv-x7">
405 <term><filename class="libraryfile">modesetting_drv.so</filename></term>
406 <listitem>
407 <para>
408 provides a video driver for machines using Kernel Mode Setting (KMS).
409 This will use glamor if that has been enabled and the hardware offers
410 acceleration
411 </para>
412 <indexterm zone="xorg-server modesetting_drv-x7">
413 <primary sortas="c-modesetting_drv">modesetting_drv.so</primary>
414 </indexterm>
415 </listitem>
416 </varlistentry>
417
418 </variablelist>
419
420 </sect2>
421
422</sect1>
Note: See TracBrowser for help on using the repository browser.