source: x/installing/xfree86.xml@ 29f1eea6

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

Updated to GNOME Magnifier-0.12.2; moved the creation of the xextensions.pc file from the GNOME Magnifier to the XFree86 instructions

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