source: x/installing/xfree86.xml@ 1663c2b5

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 1663c2b5 was 1663c2b5, checked in by Dan Nichilson <dnicholson@…>, 18 years ago

Updated wiki links

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5786 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>ln -svn /usr/X11R6/lib/X11/fonts/OTF /usr/share/fonts/X11-OTF &amp;&amp;
398ln -svn /usr/X11R6/lib/X11/fonts/TTF /usr/share/fonts/X11-TTF</userinput></screen>
399
400 <para><application>XFree86</application> installs the
401 <application>XRender</application> and
402 <application>XExtensions</application> extension libraries but does not
403 install the corresponding <application>pkg-config</application> files.
404 Create the files by issuing the following commands as the
405 <systemitem class="username">root</systemitem> user:</para>
406
407<screen role="root"><userinput>cat &gt; /usr/X11R6/lib/pkgconfig/xrender.pc &lt;&lt; "EOF"
408<literal>prefix=/usr/X11R6
409exec_prefix=${prefix}
410libdir=${exec_prefix}/lib
411includedir=${prefix}/include
412
413Name: Xrender
414Description: X Render Library
415Version: 0.8.3
416Cflags: -I${includedir} -I/usr/X11R6/include
417Libs: -L${libdir} -lXrender -L/usr/X11R6/lib -lX11</literal>
418
419EOF
420
421cat &gt; /usr/X11R6/lib/pkgconfig/xextensions.pc &lt;&lt; "EOF"
422<literal>prefix=/usr/X11R6
423exec_prefix=${prefix}
424libdir=${exec_prefix}/lib
425includedir=${prefix}/include
426
427Name: XExtensions
428Description: Sundry X extension headers
429Version: 1.0.1
430Cflags: -I${includedir}</literal>
431
432EOF</userinput></screen>
433
434 </sect3>
435
436 </sect2>
437
438 <sect2 role="commands">
439 <title>Command Explanations</title>
440
441 <para><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@...</command>:
442 The <application>Linux-Libc-Headers</application> package installed in
443 LFS installs a <filename>/usr/include/linux/config.h</filename> file which
444 is not compatible with userspace applications. The recommended fix for
445 applications including this file is to remove it (see <ulink
446 url="http://ep09.pld-linux.org/~mmazur/linux-libc-headers/doc/FAQ">
447 linux-libc-headers FAQ</ulink>). The <command>sed</command> uses
448 <command>grep -lr</command> to replace all occurrences. If you desire, just
449 remove (comment) the line in the appropriate video driver file if you
450 customized <filename>host.def</filename>.</para>
451
452 <para><command>( make WORLDOPTS="" World 2&gt;&amp;1 | tee xfree-compile.log
453 &amp;&amp; exit $PIPESTATUS )</command>:
454 This command runs multiple <filename>Makefile</filename>s to completely
455 rebuild the system. <envar>WORLDOPTS</envar>="" disables the default setting
456 to continue after encountering an error. <option>2&gt;&amp;1</option>
457 redirects error messages to the same location as standard output. The
458 <command>tee</command> command allows viewing of the output while logging
459 the results to a file. The parentheses around the command runs the entire
460 command in a subshell and finally the <command>exit $PIPESTATUS</command>
461 ensures the result of the <command>make</command> is returned as the result
462 and not the result of the <command>tee</command> command.</para>
463
464 <note>
465 <para>When rebuilding <application>XFree86</application>, a separate
466 command that may be used if only minor changes are made to the sources
467 is <command>make Everything</command>. This does not automatically
468 remove generated files and only rebuilds those files or programs that
469 are out of date.</para>
470 </note>
471
472 <para><command>ln -v -sf ...</command>: These commands are present to
473 enable other (broken) packages to build against
474 <application>XFree86</application>, even though the Filesystem Hierarchy
475 Standard says: <quote>In general, software must not be installed or managed
476 via the above symbolic links. They are intended for utilization by
477 users only.</quote></para>
478
479 </sect2>
480
481 <sect2 role="configuration" id="xfree86-config">
482 <title>Configuring XFree86</title>
483
484 <para>As the <systemitem class="username">root</systemitem> user: Edit
485 <filename>/etc/ld.so.conf</filename> and add
486 <filename class="directory">/usr/X11R6/lib</filename>, then run:</para>
487
488<screen role="root"><userinput>ldconfig</userinput></screen>
489
490 <indexterm zone="xfree86 xfree86-config">
491 <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary>
492 </indexterm>
493
494 <para>Ensure <filename class="directory">/usr/X11R6/bin</filename>
495 and <filename class="directory">/usr/X11R6/lib/pkgconfig</filename>
496 are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar>
497 environment variables, respectively. Instructions for doing this are
498 described in the section <xref linkend='postlfs-config-profile'/>.</para>
499
500 <indexterm zone="xfree86 xfree86-config">
501 <primary sortas="e-etc-X11-XF86Config">/etc/X11/XF86Config</primary>
502 </indexterm>
503
504 <para>Create the <filename>XF86Config</filename> file with:</para>
505
506<screen><userinput>cd ~ &amp;&amp;
507XFree86 -configure</userinput></screen>
508
509 <para>The screen will go black and you may hear some clicking of the monitor.
510 This command will create a file, <filename>XF86Config.new</filename> in your
511 home directory.</para>
512
513 <para>Edit <filename>XF86Config.new</filename> to suit your system.
514 The details of the file are located in the man page <command>man
515 XF86Config</command>. Some things you may want to do are:</para>
516
517 <itemizedlist>
518 <listitem>
519 <para>Section "Files". Change the order of the font paths searched.
520 You may want to put 100dpi fonts ahead of 75dpi fonts if your system
521 normally comes up closer to 100 dots per inch. You may want to remove
522 some font directories completely.</para>
523 </listitem>
524 <listitem>
525 <para>Section "Module". If you are going to install NVidia
526 drivers, remove the "dri" line.</para>
527 </listitem>
528 <listitem>
529 <para>Sections "InputDevice". You may want to change the
530 keyboard autorepeat rate by adding
531 <option>Option "Autorepeat" "250 30"</option>.</para>
532 </listitem>
533 <listitem>
534 <para>Section "Monitor". Specify the <option>VertRefresh</option>
535 and <option>HorizSync</option> values if the system does not
536 automatically detect the monitor and its values.</para>
537 </listitem>
538 <listitem>
539 <para>Section "Device". You may want to set some of the options
540 available for your selected video driver. A description of the
541 driver parameters is in the man page for your driver.</para>
542 </listitem>
543 <listitem>
544 <para>Section "Screen". Add a DefaultDepth statement such as:
545 <option>DefaultDepth 24</option>. In the SubSection for your
546 default depth, add a modes line such as:
547 <option>Modes "1600x1200" "1280x1024" "1024x768"</option>. The
548 first mode listed will normally be the starting resolution.</para>
549 </listitem>
550 </itemizedlist>
551
552 <para>Test the system with:</para>
553
554<screen><userinput>XFree86 -xf86config ~/XF86Config.new</userinput></screen>
555
556 <para>You will only get a gray background with an X-shaped mouse cursor,
557 but it confirms the system is working. Exit with
558 <keycap>Control+Alt+Backspace</keycap>. If the system does not work,
559 examine <filename>/var/log/XFree86.0.log</filename> to see what went
560 wrong.</para>
561
562 <para>As the <systemitem class="username">root</systemitem> user:
563 move the configuration file to its final location:</para>
564
565<screen role="root"><userinput>mv ~/XF86Config.new /etc/X11/XF86Config</userinput></screen>
566
567 <para>Create <filename>.xinitrc</filename>:</para>
568
569<screen><userinput>cat &gt; ~/.xinitrc &lt;&lt; "EOF"
570<literal># Begin .xinitrc file
571xterm -g 80x40+0+0 &amp;
572xclock -g 100x100-0+0 &amp;
573twm</literal>
574EOF</userinput></screen>
575
576 <para>This provides an initial screen with an xterm and a clock that is
577 managed by a simple window manager, Tab Window Manager. For details of
578 <command>twm</command>, see the man page.</para>
579
580 <indexterm zone="xfree86 xfree86-config">
581 <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
582 </indexterm>
583
584 <note>
585 <para>When needed, <application>XFree86</application> creates the
586 directory <filename>/tmp/.ICE-unix</filename> if it does not exist.
587 If this directory is not owned by <systemitem
588 class="username">root</systemitem>, <application>XFree86</application>
589 delays startup by a few seconds and also appends a warning to the
590 logfile. This also affects startup of other applications. To improve
591 performance, it is advisable to manually create the directory before
592 <application>XFree86</application> uses it. Add the file creation to
593 <filename>/etc/sysconfig/createfiles</filename> that is sourced by
594 the <filename>/etc/rc.d/init.d/cleanfs</filename> startup script.</para>
595
596<screen role="root"><userinput>cat &gt;&gt; /etc/sysconfig/createfiles &lt;&lt; "EOF"
597<literal>/tmp/.ICE-unix dir 1777 root root</literal>
598EOF</userinput></screen>
599
600 </note>
601
602 <indexterm zone="xfree86 xfree86-config">
603 <primary
604 sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
605 </indexterm>
606
607 <para>Start <application>X</application> with:</para>
608
609<screen><userinput>startx</userinput></screen>
610
611 <para>to get a basic functional <application>X Window
612 System</application>.</para>
613
614 <para>At this point, you should check out <xref linkend='x-setup'/>
615 for the necessary configuration to make <application>X</application>
616 fully functional. Additionally, you can have a look at <xref
617 linkend='x-config'/> for information on fine tuning your
618 <application>X</application> configuration.</para>
619
620 </sect2>
621
622 <sect2 id="xfree86-contents" role="content"
623 xreflabel="XFree86 Contents and Descriptions">
624 <title>Contents</title>
625
626 <para>The <application>XFree86</application> package contains the
627 <application>X Window System</application> for Linux (and other operating
628 systems). It includes the <application>X</application> server, fonts,
629 <command>xterm</command>, a simple window manager (<command>twm</command>),
630 various utilities, video output drivers, and various input drivers
631 including the mouse and keyboard.</para>
632
633 <para><application>XFree86</application> also contains libraries and header
634 files for development of the <application>X Window System</application>
635 programs.</para>
636
637 <note>
638 <para>The following lists are not comprehensive. The full list of
639 programs is in <filename class="directory">/usr/X11R6/bin</filename>.
640 For additional information about these programs, see the respective
641 man page.</para>
642 </note>
643
644 <segmentedlist>
645 <segtitle>Installed Programs</segtitle>
646 <segtitle>Installed Libraries</segtitle>
647 <segtitle>Installed Directories</segtitle>
648
649 <seglistitem>
650 <seg>XFree86, xf86config, xf86cfg, startx, xinit, twm, xterm,
651 xwininfo, x11perf, xlsfonts, xvidtune, xload, xcalc, xclock,
652 oclock, and xmodmap</seg>
653 <seg>libGL.so, libGLU.so, libSM.so, libXi.so, libXrender.so,
654 libXt.so, and libXfont.so</seg>
655 <seg>/usr/X11R6/ and /etc/X11/</seg>
656 </seglistitem>
657 </segmentedlist>
658
659 <variablelist>
660 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
661 <?dbfo list-presentation="list"?>
662 <?dbhtml list-presentation="table"?>
663
664 <varlistentry id="XFree86">
665 <term><command>XFree86</command></term>
666 <listitem>
667 <para>is the X11R6 implementation of the <application>X Window
668 System</application> server.</para>
669 <indexterm zone="xfree86 XFree86">
670 <primary sortas="b-XFree86">XFree86</primary>
671 </indexterm>
672 </listitem>
673 </varlistentry>
674
675 <varlistentry id="xf86config">
676 <term><command>xf86config</command></term>
677 <listitem>
678 <para>is an interactive program for generating an
679 <filename>XF86Config</filename> file for use with
680 <application>XFree86</application> <application>X</application>
681 servers.</para>
682 <indexterm zone="xfree86 xf86config">
683 <primary sortas="b-xf86config">xf86config</primary>
684 </indexterm>
685 </listitem>
686 </varlistentry>
687
688 <varlistentry id="xf86cfg">
689 <term><command>xf86cfg</command></term>
690 <listitem>
691 <para>is a tool to configure <application>XFree86</application>
692 that can be used to either write the initial configuration file
693 or make customizations to the current configuration.</para>
694 <indexterm zone="xfree86 xf86cfg">
695 <primary sortas="b-xf86cfg">xf86cfg</primary>
696 </indexterm>
697 </listitem>
698 </varlistentry>
699
700 <varlistentry id="startx">
701 <term><command>startx</command></term>
702 <listitem>
703 <para>is a script to initialize the <application>X</application>
704 session. It runs <command>xinit</command>.</para>
705 <indexterm zone="xfree86 startx">
706 <primary sortas="b-startx">startx</primary>
707 </indexterm>
708 </listitem>
709 </varlistentry>
710
711 <varlistentry id="xinit">
712 <term><command>xinit</command></term>
713 <listitem>
714 <para>is used to start the <application>X Window
715 System</application> server.</para>
716 <indexterm zone="xfree86 xinit">
717 <primary sortas="b-xinit">xinit</primary>
718 </indexterm>
719 </listitem>
720 </varlistentry>
721
722 <varlistentry id="twm">
723 <term><command>twm</command></term>
724 <listitem>
725 <para>(Tab Window Manager) is a window manager included with the
726 <application>X Window System</application>.</para>
727 <indexterm zone="xfree86 twm">
728 <primary sortas="b-twm">twm</primary>
729 </indexterm>
730 </listitem>
731 </varlistentry>
732
733 <varlistentry id="xterm">
734 <term><command>xterm</command></term>
735 <listitem>
736 <para>is a terminal emulator for <application>X</application>.</para>
737 <indexterm zone="xfree86 xterm">
738 <primary sortas="b-xterm">xterm</primary>
739 </indexterm>
740 </listitem>
741 </varlistentry>
742
743 <varlistentry id="xwininfo">
744 <term><command>xwininfo</command></term>
745 <listitem>
746 <para>is a window information utility for
747 <application>X</application>.</para>
748 <indexterm zone="xfree86 xwininfo">
749 <primary sortas="b-xwininfo">xwininfo</primary>
750 </indexterm>
751 </listitem>
752 </varlistentry>
753
754 <varlistentry id="x11perf">
755 <term><command>x11perf</command></term>
756 <listitem>
757 <para>is an <application>X</application>11 server performance
758 test program.</para>
759 <indexterm zone="xfree86 x11perf">
760 <primary sortas="b-x11perf">x11perf</primary>
761 </indexterm>
762 </listitem>
763 </varlistentry>
764
765 <varlistentry id="xlsfonts">
766 <term><command>xlsfonts</command></term>
767 <listitem>
768 <para>is a program to list fonts available to the
769 <application>X</application> server.</para>
770 <indexterm zone="xfree86 xlsfonts">
771 <primary sortas="b-xlsfonts">xlsfonts</primary>
772 </indexterm>
773 </listitem>
774 </varlistentry>
775
776 <varlistentry id="xvidtune">
777 <term><command>xvidtune</command></term>
778 <listitem>
779 <para>is a video mode tuner for
780 <application>XFree86</application>.</para>
781 <indexterm zone="xfree86 xvidtune">
782 <primary sortas="b-xvidtune">xvidtune</primary>
783 </indexterm>
784 </listitem>
785 </varlistentry>
786
787 <varlistentry id="xload">
788 <term><command>xload</command></term>
789 <listitem>
790 <para> is a system load average display for
791 <application>X</application>.</para>
792 <indexterm zone="xfree86 xload">
793 <primary sortas="b-xload">xload</primary>
794 </indexterm>
795 </listitem>
796 </varlistentry>
797
798 <varlistentry id="xcalc">
799 <term><command>xcalc</command></term>
800 <listitem>
801 <para>is a scientific calculator for
802 <application>X</application>.</para>
803 <indexterm zone="xfree86 xcalc">
804 <primary sortas="b-xcalc">xcalc</primary>
805 </indexterm>
806 </listitem>
807 </varlistentry>
808
809 <varlistentry id="xclock">
810 <term><command>xclock</command></term>
811 <listitem>
812 <para>is a clock programs for <application>X</application>.</para>
813 <indexterm zone="xfree86 xclock">
814 <primary sortas="b-xclock">xclock</primary>
815 </indexterm>
816 </listitem>
817 </varlistentry>
818
819 <varlistentry id="oclock">
820 <term><command>oclock</command></term>
821 <listitem>
822 <para>is a clock programs for <application>X</application>.</para>
823 <indexterm zone="xfree86 oclock">
824 <primary sortas="b-oclock">oclock</primary>
825 </indexterm>
826 </listitem>
827 </varlistentry>
828
829 <varlistentry id="xmodmap">
830 <term><command>xmodmap</command></term>
831 <listitem>
832 <para>is a utility for modifying keymaps and pointer button
833 mappings in <application>X</application>.</para>
834 <indexterm zone="xfree86 xmodmap">
835 <primary sortas="b-xmodmap">xmodmap</primary>
836 </indexterm>
837 </listitem>
838 </varlistentry>
839
840 </variablelist>
841
842 </sect2>
843
844</sect1>
Note: See TracBrowser for help on using the repository browser.