Changeset d3d229f


Ignore:
Timestamp:
02/20/2003 01:59:14 PM (21 years ago)
Author:
Gerard Beekmans <gerard@…>
Branches:
10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.0, 6.1, 6.1.1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, v4_1, v5_0, v5_1, v5_1_1, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
Children:
3ae77e1
Parents:
212a71b
Message:

grammar fixes from Alex

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@2447 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

Files:
3 edited

Legend:

Unmodified
Added
Removed
  • chapter06/config-glibc.xml

    r212a71b rd3d229f  
    33<sect2><title>Configuring Glibc</title>
    44
    5 <para>We need to create the /etc/nsswitch.conf file. Although glibc should
    6 provide defaults when this file is missing or corrupt, its defaults don't work
    7 well with networking. That is dealt with in a later chapter. Also, our
    8 timezone needs to be set up.</para>
     5<para>We need to create the <filename>/etc/nsswitch.conf</filename> file,
     6because, although Glibc provides defaults when this file is missing or corrupt,
     7the Glibc defaults don't work well with networking. Also, our timezone needs
     8to be set up.</para>
    99
    1010<para>Create a new file <filename>/etc/nsswitch.conf</filename> by running the
     
    3333<userinput>EOF</userinput></screen></para>
    3434
    35 <para>The <userinput>tzselect</userinput> script has to be run and the
    36 questions regarding your timezone have to be answered.
    37 When you're done, the script will give the
    38 location of the needed timezone file.</para>
     35<para>To find out what timezone you're in, run the following script:</para>
    3936
    40 <para> Create the <filename class="directory">/etc/localtime</filename> symlink
    41 by running:</para>
     37<para><screen><userinput>tzselect</userinput></screen></para>
    4238
    43 <para><screen><userinput>ln -sf ../usr/share/zoneinfo/&lt;tzselect's output&gt; /etc/localtime</userinput></screen></para>
    44 
    45 <para>tzselect's output can be something like <emphasis>EST5EDT</emphasis> or
    46 <emphasis>Canada/Eastern</emphasis>.</para>
    47 
    48 <para>The symlink you'd create with that information would be:</para>
    49 
    50 <para><screen><userinput>ln -sf ../usr/share/zoneinfo/EST5EDT /etc/localtime</userinput></screen></para>
    51 
    52 <para>Or:</para>
     39<para>When you've answered a few questions about your location, the script will
     40output the name of your timezone, something like <emphasis>EST5EDT</emphasis>
     41or <emphasis>Canada/Eastern</emphasis>. Then create the
     42<filename>/etc/localtime</filename> symlink by running:</para>
    5343
    5444<para><screen><userinput>ln -sf ../usr/share/zoneinfo/Canada/Eastern /etc/localtime </userinput></screen></para>
     45
     46<para>Of course, instead of <emphasis>Canada/Eastern</emphasis>, fill in
     47the name of the timezone that the <userinput>tzselect</userinput> script
     48gave you.</para>
    5549
    5650</sect2>
  • chapter06/glibc-inst.xml

    r212a71b rd3d229f  
    44<title>Glibc installation</title>
    55
    6 <para>Before starting to install glibc, you must cd into the
    7 glibc-&glibc-version; directory and unpack glibc-linuxthreads inside
    8 the glibc-&glibc-version; directory, not in /usr/src as you normally
    9 would do.</para>
     6<para>Before starting to install Glibc, you must <userinput>cd</userinput>
     7into the <filename>glibc-&glibc-version;</filename> directory and unpack
     8Glibc-linuxthreads in that directory, not in <filename>/usr/src</filename> as
     9you would normally do.</para>
    1010
    1111<para>This package is known to behave badly when you have changed its
     
    1313Therefore, if you have defined any environment variables that override
    1414default optimizations, such as CFLAGS and CXXFLAGS, we recommend unsetting
    15 or modifying them when building Glibc.</para>
     15them when building Glibc.</para>
    1616
    1717<para>Basically, compiling Glibc in any other way than the book suggests
    1818is putting your system at a very high risk.</para>
    1919
    20 <para>We'll start by applying a patch to Glibc that fixes the following:</para>
     20<para>We'll start by applying a patch that does the following:</para>
    2121
    2222<itemizedlist>
     
    2424to <emphasis>/usr/bin/perl</emphasis> in the
    2525<filename>malloc/Makefile</filename> file. This is done because Glibc
    26 can't autodetect the location of perl because the Perl package hasn't been
    27 installed yet. And if Glibc thinks Perl isn't installed, the
    28 <userinput>mtrace</userinput> perl program won't be installed
     26can't autodetect the location of <filename>perl</filename> because the Perl
     27package hasn't been installed yet. And if Glibc thinks Perl isn't installed, the
     28perl program <filename>mtrace</filename> won't be installed
    2929either.</para></listitem>
    3030
     
    3232with <emphasis>0</emphasis> in the <filename>login/Makefile</filename>
    3333file. This is done because Glibc itself isn't installed yet and therefore
    34 username to userid resolving isn't working yet, so a
    35 <userinput>chown root file</userinput> will fail, however it'll work fine
    36 if you use the numeric IDs (such as <userinput>chown 0
    37 file</userinput>).</para></listitem>
     34username-to-userid resolving isn't working yet, so a
     35<userinput>chown root file</userinput> would fail. Using numeric IDs (as in
     36<userinput>chown 0 file</userinput>) works fine.</para></listitem>
    3837
    3938</itemizedlist>
     
    4645rely on one external library set: Glibc's NSS libraries. These libraries,
    4746among other things, tell programs where the system's password database is
    48 (/etc/password, or NIS, or whatever other scheme has been
    49 configured).</para>
     47(in <filename>/etc/password</filename>, NIS, or whatever other scheme has
     48been configured).</para>
    5049
    5150<para>Glibc has undergone some changes since version 2.2.x and the new NSS
    52 code is incompatible with the old one. So when Glibc is installed, it will
    53 install its new NSS libraries and static programs will load these new NSS
    54 libraries and start to abort with <emphasis>segmentation fault</emphasis>
    55 error. This patch undoes a few of the changes to overcome the problem.</para>
     51code is incompatible with the old one. So when Glibc is installed it will
     52install its new NSS libraries, and static programs will load these new NSS
     53libraries and will abort with a <emphasis>segmentation fault</emphasis>
     54error. This patch undoes some of the changes to overcome the problem.</para>
    5655
    5756<para>If you started chapter 5 with a host system that uses Glibc-2.2.x
     
    6766<para><screen><userinput>touch /etc/ld.so.conf</userinput></screen></para>
    6867
    69 <para>It is recommended by the Glibc installation documentation to build
    70 Glibc outside of the source directory in a dedicated directory:</para>
     68<para>The documentation that comes with Glibc recommends to build the package
     69not in the source directory but in a separate, dedicated directory:</para>
    7170
    7271<para><screen><userinput>mkdir ../glibc-build &amp;&amp;
     
    8382<itemizedlist>
    8483<listitem><para><userinput>--disable-profile</userinput>: This disables the
    85 building of libraries with profiling information. This command may be
    86 omitted if you plan to do profiling.</para></listitem>
     84building of the libraries with profiling information. Omit this option if you
     85plan to do profiling.</para></listitem>
    8786
    88 <listitem><para><userinput>--enable-add-ons</userinput>: This enables the
    89 add-on that we install with Glibc, linuxthreads</para></listitem>
     87<listitem><para><userinput>--enable-add-ons</userinput>: This enables any
     88add-ons that we installed with Glibc, in our case Linuxthreads.</para></listitem>
    9089
    9190<listitem><para><userinput>--libexecdir=/usr/bin</userinput>: This will
    92 cause the pt_chown program to be installed in the /usr/bin
    93 directory.</para></listitem>
     91cause the <filename>pt_chown</filename> program to be installed in the
     92<filename>/usr/bin</filename> directory.</para></listitem>
    9493</itemizedlist>
    9594
     
    101100*** Check the INSTALL file for required versions.</screen></blockquote>
    102101
    103 <para>The missing msgfmt (from the gettext package which we will install
    104 later in this chapter) won't cause any problems. msgfmt is used to generate
    105 the binary translation files that are used to make your system talk in a
    106 different language. Because these translation files have already been
    107 generated for you, there is no need for msgfmt. You'd only need msgfmt if
    108 you change the translation source files (the <filename>*.po</filename>
    109 files in the <filename class="directory">po</filename> subdirectory) which
    110 would require you to re-generate the binary files.</para>
     102<para>The missing <filename>msgfmt</filename> program (from the Gettext
     103package, which we'll install later) won't cause any problems. The
     104<filename>msgfmt</filename> is used to generate the binary translation
     105files that can make your system talk in a different language. Because these
     106translation files have already been generated for you, there is no need for
     107<filename>msgfmt</filename>. You'd only need the program if you change the
     108translation source files (the <filename>*.po</filename> files in the
     109<filename class="directory">po</filename> subdirectory), which
     110would require you to regenerate the binary files.</para>
    111111
    112112<para>Because Glibc hasn't been installed yet, one of the tests that was
    113 run by the configure script failed. This test is supposed to test gcc to
    114 determine whether or not a cross-compiler is installed. However, Glibc
    115 needs to be installed already to run this test. Since the test failed, the
    116 configure script automatically assumed we do have a cross-compiler. We have
    117 to override that assumption by explicitly telling Glibc we're not
    118 cross-compiling. Not doing this has a couple of unintended side effects,
     113run by the configure script has failed. This test is supposed to test
     114<filename>gcc</filename> to determine whether a cross-compiler is installed.
     115However, Glibc needs to be already installed to run this test. Since the test
     116failed, the configure script assumes we have a cross-compiler. We override
     117that assumption by explicitly telling Glibc we're not cross-compiling.
     118Not doing this would have a couple of unintended side effects,
    119119such as the timezone files not being installed.</para>
    120120
     
    133133<para><screen><userinput>make install</userinput></screen></para>
    134134
    135 <para>Locales aren't installed when you ran
    136 <userinput>make install</userinput>, so we have to do that ourselves now.
    137 Locales are used by Glibc to make your Linux system talk in a different
    138 language:</para>
     135<para>The locales (used by Glibc to make your Linux system talk in a different
     136language) weren't installed when you ran the previous command, so we have to
     137do that ourselves now:</para>
    139138
    140139<para><screen><userinput>make localedata/install-locales</userinput></screen></para>
    141140
    142 <para>An alternative to running <userinput>make
    143 localedata/install-locales</userinput> is to only install those locales
    144 which you need or want. This can be achieved using the localedef
    145 command. Information on this can be found in the INSTALL
    146 file in the glibc-&glibc-version; tree.</para>
     141<para>An alternative to running the previous command is to install only those
     142locales which you need or want. This can be achieved using the localedef
     143command. Information on this can be found in the <filename>INSTALL</filename>
     144file in the <filename>glibc-&glibc-version;</filename> tree.</para>
    147145
    148 <para>To finish off the installation we'll reload Bash so it uses the
    149 libnss files. This will also get rid of the
     146<para>To finish off the installation we'll reload Bash so it will use the new
     147<filename>libnss_*</filename> files. This will also get rid of the
    150148<emphasis>I have no name!</emphasis> message in the command prompt:</para>
    151149
  • index.xml

    r212a71b rd3d229f  
    55<!ENTITY book SYSTEM "book/book.xml">
    66
    7 <!ENTITY version "20030217">
    8 <!ENTITY releasedate "February 17th, 2003">
     7<!ENTITY version "20030219">
     8<!ENTITY releasedate "February 19th, 2003">
    99
    1010<!ENTITY ftp-root "ftp://ftp.linuxfromscratch.org">
Note: See TracChangeset for help on using the changeset viewer.