source: x/installing/xfree86.xml@ ff769b8c

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 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 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since ff769b8c was ff769b8c, checked in by Manuel Canales Esparcia <manuel@…>, 19 years ago

Updated the XML sources to use DocBook XML DTD-4.4.

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

  • Property mode set to 100644
File size: 29.4 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/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". You may want to change the
465keyboard autorepeat rate by adding
466<parameter>Option "Autorepeat" "250 30"</parameter>.</para></listitem>
467
468<listitem><para>Section "Monitor". Specify the
469<parameter>VertRefresh</parameter> and <parameter>HorizSync</parameter> values
470if the system does not automatically detect the monitor and its values.</para>
471</listitem>
472
473<listitem><para>Section "Device". You may want to set some of the options
474available for your selected video driver. A description of the driver
475parameters is in the man page for your driver.</para></listitem>
476
477<listitem><para>Section "Screen". Add a DefaultDepth statement such
478as: <parameter>DefaultDepth 24</parameter>. In the SubSection for your
479default depth, add a modes line such as:
480<parameter>Modes "1600x1200" "1280x1024" "1024x768"</parameter>. The first mode listed
481will normally be the starting resolution.</para></listitem>
482
483</itemizedlist>
484
485<para>Test the system with:
486<screen><userinput><command>XFree86 -xf86config ~/XF86Config.new</command></userinput></screen>
487You will only get a gray background with an X-shaped mouse cursor, but it
488confirms the system is working. Exit with Control-Alt-Backspace. If the
489system does not work, examine <filename>/var/log/XFree86.0.log</filename> to
490see what went wrong.</para>
491
492<para>Move the configuration file to its final location:</para>
493<screen><userinput><command>mv ~/XF86Config.new /etc/X11/XF86Config</command></userinput></screen>
494
495<para>Create <filename>.xinitrc</filename>:
496<screen><userinput><command>cat &gt; ~/.xinitrc &lt;&lt; "EOF"</command>
497# Begin .xinitrc file
498xterm -g 80x40+0+0 &amp;
499xclock -g 100x100-0+0 &amp;
500twm
501<command>EOF</command></userinput></screen>
502This provides an initial screen with an xterm and a clock that is managed by a
503simple window manager, Tab Window Manager. For details of
504<command>twm</command>, see the man page.</para>
505
506<indexterm zone="xfree86 xfree86-config">
507 <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
508</indexterm>
509
510
511<note>
512
513<para>When needed, <application>XFree86</application> creates the directory
514<filename>/tmp/.ICE-unix</filename> if it does not exist. If this directory is
515not owned by root, <application>XFree86</application> delays startup by a few
516seconds and also appends a warning to the logfile. This also affects startup of
517other applications. To improve performance, it is advisable to manually create
518the directory before <application>XFree86</application> uses it. Add the file
519creation to <filename>/etc/sysconfig/createfiles</filename> that is sourced by
520the <filename>/etc/rc.d/init.d/cleanfs</filename> startup script.</para>
521
522<screen><userinput><command>cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"</command>
523/tmp/.ICE-unix dir 1777 root root
524<command>EOF</command></userinput></screen>
525</note>
526
527 <indexterm zone="xfree86 xfree86-config">
528 <primary sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
529 </indexterm>
530
531<para>Start <application>X</application> with:
532<screen><userinput><command>startx</command></userinput></screen>
533to get a basic functional <application>X</application> Window System.</para>
534
535<para>At this point, you should check out <xref linkend='x-setup'/>.</para>
536
537</sect2>
538
539<sect2 id="xfree86-contents" xreflabel="XFree86 Contents and Descriptions">
540<title>Contents</title>
541
542<para>The <application>XFree86</application> package contains the
543<application>X</application> Window System for Linux (and other operating
544systems). It includes the <application>X</application> server, fonts,
545<command>xterm</command>, a simple window manager (<command>twm</command>),
546various utilities, video output drivers, and various input drivers including
547the mouse and keyboard.</para>
548
549<para><application>XFree86</application> also contains libraries and header
550files for development of the <application>X</application> Window System
551programs.</para>
552
553</sect2>
554
555<sect2><title>Description</title>
556
557<note><para>The following lists are not comprehensive. The
558full list of programs is in <filename class="directory">/usr/X11R6/bin</filename>. For
559additional information about these programs, see the respective man
560page.</para></note>
561
562<segmentedlist>
563 <segtitle>Installed Programs</segtitle>
564 <segtitle>Installed Libraries</segtitle>
565 <segtitle>Installed Directories</segtitle>
566
567 <seglistitem>
568 <seg>XFree86, xf86config, xf86cfg, startx, xinit, twm, xterm, xwininfo,
569 x11perf, xlsfonts, xvidtune, xload, xcalc, xclock, oclock, xmodmap</seg>
570 <seg>libGL.so, libGLU.so, libSM.so, libXi.so, libXrender.so, libXt.so, libXfont.so</seg>
571 <seg>/usr/X11R6/, /etc/X11/</seg>
572 </seglistitem>
573</segmentedlist>
574
575<variablelist>
576 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
577 <?dbfo list-presentation="list"?>
578
579<varlistentry id="XFree86">
580 <term><command>XFree86</command></term>
581 <listitem>
582 <para>is the X11R6 implementation of the <application>X</application> Window System server.</para>
583 <indexterm zone="xfree86 XFree86">
584 <primary sortas="b-XFree86">XFree86</primary>
585 </indexterm>
586 </listitem>
587</varlistentry>
588
589<varlistentry id="xf86config">
590 <term><command>xf86config</command></term>
591 <listitem>
592 <para>is an interactive program for generating an <filename>XF86Config</filename> file for use with
593 <application>XFree86</application> <application>X</application> servers.</para>
594 <indexterm zone="xfree86 xf86config">
595 <primary sortas="b-xf86config">xf86config</primary>
596 </indexterm>
597 </listitem>
598</varlistentry>
599
600<varlistentry id="xf86cfg">
601 <term><command>xf86cfg</command></term>
602 <listitem>
603 <para> is a tool to configure <application>XFree86</application> that can be used to either write the
604 initial configuration file or make customizations to the current configuration.</para>
605 <indexterm zone="xfree86 xf86cfg">
606 <primary sortas="b-xf86cfg">xf86cfg</primary>
607 </indexterm>
608 </listitem>
609</varlistentry>
610
611<varlistentry id="startx">
612 <term><command>startx</command></term>
613 <listitem>
614 <para>is a script to initialize the <application>X</application> session. It
615 runs <command>xinit</command>.</para>
616 <indexterm zone="xfree86 startx">
617 <primary sortas="b-startx">startx</primary>
618 </indexterm>
619 </listitem>
620</varlistentry>
621
622<varlistentry id="xinit">
623 <term><command>xinit</command></term>
624 <listitem>
625 <para>is used to start the <application>X</application> Window System server.</para>
626 <indexterm zone="xfree86 xinit">
627 <primary sortas="b-xinit">xinit</primary>
628 </indexterm>
629 </listitem>
630</varlistentry>
631
632<varlistentry id="twm">
633 <term><command>twm</command></term>
634 <listitem>
635 <para> (Tab Window Manager) is a window manager included with the
636 <application>X</application> Window System.</para>
637 <indexterm zone="xfree86 twm">
638 <primary sortas="b-twm">twm</primary>
639 </indexterm>
640 </listitem>
641</varlistentry>
642
643<varlistentry id="xterm">
644 <term><command>xterm</command></term>
645 <listitem>
646 <para>is a terminal emulator for <application>X</application>.</para>
647 <indexterm zone="xfree86 xterm">
648 <primary sortas="b-xterm">xterm</primary>
649 </indexterm>
650 </listitem>
651</varlistentry>
652
653<varlistentry id="xwininfo">
654 <term><command>xwininfo</command></term>
655 <listitem>
656 <para> is a window information utility for <application>X</application>.</para>
657 <indexterm zone="xfree86 xwininfo">
658 <primary sortas="b-xwininfo">xwininfo</primary>
659 </indexterm>
660 </listitem>
661</varlistentry>
662
663<varlistentry id="x11perf">
664 <term><command>x11perf</command></term>
665 <listitem>
666 <para>is an <application>X</application>11 server performance test program.</para>
667 <indexterm zone="xfree86 x11perf">
668 <primary sortas="b-x11perf">x11perf</primary>
669 </indexterm>
670 </listitem>
671</varlistentry>
672
673<varlistentry id="xlsfonts">
674 <term><command>xlsfonts</command></term>
675 <listitem>
676 <para>is a program to list fonts available to the <application>X</application> server.</para>
677 <indexterm zone="xfree86 xlsfonts">
678 <primary sortas="b-xlsfonts">xlsfonts</primary>
679 </indexterm>
680 </listitem>
681</varlistentry>
682
683<varlistentry id="xvidtune">
684 <term><command>xvidtune</command></term>
685 <listitem>
686 <para>is a video mode tuner for <application>XFree86</application>.</para>
687 <indexterm zone="xfree86 xvidtune">
688 <primary sortas="b-xvidtune">xvidtune</primary>
689 </indexterm>
690 </listitem>
691</varlistentry>
692
693<varlistentry id="xload">
694 <term><command>xload</command></term>
695 <listitem>
696 <para> is a system load average display for <application>X</application>.</para>
697 <indexterm zone="xfree86 xload">
698 <primary sortas="b-xload">xload</primary>
699 </indexterm>
700 </listitem>
701</varlistentry>
702
703<varlistentry id="xcalc">
704 <term><command>xcalc</command></term>
705 <listitem>
706 <para>is a scientific calculator for <application>X</application>.</para>
707 <indexterm zone="xfree86 xcalc">
708 <primary sortas="b-xcalc">xcalc</primary>
709 </indexterm>
710 </listitem>
711</varlistentry>
712
713<varlistentry id="xclock">
714 <term><command>xclock</command></term>
715 <listitem>
716 <para>is a clock programs for <application>X</application>.</para>
717 <indexterm zone="xfree86 xclock">
718 <primary sortas="b-xclock">xclock</primary>
719 </indexterm>
720 </listitem>
721</varlistentry>
722
723<varlistentry id="oclock">
724 <term><command>oclock</command></term>
725 <listitem>
726 <para>is a clock programs for <application>X</application>.</para>
727 <indexterm zone="xfree86 oclock">
728 <primary sortas="b-oclock">oclock</primary>
729 </indexterm>
730 </listitem>
731</varlistentry>
732
733<varlistentry id="xmodmap">
734 <term><command>xmodmap</command></term>
735 <listitem>
736 <para>is a utility for modifying keymaps and pointer button mappings in
737 <application>X</application>.</para>
738 <indexterm zone="xfree86 xmodmap">
739 <primary sortas="b-xmodmap">xmodmap</primary>
740 </indexterm>
741 </listitem>
742</varlistentry>
743
744</variablelist>
745</sect2>
746</sect1>
Note: See TracBrowser for help on using the repository browser.