source: x/installing/xfree86.xml@ 7f76b96

10.0 10.1 11.0 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 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 xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 7f76b96 was 7f76b96, checked in by Manuel Canales Esparcia <manuel@…>, 17 years ago

Reverted the DTD change. That don't be done untiltomorrow.

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

  • Property mode set to 100644
File size: 29.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3 "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY xfree86-download-http "http://gnu.kookel.org/ftp/XFree86/4.4.0/source/">
8 <!ENTITY xfree86-download-ftp "ftp://ftp.xfree86.org/pub/XFree86/4.4.0/source/">
9 <!ENTITY xfree86-md5sum "ftp://ftp.xfree86.org/pub/XFree86/4.4.0/source/SUMS.md5sum">
10 <!ENTITY xfree86-size "52 MB">
11 <!ENTITY xfree86-buildsize "775 MB">
12 <!ENTITY xfree86-time "11.6 SBU">
13]>
14
15<sect1 id="xfree86" xreflabel="XFree86-&xfree86-version;">
16<sect1info>
17 <othername>$LastChangedBy$</othername>
18 <date>$Date$</date>
19</sect1info>
20
21<?dbhtml filename="xfree86.html" ?>
22<title>XFree86-&xfree86-version;</title>
23
24<indexterm zone="xfree86">
25 <primary sortas="a-xfree86">XFree86</primary>
26</indexterm>
27
28<sect2>
29<title>Introduction to <application>XFree86</application></title>
30
31<para><application>XFree86</application> is a freely redistributable
32open-source implementation of the <application>X</application> Window System.
33<application>XFree86</application> provides a client/server interface between
34display hardware (the mouse, keyboard, and video displays) and the desktop
35environment, while also providing both the windowing infrastructure and a
36standardized application interface (<acronym>API</acronym>).</para>
37
38<sect3><title>Package information</title>
39 <itemizedlist spacing='compact'>
40 <listitem><para>Download (HTTP): <ulink url="&xfree86-download-http;"/></para></listitem>
41 <listitem><para>Download (FTP): <ulink url="&xfree86-download-ftp;"/></para></listitem>
42 <listitem><para>Download MD5 sums: <ulink url="&xfree86-md5sum;"/></para></listitem>
43 <listitem><para>Download size: &xfree86-size;</para></listitem>
44 <listitem><para>Estimated disk space required: &xfree86-buildsize;</para></listitem>
45 <listitem><para>Estimated build time: &xfree86-time;</para></listitem>
46 </itemizedlist>
47</sect3>
48
49<sect3>
50 <title>Additional downloads</title>
51
52<itemizedlist spacing='compact'>
53 <listitem>
54 <para>Security patch: <ulink
55 url="http://www.x.org/pub/X11R6.8.0/patches/xorg-CAN-2004-0687-0688.patch"/></para>
56 </listitem>
57</itemizedlist></sect3>
58
59<sect3>
60 <title><application>XFree86</application> dependencies</title>
61
62<sect4>
63 <title>Required</title>
64 <para><xref linkend="libpng"/></para>
65</sect4>
66
67<sect4>
68 <title>Optional</title>
69 <para><xref linkend="Linux_PAM"/>; the
70 following packages are included in the <application>XFree86</application>
71 package, however they are updated more often than the
72 <application>XFree86</application> package and are highly recommended:
73 <xref linkend="expat"/>, <xref linkend="freetype2"/>,
74 <xref linkend="fontconfig"/>.
75 </para>
76
77 <note><para>If you choose not to install <application>expat</application>,
78 <application>FreeType2</application>, and <application>Fontconfig</application>,
79 the <filename>host.def</filename> file below will have to be modified to
80 instruct <application>XFree86</application> to build them.</para>
81 </note>
82</sect4>
83
84</sect3>
85
86<sect3>
87 <title>Download Instructions</title>
88
89 <para>There are several files that need to be fetched from the download location:</para>
90
91 <itemizedlist spacing='compact'>
92 <listitem><para><filename>XFree86-4.4.0-src-1.tgz</filename></para></listitem>
93 <listitem><para><filename>XFree86-4.4.0-src-2.tgz</filename></para></listitem>
94 <listitem><para><filename>XFree86-4.4.0-src-3.tgz</filename></para></listitem>
95 <listitem><para><filename>XFree86-4.4.0-src-4.tgz</filename></para></listitem>
96 <listitem><para><filename>XFree86-4.4.0-src-5.tgz</filename></para></listitem>
97 <listitem><para><filename>XFree86-4.4.0-src-6.tgz</filename></para></listitem>
98 <listitem><para><filename>XFree86-4.4.0-src-7.tgz</filename></para></listitem>
99 </itemizedlist>
100
101 <para>The first three packages are the <application>XFree86</application>
102 programs, the fourth and fifth are fonts, the sixth is normal documentation,
103 and the seventh is hardcopy documentation. There are also two packages
104 <filename>doctools-1.3.1.tgz</filename>, which contain programs to regenerate
105 hardcopy documentation, and <filename>utils-1.1.0.tgz</filename>, which contain
106 <application><acronym>GNU</acronym> <acronym>TAR</acronym></application>
107 and <application>zlib</application> which are already installed on an
108 <acronym>LFS</acronym> system.
109 </para>
110
111 <para>To check your downloads for integrity, download the
112 <filename>SUMS.md5sum</filename> file. Then:
113 </para>
114
115 <screen><userinput><command>md5sum -c SUMS.md5sum</command></userinput></screen>
116
117 <para>The only errors you should see are for <filename>README</filename>,
118 <filename>doctools-1.3.1.tgz</filename>, <filename>utils-1.1.0.tgz</filename>
119 and <filename>XFree86-xtest-4.0.x.tar.bz2</filename> files if you did not
120 download them.
121 </para>
122
123<!--
124<para>The fixes subdirectory also has a <filename>SUMS.md5sum</filename>. Note that
125this is the same filename as the sums for the main sources, so you need to rename the
126file if you download it. Otherwise, you can just look at it and use it to
127check against the patch files:</para>
128<screen><userinput><command>md5sum 4.3.0-4.3.0.1.diff.gz</command></userinput>
129<userinput><command>md5sum fontfile.diff</command></userinput></screen>
130
131<para>After unpacking the <filename>X430src-?.tgz</filename> files and uncompressing the
132diff file, change to the <filename class="directory">xc</filename> directory and run:</para>
133
134<screen><userinput><command>patch -Np1 -i ../4.3.0-4.3.0.1.diff</command></userinput>
135<userinput><command>pushd lib/font/fontfile/</command></userinput>
136<userinput><command>patch -N -i ../../../../fontfile.diff</command></userinput>
137<userinput><command>popd</command></userinput></screen>
138-->
139
140</sect3>
141</sect2>
142
143<sect2>
144 <title>Installation of <application>XFree86</application></title>
145
146<sect3 id='xfree86-kernel'>
147 <title>Kernel Compilation Settings</title>
148
149 <para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is
150 recommended that you compile <acronym>MTRR</acronym> (Memory Type Range
151 Registers) support into the kernel. The kernel can map Cyrix and AMD
152 <acronym>CPU</acronym>s to the <acronym>MTRR</acronym> interface, so selecting
153 this option is useful for those processors also. This option is found in the
154 "Processor type and features" menu. It can increase performance of image write
155 operations 2.5 times or more on <acronym>PCI</acronym> or
156 <acronym>AGP</acronym> video cards.
157 </para>
158
159 <indexterm zone="xfree86 xfree86-kernel">
160 <primary sortas="d-xfree86">XFree86</primary>
161 </indexterm>
162
163 <para>In the "Character Devices" section, enable <acronym>AGP</acronym> Support
164 and select the chipset support on your motherboard. If you do not know the
165 chipset, you may select all the chip types at the expense of extra kernel size.
166 You can usually determine your motherboard's chipset by running the command
167 <command>lspci</command>, a program from the <xref linkend="pciutils"/> package.
168 </para>
169
170 <para>In the "Character Devices" section, <emphasis>disable</emphasis> Direct
171 Rendering Manager unless you have a Direct Rendering Infrastructure
172 (<acronym>DRI</acronym>) supported video card. A complete list of
173 <acronym>DRI</acronym> supported video cards can be found at
174 <ulink url="http://dri.sourceforge.net" /> in the Status section. Currently,
175 supported cards include those from 3dfx (Voodoo, Banshee), 3Dlabs,
176 ATI (Rage Pro, Rage 128, Radeon 7X00, Radeon 2), Intel (i810, i815), and
177 Matrox (G200, G400, G450).
178 </para>
179
180 <para>Additionally NVidia provides their own closed source binary drivers,
181 which do not make use of <acronym>DRI</acronym>. If you intend to use these
182 drivers, do not enable <acronym>DRI</acronym>.
183 </para>
184
185 <para>If you made any changes to the kernel configuration, recompile and
186 install the new kernel.
187 </para>
188
189 <note><para>If you build <application>XFree86</application> in a
190 <command>chroot</command> environment, make sure the kernel version of the base
191 system and the target system are the same.
192 </para></note>
193
194</sect3>
195
196<sect3>
197 <title>Creating <filename>host.def</filename></title>
198
199 <para>Although <application>XFree86</application> will compile without a
200 <filename>host.def</filename> file, the following file is recommended for
201 customizing the installation. Start from the
202 <filename class="directory">xc</filename> directory.
203 </para>
204
205 <note><para>The <filename>host.def</filename> file is a
206 <application>C</application> file, not the usual configuration file. If you
207 make any changes, be sure the comment characters (<userinput>/*</userinput>
208 and <userinput>*/</userinput>) are balanced. Most of the entries in the file
209 below are commented out with the default settings shown.
210 </para></note>
211
212<screen><userinput><command>cat &gt; config/cf/host.def &lt;&lt; "EOF"</command>
213/* Begin XFree86 host.def file */
214
215/* System Related Information. If you read and configure only one
216 * section then it should be this one. The Intel architecture defaults
217 * are set for a i686 and higher. Axp is for the Alpha architecture
218 * and Ppc is for the Power PC. Note that there have been reports that
219 * the Ppc optimization line causes segmentation faults during build.
220 * If that happens, try building without the DefaultGcc2PpcOpt line. */
221
222/* #define DefaultGcc2i386Opt -O2 -fomit-frame-pointer -march=i686 */
223/* #define DefaultGcc2AxpOpt -O2 -mcpu=ev6 */
224/* #define DefaultGcc2PpcOpt -O2 -mcpu=750 */
225
226/* The following definitions are normally set properly by XFree86's
227 * scripts. You can uncomment them if you want to make sure. *********/
228
229/* #define HasMTRRSupport YES */ /* Enabled in kernel; */
230 /* see kernel docs */
231/* #define HasMMXSupport NO */ /* Any i586 or above */
232/* #define HasKatmaiSupport NO */ /* PIII SSE instructions */
233/* #define Has3DNowSupport NO */ /* AMD instructions */
234
235
236/* This setting reduces compile time a little by omitting rarely used
237 * input devices. You can find the complete list in
238 * config/cf/xfree86.cf *********************************************/
239
240#define XInputDrivers mouse void
241
242/* VIDEO DRIVERS ****************************************************/
243
244/* If you are sure you only want the drivers for one or a few video
245 * cards, you can delete the drivers you do not want. ***************/
246
247
248#define XF86CardDrivers mga glint nv tga s3 s3virge sis rendition \
249 neomagic i740 tdfx savage \
250 cirrus vmware tseng trident chips apm \
251 GlideDriver fbdev i128 nsc \
252 ati i810 AgpGartDrivers DevelDrivers ark \
253 cyrix siliconmotion \
254 vesa vga \
255 dummy XF86OSCardDrivers XF86ExtraCardDrivers
256
257
258/* USER AND SYSTEM DEFAULT PATHS *************************************/
259
260/* These settings set the PATH variables used by xdm. See README for */
261/* detailed description and modify the following as per your need. ***/
262
263/* #define DefaultSystemPath \
264 /usr/bin:/bin:/usr/sbin:/sbin:/usr/X11R6/bin */
265/* #define DefaultUserPath /usr/bin:/bin:/usr/X11R6/bin */
266
267/* FONT SERVER AND LIBRARY SETTINGS **********************************/
268
269/* These settings are the defaults **********************************/
270
271/* #define BuildFontServer YES */ /*For Ghostscript Print Server*/
272/* #define SharedLibFont YES */
273/* #define CompressAllFonts YES */
274/* #define GzipFontCompression YES */
275
276/* These settings ensure we use our libraries ************************/
277#define HasFreetype2 YES
278#define HasFontconfig YES
279#define HasExpat YES
280#define HasLibpng YES
281#define HasZlib YES
282
283/* The font path can be redefined in the XF86Config file *************/
284
285/*
286#define DefaultFontPath $(FONTDIR)/misc/,$(FONTDIR)/75dpi/,\
287$(FONTDIR)/100dpi/,$(FONTDIR)/Type1,$(FONTDIR)/local,\
288$(FONTDIR)/TrueType,$(FONTDIR)/CID,$(FONTDIR)/Speedo
289*/
290
291
292/* INTERNATIONAL FONTS. Change to YES if you need any of them. These
293 * are the defaults. **************************************************/
294
295/* #define BuildCyrillicFonts NO */
296/* #define BuildArabicFonts NO */
297/* #define BuildISO8859_6Fonts NO */
298/* #define BuildGreekFonts NO */
299/* #define BuildISO8859_7Fonts NO */
300/* #define BuildHebrewFonts NO */
301/* #define BuildISO8859_8Fonts NO */
302/* #define BuildKOI8_RFonts NO */
303/* #define BuildJapaneseFonts NO */
304/* #define BuildJISX0201Fonts NO */
305/* #define BuildKoreanFonts NO */
306/* #define BuildChineseFonts NO */
307
308/* DOCUMENTATION SETTINGS ********************************************/
309
310/* These setting are the defaults. ***********************************/
311
312/* #define BuildLinuxDocHtml NO */ /* X Docs in Html format */
313/* #define BuildLinuxDocPS NO */ /* PostScript format */
314/* #define BuildAllSpecsDocs NO */ /* Various docs */
315/* #define BuildHtmlManPages NO */
316
317/* GENERAL SETTINGS: You generally want to leave these alone when
318 * building X on an LFS system ***************************************/
319
320#define GccWarningOptions -pipe /* Speed up compiles */
321#define TermcapLibrary -lncurses
322#define XprtServer YES /* Needed by realplayer */
323#define XnestServer YES
324#define XAppLoadDir EtcX11Directory/app-defaults
325#define VarLibDir /var/lib
326#define XFree86Devel NO
327#define FSUseSyslog YES
328#define ThreadedX YES
329#define HasPam NO
330#define SystemManDirectory /usr/share/man /*Instead of /usr/man*/
331#define HasLibCrypt YES
332#define InstallXinitConfig YES
333#define InstallXdmConfig YES
334#define ForceNormalLib YES
335#define BuildSpecsDocs NO
336
337/* End XFree86 host.def file */
338<command>EOF</command></userinput></screen>
339
340<para>Edit the file for your hardware and desires.</para>
341
342</sect3>
343
344<sect3>
345 <title>Build Commands</title>
346
347 <para>Some vulnerabilities were reported in <filename
348 class="libraryfile">libXpm</filename>. A remote user may be able to
349 execute arbitrary code on applications that use <filename
350 class="libraryfile">libXpm</filename>. The <application>Xorg</application>
351 team released a patch for their version 6.8.0 but it works for
352 <application>XFree86</application> as well. Apply the patch:
353 </para>
354
355<screen><userinput><command>patch -Np1 -i ../xorg-CAN-2004-0687-0688.patch</command></userinput></screen>
356
357<para>Install <application>XFree86</application> by running the following commands:</para>
358
359<screen><userinput><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@/* &amp; */@" \
360 `grep -lr linux/config.h *` &amp;&amp;
361( make WORLDOPTS="" World 2&gt;&amp;1 | \
362 tee xfree-compile.log &amp;&amp; exit $PIPESTATUS )</command></userinput></screen>
363
364<para>Now, as the root user:</para>
365
366<screen><userinput role='root'><command>make install &amp;&amp;
367make install.man &amp;&amp;
368ln -sf ../X11R6/bin /usr/bin/X11 &amp;&amp;
369ln -sf ../X11R6/lib/X11 /usr/lib/X11 &amp;&amp;
370ln -sf ../X11R6/include/X11 /usr/include/X11</command></userinput></screen>
371
372</sect3>
373
374</sect2>
375
376<sect2>
377<title>Command explanations</title>
378
379<para><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@...</command>: The
380<application>Linux-Libc-Headers</application> package installed in
381<acronym>LFS</acronym> installs a
382<filename>/usr/include/linux/config.h</filename> file which is not compatible
383with userspace applications. The recommended fix for applications including
384this file is to remove it (see <ulink
385url="http://ep09.pld-linux.org/~mmazur/linux-libc-headers/doc/FAQ">
386linux-libc-headers FAQ</ulink>). The <command>sed</command> uses
387<command>grep -lr</command> to replace all occurences. If you desire, just
388remove (comment) the line in the appropriate video driver file if you
389customized <filename>host.def</filename>.
390</para>
391
392<para><command>( make WORLDOPTS="" World 2&gt;&amp;1 | tee xfree-compile.log
393 &amp;&amp; exit $PIPESTATUS )</command>:
394This command runs multiple <filename>Makefile</filename>s to completely rebuild
395the system. <envar>WORLDOPTS</envar>="" disables the default setting to
396continue after encountering an error. <parameter>2&gt;&amp;1</parameter>
397redirects error messages to the same location as standard output. The
398<command>tee</command> command allows viewing of the output while logging the
399results to a file. The parentheses around the command runs the entire comand in
400a subshell and finally the <command>exit $PIPESTATUS</command> ensures the
401result of the <command>make</command> is returned as the result and not the
402result of the <command>tee</command> command.</para>
403
404<note><para>When rebuilding <application>XFree86</application>, a separate
405command that may be used if only minor changes are made to the sources is
406<command>make Everything</command>. This does not automatically remove
407generated files and only rebuilds those files or programs that are out
408of date.</para></note>
409
410<para><screen><command>ln -sf ../X11R6/bin /usr/bin/X11
411ln -sf ../X11R6/lib/X11 /usr/lib/X11
412ln -sf ../X11R6/include/X11 /usr/include/X11</command></screen>
413These commands are present to enable other (broken) packages to build
414against <application>XFree86</application>, even though the Filesystem
415Hierarchy Standard says: "In general, software must not be installed or
416managed via the above symbolic links. They are intended for utilization by
417users only."</para>
418
419</sect2>
420
421<sect2 id='xfree86-config'>
422<title>Configuring <application>XFree86</application></title>
423
424<para>Edit <filename>/etc/ld.so.conf</filename> and add
425<filename class="directory">/usr/X11R6/lib</filename>.
426Run: </para>
427<screen><userinput><command>ldconfig</command></userinput></screen>
428
429<indexterm zone="xfree86 xfree86-config">
430 <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
431</indexterm>
432
433<para>Ensure <filename class="directory">/usr/X11R6/bin</filename>
434and <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>
435are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
436environment variables, respectively. Instructions for doing this are
437described in the section "<xref linkend='postlfs-config-profile'/>."</para>
438
439<indexterm zone="xfree86 xfree86-config">
440 <primary sortas="e-etc-X11-XF86Config">/etc/X11/XF86Config</primary>
441</indexterm>
442
443<para>Create the <filename>XF86Config</filename> file with:
444<screen><userinput><command>cd ~
445XFree86 -configure</command></userinput></screen>
446The screen will go black and you may hear some clicking of the monitor. This
447command will create a file, <filename>XF86Config.new</filename> in your home
448directory.</para>
449
450<para>Edit <filename>XF86Config.new</filename> to suit your system. The
451details of the file are located in the man page
452<command>man XF86Config</command>. Some things you may want to do are:</para>
453
454<itemizedlist>
455
456<listitem><para>Section "Files". Change the order of the font paths searched.
457You may want to put 100dpi fonts ahead of 75dpi fonts if your system normally
458comes up closer to 100 dots per inch. You may want to remove some font
459directories completely.</para></listitem>
460
461<listitem><para>Section "Module". If you are going to install NVidia
462drivers, remove the "dri" line.</para></listitem>
463
464<listitem><para>Sections "InputDevice". Specify the
465<parameter>Device</parameter> parameter to "/dev/input/mice" and
466<parameter>Protocol</parameter> to "auto" to set up your mouse. You may
467also want to change the keyboard autorepeat rate by adding
468<parameter>Option "Autorepeat" "250 30"</parameter>.</para></listitem>
469
470<listitem><para>Section "Monitor". Specify the
471<parameter>VertRefresh</parameter> and <parameter>HorizSync</parameter> values
472if the system does not automatically detect the monitor and its values.</para>
473</listitem>
474
475<listitem><para>Section "Device". You may want to set some of the options
476available for your selected video driver. A description of the driver
477parameters is in the man page for your driver.</para></listitem>
478
479<listitem><para>Section "Screen". Add a DefaultDepth statement such
480as: <parameter>DefaultDepth 16</parameter>. In the SubSection for your
481default depth, add a modes line such as:
482<parameter> Modes "1280x1024" "1024x768"</parameter>. The first mode listed
483will normally be the starting resolution.</para></listitem>
484
485</itemizedlist>
486
487<para>Test the system with:
488<screen><userinput><command>XFree86 -xf86config ~/XF86Config.new</command></userinput></screen>
489You will only get a gray background with an X-shaped mouse cursor, but it
490confirms the system is working. Exit with Control-Alt-Backspace. If the
491system does not work, examine <filename>/var/log/XFree86.0.log</filename> to
492see what went wrong.</para>
493
494<para>Move the configuration file to its final location:</para>
495<screen><userinput><command>mv ~/XF86Config.new /etc/X11/XF86Config</command></userinput></screen>
496
497<para>Create <filename>.xinitrc</filename>:
498<screen><userinput><command>cat &gt; ~/.xinitrc &lt;&lt; "EOF"</command>
499# Begin .xinitrc file
500xterm -g 80x40+0+0 &amp;
501xclock -g 100x100-0+0 &amp;
502twm
503<command>EOF</command></userinput></screen>
504This provides an initial screen with an xterm and a clock that is managed by a
505simple window manager, Tab Window Manager. For details of
506<command>twm</command>, see the man page.</para>
507
508<indexterm zone="xfree86 xfree86-config">
509 <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
510</indexterm>
511
512
513<note>
514
515<para>When needed, <application>XFree86</application> creates the directory
516<filename>/tmp/.ICE-unix</filename> if it does not exist. If this directory is
517not owned by root, <application>XFree86</application> delays startup by a few
518seconds and also appends a warning to the logfile. This also affects startup of
519other applications. To improve performance, it is advisable to manually create
520the directory before <application>XFree86</application> uses it. Add the file
521creation to <filename>/etc/sysconfig/createfiles</filename> that is sourced by
522the <filename>/etc/rc.d/init.d/cleanfs</filename> startup script.</para>
523
524<screen><userinput><command>cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"</command>
525/tmp/.ICE-unix dir 1777 root root
526<command>EOF</command></userinput></screen>
527</note>
528
529 <indexterm zone="xfree86 xfree86-config">
530 <primary sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
531 </indexterm>
532
533<para>Start <application>X</application> with:
534<screen><userinput><command>startx</command></userinput></screen>
535to get a basic functional <application>X</application> Window System.</para>
536
537<para>At this point, you should check out <xref linkend='x-setup'/>.</para>
538
539</sect2>
540
541<sect2 id="xfree86-contents" xreflabel="XFree86 Contents and Descriptions">
542<title>Contents</title>
543
544<para>The <application>XFree86</application> package contains the
545<application>X</application> Window System for Linux (and other operating
546systems). It includes the <application>X</application> server, fonts,
547<command>xterm</command>, a simple window manager (<command>twm</command>),
548various utilities, video output drivers, and various input drivers including
549the mouse and keyboard.</para>
550
551<para><application>XFree86</application> also contains libraries and header
552files for development of the <application>X</application> Window System
553programs.</para>
554
555</sect2>
556
557<sect2><title>Description</title>
558
559<note><para>The following lists are not comprehensive. The
560full list of programs is in <filename class="directory">/usr/X11R6/bin</filename>. For
561additional information about these programs, see the respective man
562page.</para></note>
563
564<segmentedlist>
565 <segtitle>Installed Programs</segtitle>
566 <segtitle>Installed Libraries</segtitle>
567 <segtitle>Installed Directories</segtitle>
568
569 <seglistitem>
570 <seg>XFree86, xf86config, xf86cfg, startx, xinit, twm, xterm, xwininfo,
571 x11perf, xlsfonts, xvidtune, xload, xcalc, xclock, oclock, xmodmap</seg>
572 <seg>libGL.so, libGLU.so, libSM.so, libXi.so, libXrender.so, libXt.so, libXfont.so</seg>
573 <seg>/usr/X11R6/, /etc/X11/</seg>
574 </seglistitem>
575</segmentedlist>
576
577<variablelist>
578 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
579 <?dbfo list-presentation="list"?>
580
581<varlistentry id="XFree86">
582 <term><command>XFree86</command></term>
583 <listitem>
584 <para>is the X11R6 implementation of the <application>X</application> Window System server.</para>
585 <indexterm zone="xfree86 XFree86">
586 <primary sortas="b-XFree86">XFree86</primary>
587 </indexterm>
588 </listitem>
589</varlistentry>
590
591<varlistentry id="xf86config">
592 <term><command>xf86config</command></term>
593 <listitem>
594 <para>is an interactive program for generating an <filename>XF86Config</filename> file for use with
595 <application>XFree86</application> <application>X</application> servers.</para>
596 <indexterm zone="xfree86 xf86config">
597 <primary sortas="b-xf86config">xf86config</primary>
598 </indexterm>
599 </listitem>
600</varlistentry>
601
602<varlistentry id="xf86cfg">
603 <term><command>xf86cfg</command></term>
604 <listitem>
605 <para> is a tool to configure <application>XFree86</application> that can be used to either write the
606 initial configuration file or make customizations to the current configuration.</para>
607 <indexterm zone="xfree86 xf86cfg">
608 <primary sortas="b-xf86cfg">xf86cfg</primary>
609 </indexterm>
610 </listitem>
611</varlistentry>
612
613<varlistentry id="startx">
614 <term><command>startx</command></term>
615 <listitem>
616 <para>is a script to initialize the <application>X</application> session. It
617 runs <command>xinit</command>.</para>
618 <indexterm zone="xfree86 startx">
619 <primary sortas="b-startx">startx</primary>
620 </indexterm>
621 </listitem>
622</varlistentry>
623
624<varlistentry id="xinit">
625 <term><command>xinit</command></term>
626 <listitem>
627 <para>is used to start the <application>X</application> Window System server.</para>
628 <indexterm zone="xfree86 xinit">
629 <primary sortas="b-xinit">xinit</primary>
630 </indexterm>
631 </listitem>
632</varlistentry>
633
634<varlistentry id="twm">
635 <term><command>twm</command></term>
636 <listitem>
637 <para> (Tab Window Manager) is a window manager included with the
638 <application>X</application> Window System.</para>
639 <indexterm zone="xfree86 twm">
640 <primary sortas="b-twm">twm</primary>
641 </indexterm>
642 </listitem>
643</varlistentry>
644
645<varlistentry id="xterm">
646 <term><command>xterm</command></term>
647 <listitem>
648 <para>is a terminal emulator for <application>X</application>.</para>
649 <indexterm zone="xfree86 xterm">
650 <primary sortas="b-xterm">xterm</primary>
651 </indexterm>
652 </listitem>
653</varlistentry>
654
655<varlistentry id="xwininfo">
656 <term><command>xwininfo</command></term>
657 <listitem>
658 <para> is a window information utility for <application>X</application>.</para>
659 <indexterm zone="xfree86 xwininfo">
660 <primary sortas="b-xwininfo">xwininfo</primary>
661 </indexterm>
662 </listitem>
663</varlistentry>
664
665<varlistentry id="x11perf">
666 <term><command>x11perf</command></term>
667 <listitem>
668 <para>is an <application>X</application>11 server performance test program.</para>
669 <indexterm zone="xfree86 x11perf">
670 <primary sortas="b-x11perf">x11perf</primary>
671 </indexterm>
672 </listitem>
673</varlistentry>
674
675<varlistentry id="xlsfonts">
676 <term><command>xlsfonts</command></term>
677 <listitem>
678 <para>is a program to list fonts available to the <application>X</application> server.</para>
679 <indexterm zone="xfree86 xlsfonts">
680 <primary sortas="b-xlsfonts">xlsfonts</primary>
681 </indexterm>
682 </listitem>
683</varlistentry>
684
685<varlistentry id="xvidtune">
686 <term><command>xvidtune</command></term>
687 <listitem>
688 <para>is a video mode tuner for <application>XFree86</application>.</para>
689 <indexterm zone="xfree86 xvidtune">
690 <primary sortas="b-xvidtune">xvidtune</primary>
691 </indexterm>
692 </listitem>
693</varlistentry>
694
695<varlistentry id="xload">
696 <term><command>xload</command></term>
697 <listitem>
698 <para> is a system load average display for <application>X</application>.</para>
699 <indexterm zone="xfree86 xload">
700 <primary sortas="b-xload">xload</primary>
701 </indexterm>
702 </listitem>
703</varlistentry>
704
705<varlistentry id="xcalc">
706 <term><command>xcalc</command></term>
707 <listitem>
708 <para>is a scientific calculator for <application>X</application>.</para>
709 <indexterm zone="xfree86 xcalc">
710 <primary sortas="b-xcalc">xcalc</primary>
711 </indexterm>
712 </listitem>
713</varlistentry>
714
715<varlistentry id="xclock">
716 <term><command>xclock</command></term>
717 <listitem>
718 <para>is a clock programs for <application>X</application>.</para>
719 <indexterm zone="xfree86 xclock">
720 <primary sortas="b-xclock">xclock</primary>
721 </indexterm>
722 </listitem>
723</varlistentry>
724
725<varlistentry id="oclock">
726 <term><command>oclock</command></term>
727 <listitem>
728 <para>is a clock programs for <application>X</application>.</para>
729 <indexterm zone="xfree86 oclock">
730 <primary sortas="b-oclock">oclock</primary>
731 </indexterm>
732 </listitem>
733</varlistentry>
734
735<varlistentry id="xmodmap">
736 <term><command>xmodmap</command></term>
737 <listitem>
738 <para>is a utility for modifying keymaps and pointer button mappings in
739 <application>X</application>.</para>
740 <indexterm zone="xfree86 xmodmap">
741 <primary sortas="b-xmodmap">xmodmap</primary>
742 </indexterm>
743 </listitem>
744</varlistentry>
745
746</variablelist>
747</sect2>
748</sect1>
Note: See TracBrowser for help on using the repository browser.