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

10.0 10.1 11.0 11.1 11.2 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 krejzi/svn lazarus nosym perl-modules plabs/python-mods qt5new systemd-11177 systemd-13485 trunk upgradedb v5_1 v5_1-pre1 xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since bab4a94 was bab4a94, checked in by Igor Živković <igor@…>, 19 years ago

applied Simon's rewording of DRI section concerning NVidia drivers

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

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