source: x/installing/xfree86.xml@ 0bfe309a

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.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 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 0bfe309a was 52535ba5, checked in by Bruce Dubbs <bdubbs@…>, 19 years ago

Tagging XFree86 and fixes to xorg

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

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