source: x/installing/xfree86/xfree86-inst.xml@ c9bc781d

10.0 10.1 11.0 6.0 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk v5_1 xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since c9bc781d was c9bc781d, checked in by Bruce Dubbs <bdubbs@…>, 17 years ago

Grammar changes in xfree86

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

  • Property mode set to 100644
File size: 10.7 KB
Line 
1<sect2>
2<title>Installation of <application>XFree86</application></title>
3
4<sect3>
5<title>Kernel Compilation Settings</title>
6
7<para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is
8recommended that you compile <acronym>MTRR</acronym> (Memory Type Range
9Registers) support into the kernel. The kernel can map Cyrix and AMD
10<acronym>CPU</acronym>s to the <acronym>MTRR</acronym> interface, so selecting
11this option is useful for those processors also. This option is found in the
12"Processor type and features" menu. It can increase performance of image write
13operations 2.5 times or more on <acronym>PCI</acronym> or
14<acronym>AGP</acronym> video cards.</para>
15
16<para>In the "Character Devices" section, enable <acronym>AGP</acronym> Support and select the chipset
17support on your motherboard. If you do not know the chipset, you may select
18all the chip types at the expense of extra kernel size. You can usually
19determine your motherboard's chipset by doing:</para>
20<screen><userinput><command>cat /proc/pci</command></userinput></screen>
21
22<para>In the "Character Devices" section, <emphasis>disable</emphasis> Direct
23Rendering Manager unless you have a Direct Rendering Infrastructure
24(<acronym>DRI</acronym>)
25supported video card. A complete list of <acronym>DRI</acronym> supported video cards can
26be found at <ulink url="http://dri.sourceforge.net" /> in the Status section.
27Currently,
28supported cards include those from 3dfx (Voodoo, Banshee), 3Dlabs,
29ATI (Rage Pro, Rage 128,
30Radeon 7X00, Radeon 2), Intel (i810, i815), and Matrox (G200, G400, G450).
31If you do enable <acronym>DRI</acronym> here, make sure you select the video card(s) you want
32to support as a <emphasis>module</emphasis>.</para>
33
34<para>Additionally NVidia provides their own closed source binary drivers,
35which do not make use of <acronym>DRI</acronym>. If you intend to use these drivers,
36do not enable <acronym>DRI</acronym>.</para>
37
38<para>If you made any changes to the kernel configuration, recompile the kernel.</para>
39
40<para>Copy <filename>/usr/src/linux/arch/i386/boot/bzImage</filename> and
41<filename>/usr/src/linux/System.map</filename> to
42<filename>/boot</filename>, edit <filename>/etc/lilo.conf</filename>
43appropriately and run <filename>lilo</filename>. If you use
44<filename>grub</filename>, edit <filename>/boot/grub/grub.conf</filename>
45and add the new kernel to the boot menu.
46</para>
47
48<note><para>If you build <application>XFree86</application> in a chroot environment, make sure the kernel
49version of the base system and the target system are the same. This is
50especially important if you enabled <acronym>DRI</acronym> support as a module as
51instructed above.</para></note>
52
53</sect3>
54
55<sect3><title>Creating <filename>host.def</filename></title>
56
57<para>Although <application>XFree86</application> will compile without a
58<filename>host.def</filename> file, the following file
59is recommended for customizing the installation. Start from
60the <filename class="directory">xc</filename> directory.</para>
61
62<note><para>The <filename>host.def</filename> file is a
63<application>C</application> file, not the
64usual configuration file. If you make any changes, be sure the comment characters
65(<userinput>/*</userinput> and <userinput>*/</userinput>)
66are balanced. Most of the entries in the file below are
67commented out with the default settings shown.
68</para></note>
69
70<screen><userinput><command>cat &gt; config/cf/host.def &lt;&lt; "EOF"</command>
71/* Begin XFree86 host.def file */
72
73/* System Related Information. If you read and configure only one
74 * section then it should be this one. The Intel architecture defaults are
75 * set for a i686 and higher. Axp is for the Alpha architecture and Ppc is
76 * for the Power PC. Note that there have been reports that the Ppc
77 * optimization line causes segmentation faults during build. If that
78 * happens, try building without the DefaultGcc2PpcOpt line. **************/
79
80/* #define DefaultGcc2i386Opt -O2 -fomit-frame-pointer -march=i686 */
81/* #define DefaultGcc2AxpOpt -O2 -mcpu=ev6 */
82/* #define DefaultGcc2PpcOpt -O2 -mcpu=750 */
83
84/* The following definitions are normally set properly by XFree86's scripts.
85 * You can uncomment them if you want to make sure. ************************/
86
87/* #define HasMTRRSupport YES */ /* Enabled in kernel see kernel docs*/
88/* #define HasMMXSupport NO */ /* Any i586 or above */
89/* #define HasKatmaiSupport NO */ /* PIII SSE instructions */
90/* #define Has3DNowSupport NO */ /* AMD instructions */
91
92
93/* This setting reduces compile time a little by omitting rarely used input
94 * devices. You can find the complete list in config/cf/xfree86.cf ********/
95
96#define XInputDrivers mouse void
97
98/* VIDEO DRIVERS ***********************************************************/
99
100/* If you are sure you only want the drivers for one or a few video cards,
101 * you can delete the drivers you do not want. *****************************/
102
103
104#define XF86CardDrivers mga glint nv tga s3 s3virge sis rendition \
105 neomagic i740 tdfx savage \
106 cirrus vmware tseng trident chips apm \
107 GlideDriver fbdev i128 nsc \
108 ati i810 AgpGartDrivers DevelDrivers ark \
109 cyrix siliconmotion \
110 vesa vga \
111 dummy XF86OSCardDrivers XF86ExtraCardDrivers
112
113
114/* USER AND SYSTEM DEFAULT PATHS *******************************************/
115
116/* These settings set the PATH variables used by xdm. See README for *******/
117/* detailed description and modify the following as per your need. *********/
118
119/* #define DefaultSystemPath /usr/bin:/bin:/usr/sbin:/sbin:/usr/X11R6/bin */
120/* #define DefaultUserPath /usr/bin:/bin:/usr/X11R6/bin */
121
122/* FONT SERVER AND LIBRARY SETTINGS ****************************************/
123
124/* These settings are the defaults ***************************************/
125
126/* #define BuildFontServer YES */ /* For Ghostscript Print Server*/
127/* #define SharedLibFont YES */
128/* #define CompressAllFonts YES */
129/* #define GzipFontCompression YES */
130
131/* These settings ensure we use our libraries ******************************/
132#define HasFreetype2 YES
133#define HasFontconfig YES
134#define HasExpat YES
135#define HasLibpng YES
136#define HasZlib YES
137
138/* The font path can be redefined in the XF86Config file *******************/
139
140/*
141#define DefaultFontPath $(FONTDIR)/misc/,$(FONTDIR)/75dpi/,\
142$(FONTDIR)/100dpi/,$(FONTDIR)/Type1,$(FONTDIR)/local,\
143$(FONTDIR)/TrueType,$(FONTDIR)/CID,$(FONTDIR)/Speedo
144*/
145
146
147/* INTERNATIONAL FONTS. Change to YES if you need any of them. These are
148 * the defaults. ***********************************************************/
149
150/* #define BuildCyrillicFonts NO */
151/* #define BuildArabicFonts NO */
152/* #define BuildISO8859_6Fonts NO */
153/* #define BuildGreekFonts NO */
154/* #define BuildISO8859_7Fonts NO */
155/* #define BuildHebrewFonts NO */
156/* #define BuildISO8859_8Fonts NO */
157/* #define BuildKOI8_RFonts NO */
158/* #define BuildJapaneseFonts NO */
159/* #define BuildJISX0201Fonts NO */
160/* #define BuildKoreanFonts NO */
161/* #define BuildChineseFonts NO */
162
163/* DOCUMENTATION SETTINGS **************************************************/
164
165/* These setting are the defaults. *****************************************/
166
167/* #define BuildLinuxDocHtml NO */ /* X Docs in Html format */
168/* #define BuildLinuxDocPS NO */ /* PostScript format */
169/* #define BuildAllSpecsDocs NO */ /* Various docs */
170/* #define BuildHtmlManPages NO */
171
172/* GENERAL SETTINGS: You generally want to leave these alone when
173 * building X on an LFS system *********************************************/
174
175#define GccWarningOptions -pipe /* Speed up compiles */
176#define TermcapLibrary -lncurses
177#define XprtServer YES /* Needed by realplayer */
178#define XnestServer YES
179#define XAppLoadDir EtcX11Directory/app-defaults
180#define VarLibDir /var/lib
181#define XFree86Devel NO
182#define FSUseSyslog YES
183#define ThreadedX YES
184#define HasPam NO
185#define SystemManDirectory /usr/share/man /* Instead of /usr/man */
186#define HasLibCrypt YES
187#define InstallXinitConfig YES
188#define InstallXdmConfig YES
189#define ForceNormalLib YES
190#define BuildSpecsDocs NO
191
192/* End XFree86 host.def file */
193<command>EOF</command></userinput></screen>
194
195<para>Edit the file for your hardware and desires.</para>
196
197</sect3>
198
199<sect3>
200<title>Build Commands</title>
201<para>Install <application>XFree86</application> by running the following commands:</para>
202
203
204<screen><userinput><command>( make WORLDOPTS="" World 2&gt;&amp;1 | tee xfree-compile.log &amp;&amp; exit $PIPESTATUS ) &amp;&amp;
205make install &amp;&amp;
206make install.man &amp;&amp;
207ln -sf ../X11R6/bin /usr/bin/X11 &amp;&amp;
208ln -sf ../X11R6/lib/{X11,libGL.so{,.1}} /usr/lib &amp;&amp;
209ln -sf ../X11R6/include/{X11,GL} /usr/include</command></userinput></screen>
210
211</sect3>
212
213<sect3>
214<title>Updating Direct Rendering Infrastructure (<acronym>DRI</acronym>)</title>
215<para>If you have one of the supported <acronym>DRI</acronym> cards and
216have enabled <acronym>DRI</acronym> kernel modules as explained
217above, you now need to update the kernel modules to ensure they are compatible with the
218current version of <application>XFree86</application>. To do this, perform the following:</para>
219
220<screen><userinput><command>cd programs/Xserver/hw/xfree86/os-support/linux/drm/kernel &amp;&amp;
221make CC=/opt/gcc-2.95.3/bin/gcc -f Makefile.linux &amp;&amp;
222mkdir -p /lib/modules/`uname -r`/kernel/drivers/char/drm/ &amp;&amp;
223cp gamma.o radeon.o sis.o r128.o i810.o i830.o mga.o tdfx.o \
224 /lib/modules/`uname -r`/kernel/drivers/char/drm/ &amp;&amp;
225depmod -a</command></userinput></screen>
226
227<warning><para>If you recompile or upgrade your kernel, you will need to re-copy the
228appropriate driver module(s)
229to the kernel module library and rerun <command>depmod -a</command>.</para></warning>
230
231<note><para>If you created <acronym>AGP</acronym> support as a module when compiling the kernel, you may
232have to add a line to <filename>/etc/modules.conf</filename> to ensure
233the agpgart module is loaded. For instance, the <acronym>AGP</acronym> version of the Radeon video card
234will use the <filename>radeon.o</filename> driver. It will
235need to have the line <screen>below radeon agpgart</screen> in
236<filename>/etc/modules.conf</filename> to enable <acronym>DRI</acronym> support.</para></note>
237
238</sect3>
239</sect2>
Note: See TracBrowser for help on using the repository browser.