source: x/installing/x7server.xml@ 6732c094

10.0 10.1 11.0 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 6732c094 was 6732c094, checked in by Randy McMurchy <randy@…>, 15 years ago

Updated all the XML files (and the one stylesheet) to use the 4.5 version of DocBook XML DTD

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

  • Property mode set to 100644
File size: 18.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 "http://xorg.freedesktop.org/releases/individual/xserver/xorg-server-&xorg-server-version;.tar.bz2">
8 <!ENTITY xorg-server-download-ftp "ftp://ftp.x.org/pub/individual/xserver/xorg-server-&xorg-server-version;.tar.bz2">
9 <!ENTITY xorg-server-md5sum "a8ed678677af8ebb2fba5624602f6b2e">
10 <!ENTITY xorg-server-size "6.0 MB">
11 <!ENTITY xorg-server-buildsize "424 MB">
12 <!ENTITY xorg-server-time "5.6 SBU">
13
14]>
15
16<sect1 id="xorg7-server" xreflabel="Xorg-Server-&xorg-server-version;">
17 <?dbhtml filename="x7server.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Xorg-Server-&xorg-server-version;</title>
25
26 <indexterm zone="xorg7-server">
27 <primary sortas="a-xorg7-server">Xorg Server</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Xorg-Server</title>
32
33 <para>The <application>Xorg</application> Server is the core
34 of the X Window system.</para>
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>Download (HTTP): <ulink url="&xorg-server-download-http;"/></para>
40 </listitem>
41 <listitem>
42 <para>Download (FTP): <ulink url="&xorg-server-download-ftp;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download MD5 sum: &xorg-server-md5sum;</para>
46 </listitem>
47 <listitem>
48 <para>Download size: &xorg-server-size;</para>
49 </listitem>
50 <listitem>
51 <para>Estimated disk space required: &xorg-server-buildsize;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated build time: &xorg-server-time;</para>
55 </listitem>
56 </itemizedlist>
57
58 <!-- Following patch is security related and should be
59 fixed for Xorg-7.2 -->
60 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
61 <itemizedlist spacing="compact">
62 <listitem>
63 <para>Required patch: <ulink
64 url="&patch-root;/xorg-server-&xorg-server-version;-security-1.patch"/></para>
65 </listitem>
66 </itemizedlist>
67
68 <bridgehead renderas="sect3">Xorg Server Dependencies</bridgehead>
69
70 <bridgehead renderas="sect4">Required</bridgehead>
71 <para role="required"><xref linkend="xorg7-font"/></para>
72
73 <bridgehead renderas="sect4">Optional</bridgehead>
74 <para role="optional"><xref linkend="mesalib"/> and
75 <xref linkend="luit"/></para>
76
77 <para condition="html" role="usernotes">User Notes:
78 <ulink url='&blfs-wiki;/Xorg7Server'/></para>
79
80 </sect2>
81
82 <sect2 role="installation">
83 <title>Installation of Xorg Server</title>
84
85 <note>
86 <para>If you intend to build with <application>Mesa</application>,
87 you must have the <application>Mesa</application> source
88 directory available when building the
89 <application>Xorg-server</application>.</para>
90 </note>
91
92<!-- To be removed if/when proposed glibc patch is added to LFS SVN
93 Leave in in for a couple of weeks with 'you may need' and a testcase
94 around it to save the support list silly questions. Should remove in
95 a couple of weeks
96 <para>Recent <application>Glibc</application> may have a problem with its
97 installed <filename>sys/kd.h</filename> file. This has recently been
98 fixed in LFS SVN. Execute the following commands to work around a
99 broken <filename>kd.h</filename> file. The commands will only make the
100 modification if needed:</para>
101
102<screen><userinput>grep "__undef_LINUX" \
103 /usr/include/sys/kd.h 2&gt;&amp;1 &gt; /dev/null || \
104 sed -i.bak '/CONFIG_H/i #include &lt;linux/types.h&gt;' \
105 hw/xfree86/os-support/linux/lnx_agp.c</userinput></screen>
106 End remove -->
107
108 <para>A <ulink url='http://wiki.x.org/wiki/SecurityPage'>security
109 vulnerability</ulink> have been identified in the xorg-server
110 package. Apply a patch to fix this vulnerability with the following
111 command:</para>
112
113<screen><userinput>patch -Np1 -i ../xorg-server-&xorg-server-version;-security-1.patch</userinput></screen>
114
115 <para>Install the server by running the following commands:</para>
116
117<screen><userinput>sed -i \
118 's@-I$(top_builddir)/include@-I$(top_builddir)/GL/mesa/main@8' \
119 GL/glx/Makefile.in &amp;&amp;
120sed -i \
121 's@-I$(top_builddir)/include@-I$(top_builddir)/GL/mesa/glapi@7' \
122 GL/glx/Makefile.in &amp;&amp;
123./configure $XORG_CONFIG \
124 --with-mesa-source='<replaceable>&lt;/path/to&gt;</replaceable>/Mesa-&mesalib-version;' \
125 --with-fontdir=$XORG_PREFIX/lib/X11/fonts \
126 --with-module-dir=$XORG_PREFIX/lib/X11/modules \
127 --with-dri-driver-path=$XORG_PREFIX/lib/X11/modules/dri \
128 --enable-install-setuid &amp;&amp;
129make</userinput></screen>
130
131 <para>This package does not come with a test suite.</para>
132
133 <para>Now as the <systemitem class="username">root</systemitem>
134 user:</para>
135
136<screen role="root"><userinput>make install</userinput></screen>
137
138 </sect2>
139
140 <sect2 role="commands">
141 <title>Command Explanations</title>
142
143 <para><command>sed -i '...' GL/glx/Makefile.in</command>: These commands
144 correct the search path for the <application>Mesa</application> headers.
145 The 8th and 7th instance of '-I$(top_builddir)' in the existing search
146 search path are replaced with <application>Mesa</application> paths.</para>
147
148 <para><parameter>--with-mesa-source=...</parameter>: This switch directs
149 the build system to the location of the <application>Mesa</application>
150 source directory. If you wish to build without
151 <application>Mesa</application>, omit this switch.</para>
152
153 <para><parameter>--with-module-dir=...</parameter>: This parameter
154 sets the destination for the installed modules.</para>
155
156 <para><parameter>--with-dri-driver-path=...</parameter>: This is the
157 location of the <application>Mesa</application> DRI drivers.</para>
158
159 <para><parameter>--enable-install-setuid</parameter>: The Xorg binary must
160 run as the root user. This switch ensures that the binary is installed
161 setuid when <command>make</command> is run by an unprivileged user.</para>
162
163 <para><parameter>--disable-glx</parameter>: Disable building of the GLX
164 extension. This parameter is required if building without
165 <application>Mesa</application>.</para>
166
167 <para><parameter>--disable-dri</parameter>: Disable building of the DRI
168 extension. This parameter is required if building without
169 <application>Mesa</application>.</para>
170
171 <para><parameter>--disable-xprint</parameter>: Disable building of
172 the <application>Xprint</application> extension and server. This
173 parameter is required if building without
174 <application>Mesa</application>.</para>
175
176 </sect2>
177
178 <sect2 role="content">
179 <title>Contents</title>
180
181 <segmentedlist>
182 <segtitle>Installed Programs</segtitle>
183 <segtitle>Installed Libraries</segtitle>
184 <segtitle>Installed Directories</segtitle>
185
186 <seglistitem>
187 <seg>cvt, dmxaddinput, dmxaddscreen, dmxreconfig, dmxresize,
188 dmxrminput, dmxrmscreen, dmxtodmx, dmxwininfo, getconfig,
189 getconfig.pl, gtf, inb, inl, inw, ioport, outb, outl, outw,
190 pcitweak, scanpci, vdltodmx, X, Xdmx, xdmx, xdmxconfig, Xnest,
191 Xorg, xorgcfg, xorgconfig and Xvfb</seg>
192 <seg>None</seg>
193 <seg>/var/lib/xkb and the following subdirectories of
194 <envar>$XORG_PREFIX</envar>/: include/xorg, include/X11/pixmaps,
195 lib/X11/{getconfig,modules} and lib/xserver</seg>
196 </seglistitem>
197 </segmentedlist>
198
199 <variablelist>
200 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
201 <?dbfo list-presentation="list"?>
202 <?dbhtml list-presentation="table"?>
203
204 <varlistentry id="cvt-x7">
205 <term><command>cvt</command></term>
206 <listitem>
207 <para>calculates VESA CVT mode lines.</para>
208 <indexterm zone="xorg7-server cvt-x7">
209 <primary sortas="b-cvt">cvt</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 <varlistentry id="dmxaddinput-x7">
215 <term><command>dmxaddinput</command></term>
216 <listitem>
217 <para>adds an input device to an Xdmx server.</para>
218 <indexterm zone="xorg7-server dmxaddinput-x7">
219 <primary sortas="b-dmxaddinput">dmxaddinput</primary>
220 </indexterm>
221 </listitem>
222 </varlistentry>
223
224 <varlistentry id="dmxaddscreen-x7">
225 <term><command>dmxaddscreen</command></term>
226 <listitem>
227 <para>adds a screen to an Xdmx server.</para>
228 <indexterm zone="xorg7-server dmxaddscreen-x7">
229 <primary sortas="b-dmxaddscreen">dmxaddscreen</primary>
230 </indexterm>
231 </listitem>
232 </varlistentry>
233
234 <varlistentry id="dmxreconfig-x7">
235 <term><command>dmxreconfig</command></term>
236 <listitem>
237 <para>refreshes the screen attributes in an Xdmx server.</para>
238 <indexterm zone="xorg7-server dmxreconfig-x7">
239 <primary sortas="b-dmxreconfig">dmxreconfig</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 <varlistentry id="dmxresize-x7">
245 <term><command>dmxresize</command></term>
246 <listitem>
247 <para>resizes an Xdmx desktop.</para>
248 <indexterm zone="xorg7-server dmxresize-x7">
249 <primary sortas="b-dmxresize">dmxresize</primary>
250 </indexterm>
251 </listitem>
252 </varlistentry>
253
254 <varlistentry id="dmxrminput-x7">
255 <term><command>dmxrminput</command></term>
256 <listitem>
257 <para>removes an input device from an Xdmx server.</para>
258 <indexterm zone="xorg7-server dmxrminput-x7">
259 <primary sortas="b-dmxrminput">dmxrminput</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 <varlistentry id="dmxrmscreen-x7">
265 <term><command>dmxrmscreen</command></term>
266 <listitem>
267 <para>removes a screen from an Xdmx server.</para>
268 <indexterm zone="xorg7-server dmxrmscreen-x7">
269 <primary sortas="b-dmxrmscreen">dmxrmscreen</primary>
270 </indexterm>
271 </listitem>
272 </varlistentry>
273
274 <varlistentry id="dmxtodmx-x7">
275 <term><command>dmxtodmx</command></term>
276 <listitem>
277 <para>is a dmx configuration file parser and printer.</para>
278 <indexterm zone="xorg7-server dmxtodmx-x7">
279 <primary sortas="b-dmxtodmx">dmxtodmx</primary>
280 </indexterm>
281 </listitem>
282 </varlistentry>
283
284 <varlistentry id="dmxwininfo-x7">
285 <term><command>dmxwininfo</command></term>
286 <listitem>
287 <para>queries a window's attributes on an Xdmx server.</para>
288 <indexterm zone="xorg7-server dmxwininfo-x7">
289 <primary sortas="b-dmxwininfo">dmxwininfo</primary>
290 </indexterm>
291 </listitem>
292 </varlistentry>
293
294 <varlistentry id="getconfig-x7">
295 <term><command>getconfig</command></term>
296 <listitem>
297 <para>a wrapper script around getconfig.pl.</para>
298 <indexterm zone="xorg7-server getconfig-x7">
299 <primary sortas="b-getconfig">getconfig</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="getconfig.pl-x7">
305 <term><command>getconfig.pl</command></term>
306 <listitem>
307 <para>gets configuration information for the Xorg server.</para>
308 <indexterm zone="xorg7-server getconfig.pl-x7">
309 <primary sortas="b-getconfig.pl">getconfig.pl</primary>
310 </indexterm>
311 </listitem>
312 </varlistentry>
313
314 <varlistentry id="gtf-x7">
315 <term><command>gtf</command></term>
316 <listitem>
317 <para>calculates VESA GTF mode lines.</para>
318 <indexterm zone="xorg7-server gtf-x7">
319 <primary sortas="b-gtf">gtf</primary>
320 </indexterm>
321 </listitem>
322 </varlistentry>
323
324 <varlistentry id="inb-x7">
325 <term><command>inb</command></term>
326 <listitem>
327 <para>is a symbolic link to ioport.</para>
328 <indexterm zone="xorg7-server inb-x7">
329 <primary sortas="b-inb">inb</primary>
330 </indexterm>
331 </listitem>
332 </varlistentry>
333
334 <varlistentry id="inl-x7">
335 <term><command>inl</command></term>
336 <listitem>
337 <para>is a symbolic link to ioport.</para>
338 <indexterm zone="xorg7-server inl-x7">
339 <primary sortas="b-inl">inl</primary>
340 </indexterm>
341 </listitem>
342 </varlistentry>
343
344 <varlistentry id="inw-x7">
345 <term><command>inw</command></term>
346 <listitem>
347 <para>is a symbolic link to ioport.</para>
348 <indexterm zone="xorg7-server inw-x7">
349 <primary sortas="b-inw">inw</primary>
350 </indexterm>
351 </listitem>
352 </varlistentry>
353
354 <varlistentry id="ioport-x7">
355 <term><command>ioport</command></term>
356 <listitem>
357 <para>sets input and output ports for the X server.</para>
358 <indexterm zone="xorg7-server ioport-x7">
359 <primary sortas="b-ioport">ioport</primary>
360 </indexterm>
361 </listitem>
362 </varlistentry>
363
364 <varlistentry id="outb-x7">
365 <term><command>outb</command></term>
366 <listitem>
367 <para>is a symbolic link to ioport.</para>
368 <indexterm zone="xorg7-server outb-x7">
369 <primary sortas="b-outb">outb</primary>
370 </indexterm>
371 </listitem>
372 </varlistentry>
373
374 <varlistentry id="outl-x7">
375 <term><command>outl</command></term>
376 <listitem>
377 <para>is a symbolic link to ioport.</para>
378 <indexterm zone="xorg7-server outl-x7">
379 <primary sortas="b-outl">outl</primary>
380 </indexterm>
381 </listitem>
382 </varlistentry>
383
384 <varlistentry id="outw-x7">
385 <term><command>outw</command></term>
386 <listitem>
387 <para>is a symbolic link to ioport.</para>
388 <indexterm zone="xorg7-server outw-x7">
389 <primary sortas="b-outw">outw</primary>
390 </indexterm>
391 </listitem>
392 </varlistentry>
393
394 <varlistentry id="pcitweak-x7">
395 <term><command>pcitweak</command></term>
396 <listitem>
397 <para>reads or writes the PCI config space.</para>
398 <indexterm zone="xorg7-server pcitweak-x7">
399 <primary sortas="b-pcitweak">pcitweak</primary>
400 </indexterm>
401 </listitem>
402 </varlistentry>
403
404 <varlistentry id="scanpci-x7">
405 <term><command>scanpci</command></term>
406 <listitem>
407 <para>scans and probes the PCI buses.</para>
408 <indexterm zone="xorg7-server scanpci-x7">
409 <primary sortas="b-scanpci">scanpci</primary>
410 </indexterm>
411 </listitem>
412 </varlistentry>
413
414 <varlistentry id="vdltodmx-x7">
415 <term><command>vdltodmx</command></term>
416 <listitem>
417 <para>is a VDL format dmx configuration file parser and
418 printer.</para>
419 <indexterm zone="xorg7-server vdltodmx-x7">
420 <primary sortas="b-vdltodmx">vdltodmx</primary>
421 </indexterm>
422 </listitem>
423 </varlistentry>
424
425 <varlistentry id="X-x7">
426 <term><command>X</command></term>
427 <listitem>
428 <para>is a symbolic link to Xorg.</para>
429 <indexterm zone="xorg7-server X-x7">
430 <primary sortas="b-X">X</primary>
431 </indexterm>
432 </listitem>
433 </varlistentry>
434
435 <varlistentry id="Xdmx-x7">
436 <term><command>Xdmx</command></term>
437 <listitem>
438 <para>is the Distributed Multi-head X server.</para>
439 <indexterm zone="xorg7-server Xdmx-x7">
440 <primary sortas="b-Xdmx">Xdmx</primary>
441 </indexterm>
442 </listitem>
443 </varlistentry>
444
445 <varlistentry id="xdmx-x7">
446 <term><command>xdmx</command></term>
447 <listitem>
448 <para>prints information about the Xdmx server.</para>
449 <indexterm zone="xorg7-server xdmx-x7">
450 <primary sortas="b-xdmx">xdmx</primary>
451 </indexterm>
452 </listitem>
453 </varlistentry>
454
455 <varlistentry id="xdmxconfig-x7">
456 <term><command>xdmxconfig</command></term>
457 <listitem>
458 <para>is a graphical configuration tool for Xdmx configuration
459 files.</para>
460 <indexterm zone="xorg7-server xdmxconfig-x7">
461 <primary sortas="b-xdmxconfig">xdmxconfig</primary>
462 </indexterm>
463 </listitem>
464 </varlistentry>
465
466 <varlistentry id="Xnest-x7">
467 <term><command>Xnest</command></term>
468 <listitem>
469 <para>is a nested X server.</para>
470 <indexterm zone="xorg7-server Xnest-x7">
471 <primary sortas="b-Xnest">Xnest</primary>
472 </indexterm>
473 </listitem>
474 </varlistentry>
475
476 <varlistentry id="Xorg-x7">
477 <term><command>Xorg</command></term>
478 <listitem>
479 <para>is the X11R7 X Server.</para>
480 <indexterm zone="xorg7-server Xorg-x7">
481 <primary sortas="b-Xorg">Xorg</primary>
482 </indexterm>
483 </listitem>
484 </varlistentry>
485
486 <varlistentry id="xorgcfg-x7">
487 <term><command>xorgcfg</command></term>
488 <listitem>
489 <para>is a graphical configuration tool for Xorg.</para>
490 <indexterm zone="xorg7-server xorgcfg-x7">
491 <primary sortas="b-xorgcfg">xorgcfg</primary>
492 </indexterm>
493 </listitem>
494 </varlistentry>
495
496 <varlistentry id="xorgconfig-x7">
497 <term><command>xorgconfig</command></term>
498 <listitem>
499 <para>generates an xorg.conf file.</para>
500 <indexterm zone="xorg7-server xorgconfig-x7">
501 <primary sortas="b-xorgconfig">xorgconfig</primary>
502 </indexterm>
503 </listitem>
504 </varlistentry>
505
506 <varlistentry id="Xvfb-x7">
507 <term><command>Xvfb</command></term>
508 <listitem>
509 <para>is the virtual framebuffer X server for X Version 11.</para>
510 <indexterm zone="xorg7-server Xvfb-x7">
511 <primary sortas="b-Xvfb">Xvfb</primary>
512 </indexterm>
513 </listitem>
514 </varlistentry>
515
516 </variablelist>
517
518 </sect2>
519
520</sect1>
Note: See TracBrowser for help on using the repository browser.