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

11.1 lazarus qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since c53fe5a7 was c53fe5a7, checked in by Douglas R. Reno <renodr@…>, 6 months ago

Package updates and some tweaks

Update to vala-0.54.3
Update to librsvg-2.52.4
Update to libgusb-0.3.8
libxvct: minor spacing tweaks
xorg-server: minor formatting/spacing tweaks

  • Property mode set to 100644
File size: 13.4 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 "6d8e557a6dbd5a9923c3564b64af7d94">
10 <!ENTITY xorg-server-size "4.7 MB">
11 <!ENTITY xorg-server-buildsize "217 MB (with tests)">
12 <!ENTITY xorg-server-time "0.4 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 &lfs110a_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), and
98 <phrase revision="sysv"><xref role="runtime"
99 linkend="polkit"/> (runtime)</phrase>
100 <phrase revision="systemd"><xref linkend="systemd"/></phrase>
101 </para>
102
103 <bridgehead renderas="sect4">Optional</bridgehead>
104 <para role="optional">
105 <xref role="runtime" linkend="acpid"/> (runtime),
106 <xref linkend="doxygen"/> (to build API documentation),
107 <xref linkend="fop"/> (to build documentation),
108 <xref linkend="nettle"/>,
109 <xref linkend="libgcrypt"/>,
110 <xref linkend="xcb-util-keysyms"/>,
111 <xref linkend="xcb-util-image"/>,
112 <xref linkend="xcb-util-renderutil"/>,
113 <xref linkend="xcb-util-wm"/> (all four to build Xephyr),
114 <xref linkend="xmlto"/> (to build documentation),
115 <ulink url="http://download.savannah.gnu.org/releases/libunwind">libunwind</ulink>,
116 <ulink url="https://gitlab.freedesktop.org/xorg/test/rendercheck">rendercheck</ulink> (for tests), and
117 <ulink url="https://www.x.org/archive/individual/doc/">xorg-sgml-doctools</ulink> (to build documentation)
118 </para>
119
120 <para condition="html" role="usernotes">User Notes:
121 <ulink url='&blfs-wiki;/Xorg7Server'/>
122 </para>
123 </sect2>
124
125 <sect2 role="installation">
126 <title>Installation of Xorg Server</title>
127<!-- Patch removed
128 <para>
129 If you have downloaded the optional patch, apply it by running the
130 following command:
131 </para>
132
133<screen><userinput>patch -Np1 -i ../xorg-server-&xorg-server-version;-add_prime_support-1.patch</userinput></screen>-->
134
135 <para>
136 Install the server by running the following commands:
137 </para>
138
139<screen><userinput>mkdir build &amp;&amp;
140cd build &amp;&amp;
141
142meson --prefix=$XORG_PREFIX \
143 -Dsuid_wrapper=true \
144 -Dxkb_output_dir=/var/lib/xkb &amp;&amp;
145ninja</userinput></screen>
146
147 <para>
148 To test the results, issue: <command>ninja test</command>. You
149 will need to run <command>ldconfig</command> as the <systemitem
150 class="username">root</systemitem> user first or some tests may fail.
151 </para>
152
153 <para>
154 Now as the <systemitem class="username">root</systemitem>
155 user:
156 </para>
157
158<screen role="root" revision="sysv"><userinput>ninja install &amp;&amp;
159mkdir -pv /etc/X11/xorg.conf.d &amp;&amp;
160cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"
161<literal>/tmp/.ICE-unix dir 1777 root root
162/tmp/.X11-unix dir 1777 root root</literal>
163EOF</userinput></screen>
164
165<screen role="root" revision="systemd"><userinput>ninja install &amp;&amp;
166mkdir -pv /etc/X11/xorg.conf.d</userinput></screen>
167
168 </sect2>
169
170 <sect2 role="commands">
171 <title>Command Explanations</title>
172<!-- built by default now
173 <para>
174 <parameter>- -enable-glamor</parameter>: Build the Glamor DIX (Device
175 Independent X) module which is currently used by: R600 or later radeon
176 video chipsets, the modesetting driver (which is part of this package)
177 for hardware using KMS which offers acceleration, and (optionally) the
178 intel driver.
179 </para>
180-->
181 <para>
182 <parameter>-Dsuid_wrapper=true</parameter>: Builds the suid-root
183 wrapper for legacy driver support on rootless xserver systems.
184 </para>
185
186 <para>
187 <option>-Dsystemd_logind=false</option>:
188 This switch disables <phrase revision="systemd">systemd-logind</phrase>
189 <phrase revision="sysv">elogind</phrase> integration, allowing Xorg Server
190 to work without having the <phrase revision="systemd">systemd</phrase>
191 <phrase revision="elogind">elogind</phrase> PAM module configured.
192 </para>
193<!-- seems to be completely removed with meson build:
194 <para>
195 <option>- -enable-install-setuid</option>:
196 This switch restores the setuid bit to the Xorg executable allowing Xorg
197 Server to work with a virtual terminal designated on the
198 <command>startx</command> command line.
199 </para>
200-->
201 <para revision="sysv">
202 <command>cat &gt;&gt; /etc/sysconfig/createfiles...</command>: This
203 command creates the <filename class="directory">/tmp/.ICE-unix</filename>
204 and <filename class="directory">/tmp/.X11-unix</filename> directories at
205 startup, and ensures that the permissions and ownership are correct as
206 required by the server.
207 </para>
208
209 <para>
210 <option>-Dxephyr=true</option>: This option allows building Xephyr if its
211 dependencies are met.
212 </para>
213
214 </sect2>
215
216 <sect2 role="content">
217 <title>Contents</title>
218
219 <segmentedlist>
220 <segtitle>Installed Programs</segtitle>
221 <segtitle>Installed Libraries</segtitle>
222 <segtitle>Installed Directories</segtitle>
223
224 <seglistitem>
225 <seg>
226 gtf, X, Xnest, Xorg, Xvfb, and optionally Xephyr
227 </seg>
228 <seg>
229 several under $XORG_PREFIX/lib/xorg/modules/ including the
230 <filename class="libraryfile">modesetting_drv.so</filename>
231 driver
232 </seg>
233 <seg>
234 /etc/X11/xorg.conf.d,
235 $XORG_PREFIX/include/xorg,
236 $XORG_PREFIX/lib/xorg, and
237 $XORG_PREFIX/share/X11/xorg.conf.d
238 </seg>
239
240 </seglistitem>
241 </segmentedlist>
242
243 <variablelist>
244 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
245 <?dbfo list-presentation="list"?>
246 <?dbhtml list-presentation="table"?>
247<!-- Now in libxcvt:
248 <varlistentry id="cvt-x7">
249 <term><command>cvt</command></term>
250 <listitem>
251 <para>
252 calculates VESA CVT mode lines
253 </para>
254 <indexterm zone="xorg-server cvt-x7">
255 <primary sortas="b-cvt">cvt</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259Removed in this release:
260 <varlistentry id="dmx-x7">
261 <term><command>dmx*</command></term>
262 <listitem>
263 <para>
264 are various tools used for manipulating the dmx server
265 </para>
266 <indexterm zone="xorg-server dmx-x7">
267 <primary sortas="b-dmx">dmx*</primary>
268 </indexterm>
269 </listitem>
270 </varlistentry>
271-->
272 <varlistentry id="gtf-x7">
273 <term><command>gtf</command></term>
274 <listitem>
275 <para>
276 calculates VESA GTF mode lines
277 </para>
278 <indexterm zone="xorg-server gtf-x7">
279 <primary sortas="b-gtf">gtf</primary>
280 </indexterm>
281 </listitem>
282 </varlistentry>
283<!-- No dmx in this release
284 <varlistentry id="vdltodmx-x7">
285 <term><command>vdltodmx</command></term>
286 <listitem>
287 <para>
288 is a tool used to convert VDL config files to DMX config
289 files
290 </para>
291 <indexterm zone="xorg-server vdltodmx-x7">
292 <primary sortas="b-vdltodmx">vdltodmx</primary>
293 </indexterm>
294 </listitem>
295 </varlistentry>
296-->
297 <varlistentry id="X-x7">
298 <term><command>X</command></term>
299 <listitem>
300 <para>
301 is a symbolic link to Xorg
302 </para>
303 <indexterm zone="xorg-server X-x7">
304 <primary sortas="b-X">X</primary>
305 </indexterm>
306 </listitem>
307 </varlistentry>
308<!-- No dmx in this release
309 <varlistentry id="Xdmx">
310 <term><command>Xdmx</command></term>
311 <listitem>
312 <para>
313 is a proxy X server that uses one or more other X servers as
314 its display devices
315 </para>
316 <indexterm zone="xorg-server Xdmx">
317 <primary sortas="b-Xdmx">Xdmx</primary>
318 </indexterm>
319 </listitem>
320 </varlistentry>
321-->
322 <varlistentry id="Xephyr-x7">
323 <term><command>Xephyr</command></term>
324 <listitem>
325 <para>
326 is a nested X server which supports modern X extensions
327 </para>
328 <indexterm zone="xorg-server Xephyr-x7">
329 <primary sortas="b-Xephyr">Xephyr</primary>
330 </indexterm>
331 </listitem>
332 </varlistentry>
333
334 <varlistentry id="Xnest-x7">
335 <term><command>Xnest</command></term>
336 <listitem>
337 <para>
338 is a nested X server
339 </para>
340 <indexterm zone="xorg-server Xnest-x7">
341 <primary sortas="b-Xnest">Xnest</primary>
342 </indexterm>
343 </listitem>
344 </varlistentry>
345
346 <varlistentry id="Xorg-x7">
347 <term><command>Xorg</command></term>
348 <listitem>
349 <para>
350 is the X11R7 X Server
351 </para>
352 <indexterm zone="xorg-server Xorg-x7">
353 <primary sortas="b-Xorg">Xorg</primary>
354 </indexterm>
355 </listitem>
356 </varlistentry>
357
358 <varlistentry id="Xvfb-x7">
359 <term><command>Xvfb</command></term>
360 <listitem>
361 <para>
362 is the virtual framebuffer X server for X Version 11
363 </para>
364 <indexterm zone="xorg-server Xvfb-x7">
365 <primary sortas="b-Xvfb">Xvfb</primary>
366 </indexterm>
367 </listitem>
368 </varlistentry>
369<!-- No dmx in this release
370 <varlistentry id="xdmxconfig-x7">
371 <term><command>xdmxconfig</command></term>
372 <listitem>
373 <para>
374 is a graphical configuration utility for the dmx server
375 </para>
376 <indexterm zone="xorg-server xdmxconfig-x7">
377 <primary sortas="b-xdmxconfig">xdmxconfig</primary>
378 </indexterm>
379 </listitem>
380 </varlistentry>
381Xwayland has been separated to xwayland package
382 <varlistentry id="Xwayland-x7">
383 <term><command>Xwayland</command></term>
384 <listitem>
385 <para>
386 allows the X server to run X clients under wayland (i.e. wayland
387 provides the input devices and handles the presentation of the
388 windows)
389 </para>
390 <indexterm zone="xorg-server Xwayland-x7">
391 <primary sortas="b-Xwayland">Xwayland</primary>
392 </indexterm>
393 </listitem>
394 </varlistentry>
395-->
396 <varlistentry id="modesetting_drv-x7">
397 <term><filename class="libraryfile">modesetting_drv.so</filename></term>
398 <listitem>
399 <para>
400 provides a video driver for machines using Kernel Mode Setting (KMS).
401 This will use glamor if that has been enabled and the hardware offers
402 acceleration
403 </para>
404 <indexterm zone="xorg-server modesetting_drv-x7">
405 <primary sortas="c-modesetting_drv">modesetting_drv.so</primary>
406 </indexterm>
407 </listitem>
408 </varlistentry>
409
410 </variablelist>
411
412 </sect2>
413
414</sect1>
Note: See TracBrowser for help on using the repository browser.