source: x/installing/xfree86.xml@ e3ef32f

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

Shortened sed command in XFree86 and Xorg instructions

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

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