source: x/installing/xfree86.xml@ aebc72fa

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.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 aebc72fa was aebc72fa, checked in by DJ Lucas <dj@…>, 18 years ago

added dir creation to xorg and xfre86 and made lnx_agp.c sed optional for xorg

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