source: x/installing/xorg-server.xml@ 4ca7bec

11.2 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/soup3 xry111/xf86-video-removal
Last change on this file since 4ca7bec was aa0b625, checked in by Douglas R. Reno <renodr@…>, 21 months ago

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