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

elogind
Last change on this file since c7765a68 was c7765a68, checked in by DJ Lucas <dj@…>, 6 years ago

Add elogind support to xorg-server.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/BOOK-elogind@20839 af4574ff-66df-0310-9fd7-8a98e5e911e0

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