source: x/installing/xfree86.xml@ 20f1da7

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 20f1da7 was 20f1da7, checked in by Randy McMurchy <randy@…>, 20 years ago

Added instructions to remove linux/config.h source file includes and made various fixed to XFree86

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

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