Changeset 2826127


Ignore:
Timestamp:
02/06/2005 05:17:20 AM (18 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 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/inkscape-core-mods, krejzi/svn, lazarus, nosym, perl-modules, plabs/python-mods, qt5new, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/soup3, xry111/test-20220226
Children:
bfb65d5
Parents:
8b7d510
Message:

Tagging for xorg

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • x/installing/xorg.xml

    r8b7d510 r2826127  
    1414<sect1 id="xorg" xreflabel="X.org-&xorg-version;">
    1515<sect1info>
    16 <othername>$LastChangedBy$</othername>
    17 <date>$Date$</date>
     16  <othername>$LastChangedBy$</othername>
     17  <date>$Date$</date>
    1818</sect1info>
     19
    1920<?dbhtml filename="xorg.html"?>
    2021<title>Xorg-&xorg-version;</title>
     22
     23<indexterm zone="xorg">
     24  <primary sortas="a-xorg">xorg</primary>
     25</indexterm>
    2126
    2227
    … …  
    5863 
    5964<sect3><title>Package information</title>
    60 <itemizedlist spacing='compact'>
    61 <listitem><para>Download (HTTP):
    62 <ulink url="&xorg-download-http;"/></para></listitem>
    63 <listitem><para>Download (FTP):
    64 <ulink url="&xorg-download-ftp;"/></para></listitem>
    65 <listitem><para>Download size:
    66 &xorg-size;</para></listitem>
    67 <listitem><para>Estimated disk space required:
    68 &xorg-buildsize;</para></listitem>
    69 <listitem><para>Estimated build time:
    70 &xorg-time;</para></listitem></itemizedlist>
    71 </sect3>
    72  
    73 <sect3><title><application>Xorg</application> Dependencies</title>
    74  
    75 <sect4><title>Required</title>
    76 <para><xref linkend="libpng"/> and <xref linkend="fontconfig"/></para>
     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 size: &xorg-size;</para></listitem>
     69    <listitem><para>Estimated disk space required: &xorg-buildsize;</para></listitem>
     70    <listitem><para>Estimated build time: &xorg-time;</para></listitem>
     71  </itemizedlist>
     72</sect3>
     73 
     74<sect3>
     75  <title><application>Xorg</application> Dependencies</title>
     76 
     77<sect4>
     78  <title>Required</title>
     79  <para><xref linkend="libpng"/> and
     80        <xref linkend="fontconfig"/></para>
    7781</sect4>
    7882
    79 <sect4><title>Optional</title>
    80 <para><xref linkend="Linux_PAM"/></para>
     83<sect4>
     84  <title>Optional</title>
     85  <para><xref linkend="Linux_PAM"/></para>
    8186</sect4>
    8287
    … …  
    9095
    9196<itemizedlist spacing='compact'>
    92 <listitem><para><filename>X11R&xorg-version;-src1.tar.gz</filename></para></listitem>
    93 <listitem><para><filename>X11R&xorg-version;-src2.tar.gz</filename></para></listitem>
    94 <listitem><para><filename>X11R&xorg-version;-src3.tar.gz</filename></para></listitem>
    95 <listitem><para><filename>X11R&xorg-version;-src4.tar.gz</filename></para></listitem>
    96 <listitem><para><filename>X11R&xorg-version;-src5.tar.gz</filename></para></listitem>
    97 <listitem><para><filename>X11R&xorg-version;-src6.tar.gz</filename></para></listitem>
    98 <listitem><para><filename>X11R&xorg-version;-src7.tar.gz</filename></para></listitem>
     97  <listitem><para><filename>X11R&xorg-version;-src1.tar.gz</filename></para></listitem>
     98  <listitem><para><filename>X11R&xorg-version;-src2.tar.gz</filename></para></listitem>
     99  <listitem><para><filename>X11R&xorg-version;-src3.tar.gz</filename></para></listitem>
     100  <listitem><para><filename>X11R&xorg-version;-src4.tar.gz</filename></para></listitem>
     101  <listitem><para><filename>X11R&xorg-version;-src5.tar.gz</filename></para></listitem>
     102  <listitem><para><filename>X11R&xorg-version;-src6.tar.gz</filename></para></listitem>
     103  <listitem><para><filename>X11R&xorg-version;-src7.tar.gz</filename></para></listitem>
    99104</itemizedlist>
    100105
    … …  
    115120
    116121<sect2>
    117 <title>Installation of <application>Xorg</application></title>
     122  <title>Installation of <application>Xorg</application></title>
     123
     124<sect3 id='xorg-kernel'>
     125  <title>Kernel Compilation Settings</title>
     126
     127  <indexterm zone="xorg xorg-kernel">
     128  <primary sortas="d-Xorg">Xorg</primary></indexterm>
     129
     130  <para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is
     131    recommended that you compile <acronym>MTRR</acronym> (Memory Type Range
     132    Registers) support into the kernel. The kernel can map Cyrix and AMD
     133    <acronym>CPU</acronym>s to the <acronym>MTRR</acronym> interface, so selecting
     134    this option is useful for those processors also. This option is found in the
     135    "Processor type and features" menu.  It can increase performance of
     136    image write operations 2.5 times or more on <acronym>PCI</acronym> or
     137    <acronym>AGP</acronym> video cards.
     138  </para>
     139 
     140  <para>In the "Character Devices" section, enable <acronym>AGP</acronym> Support
     141    and select the chipset support on your motherboard. If you do not know the
     142    chipset, you may select all the chip types at the expense of extra kernel size.
     143    You can usually determine your motherboard's chipset by running the command
     144    <command>lspci</command>, a program from the <xref linkend="pciutils"/>
     145    package.
     146  </para>
     147 
     148  <para>In the "Character Devices" section, <emphasis>disable</emphasis> Direct
     149    Rendering Manager unless you have a Direct Rendering Infrastructure
     150    (<acronym>DRI</acronym>) supported video card.  A complete list of
     151    <acronym>DRI</acronym> supported video cards can be found at
     152    <ulink url="http://dri.sourceforge.net" /> in the "Status" section.
     153    Currently, supported cards include those from 3dfx (Voodoo, Banshee), 3Dlabs,
     154    ATI (Rage Pro, Rage 128, Radeon 7X00, Radeon 2), Intel (i810, i815), and
     155    Matrox (G200, G400, G450).
     156  </para>
     157 
     158  <para>Additionally NVidia provides their own closed source binary drivers,
     159    which do not make use of <acronym>DRI</acronym>. If you intend to use these
     160    drivers, do not enable <acronym>DRI</acronym>.
     161  </para>
     162 
     163  <para>If you made any changes to the kernel configuration, recompile and
     164    install the new kernel.
     165  </para>
     166 
     167  <note><para>If you build <application>Xorg</application> in a
     168    <command>chroot</command> environment, make sure the kernel version of the base
     169    system and the target system are the same.</para>
     170  </note>
     171</sect3>
    118172
    119173<sect3>
    120 <title>Kernel Compilation Settings</title>
    121 <para>If you have an Intel P6 (Pentium Pro, Pentium II and later), it is
    122 recommended that you compile <acronym>MTRR</acronym> (Memory Type Range
    123 Registers) support into the kernel. The kernel can map Cyrix and AMD
    124 <acronym>CPU</acronym>s to the <acronym>MTRR</acronym> interface, so selecting
    125 this option is useful for those processors also. This option is found in the
    126 "Processor type and features" menu.  It can increase performance of
    127 image write operations 2.5 times or more on <acronym>PCI</acronym> or
    128 <acronym>AGP</acronym> video cards.</para>
    129  
    130 <para>In the "Character Devices" section, enable <acronym>AGP</acronym> Support
    131 and select the chipset support on your motherboard. If you do not know the
    132 chipset, you may select all the chip types at the expense of extra kernel size.
    133 You can usually determine your motherboard's chipset by running the command
    134 <command>lspci</command>, a program from the <xref linkend="pciutils"/>
    135 package.</para>
    136  
    137 <para>In the "Character Devices" section, <emphasis>disable</emphasis> Direct
    138 Rendering Manager unless you have a Direct Rendering Infrastructure
    139 (<acronym>DRI</acronym>) supported video card.  A complete list of
    140 <acronym>DRI</acronym> supported video cards can be found at
    141 <ulink url="http://dri.sourceforge.net" /> in the "Status" section.
    142 Currently, supported cards include those from 3dfx (Voodoo, Banshee), 3Dlabs,
    143 ATI (Rage Pro, Rage 128, Radeon 7X00, Radeon 2), Intel (i810, i815), and
    144 Matrox (G200, G400, G450).</para>
    145  
    146 <para>Additionally NVidia provides their own closed source binary drivers,
    147 which do not make use of <acronym>DRI</acronym>. If you intend to use these
    148 drivers, do not enable <acronym>DRI</acronym>.</para>
    149  
    150 <para>If you made any changes to the kernel configuration, recompile and
    151 install the new kernel.</para>
    152  
    153 <note><para>If you build <application>Xorg</application> in a
    154 <command>chroot</command> environment, make sure the kernel version of the base
    155 system and the target system are the same.</para>
    156 </note>
    157 </sect3>
    158 
    159 <sect3><title>Suppressing Xprint-related modification to <filename
    160 class="directory">/etc</filename></title>
    161 
    162 <para><application>Xorg</application> insists on putting
    163 its boot and profile scripts into the <filename
    164 class="directory">/etc</filename> directory even if we specifically tell
    165 it not to compile anything Xprint server or client related (see
    166 <filename>host.def</filename> below). The following command will
    167 suppress any such modifications:</para>
     174  <title>Suppressing Xprint-related modification to <filename class="directory">/etc</filename></title>
     175
     176  <para><application>Xorg</application> insists on putting
     177    its boot and profile scripts into the <filename
     178    class="directory">/etc</filename> directory even if we specifically tell
     179    it not to compile anything Xprint server or client related (see
     180    <filename>host.def</filename> below). The following command will
     181    suppress any such modifications:
     182  </para>
    168183
    169184<screen><userinput><command>sed -i '/^SUBDIRS =/s/ etc$//' programs/Xserver/Xprint/Imakefile</command></userinput></screen>
    … …  
    171186</sect3>
    172187
    173 <sect3><title>Setting Up a Shadow Directory</title> 
    174 <para>When building <application>Xorg</application>, you should create a shadow
    175 directory of symbolic links for the compiled code.  To do that, first make
    176 <command>lndir</command>.  Starting from the
    177 <filename class='directory'>xc</filename> directory:</para>
     188<sect3>
     189  <title>Setting Up a Shadow Directory</title> 
     190
     191  <para>When building <application>Xorg</application>, you should create a shadow
     192    directory of symbolic links for the compiled code.  To do that, first make
     193    <command>lndir</command>.  Starting from the <filename class='directory'>xc</filename> directory:
     194  </para>
    178195
    179196<screen><userinput><command>pushd config/util &amp;&amp;
    180 make -f Makefile.ini lndir &amp;&amp;
    181 cp lndir /usr/bin/ &amp;&amp;
    182 popd</command></userinput></screen>
     197make -f Makefile.ini lndir</command></userinput></screen>
     198
     199<para>Now, as the root user:</para>
     200 
     201<screen><userinput role='root'><command>cp lndir /usr/bin/</command></userinput></screen>
     202
     203<para>And back as a regular user::</para>
     204<screen><userinput><command>popd</command></userinput></screen>
    183205
    184206<para>Now create the shadow tree:</para>
    … …  
    189211</sect3>
    190212
    191 <sect3><title>Creating <filename>host.def</filename></title> 
    192 <para>The next step is to create the <filename>config/cf/host.def</filename>
    193 file. The documentation for <application>Xorg</application> indicates that the
    194 application will build without a <filename>host.def</filename> file, but
    195 the included libraries for <application>Fontconfig</application> and
    196 <application>FreeType2</application> do not build properly on a base
    197 <acronym>LFS</acronym> system. Therefore, you must specify that these
    198 libraries, as well as others, should be imported from the system.</para>
    199 
    200 <note><para><filename>config/cf/host.def</filename> is a C file, not a shell
    201 script.  Ensure the comments delimited by <userinput>/*</userinput> ...
    202 <userinput>*/</userinput> are balanced when modifying the file.</para></note>
     213<sect3>
     214  <title>Creating <filename>host.def</filename></title> 
     215
     216  <para>The next step is to create the <filename>config/cf/host.def</filename>
     217    file. The documentation for <application>Xorg</application> indicates that the
     218    application will build without a <filename>host.def</filename> file, but
     219    the included libraries for <application>Fontconfig</application> and
     220    <application>FreeType2</application> do not build properly on a base
     221    <acronym>LFS</acronym> system. Therefore, you must specify that these
     222    libraries, as well as others, should be imported from the system.
     223  </para>
     224
     225  <note><para><filename>config/cf/host.def</filename> is a C file, not a shell
     226    script.  Ensure the comments delimited by <userinput>/*</userinput> ...
     227    <userinput>*/</userinput> are balanced when modifying the file.</para>
     228  </note>
    203229
    204230<screen><userinput><command>cat &gt; config/cf/host.def &lt;&lt; "EOF"</command>
    … …  
    264290<command>EOF</command></userinput></screen>
    265291
    266 <para>There are several other options that you may want to consider.  A well
    267 documented example file is <filename>config/cf/xorgsite.def</filename>.</para>
     292  <para>There are several other options that you may want to consider.  A well
     293    documented example file is <filename>config/cf/xorgsite.def</filename>.
     294  </para>
     295
    268296</sect3>
    269297
    270298<sect3>
    271 <title>Build Commands</title>
    272 <para>Install <application>Xorg</application> by running the following
    273 commands:</para>
     299  <title>Build Commands</title>
     300
     301  <para>Install <application>Xorg</application> by running the following commands:</para>
    274302 
    275303<screen><userinput><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@/* &amp; */@" \
    276304    `grep -lr linux/config.h *` &amp;&amp;
    277 ( make World 2&gt;&amp;1 | tee xorg-compile.log &amp;&amp; exit $PIPESTATUS ) &amp;&amp;
    278 make install &amp;&amp;
     305( make World 2&gt;&amp;1 | tee xorg-compile.log &amp;&amp; exit $PIPESTATUS )</command></userinput></screen>
     306
     307<para>Againas as the root user:</para>
     308 
     309<screen><userinput role='root'><command>make install &amp;&amp;
    279310make install.man &amp;&amp;
    280311ln -sf ../X11R6/bin /usr/bin/X11 &amp;&amp;
    … …  
    288319<title>Command explanations</title>
    289320 
    290 <para><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@...</command>: The
    291 <application>Linux-Libc-Headers</application> package installed in
    292 <acronym>LFS</acronym> installs a
    293 <filename>/usr/include/linux/config.h</filename> file which is not compatible
    294 with userspace applications. The recommended fix for applications including
    295 this file is to remove it (see <ulink
    296 url="http://ep09.pld-linux.org/~mmazur/linux-libc-headers/doc/FAQ">
    297 linux-libc-headers FAQ</ulink>). The <command>sed</command> uses
    298 <command>grep -lr</command> to replace all occurences. If you desire, just
    299 remove (comment) the line in the appropriate video driver file if you
    300 customized <filename>host.def</filename>.
     321  <para><command>sed -i -e "s@^#include &lt;linux/config.h&gt;@...</command>:
     322    The <application>Linux-Libc-Headers</application> package installed in
     323    <acronym>LFS</acronym> installs a
     324    <filename>/usr/include/linux/config.h</filename> file which is not compatible
     325    with userspace applications. The recommended fix for applications including
     326    this file is to remove it (see <ulink
     327    url="http://ep09.pld-linux.org/~mmazur/linux-libc-headers/doc/FAQ">
     328    linux-libc-headers FAQ</ulink>). The <command>sed</command> uses
     329    <command>grep -lr</command> to replace all occurences. If you desire, just
     330    remove (comment) the line in the appropriate video driver file if you
     331    customized <filename>host.def</filename>.
    301332</para>
    302333
    303 <para><command>( make World 2&gt;&amp;1 | tee xorg-compile.log
    304    &amp;&amp; exit $PIPESTATUS )</command>:
    305 This command runs multiple <filename>Makefile</filename>s to completely rebuild
    306 the system. <parameter>2&gt;&amp;1</parameter> redirects error messages
    307 to the same location as standard output. The <command>tee</command> command
    308 allows viewing of the output while logging the results to a file. The
    309 parentheses around the command runs the entire comand in a subshell and finally
    310 the <command>exit $PIPESTATUS</command> ensures the result of the
    311 <command>make</command> is returned as the result and not the result of the
    312 <command>tee</command> command.</para>
    313  
    314 <note><para>When rebuilding <application>Xorg</application>, a separate command
    315 that may be used if only minor changes are made to the sources is
    316 <command>make Everything</command>. This does not automatically remove generated
    317 files and only rebuilds those files or programs that are out of date.</para>
    318 </note>
     334  <para><command>( make World 2&gt;&amp;1 | tee xorg-compile.log
     335    &amp;&amp; exit $PIPESTATUS )</command>:
     336    This command runs multiple <filename>Makefile</filename>s to completely rebuild
     337    the system. <parameter>2&gt;&amp;1</parameter> redirects error messages
     338    to the same location as standard output. The <command>tee</command> command
     339    allows viewing of the output while logging the results to a file. The
     340    parentheses around the command runs the entire comand in a subshell and finally
     341    the <command>exit $PIPESTATUS</command> ensures the result of the
     342    <command>make</command> is returned as the result and not the result of the
     343    <command>tee</command> command.
     344  </para>
     345 
     346  <note><para>When rebuilding <application>Xorg</application>, a separate command
     347    that may be used if only minor changes are made to the sources is
     348    <command>make Everything</command>. This does not automatically remove generated
     349    files and only rebuilds those files or programs that are out of date.</para>
     350  </note>
    319351 
    320352<para><screen><command>ln -sf ../X11R6/bin /usr/bin/X11
    … …  
    328360</sect2>
    329361
    330 <sect2>
     362<sect2 id='xorg-config'>
    331363<title>Configuring Xorg</title>
    332364
    333365<para>Edit <filename>/etc/ld.so.conf</filename> and add
    334 <filename class="directory">/usr/X11R6/lib</filename>.
    335 Run:</para>
     366  <filename class="directory">/usr/X11R6/lib</filename>. Run:
     367</para>
     368
     369<indexterm zone="xorg xorg-config">
     370  <primary sortas="e-etc-ld-so.conf">/etc/ld.so.conf</primary>
     371</indexterm>
     372 
    336373<screen><userinput><command>ldconfig</command></userinput></screen>
    337374 
    … …  
    348385command will create a file, <filename>xorg.conf.new</filename> in your home
    349386directory.</para>
     387
     388<indexterm zone="xorg xorg-config">
     389  <primary sortas="e-etc-X11-xorg-conf">/etc/X11/xorg.conf</primary>
     390</indexterm>
    350391 
    351392<para>Edit <filename>xorg.conf.new</filename> to suit your system.  The details
    … …  
    406447simple window manager, Tab Window Manager.  For details of
    407448<command>twm</command>, see the man page.</para>
     449
     450<indexterm zone="xorg xorg-config">
     451  <primary sortas="e-AA.xinitrc">~/.xinitrc</primary>
     452</indexterm>
    408453 
    409454<note>
    … …  
    422467</note>
    423468
     469<indexterm zone="xorg xorg-config">
     470  <primary sortas="e-etc-sysconfig-createfiles">/etc/sysconfig/createfiles</primary>
     471</indexterm>
     472
    424473<para>Start <application>X</application> with:
    425474<screen><userinput><command>startx</command></userinput></screen>
Note: See TracChangeset for help on using the changeset viewer.