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

12.0 12.1 12.2 gimp3 ken/TL2024 ken/tuningfonts lazarus plabs/newcss python3.11 rahul/power-profiles-daemon renodr/vulkan-addition trunk xry111/for-12.3 xry111/llvm18 xry111/spidermonkey128 xry111/xf86-video-removal
Last change on this file since c97d35e was c97d35e, checked in by Xi Ruoyao <xry111@…>, 15 months ago

xorg-server: Force -Dglamor=true

With the DDX drivers gone, we must use Glamor to provide the modeset
driver or X server won't start.
  • Property mode set to 100644
File size: 9.8 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 "79a6eb04b1b17ad6c7aab46da73944e8">
10 <!ENTITY xorg-server-size "4.8 MB">
11 <!ENTITY xorg-server-buildsize "188 MB (with tests)">
12 <!ENTITY xorg-server-time "0.6 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 &lfs113_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 <bridgehead renderas="sect3">Xorg Server Dependencies</bridgehead>
70
71 <bridgehead renderas="sect4">Required</bridgehead>
72 <para role="required">
73 <xref linkend="libxcvt"/>,
74 <xref linkend="pixman"/>,
75 <xref linkend="xorg7-font"/> (only font-util), and at runtime:
76 <xref role="runtime" linkend="xkeyboard-config"/>
77 </para>
78
79 <bridgehead renderas="sect4">Recommended</bridgehead>
80 <para role="recommended">
81 <phrase revision="sysv"><xref role="runtime"
82 linkend="elogind"/> (runtime),</phrase>
83 <xref linkend="libepoxy"/> (needed for glamor),
84 <xref linkend="libtirpc"/>,
85 <phrase revision="systemd"><xref role="runtime"
86 linkend="systemd"/> (runtime),</phrase>
87 and <xref role='runtime' linkend='xorg-libinput-driver'/> (runtime)
88 </para>
89
90 <bridgehead renderas="sect4">Optional</bridgehead>
91 <para role="optional">
92 <xref role="runtime" linkend="acpid"/> (runtime),
93 <xref linkend="doxygen"/> (to build API documentation),
94 <xref linkend="fop"/> (to build documentation),
95 <xref linkend="libunwind"/>,
96 <xref linkend="nettle"/>,
97 <xref linkend="libgcrypt"/>,
98 <xref linkend="xcb-util-keysyms"/>,
99 <xref linkend="xcb-util-image"/>,
100 <xref linkend="xcb-util-renderutil"/>,
101 <xref linkend="xcb-util-wm"/> (all four to build Xephyr),
102 <xref linkend="xmlto"/> (to build documentation),
103 <xref linkend="xkeyboard-config"/> (for tests),
104 <ulink url="https://gitlab.freedesktop.org/xorg/test/rendercheck">rendercheck</ulink> (for tests), and
105 <ulink url="https://www.x.org/archive/individual/doc/">xorg-sgml-doctools</ulink> (to build documentation)
106 </para>
107
108 </sect2>
109
110 <sect2 role="installation">
111 <title>Installation of Xorg Server</title>
112
113 <para>
114 Install the server by running the following commands:
115 </para>
116
117<screen><userinput>mkdir build &amp;&amp;
118cd build &amp;&amp;
119
120meson setup .. \
121 --prefix=$XORG_PREFIX \
122 --localstatedir=/var \
123 -Dglamor=true \
124 -Dxkb_output_dir=/var/lib/xkb &amp;&amp;
125ninja</userinput></screen>
126
127 <para>
128 To test the results, issue: <command>ninja test</command>. You
129 will need to run <command>ldconfig</command> as the <systemitem
130 class="username">root</systemitem> user first or some tests may fail.
131 </para>
132
133 <para>
134 Now as the <systemitem class="username">root</systemitem>
135 user:
136 </para>
137
138<screen role="root" revision="sysv"><userinput>ninja install &amp;&amp;
139mkdir -pv /etc/X11/xorg.conf.d &amp;&amp;
140install -v -d -m1777 /tmp/.{ICE,X11}-unix &amp;&amp;
141cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"
142<literal>/tmp/.ICE-unix dir 1777 root root
143/tmp/.X11-unix dir 1777 root root</literal>
144EOF</userinput></screen>
145
146<screen role="root" revision="systemd"><userinput>ninja install &amp;&amp;
147mkdir -pv /etc/X11/xorg.conf.d</userinput></screen>
148
149 </sect2>
150
151 <sect2 role="commands">
152 <title>Command Explanations</title>
153
154 <para>
155 <parameter>-Dglamor=true</parameter>: Ensure building the Glamor
156 module. It's needed to run the Xorg server without Device Dependant X
157 (DDX) drivers.
158 </para>
159
160 <para>
161 <option>-Dsuid_wrapper=true</option>: Builds the suid-root
162 wrapper for legacy DDX driver support on rootless xserver systems.
163 </para>
164
165 <para>
166 <option>-Dsystemd_logind=false</option>:
167 This switch disables <phrase revision="systemd">systemd-logind</phrase>
168 <phrase revision="sysv">elogind</phrase> integration, allowing Xorg Server
169 to work without having the <phrase revision="systemd">systemd</phrase>
170 <phrase revision="elogind">elogind</phrase> PAM module configured.
171 </para>
172
173 <para revision="sysv">
174 <command>cat &gt;&gt; /etc/sysconfig/createfiles...</command>: This
175 command creates the <filename class="directory">/tmp/.ICE-unix</filename>
176 and <filename class="directory">/tmp/.X11-unix</filename> directories at
177 startup, and ensures that the permissions and ownership are correct as
178 required by the server.
179 </para>
180
181 <para>
182 <option>-Dxephyr=true</option>: This option allows building Xephyr if its
183 dependencies are met.
184 </para>
185
186 </sect2>
187
188 <sect2 role="content">
189 <title>Contents</title>
190
191 <segmentedlist>
192 <segtitle>Installed Programs</segtitle>
193 <segtitle>Installed Libraries</segtitle>
194 <segtitle>Installed Directories</segtitle>
195
196 <seglistitem>
197 <seg>
198 gtf, X, Xnest, Xorg, Xvfb, and optionally Xephyr
199 </seg>
200 <seg>
201 several under $XORG_PREFIX/lib/xorg/modules/ including the
202 <filename class="libraryfile">modesetting_drv.so</filename>
203 driver
204 </seg>
205 <seg>
206 /etc/X11/xorg.conf.d,
207 $XORG_PREFIX/include/xorg,
208 $XORG_PREFIX/lib/xorg, and
209 $XORG_PREFIX/share/X11/xorg.conf.d
210 </seg>
211
212 </seglistitem>
213 </segmentedlist>
214
215 <variablelist>
216 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
217 <?dbfo list-presentation="list"?>
218 <?dbhtml list-presentation="table"?>
219
220 <varlistentry id="gtf-x7">
221 <term><command>gtf</command></term>
222 <listitem>
223 <para>
224 calculates VESA GTF mode lines
225 </para>
226 <indexterm zone="xorg-server gtf-x7">
227 <primary sortas="b-gtf">gtf</primary>
228 </indexterm>
229 </listitem>
230 </varlistentry>
231
232 <varlistentry id="X-x7">
233 <term><command>X</command></term>
234 <listitem>
235 <para>
236 is a symbolic link to Xorg
237 </para>
238 <indexterm zone="xorg-server X-x7">
239 <primary sortas="b-X">X</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 <varlistentry id="Xephyr-x7">
245 <term><command>Xephyr</command></term>
246 <listitem>
247 <para>
248 is a nested X server which supports modern X extensions
249 </para>
250 <indexterm zone="xorg-server Xephyr-x7">
251 <primary sortas="b-Xephyr">Xephyr</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255
256 <varlistentry id="Xnest-x7">
257 <term><command>Xnest</command></term>
258 <listitem>
259 <para>
260 is a nested X server
261 </para>
262 <indexterm zone="xorg-server Xnest-x7">
263 <primary sortas="b-Xnest">Xnest</primary>
264 </indexterm>
265 </listitem>
266 </varlistentry>
267
268 <varlistentry id="Xorg-x7">
269 <term><command>Xorg</command></term>
270 <listitem>
271 <para>
272 is the X11R7 X Server
273 </para>
274 <indexterm zone="xorg-server Xorg-x7">
275 <primary sortas="b-Xorg">Xorg</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="Xvfb-x7">
281 <term><command>Xvfb</command></term>
282 <listitem>
283 <para>
284 is the virtual framebuffer X server for X Version 11
285 </para>
286 <indexterm zone="xorg-server Xvfb-x7">
287 <primary sortas="b-Xvfb">Xvfb</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 <varlistentry id="modesetting_drv-x7">
293 <term><filename class="libraryfile">modesetting_drv.so</filename></term>
294 <listitem>
295 <para>
296 provides a video driver for machines using Kernel Mode Setting (KMS).
297 This will use glamor if that has been enabled and the hardware offers
298 acceleration
299 </para>
300 <indexterm zone="xorg-server modesetting_drv-x7">
301 <primary sortas="c-modesetting_drv">modesetting_drv.so</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 </variablelist>
307
308 </sect2>
309
310</sect1>
Note: See TracBrowser for help on using the repository browser.