Changeset 36c3ba1
- Timestamp:
- 05/19/2005 07:16:56 PM (19 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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, 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
- Children:
- 7d7bb83
- Parents:
- 06092fc
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
x/installing/xorg.xml
r06092fc r36c3ba1 14 14 15 15 <sect1 id="xorg" xreflabel="X.org-&xorg-version;"> 16 <sect1info> 17 <othername>$LastChangedBy$</othername> 18 <date>$Date$</date> 19 </sect1info> 20 21 <?dbhtml filename="xorg.html"?> 22 <title>Xorg-&xorg-version;</title> 23 24 <indexterm zone="xorg"> 25 <primary sortas="a-xorg">Xorg</primary> 26 </indexterm> 27 28 <sect2> 29 <title>Introduction to <application>Xorg</application></title> 30 31 <note><para>There are two packages in <acronym>BLFS</acronym> that implement 32 the <application>X</application> Window System: <application>Xorg</application> 33 and <application>XFree86</application>. These packages are quite similar. In 34 fact, the base system of <application>Xorg</application> is 35 <application>XFree86</application>-4.4.0RC2. The primary difference as of this 36 writing is the license provisions of the packages. For someone building a 37 package for their own use, these issues are not significant. Most large 38 commercial distributions have decided to use the 39 <application>Xorg</application> package, but several still use 40 <application>XFree86</application>.</para> 41 42 <para>A second reason for the forking of <application>X</application> packages 43 is the stated goals of the developers. Some developers were unhappy with the 44 administration and progress of <application>XFree86</application>. X.org's 45 future plans include significant improvements to the internals of the system 46 and more frequent releases.</para> 47 48 <para><application>XFree86</application> continues to be a solid, conservative 49 application with excellent driver support.</para> 50 51 <para>Both <application>Xorg</application> and 52 <application>XFree86</application> can be installed in the same way, but this 53 section will provide a slightly different and more current variation for 54 installation.</para> 55 </note> 56 57 <para><application>Xorg</application> is a freely redistributable open-source 58 implementation of the <application>X</application> Window System. This 59 application provides a client/server interface between display hardware (the 60 mouse, keyboard, and video displays) and the desktop environment, while also 61 providing both the windowing infrastructure and a standardized application 62 interface (<acronym>API</acronym>).</para> 63 64 <sect3><title>Package information</title> 65 <itemizedlist spacing='compact'> 66 <listitem><para>Download (HTTP): <ulink url="&xorg-download-http;"/></para></listitem> 67 <listitem><para>Download (FTP): <ulink url="&xorg-download-ftp;"/></para></listitem> 68 <listitem><para>Download MD5 sum: &xorg-md5sum;</para></listitem> 69 <listitem><para>Download size: &xorg-size;</para></listitem> 70 <listitem><para>Estimated disk space required: &xorg-buildsize;</para></listitem> 71 <listitem><para>Estimated build time: &xorg-time;</para></listitem> 72 </itemizedlist> 73 </sect3> 74 75 <sect3> 76 <title><application>Xorg</application> Dependencies</title> 77 78 <sect4> 79 <title>Required</title> 80 <para><xref linkend="libpng"/> and 81 <xref linkend="fontconfig"/></para> 82 </sect4> 83 84 <sect4> 85 <title>Optional</title> 86 <para><xref linkend="Linux_PAM"/></para> 87 </sect4> 88 89 </sect3> 90 91 <sect3><title>Download Instructions</title> 92 93 <para>As an alternative to downloading the entire source tree in a single 94 file, there are several files that need to be fetched from the download 95 location (directory /pub/x.org/pub/X11R&xorg-version;/src/):</para> 96 97 <itemizedlist spacing='compact'> 98 <listitem><para><filename>X11R&xorg-version;-src1.tar.gz</filename></para></listitem> 99 <listitem><para><filename>X11R&xorg-version;-src2.tar.gz</filename></para></listitem> 100 <listitem><para><filename>X11R&xorg-version;-src3.tar.gz</filename></para></listitem> 101 <listitem><para><filename>X11R&xorg-version;-src4.tar.gz</filename></para></listitem> 102 <listitem><para><filename>X11R&xorg-version;-src5.tar.gz</filename></para></listitem> 103 <listitem><para><filename>X11R&xorg-version;-src6.tar.gz</filename></para></listitem> 104 <listitem><para><filename>X11R&xorg-version;-src7.tar.gz</filename></para></listitem> 105 </itemizedlist> 106 107 <para>The first package contains the <application>Xorg</application> libraries 108 and support programs, the second contains standard <application>X</application> 109 programs, the third contains the <application>X</application> server, the 110 fourth and fifth are fonts, the sixth is normal documentation, and the seventh 111 is hardcopy documentation.</para> 112 113 <para>To check your file for integrity, download the 114 <filename>md5sums</filename> file. Then:</para> 115 116 <screen><userinput><command>md5sum -c md5sums</command></userinput></screen> 117 118 <para>The package (or all seven packages) should give an OK status.</para> 119 </sect3> 120 </sect2> 121 122 <sect2> 123 <title>Installation of <application>Xorg</application></title> 124 125 <sect3 id='xorg-kernel'> 126 <title>Kernel Compilation Settings</title> 127 128 <indexterm zone="xorg xorg-kernel"> 129 <primary sortas="d-Xorg">Xorg</primary></indexterm> 130 131 <para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is 132 recommended that you compile <acronym>MTRR</acronym> (Memory Type Range 133 Registers) support into the kernel. The kernel can map Cyrix and AMD 134 <acronym>CPU</acronym>s to the <acronym>MTRR</acronym> interface, so selecting 135 this option is useful for those processors also. This option is found in the 136 "Processor type and features" menu. It can increase performance of 137 image write operations 2.5 times or more on <acronym>PCI</acronym> or 138 <acronym>AGP</acronym> video cards. 139 </para> 140 141 <para>In the "Character Devices" section, enable <acronym>AGP</acronym> Support 142 and select the chipset support on your motherboard. If you do not know the 143 chipset, you may select all the chip types at the expense of extra kernel size. 16 <?dbhtml filename="xorg.html"?> 17 18 <sect1info> 19 <othername>$LastChangedBy$</othername> 20 <date>$Date$</date> 21 </sect1info> 22 23 <title>Xorg-&xorg-version;</title> 24 25 <indexterm zone="xorg"> 26 <primary sortas="a-xorg">Xorg</primary> 27 </indexterm> 28 29 <sect2 role="package"> 30 <title>Introduction to Xorg</title> 31 32 <note> 33 <para>There are two packages in BLFS that implement the <application>X 34 Window System</application>: <application>Xorg</application> and 35 <application>XFree86</application>. These packages are quite similar. 36 In fact, the base system of <application>Xorg</application> is 37 <application>XFree86</application>-4.4.0RC2. The primary difference as 38 of this writing is the license provisions of the packages. For someone 39 building a package for their own use, these issues are not significant. 40 Most large commercial distributions have decided to use the 41 <application>Xorg</application> package, but several still use 42 <application>XFree86</application>.</para> 43 44 <para>A second reason for the forking of <application>X</application> 45 packages is the stated goals of the developers. Some developers were 46 unhappy with the administration and progress of 47 <application>XFree86</application>. X.org's future plans include 48 significant improvements to the internals of the system and more frequent 49 releases.</para> 50 51 <para><application>XFree86</application> continues to be a solid, 52 conservative application with excellent driver support.</para> 53 54 <para>Both <application>Xorg</application> and 55 <application>XFree86</application> can be installed in the same way, 56 but this section will provide a slightly different and more current 57 variation for installation.</para> 58 </note> 59 60 <para><application>Xorg</application> is a freely redistributable open-source 61 implementation of the <application>X</application> Window System. This 62 application provides a client/server interface between display hardware (the 63 mouse, keyboard, and video displays) and the desktop environment, while also 64 providing both the windowing infrastructure and a standardized application 65 interface (API).</para> 66 67 <bridgehead renderas="sect3">Package Information</bridgehead> 68 <itemizedlist spacing="compact"> 69 <listitem> 70 <para>Download (HTTP): <ulink url="&xorg-download-http;"/></para> 71 </listitem> 72 <listitem> 73 <para>Download (FTP): <ulink url="&xorg-download-ftp;"/></para> 74 </listitem> 75 <listitem> 76 <para>Download MD5 sum: &xorg-md5sum;</para> 77 </listitem> 78 <listitem> 79 <para>Download size: &xorg-size;</para> 80 </listitem> 81 <listitem> 82 <para>Estimated disk space required: &xorg-buildsize;</para> 83 </listitem> 84 <listitem> 85 <para>Estimated build time: &xorg-time;</para> 86 </listitem> 87 </itemizedlist> 88 89 <bridgehead renderas="sect3">TEMPLATE Dependencies</bridgehead> 90 91 <bridgehead renderas="sect4">Required</bridgehead> 92 <para><xref linkend="libpng"/> and 93 <xref linkend="fontconfig"/></para> 94 95 <bridgehead renderas="sect4">Optional</bridgehead> 96 <para><xref linkend="Linux_PAM"/></para> 97 98 <bridgehead renderas="sect3">Download Instructions</bridgehead> 99 100 <para>As an alternative to downloading the entire source tree in a single 101 file, there are several files that need to be fetched from the download 102 location (directory /pub/x.org/pub/X11R&xorg-version;/src/):</para> 103 104 <itemizedlist spacing='compact'> 105 <listitem> 106 <para><filename>X11R&xorg-version;-src1.tar.gz</filename></para> 107 </listitem> 108 <listitem> 109 <para><filename>X11R&xorg-version;-src2.tar.gz</filename></para> 110 </listitem> 111 <listitem> 112 <para><filename>X11R&xorg-version;-src3.tar.gz</filename></para> 113 </listitem> 114 <listitem> 115 <para><filename>X11R&xorg-version;-src4.tar.gz</filename></para> 116 </listitem> 117 <listitem> 118 <para><filename>X11R&xorg-version;-src5.tar.gz</filename></para> 119 </listitem> 120 <listitem> 121 <para><filename>X11R&xorg-version;-src6.tar.gz</filename></para> 122 </listitem> 123 <listitem> 124 <para><filename>X11R&xorg-version;-src7.tar.gz</filename></para> 125 </listitem> 126 </itemizedlist> 127 128 <para>The first package contains the <application>Xorg</application> 129 libraries and support programs, the second contains standard 130 <application>X</application> programs, the third contains the 131 <application>X</application> server, the fourth and fifth are fonts, 132 the sixth is normal documentation, and the seventh is hardcopy 133 documentation.</para> 134 135 <para>To check your file for integrity, download the 136 <filename>md5sums</filename> file. Then:</para> 137 138 <screen><userinput>md5sum -c md5sums</userinput></screen> 139 140 <para>The package (or all seven packages) should give an OK status.</para> 141 142 </sect2> 143 144 <sect2 role="kernel" id='xorg-kernel'> 145 <title>Kernel Configuration</title> 146 147 <indexterm zone="xorg xorg-kernel"> 148 <primary sortas="d-Xorg">Xorg</primary> 149 </indexterm> 150 151 <para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is 152 recommended that you compile MTRR (Memory Type Range Registers) support 153 into the kernel. The kernel can map Cyrix and AMD CPUs to the MTRR 154 interface, so selecting this option is useful for those processors also. 155 This option is found in the "Processor type and features" menu. It can 156 increase performance of image write operations 2.5 times or more on PCI or 157 AGP video cards.</para> 158 159 <para>In the "Character Devices" section, enable AGP Support and select 160 the chipset support on your motherboard. If you do not know the chipset, 161 you may select all the chip types at the expense of extra kernel size. 144 162 You can usually determine your motherboard's chipset by running the command 145 <command>lspci</command>, a program from the <xref linkend="pciutils"/> 146 package. 147 </para> 148 149 <para>In the "Character Devices" section, <emphasis>disable</emphasis> Direct 150 Rendering Manager unless you have a Direct Rendering Infrastructure 151 (<acronym>DRI</acronym>) supported video card. A complete list of 152 <acronym>DRI</acronym> supported video cards can be found at 153 <ulink url="http://dri.sourceforge.net" /> in the "Status" section. 154 Currently, supported cards include those from 3dfx (Voodoo, Banshee), 3Dlabs, 155 ATI (Rage Pro, Rage 128, Radeon 7X00, Radeon 2), Intel (i810, i815), and 156 Matrox (G200, G400, G450). 157 </para> 158 159 <para>Additionally NVidia provides their own closed source binary drivers, 160 which do not make use of <acronym>DRI</acronym>. If you intend to use these 161 drivers, do not enable <acronym>DRI</acronym>. 162 </para> 163 164 <para>If you made any changes to the kernel configuration, recompile and 165 install the new kernel. 166 </para> 167 168 </sect3> 169 170 <sect3> 171 <title>Suppressing Xprint-related modification to <filename class="directory">/etc</filename></title> 172 173 <para><application>Xorg</application> insists on putting 174 its boot and profile scripts into the <filename 175 class="directory">/etc</filename> directory even if specifically told 176 not to compile anything Xprint server or client related (see 177 <filename>host.def</filename> below). The following command will 178 suppress any such modifications: 179 </para> 180 181 <screen><userinput><command>sed -i '/^SUBDIRS =/s/ etc$//' programs/Xserver/Xprint/Imakefile</command></userinput></screen> 182 183 </sect3> 184 185 <sect3> 186 <title>Setting Up a Shadow Directory</title> 187 188 <para>When building <application>Xorg</application>, you should create a shadow 189 directory of symbolic links for the compiled code. To do that, first make 190 <command>lndir</command>. Starting from the 191 <filename class='directory'>xc</filename> directory: 192 </para> 193 194 <screen><userinput><command>pushd config/util && 195 make -f Makefile.ini lndir</command></userinput></screen> 196 197 <para>Now, as the root user:</para> 198 199 <screen><userinput role='root'><command>cp lndir /usr/bin/</command></userinput></screen> 200 201 <para>And back as a regular user:</para> 202 <screen><userinput><command>popd</command></userinput></screen> 203 204 <para>Now create the shadow tree:</para> 205 206 <screen><userinput><command>mkdir ../xcbuild && 163 <command>lspci</command>, a program from the <xref linkend="pciutils"/> 164 package.</para> 165 166 <para>In the "Character Devices" section, <emphasis>disable</emphasis> 167 Direct Rendering Manager unless you have a Direct Rendering Infrastructure 168 (DRI) supported video card. A complete list of DRI supported video cards 169 can be found at <ulink url="http://dri.sourceforge.net" /> in the "Status" 170 section. Currently, supported cards include those from 3dfx (Voodoo, 171 Banshee), 3Dlabs, ATI (Rage Pro, Rage 128, Radeon 7X00, Radeon 2), Intel 172 (i810, i815), and Matrox (G200, G400, G450).</para> 173 174 <para>Additionally NVidia provides their own closed source binary drivers, 175 which do not make use of DRI. If you intend to use these drivers, do not 176 enable DRI.</para> 177 178 <para>If you made any changes to the kernel configuration, recompile and 179 install the new kernel.</para> 180 181 </sect2> 182 183 <sect2 role="installation"> 184 <title>Installation of Xorg</title> 185 186 <sect3> 187 <title>Suppressing Xprint-related Modification to '/etc'</title> 188 189 <para><application>Xorg</application> insists on putting 190 its boot and profile scripts into the <filename 191 class="directory">/etc</filename> directory even if specifically told 192 not to compile anything Xprint server or client related (see 193 <filename>host.def</filename> below). The following command will 194 suppress any such modifications:</para> 195 196 <screen><userinput>sed -i '/^SUBDIRS =/s/ etc$//' programs/Xserver/Xprint/Imakefile</userinput></screen> 197 198 </sect3> 199 200 <sect3> 201 <title>Setting Up a Shadow Directory</title> 202 203 <para>When building <application>Xorg</application>, you should create 204 a shadow directory of symbolic links for the compiled code. To do that, 205 first make <command>lndir</command>. Starting from the 206 <filename class='directory'>xc</filename> directory:</para> 207 208 <screen><userinput>pushd config/util && 209 make -f Makefile.ini lndir</userinput></screen> 210 211 <para>Now, as the <systemitem class="username">root</systemitem> 212 user:</para> 213 214 <screen role="root"><userinput>cp -v lndir /usr/bin/</userinput></screen> 215 216 <para>And back as a regular user:</para> 217 218 <screen><userinput>popd</userinput></screen> 219 220 <para>Now create the shadow tree:</para> 221 222 <screen><userinput>mkdir ../xcbuild && 207 223 cd ../xcbuild && 208 lndir ../xc</command></userinput></screen> 209 </sect3> 210 211 <sect3> 212 <title>Creating <filename>host.def</filename></title> 213 214 <para>The next step is to create the <filename>config/cf/host.def</filename> 215 file. The documentation for <application>Xorg</application> indicates that the 216 application will build without a <filename>host.def</filename> file, but 217 the included libraries for <application>Fontconfig</application> and 218 <application>FreeType2</application> do not build properly on a base 219 <acronym>LFS</acronym> system. Therefore, you must specify that these 220 libraries, as well as others, should be imported from the system. 221 </para> 222 223 <note><para><filename>config/cf/host.def</filename> is a C file, not a shell 224 script. Ensure the comments delimited by <userinput>/*</userinput> ... 225 <userinput>*/</userinput> are balanced when modifying the file.</para> 226 </note> 227 228 <screen><userinput><command>cat > config/cf/host.def << "EOF"</command> 229 /* Begin Xorg host.def file */ 230 224 lndir ../xc</userinput></screen> 225 226 </sect3> 227 228 <sect3> 229 <title>Creating 'host.def'</title> 230 231 <para>The next step is to create the 232 <filename>config/cf/host.def</filename> file. The documentation for 233 <application>Xorg</application> indicates that the application will 234 build without a <filename>host.def</filename> file, but the included 235 libraries for <application>Fontconfig</application> and 236 <application>FreeType2</application> do not build properly on a base 237 LFS system. Therefore, you must specify that these libraries, as well 238 as others, should be imported from the system.</para> 239 240 <note> 241 <para><filename>config/cf/host.def</filename> is a C file, not a 242 shell script. Ensure the comments delimited by /* ... */ are balanced 243 when modifying the file.</para> 244 </note> 245 246 <screen><userinput>cat > config/cf/host.def << "EOF" 247 <literal>/* Begin Xorg host.def file */ 248 231 249 /* System Related Information. If you read and configure only one 232 * section then it should be this one. The Intel architecture defaults 233 * are set for a i686 and higher. Axp is for the Alpha architecture 234 * and Ppc is for the Power PC. AMD64 is for the Opteron processor. 235 * Note that there have been reports that the Ppc optimization line 236 * causes segmentation faults during build. If that happens, try 250 * section then it should be this one. The Intel architecture defaults 251 * are set for a i686 and higher. Axp is for the Alpha architecture 252 * and Ppc is for the Power PC. AMD64 is for the Opteron processor. 253 * Note that there have been reports that the Ppc optimization line 254 * causes segmentation faults during build. If that happens, try 237 255 * building without the DefaultGcc2PpcOpt line. ***********/ 238 256 239 257 /* #define DefaultGcc2i386Opt -O2 -fno-strength-reduce \ 240 258 -fno-strict-aliasing -march=i686 */ … … 251 269 252 270 /* 253 * Which drivers to build. When building a static server, each of 254 * these will be included in it. When building the loadable server 271 * Which drivers to build. When building a static server, each of 272 * these will be included in it. When building the loadable server 255 273 * each of these modules will be built. 256 274 * … … 285 303 #define BuildXprintClients NO 286 304 287 /* End Xorg host.def file */ 288 <command>EOF</command></userinput></screen> 289 290 <para>There are several other options that you may want to consider. A well 291 documented example file is <filename>config/cf/xorgsite.def</filename>. 292 </para> 293 294 </sect3> 295 296 <sect3> 297 <title>Build Commands</title> 298 299 <para>Install <application>Xorg</application> by running the following commands:</para> 300 301 <screen><userinput><command>sed -i -e "s@^#include <linux/config.h>@/* & */@" \ 305 /* End Xorg host.def file */</literal> 306 EOF</userinput></screen> 307 308 <para>There are several other options that you may want to consider. 309 A well documented example file is 310 <filename>config/cf/xorgsite.def</filename>.</para> 311 312 </sect3> 313 314 <sect3> 315 <title>Build Commands</title> 316 317 <para>Install <application>Xorg</application> by running the 318 following commands:</para> 319 320 <screen><userinput>sed -i -e "s@^#include <linux/config.h>@/* & */@" \ 302 321 `grep -lr linux/config.h *` && 303 ( make World 2>&1 | tee xorg-compile.log && exit $PIPESTATUS )</command></userinput></screen> 304 305 <para>Again as the root user:</para> 306 307 <screen><userinput role='root'><command>make install && 322 ( make World 2>&1 | tee xorg-compile.log && exit $PIPESTATUS )</userinput></screen> 323 324 <para>Again as the <systemitem class="username">root</systemitem> 325 user:</para> 326 327 <screen role="root"><userinput>make install && 308 328 make install.man && 309 ln -sf ../X11R6/bin /usr/bin/X11 && 310 ln -sf ../X11R6/lib/X11 /usr/lib/X11 && 311 ln -sf ../X11R6/include/X11 /usr/include/X11</command></userinput></screen> 312 313 </sect3> 314 </sect2> 315 316 <sect2> 317 <title>Command explanations</title> 318 319 <para><command>sed -i -e "s@^#include <linux/config.h>@...</command>: 329 ln -v -sf ../X11R6/bin /usr/bin/X11 && 330 ln -v -sf ../X11R6/lib/X11 /usr/lib/X11 && 331 ln -v -sf ../X11R6/include/X11 /usr/include/X11</userinput></screen> 332 333 </sect3> 334 335 </sect2> 336 337 <sect2 role="commands"> 338 <title>Command Explanations</title> 339 340 <para><command>sed -i -e "s@^#include <linux/config.h>@...</command>: 320 341 The <application>Linux-Libc-Headers</application> package installed in 321 <acronym>LFS</acronym> installs a 322 <filename>/usr/include/linux/config.h</filename> file which is not compatible 323 with userspace applications. The recommended fix for applications including 324 this file is to remove it (see <ulink 342 LFS installs a <filename>/usr/include/linux/config.h</filename> file 343 which is not compatible with userspace applications. The recommended fix 344 for applications including this file is to remove it (see <ulink 325 345 url="http://ep09.pld-linux.org/~mmazur/linux-libc-headers/doc/FAQ"> 326 346 linux-libc-headers FAQ</ulink>). The <command>sed</command> uses 327 347 <command>grep -lr</command> to replace all occurences. If you desire, just 328 348 remove (comment) the line in the appropriate video driver file if you 329 customized <filename>host.def</filename>. 330 </para> 331 332 <para><command>( make World 2>&1 | tee xorg-compile.log 333 && exit $PIPESTATUS )</command>: 334 This command runs multiple <filename>Makefile</filename>s to completely rebuild 335 the system. <parameter>2>&1</parameter> redirects error messages 336 to the same location as standard output. The <command>tee</command> command 337 allows viewing of the output while logging the results to a file. The 338 parentheses around the command runs the entire comand in a subshell and finally 339 the <command>exit $PIPESTATUS</command> ensures the result of the 340 <command>make</command> is returned as the result and not the result of the 341 <command>tee</command> command. 342 </para> 343 344 <note><para>When rebuilding <application>Xorg</application>, a separate command 345 that may be used if only minor changes are made to the sources is 346 <command>make Everything</command>. This does not automatically remove generated 347 files and only rebuilds those files or programs that are out of date.</para> 348 </note> 349 350 <para><screen><command>ln -sf ../X11R6/bin /usr/bin/X11 351 ln -sf ../X11R6/lib/X11 /usr/lib/X11 352 ln -sf ../X11R6/include/X11 /usr/include/X11</command></screen> 353 These commands are present to enable other (broken) packages to build against 354 <application>Xorg</application>, even though the Filesystem Hierarchy Standard 355 says: "In general, software must not be installed or managed via the above 356 symbolic links. They are intended for utilization by users only."</para> 357 358 </sect2> 359 360 <sect2 id='xorg-config'> 361 <title>Configuring Xorg</title> 362 363 <para>Edit <filename>/etc/ld.so.conf</filename> and add 364 <filename class="directory">/usr/X11R6/lib</filename>. Run: 365 </para> 366 367 <indexterm zone="xorg xorg-config"> 368 <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary> 369 </indexterm> 370 371 <screen><userinput><command>ldconfig</command></userinput></screen> 372 373 <para>Ensure <filename class="directory">/usr/X11R6/bin</filename> 374 and <filename class="directory">/usr/X11R6/lib/pkgconfig</filename> 375 are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar> 376 environment variables, respectively. Instructions for doing this are 377 described in the section "<xref linkend='postlfs-config-profile'/>."</para> 378 379 <para>Create the <filename>xorg.conf</filename> file with: 380 <screen><userinput><command>cd ~ 381 Xorg -configure</command></userinput></screen> 382 The screen will go black and you may hear some clicking of the monitor. This 383 command will create a file, <filename>xorg.conf.new</filename> in your home 384 directory.</para> 385 386 <indexterm zone="xorg xorg-config"> 387 <primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary> 388 </indexterm> 389 390 <para>Edit <filename>xorg.conf.new</filename> to suit your system. The details 391 of the file are located in the xorg.conf man page. Some 392 things you may want to do are:</para> 393 394 <itemizedlist> 395 396 <listitem><para>Section "Files". Change the order of the font paths searched. 397 You may want to put 100dpi fonts ahead of 75dpi fonts if your system normally 398 comes up closer to 100 dots per inch. You may want to remove some font 399 directories completely.</para></listitem> 400 401 <listitem><para>Section "Module". If you are going to install NVidia 402 drivers, remove the "dri" line.</para></listitem> 403 404 <listitem><para>Sections "InputDevice". You may want to change the 405 keyboard autorepeat rate by adding 406 <parameter>Option "Autorepeat" "250 30"</parameter>.</para></listitem> 407 408 <listitem><para>Section "Monitor". Specify the 409 <parameter>VertRefresh</parameter> and <parameter>HorizSync</parameter> values 410 if the system does not automatically detect the monitor and its values.</para> 411 </listitem> 412 413 <listitem><para>Section "Device". You may want to set some of the options 414 available for your selected video driver. A description of the driver 415 parameters is in the man page for your driver.</para></listitem> 416 417 <listitem><para>Section "Screen". Add a DefaultDepth statement such as: 418 <parameter>DefaultDepth 24</parameter>. In the SubSection for your default 419 depth, add a modes line such as: 420 <parameter>Modes "1600x1200" "1280x1024" "1024x768"</parameter>. The first mode listed 421 will normally be the starting resolution.</para></listitem> 422 423 </itemizedlist> 424 425 <para>Test the system with: 426 <screen><userinput><command>X -config ~/xorg.conf.new</command></userinput></screen> 427 You will only get a gray background with an X-shaped mouse cursor, but it 428 confirms the system is working. Exit with Control-Alt-Backspace. If the 429 system does not work, take a look at <filename>/var/log/Xorg.0.log</filename> 430 to see what went wrong.</para> 431 432 <para>Move the configuration file to its final location:</para> 433 <screen><userinput><command>mv ~/xorg.conf.new /etc/X11/xorg.conf</command></userinput></screen> 434 435 <para>Create <filename>.xinitrc</filename>: 436 <screen><userinput><command>cat > ~/.xinitrc << "EOF"</command> 437 # Begin .xinitrc file 349 customized <filename>host.def</filename>.</para> 350 351 <para><command>( make World 2>&1 | tee xorg-compile.log 352 && exit $PIPESTATUS )</command>: This command runs multiple 353 <filename>Makefile</filename>s to completely rebuild the system. 354 <parameter>2>&1</parameter> redirects error messages to the 355 same location as standard output. The <command>tee</command> command 356 allows viewing of the output while logging the results to a file. The 357 parentheses around the command runs the entire comand in a subshell 358 and finally the <command>exit $PIPESTATUS</command> ensures the result 359 of the <command>make</command> is returned as the result and not the 360 result of the <command>tee</command> command.</para> 361 362 <note> 363 <para>When rebuilding <application>Xorg</application>, a separate 364 command that may be used if only minor changes are made to the sources 365 is <command>make Everything</command>. This does not automatically 366 remove generated files and only rebuilds those files or programs that 367 are out of date.</para> 368 </note> 369 370 <para><command>ln -v -sf ...</command>: These commands are present to 371 enable other (broken) packages to build against 372 <application>Xorg</application>, even though the Filesystem Hierarchy 373 Standard says: <quote>In general, software must not be installed or 374 managed via the above symbolic links. They are intended for utilization 375 by users only.</quote></para> 376 377 </sect2> 378 379 <sect2 role="configuration" id='xorg-config'> 380 <title>Configuring Xorg</title> 381 382 <para>Edit <filename>/etc/ld.so.conf</filename> and add 383 <filename class="directory">/usr/X11R6/lib</filename>. Run:</para> 384 385 <indexterm zone="xorg xorg-config"> 386 <primary sortas="e-etc-ld.so.conf">/etc/ld.so.conf</primary> 387 </indexterm> 388 389 <screen role="root"><userinput>ldconfig</userinput></screen> 390 391 <para>Ensure <filename class="directory">/usr/X11R6/bin</filename> 392 and <filename class="directory">/usr/X11R6/lib/pkgconfig</filename> 393 are added to your <envar>PATH</envar> and <envar>PKG_CONFIG_PATH</envar> 394 environment variables, respectively. Instructions for doing this are 395 described in the section <xref linkend='postlfs-config-profile'/>.</para> 396 397 <para>Create the <filename>xorg.conf</filename> file with:</para> 398 399 <screen><userinput>cd ~r && 400 Xorg -configure</userinput></screen> 401 402 <para>The screen will go black and you may hear some clicking of the monitor. 403 This command will create a file, <filename>xorg.conf.new</filename> in your 404 home directory.</para> 405 406 <indexterm zone="xorg xorg-config"> 407 <primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary> 408 </indexterm> 409 410 <para>Edit <filename>xorg.conf.new</filename> to suit your system. The 411 details of the file are located in the xorg.conf man page. Some things 412 you may want to do are:</para> 413 414 <itemizedlist> 415 <listitem> 416 <para>Section "Files". Change the order of the font paths searched. 417 You may want to put 100dpi fonts ahead of 75dpi fonts if your system 418 normally comes up closer to 100 dots per inch. You may want to remove 419 some font directories completely.</para> 420 </listitem> 421 <listitem> 422 <para>Section "Module". If you are going to install NVidia 423 drivers, remove the "dri" line.</para> 424 </listitem> 425 <listitem> 426 <para>Sections "InputDevice". You may want to change the 427 keyboard autorepeat rate by adding 428 <option>Option "Autorepeat" "250 30"</option>.</para> 429 </listitem> 430 <listitem> 431 <para>Section "Monitor". Specify the <option>VertRefresh</option> 432 and <option>HorizSync</option> values if the system does not 433 automatically detect the monitor and its values.</para> 434 </listitem> 435 <listitem> 436 <para>Section "Device". You may want to set some of the options 437 available for your selected video driver. A description of the driver 438 parameters is in the man page for your driver.</para> 439 </listitem> 440 <listitem><para>Section "Screen". Add a DefaultDepth statement such as: 441 <option>DefaultDepth 24</option>. In the SubSection for your 442 default depth, add a modes line such as: 443 <option>Modes "1600x1200" "1280x1024" "1024x768"</option>. The first 444 mode listed will normally be the starting resolution.</para> 445 </listitem> 446 </itemizedlist> 447 448 <para>Test the system with:</para> 449 450 <screen><userinput>X -config ~/xorg.conf.new</userinput></screen> 451 452 <para>You will only get a gray background with an X-shaped mouse cursor, 453 but it confirms the system is working. Exit with 454 <keycap>Control+Alt+Backspace</keycap>. If the system does not work, take 455 a look at <filename>/var/log/Xorg.0.log</filename> to see what went 456 wrong.</para> 457 458 <para>Move the configuration file to its final location:</para> 459 460 <screen role="root"><userinput>mv ~/xorg.conf.new /etc/X11/xorg.conf</userinput></screen> 461 462 <para>Create <filename>.xinitrc</filename>:</para> 463 464 <screen><userinput>cat > ~/.xinitrc << "EOF" 465 <literal># Begin .xinitrc file 438 466 xterm -g 80x40+0+0 & 439 467 xclock -g 100x100-0+0 & 440 twm 441 <command>EOF</command></userinput></screen> 442 This provides an initial screen with an xterm and a clock that is managed by a 443 simple window manager, Tab Window Manager. For details of 444 <command>twm</command>, see the man page.</para> 445 446 <indexterm zone="xorg xorg-config"> 447 <primary sortas="e-AA.xinitrc">~/.xinitrc</primary> 448 </indexterm> 449 450 <note> 451 <para>When needed, <application>Xorg</application> creates the directory 452 <filename>/tmp/.ICE-unix</filename> if it does not exist. If this directory is 453 not owned by root, <application>Xorg</application> delays startup by a few 454 seconds and also appends a warning to the logfile. This also affects startup of 455 other applications. To improve performance, it is advisable to manually create 456 the directory before <application>Xorg</application> uses it. Add the file 457 creation to <filename>/etc/sysconfig/createfiles</filename> that is sourced by 458 the <filename>/etc/rc.d/init.d/cleanfs</filename> startup script.</para> 459 460 <screen><userinput role='root'><command>cat >> /etc/sysconfig/createfiles << "EOF"</command> 461 /tmp/.ICE-unix dir 1777 root root 462 <command>EOF</command></userinput></screen> 463 </note> 464 465 <indexterm zone="xorg xorg-config"> 466 <primary sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary> 467 </indexterm> 468 469 <para>Start <application>X</application> with: 470 <screen><userinput><command>startx</command></userinput></screen> 471 to get a basic functional <application>X</application> Window System.</para> 472 473 <para>At this point, you should check out <xref linkend='x-setup'/> for the 474 necessary configuration to make <application>X</application> fully functional. 475 Additionally, you can have a look at <xref linkend='x-config'/> for 476 information on fine tuning your <application>X</application> 477 configuration.</para> 478 479 <para>For a list of the package contents and a description of the commands, 480 see the sections in the <xref linkend='xfree86-contents'/>.</para> 481 482 </sect2> 468 twm</literal> 469 EOF</userinput></screen> 470 471 <para>This provides an initial screen with an xterm and a clock that is 472 managed by a simple window manager, Tab Window Manager. For details of 473 <command>twm</command>, see the man page.</para> 474 475 <indexterm zone="xorg xorg-config"> 476 <primary sortas="e-AA.xinitrc">~/.xinitrc</primary> 477 </indexterm> 478 479 <note> 480 <para>When needed, <application>Xorg</application> creates the directory 481 <filename>/tmp/.ICE-unix</filename> if it does not exist. If this 482 directory is not owned by <systemitem class="username">root</systemitem>, 483 <application>Xorg</application> delays startup by a few seconds and also 484 appends a warning to the logfile. This also affects startup of other 485 applications. To improve performance, it is advisable to manually create 486 the directory before <application>Xorg</application> uses it. Add the 487 file creation to <filename>/etc/sysconfig/createfiles</filename> that is 488 sourced by the <filename>/etc/rc.d/init.d/cleanfs</filename> startup 489 script.</para> 490 491 <screen role="root"><userinput>cat >> /etc/sysconfig/createfiles << "EOF" 492 <literal>/tmp/.ICE-unix dir 1777 root root</literal> 493 EOF</userinput></screen> 494 495 </note> 496 497 <indexterm zone="xorg xorg-config"> 498 <primary 499 sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary> 500 </indexterm> 501 502 <para>Start <application>X</application> with:</para> 503 504 <screen><userinput>startx</userinput></screen> 505 506 <para>to get a basic functional <application>X Window 507 System</application>.</para> 508 509 <para>At this point, you should check out <xref linkend='x-setup'/> for 510 the necessary configuration to make <application>X</application> fully 511 functional. Additionally, you can have a look at <xref linkend='x-config'/> 512 for information on fine tuning your <application>X</application> 513 configuration.</para> 514 515 <para>For a list of the package contents and a description of the commands, 516 see the sections in the <xref linkend='xfree86-contents'/>.</para> 517 518 </sect2> 483 519 484 520 </sect1>
Note:
See TracChangeset
for help on using the changeset viewer.