gronod/lfs
1
0
Fork 0
mirror of https://git.linuxfromscratch.org/lfs.git synced 2025-07-25 13:45:59 +01:00
Code Issues Packages Projects Releases Wiki Activity

Indenting chapter 6, part 5

Browse Source 
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7344 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
This commit is contained in:
Manuel Canales Esparcia 2006-02-04 13:28:41 +00:00
parent 54e422c1d9
commit 6a82dd9a18
5 changed files with 1442 additions and 1112 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

88
chapter06/gawk.xml
View File

@ -1,35 +1,51 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-gawk" role="wrap"> <sect1 id="ch-system-gawk" role="wrap">
<title>Gawk-&gawk-version;</title>
<?dbhtml filename="gawk.html"?> <?dbhtml filename="gawk.html"?>
<indexterm zone="ch-system-gawk"><primary sortas="a-Gawk">Gawk</primary></indexterm> <title>Gawk-&gawk-version;</title>
<indexterm zone="ch-system-gawk">
<primary sortas="a-Gawk">Gawk</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Gawk package contains programs for manipulating text files.</para> <para>The Gawk package contains programs for manipulating text files.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>16.4 MB</seg></seglistitem>
<seglistitem>
<seg>0.2 SBU</seg>
<seg>16.4 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils,
Diffutils, GCC, Gettext, Glibc, Grep, Make, and Sed</seg></seglistitem> <seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc,
Grep, Make, and Sed</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
<title>Installation of Gawk</title> <title>Installation of Gawk</title>
<para>Under some circumstances, Gawk-&gawk-version; attempts to free a chunk <para>Under some circumstances, Gawk-&gawk-version; attempts to free a
of memory that was not allocated. This bug is fixed by the following patch:</para> chunk of memory that was not allocated. This bug is fixed by the following
patch:</para>
<screen><userinput>patch -Np1 -i ../&gawk-segfault-patch;</userinput></screen> <screen><userinput>patch -Np1 -i ../&gawk-segfault-patch;</userinput></screen>
@ -38,9 +54,9 @@ of memory that was not allocated. This bug is fixed by the following patch:</par
<screen><userinput>./configure --prefix=/usr --libexecdir=/usr/lib</userinput></screen> <screen><userinput>./configure --prefix=/usr --libexecdir=/usr/lib</userinput></screen>
<para>Due to a bug in the <command>configure</command> script, Gawk fails <para>Due to a bug in the <command>configure</command> script, Gawk fails
to detect certain aspects of locale support in Glibc. This to detect certain aspects of locale support in Glibc. This bug leads to,
bug leads to, e.g., Gettext testsuite failures. Work around this issue e.g., Gettext testsuite failures. Work around this issue by appending the
by appending the missing macro definitions to <filename>config.h</filename>:</para> missing macro definitions to <filename>config.h</filename>:</para>
<screen><userinput>cat &gt;&gt;config.h &lt;&lt;"EOF" <screen><userinput>cat &gt;&gt;config.h &lt;&lt;"EOF"
<literal>#define HAVE_LANGINFO_CODESET 1 <literal>#define HAVE_LANGINFO_CODESET 1
@ -60,16 +76,20 @@ EOF</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-gawk" role="content">
<sect2 id="contents-gawk" role="content"><title>Contents of Gawk</title> <title>Contents of Gawk</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<seglistitem><seg>awk (link to gawk), gawk, gawk-&gawk-version;, grcat, igawk,
pgawk, pgawk-&gawk-version;, and pwcat</seg></seglistitem> <seglistitem>
<seg>awk (link to gawk), gawk, gawk-&gawk-version;, grcat, igawk, pgawk,
pgawk-&gawk-version;, and pwcat</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
@ -77,7 +97,9 @@ pgawk, pgawk-&gawk-version;, and pwcat</seg></seglistitem>
<term><command>awk</command></term> <term><command>awk</command></term>
<listitem> <listitem>
<para>A link to <command>gawk</command></para> <para>A link to <command>gawk</command></para>
<indexterm zone="ch-system-gawk awk"><primary sortas="b-awk">awk</primary></indexterm> <indexterm zone="ch-system-gawk awk">
<primary sortas="b-awk">awk</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -86,7 +108,9 @@ pgawk, pgawk-&gawk-version;, and pwcat</seg></seglistitem>
<listitem> <listitem>
<para>A program for manipulating text files; it is the GNU <para>A program for manipulating text files; it is the GNU
implementation of <command>awk</command></para> implementation of <command>awk</command></para>
<indexterm zone="ch-system-gawk gawk"><primary sortas="b-gawk">gawk</primary></indexterm> <indexterm zone="ch-system-gawk gawk">
<primary sortas="b-gawk">gawk</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -94,7 +118,9 @@ implementation of <command>awk</command></para>
<term><command>gawk-&gawk-version;</command></term> <term><command>gawk-&gawk-version;</command></term>
<listitem> <listitem>
<para>A hard link to <command>gawk</command></para> <para>A hard link to <command>gawk</command></para>
<indexterm zone="ch-system-gawk gawk-version"><primary sortas="b-gawk-&gawk-version;">gawk-&gawk-version;</primary></indexterm> <indexterm zone="ch-system-gawk gawk-version">
<primary sortas="b-gawk-&gawk-version;">gawk-&gawk-version;</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -102,7 +128,9 @@ implementation of <command>awk</command></para>
<term><command>grcat</command></term> <term><command>grcat</command></term>
<listitem> <listitem>
<para>Dumps the group database <filename>/etc/group</filename></para> <para>Dumps the group database <filename>/etc/group</filename></para>
<indexterm zone="ch-system-gawk grcat"><primary sortas="b-grcat">grcat</primary></indexterm> <indexterm zone="ch-system-gawk grcat">
<primary sortas="b-grcat">grcat</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -110,7 +138,9 @@ implementation of <command>awk</command></para>
<term><command>igawk</command></term> <term><command>igawk</command></term>
<listitem> <listitem>
<para>Gives <command>gawk</command> the ability to include files</para> <para>Gives <command>gawk</command> the ability to include files</para>
<indexterm zone="ch-system-gawk igawk"><primary sortas="b-igawk">igawk</primary></indexterm> <indexterm zone="ch-system-gawk igawk">
<primary sortas="b-igawk">igawk</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -118,7 +148,9 @@ implementation of <command>awk</command></para>
<term><command>pgawk</command></term> <term><command>pgawk</command></term>
<listitem> <listitem>
<para>The profiling version of <command>gawk</command></para> <para>The profiling version of <command>gawk</command></para>
<indexterm zone="ch-system-gawk pgawk"><primary sortas="b-pgawk">pgawk</primary></indexterm> <indexterm zone="ch-system-gawk pgawk">
<primary sortas="b-pgawk">pgawk</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -126,7 +158,9 @@ implementation of <command>awk</command></para>
<term><command>pgawk-&gawk-version;</command></term> <term><command>pgawk-&gawk-version;</command></term>
<listitem> <listitem>
<para>Hard link to <command>pgawk</command></para> <para>Hard link to <command>pgawk</command></para>
<indexterm zone="ch-system-gawk pgawk-version"><primary sortas="b-pgawk-&gawk-version;">pgawk-&gawk-version;</primary></indexterm> <indexterm zone="ch-system-gawk pgawk-version">
<primary sortas="b-pgawk-&gawk-version;">pgawk-&gawk-version;</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -134,12 +168,14 @@ implementation of <command>awk</command></para>
<term><command>pwcat</command></term> <term><command>pwcat</command></term>
<listitem> <listitem>
<para>Dumps the password database <filename>/etc/passwd</filename></para> <para>Dumps the password database <filename>/etc/passwd</filename></para>
<indexterm zone="ch-system-gawk pwcat"><primary sortas="b-pwcat">pwcat</primary></indexterm> <indexterm zone="ch-system-gawk pwcat">
<primary sortas="b-pwcat">pwcat</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

114
chapter06/gcc.xml
View File

@ -1,29 +1,44 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-gcc" role="wrap"> <sect1 id="ch-system-gcc" role="wrap">
<title>GCC-&gcc-version;</title>
<?dbhtml filename="gcc.html"?> <?dbhtml filename="gcc.html"?>
<indexterm zone="ch-system-gcc"><primary sortas="a-GCC">GCC</primary></indexterm> <title>GCC-&gcc-version;</title>
<indexterm zone="ch-system-gcc">
<primary sortas="a-GCC">GCC</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The GCC package contains the GNU compiler collection, which includes <para>The GCC package contains the GNU compiler collection, which includes
the C and C++ compilers.</para> the C and C++ compilers.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>11.7 SBU</seg><seg>451 MB</seg></seglistitem>
<seglistitem>
<seg>11.7 SBU</seg>
<seg>451 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, Findutils,
Gawk, Gettext, Glibc, Grep, Make, Perl, Sed, and Texinfo</seg></seglistitem> <seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, Findutils, Gawk, Gettext,
Glibc, Grep, Make, Perl, Sed, and Texinfo</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
@ -39,8 +54,8 @@ Binutils will be used instead:</para>
<para>The bootstrap build performed in <xref linkend="ch-tools-gcc-pass1"/> <para>The bootstrap build performed in <xref linkend="ch-tools-gcc-pass1"/>
built GCC with the <option>-fomit-frame-pointer</option> compiler flag. built GCC with the <option>-fomit-frame-pointer</option> compiler flag.
Non-bootstrap builds omit this flag by default, so apply the following Non-bootstrap builds omit this flag by default, so apply the following
<command>sed</command> to use it in order to ensure consistent compiler builds. <command>sed</command> to use it in order to ensure consistent compiler
</para> builds.</para>
<screen><userinput>sed -i 's/^XCFLAGS =$/&amp; -fomit-frame-pointer/' gcc/Makefile.in</userinput></screen> <screen><userinput>sed -i 's/^XCFLAGS =$/&amp; -fomit-frame-pointer/' gcc/Makefile.in</userinput></screen>
@ -77,8 +92,10 @@ cd ../gcc-build</userinput></screen>
<screen><userinput>make</userinput></screen> <screen><userinput>make</userinput></screen>
<important><para>In this section, the test suite for GCC is considered <important>
critical. Do not skip it under any circumstance.</para></important> <para>In this section, the test suite for GCC is considered
critical. Do not skip it under any circumstance.</para>
</important>
<para>Test the results, but do not stop at errors:</para> <para>Test the results, but do not stop at errors:</para>
@ -104,27 +121,33 @@ compiler. To satisfy those packages, create a symlink:</para>
<screen><userinput>ln -sv gcc /usr/bin/cc</userinput></screen> <screen><userinput>ln -sv gcc /usr/bin/cc</userinput></screen>
<note><para>At this point, it is strongly recommended to repeat the <note>
sanity check performed earlier in this chapter. Refer back to <xref <para>At this point, it is strongly recommended to repeat the sanity
linkend="ch-system-readjusting" role=","/> and repeat the check. If the results check performed earlier in this chapter. Refer back to <xref
are in error, then the most likely reason is that the GCC Specs patch linkend="ch-system-readjusting" role=","/> and repeat the check. If
from <xref linkend="chapter-temporary-tools"/> was erroneously applied the results are in error, then the most likely reason is that the GCC
here.</para></note> Specs patch from <xref linkend="chapter-temporary-tools"/> was
erroneously applied here.</para>
</note>
</sect2> </sect2>
<sect2 id="contents-gcc" role="content">
<sect2 id="contents-gcc" role="content"><title>Contents of GCC</title> <title>Contents of GCC</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<segtitle>Installed libraries</segtitle> <segtitle>Installed libraries</segtitle>
<seglistitem><seg>c++, cc (link to gcc), cpp, g++, gcc, gccbug, and
gcov</seg> <seglistitem>
<seg>libgcc.a, libgcc_eh.a, libgcc_s.so, libstdc++.[a,so], and libsupc++.a</seg></seglistitem> <seg>c++, cc (link to gcc), cpp, g++, gcc, gccbug, and gcov</seg>
<seg>libgcc.a, libgcc_eh.a, libgcc_s.so, libstdc++.[a,so], and
libsupc++.a</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
@ -132,7 +155,9 @@ gcov</seg>
<term><command>cc</command></term> <term><command>cc</command></term>
<listitem> <listitem>
<para>The C compiler</para> <para>The C compiler</para>
<indexterm zone="ch-system-gcc cc"><primary sortas="b-cc">cc</primary></indexterm> <indexterm zone="ch-system-gcc cc">
<primary sortas="b-cc">cc</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -141,7 +166,9 @@ gcov</seg>
<listitem> <listitem>
<para>The C preprocessor; it is used by the compiler to expand the <para>The C preprocessor; it is used by the compiler to expand the
#include, #define, and similar statements in the source files</para> #include, #define, and similar statements in the source files</para>
<indexterm zone="ch-system-gcc cpp"><primary sortas="b-cpp">cpp</primary></indexterm> <indexterm zone="ch-system-gcc cpp">
<primary sortas="b-cpp">cpp</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -149,7 +176,9 @@ gcov</seg>
<term><command>c++</command></term> <term><command>c++</command></term>
<listitem> <listitem>
<para>The C++ compiler</para> <para>The C++ compiler</para>
<indexterm zone="ch-system-gcc c"><primary sortas="b-c++">c++</primary></indexterm> <indexterm zone="ch-system-gcc c">
<primary sortas="b-c++">c++</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -157,7 +186,9 @@ gcov</seg>
<term><command>g++</command></term> <term><command>g++</command></term>
<listitem> <listitem>
<para>The C++ compiler</para> <para>The C++ compiler</para>
<indexterm zone="ch-system-gcc g"><primary sortas="b-g++">g++</primary></indexterm> <indexterm zone="ch-system-gcc g">
<primary sortas="b-g++">g++</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -165,7 +196,9 @@ gcov</seg>
<term><command>gcc</command></term> <term><command>gcc</command></term>
<listitem> <listitem>
<para>The C compiler</para> <para>The C compiler</para>
<indexterm zone="ch-system-gcc gcc"><primary sortas="b-gcc">gcc</primary></indexterm> <indexterm zone="ch-system-gcc gcc">
<primary sortas="b-gcc">gcc</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -173,7 +206,9 @@ gcov</seg>
<term><command>gccbug</command></term> <term><command>gccbug</command></term>
<listitem> <listitem>
<para>A shell script used to help create useful bug reports</para> <para>A shell script used to help create useful bug reports</para>
<indexterm zone="ch-system-gcc gccbug"><primary sortas="b-gccbug">gccbug</primary></indexterm> <indexterm zone="ch-system-gcc gccbug">
<primary sortas="b-gccbug">gccbug</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -182,7 +217,9 @@ gcov</seg>
<listitem> <listitem>
<para>A coverage testing tool; it is used to analyze programs to <para>A coverage testing tool; it is used to analyze programs to
determine where optimizations will have the most effect</para> determine where optimizations will have the most effect</para>
<indexterm zone="ch-system-gcc gcov"><primary sortas="b-gcov">gcov</primary></indexterm> <indexterm zone="ch-system-gcc gcov">
<primary sortas="b-gcov">gcov</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -190,7 +227,9 @@ determine where optimizations will have the most effect</para>
<term><filename class="libraryfile">libgcc</filename></term> <term><filename class="libraryfile">libgcc</filename></term>
<listitem> <listitem>
<para>Contains run-time support for <command>gcc</command></para> <para>Contains run-time support for <command>gcc</command></para>
<indexterm zone="ch-system-gcc libgcc"><primary sortas="c-libgcc*">libgcc*</primary></indexterm> <indexterm zone="ch-system-gcc libgcc">
<primary sortas="c-libgcc*">libgcc*</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -198,20 +237,25 @@ determine where optimizations will have the most effect</para>
<term><filename class="libraryfile">libstdc++</filename></term> <term><filename class="libraryfile">libstdc++</filename></term>
<listitem> <listitem>
<para>The standard C++ library</para> <para>The standard C++ library</para>
<indexterm zone="ch-system-gcc libstdc"><primary sortas="c-libstdc++">libstdc++</primary></indexterm> <indexterm zone="ch-system-gcc libstdc">
<primary sortas="c-libstdc++">libstdc++</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="libsupc"> <varlistentry id="libsupc">
<term><filename class="libraryfile">libsupc++</filename></term> <term><filename class="libraryfile">libsupc++</filename></term>
<listitem> <listitem>
<para>Provides supporting routines for the C++ programming language</para> <para>Provides supporting routines for the C++ programming
<indexterm zone="ch-system-gcc libsupc"><primary sortas="c-libsupc++">libsupc++</primary></indexterm> language</para>
<indexterm zone="ch-system-gcc libsupc">
<primary sortas="c-libsupc++">libsupc++</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

217
chapter06/gettext.xml
View File

@ -1,30 +1,46 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-gettext" role="wrap"> <sect1 id="ch-system-gettext" role="wrap">
<title>Gettext-&gettext-version;</title>
<?dbhtml filename="gettext.html"?> <?dbhtml filename="gettext.html"?>
<indexterm zone="ch-system-gettext"><primary sortas="a-Gettext">Gettext</primary></indexterm> <title>Gettext-&gettext-version;</title>
<indexterm zone="ch-system-gettext">
<primary sortas="a-Gettext">Gettext</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Gettext package contains utilities for internationalization and <para>The Gettext package contains utilities for internationalization and
localization. These allow programs to be compiled with NLS (Native Language localization. These allow programs to be compiled with NLS (Native Language
Support), enabling them to output messages in the user's native language.</para> Support), enabling them to output messages in the user's native
language.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>1.2 SBU</seg><seg>65.1 MB</seg></seglistitem>
<seglistitem>
<seg>1.2 SBU</seg>
<seg>65.1 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Bison, Coreutils,
Diffutils, Gawk, GCC, Glibc, Grep, Make, and Sed</seg></seglistitem> <seglistitem>
<seg>Bash, Binutils, Bison, Coreutils, Diffutils, Gawk, GCC, Glibc,
Grep, Make, and Sed</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
@ -39,8 +55,8 @@ Diffutils, Gawk, GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
<screen><userinput>make</userinput></screen> <screen><userinput>make</userinput></screen>
<para>To test the results, issue: <para>To test the results, issue:
<userinput>make check</userinput>. This takes a very long time, around <userinput>make check</userinput>.
7 SBUs.</para> This takes a very long time, around 7 SBUs.</para>
<para>Install the package:</para> <para>Install the package:</para>
@ -48,45 +64,59 @@ Diffutils, Gawk, GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
</sect2> </sect2>
<sect2 id="contents-gettext" role="content">
<sect2 id="contents-gettext" role="content"><title>Contents of Gettext</title> <title>Contents of Gettext</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<segtitle>Installed libraries</segtitle> <segtitle>Installed libraries</segtitle>
<seglistitem><seg>autopoint, config.charset, config.rpath, envsubst, gettext,
<seglistitem>
<seg>autopoint, config.charset, config.rpath, envsubst, gettext,
gettextize, hostname, msgattrib, msgcat, msgcmp, msgcomm, msgconv, msgen, gettextize, hostname, msgattrib, msgcat, msgcmp, msgcomm, msgconv, msgen,
msgexec, msgfilter, msgfmt, msggrep, msginit, msgmerge, msgunfmt, msguniq, msgexec, msgfilter, msgfmt, msggrep, msginit, msgmerge, msgunfmt, msguniq,
ngettext, and xgettext</seg> ngettext, and xgettext</seg>
<seg>libasprintf.[a,so], libgettextlib.so, libgettextpo.[a,so], and libgettextsrc.so</seg></seglistitem> <seg>libasprintf.[a,so], libgettextlib.so, libgettextpo.[a,so], and
libgettextsrc.so</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
<varlistentry id="autopoint"> <varlistentry id="autopoint">
<term><command>autopoint</command></term> <term><command>autopoint</command></term>
<listitem> <listitem>
<para>Copies standard Gettext infrastructure files into a source package</para> <para>Copies standard Gettext infrastructure files into a source
<indexterm zone="ch-system-gettext autopoint"><primary sortas="b-autopoint">autopoint</primary></indexterm> package</para>
<indexterm zone="ch-system-gettext autopoint">
<primary sortas="b-autopoint">autopoint</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="config.charset"> <varlistentry id="config.charset">
<term><command>config.charset</command></term> <term><command>config.charset</command></term>
<listitem> <listitem>
<para>Outputs a system-dependent table of character encoding aliases</para> <para>Outputs a system-dependent table of character encoding
<indexterm zone="ch-system-gettext config.charset"><primary sortas="b-config.charset">config.charset</primary></indexterm> aliases</para>
<indexterm zone="ch-system-gettext config.charset">
<primary sortas="b-config.charset">config.charset</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="config.rpath"> <varlistentry id="config.rpath">
<term><command>config.rpath</command></term> <term><command>config.rpath</command></term>
<listitem> <listitem>
<para>Outputs a system-dependent set of variables, describing how to set the <para>Outputs a system-dependent set of variables, describing how
runtime search path of shared libraries in an executable</para> to set the runtime search path of shared libraries in an
<indexterm zone="ch-system-gettext config.rpath"><primary sortas="b-config.rpath">config.rpath</primary></indexterm> executable</para>
<indexterm zone="ch-system-gettext config.rpath">
<primary sortas="b-config.rpath">config.rpath</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -94,7 +124,9 @@ runtime search path of shared libraries in an executable</para>
<term><command>envsubst</command></term> <term><command>envsubst</command></term>
<listitem> <listitem>
<para>Substitutes environment variables in shell format strings</para> <para>Substitutes environment variables in shell format strings</para>
<indexterm zone="ch-system-gettext envsubst"><primary sortas="b-envsubst">envsubst</primary></indexterm> <indexterm zone="ch-system-gettext envsubst">
<primary sortas="b-envsubst">envsubst</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -103,7 +135,9 @@ runtime search path of shared libraries in an executable</para>
<listitem> <listitem>
<para>Translates a natural language message into the user's language <para>Translates a natural language message into the user's language
by looking up the translation in a message catalog</para> by looking up the translation in a message catalog</para>
<indexterm zone="ch-system-gettext gettext"><primary sortas="b-gettext">gettext</primary></indexterm> <indexterm zone="ch-system-gettext gettext">
<primary sortas="b-gettext">gettext</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -112,7 +146,9 @@ by looking up the translation in a message catalog</para>
<listitem> <listitem>
<para>Copies all standard Gettext files into the given top-level <para>Copies all standard Gettext files into the given top-level
directory of a package to begin internationalizing it</para> directory of a package to begin internationalizing it</para>
<indexterm zone="ch-system-gettext gettextize"><primary sortas="b-gettextize">gettextize</primary></indexterm> <indexterm zone="ch-system-gettext gettextize">
<primary sortas="b-gettextize">gettextize</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -120,7 +156,9 @@ directory of a package to begin internationalizing it</para>
<term><command>hostname</command></term> <term><command>hostname</command></term>
<listitem> <listitem>
<para>Displays a network hostname in various forms</para> <para>Displays a network hostname in various forms</para>
<indexterm zone="ch-system-gettext hostname-gettext"><primary sortas="b-hostname-gettext">hostname</primary></indexterm> <indexterm zone="ch-system-gettext hostname-gettext">
<primary sortas="b-hostname-gettext">hostname</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -129,15 +167,20 @@ directory of a package to begin internationalizing it</para>
<listitem> <listitem>
<para>Filters the messages of a translation catalog according to their <para>Filters the messages of a translation catalog according to their
attributes and manipulates the attributes</para> attributes and manipulates the attributes</para>
<indexterm zone="ch-system-gettext msgattrib"><primary sortas="b-msgattrib">msgattrib</primary></indexterm> <indexterm zone="ch-system-gettext msgattrib">
<primary sortas="b-msgattrib">msgattrib</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="msgcat"> <varlistentry id="msgcat">
<term><command>msgcat</command></term> <term><command>msgcat</command></term>
<listitem> <listitem>
<para>Concatenates and merges the given <filename class="extension">.po</filename> files</para> <para>Concatenates and merges the given
<indexterm zone="ch-system-gettext msgcat"><primary sortas="b-msgcat">msgcat</primary></indexterm> <filename class="extension">.po</filename> files</para>
<indexterm zone="ch-system-gettext msgcat">
<primary sortas="b-msgcat">msgcat</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -146,24 +189,31 @@ attributes and manipulates the attributes</para>
<listitem> <listitem>
<para>Compares two <filename class="extension">.po</filename> <para>Compares two <filename class="extension">.po</filename>
files to check that both contain the same set of msgid strings</para> files to check that both contain the same set of msgid strings</para>
<indexterm zone="ch-system-gettext msgcmp"><primary sortas="b-msgcmp">msgcmp</primary></indexterm> <indexterm zone="ch-system-gettext msgcmp">
<primary sortas="b-msgcmp">msgcmp</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="msgcomm"> <varlistentry id="msgcomm">
<term><command>msgcomm</command></term> <term><command>msgcomm</command></term>
<listitem> <listitem>
<para>Finds the messages that are common to <para>Finds the messages that are common to to the given
to the given <filename class="extension">.po</filename> files</para> <filename class="extension">.po</filename> files</para>
<indexterm zone="ch-system-gettext msgcomm"><primary sortas="b-msgcomm">msgcomm</primary></indexterm> <indexterm zone="ch-system-gettext msgcomm">
<primary sortas="b-msgcomm">msgcomm</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="msgconv"> <varlistentry id="msgconv">
<term><command>msgconv</command></term> <term><command>msgconv</command></term>
<listitem> <listitem>
<para>Converts a translation catalog to a different character encoding</para> <para>Converts a translation catalog to a different character
<indexterm zone="ch-system-gettext msgconv"><primary sortas="b-msgconv">msgconv</primary></indexterm> encoding</para>
<indexterm zone="ch-system-gettext msgconv">
<primary sortas="b-msgconv">msgconv</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -171,31 +221,42 @@ to the given <filename class="extension">.po</filename> files</para>
<term><command>msgen</command></term> <term><command>msgen</command></term>
<listitem> <listitem>
<para>Creates an English translation catalog</para> <para>Creates an English translation catalog</para>
<indexterm zone="ch-system-gettext msgen"><primary sortas="b-msgen">msgen</primary></indexterm> <indexterm zone="ch-system-gettext msgen">
<primary sortas="b-msgen">msgen</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="msgexec"> <varlistentry id="msgexec">
<term><command>msgexec</command></term> <term><command>msgexec</command></term>
<listitem> <listitem>
<para>Applies a command to all translations of a translation catalog</para> <para>Applies a command to all translations of a translation
<indexterm zone="ch-system-gettext msgexec"><primary sortas="b-msgexec">msgexec</primary></indexterm> catalog</para>
<indexterm zone="ch-system-gettext msgexec">
<primary sortas="b-msgexec">msgexec</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="msgfilter"> <varlistentry id="msgfilter">
<term><command>msgfilter</command></term> <term><command>msgfilter</command></term>
<listitem> <listitem>
<para>Applies a filter to all translations of a translation catalog</para> <para>Applies a filter to all translations of a translation
<indexterm zone="ch-system-gettext msgfilter"><primary sortas="b-msgfilter">msgfilter</primary></indexterm> catalog</para>
<indexterm zone="ch-system-gettext msgfilter">
<primary sortas="b-msgfilter">msgfilter</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="msgfmt"> <varlistentry id="msgfmt">
<term><command>msgfmt</command></term> <term><command>msgfmt</command></term>
<listitem> <listitem>
<para>Generates a binary message catalog from a translation catalog</para> <para>Generates a binary message catalog from a translation
<indexterm zone="ch-system-gettext msgfmt"><primary sortas="b-msgfmt">msgfmt</primary></indexterm> catalog</para>
<indexterm zone="ch-system-gettext msgfmt">
<primary sortas="b-msgfmt">msgfmt</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -204,16 +265,21 @@ to the given <filename class="extension">.po</filename> files</para>
<listitem> <listitem>
<para>Extracts all messages of a translation catalog that match a <para>Extracts all messages of a translation catalog that match a
given pattern or belong to some given source files</para> given pattern or belong to some given source files</para>
<indexterm zone="ch-system-gettext msggrep"><primary sortas="b-msggrep">msggrep</primary></indexterm> <indexterm zone="ch-system-gettext msggrep">
<primary sortas="b-msggrep">msggrep</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="msginit"> <varlistentry id="msginit">
<term><command>msginit</command></term> <term><command>msginit</command></term>
<listitem> <listitem>
<para>Creates a new <filename class="extension">.po</filename> file, initializing the meta <para>Creates a new <filename class="extension">.po</filename> file,
information with values from the user's environment</para> initializing the meta information with values from the user's
<indexterm zone="ch-system-gettext msginit"><primary sortas="b-msginit">msginit</primary></indexterm> environment</para>
<indexterm zone="ch-system-gettext msginit">
<primary sortas="b-msginit">msginit</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -221,15 +287,20 @@ information with values from the user's environment</para>
<term><command>msgmerge</command></term> <term><command>msgmerge</command></term>
<listitem> <listitem>
<para>Combines two raw translations into a single file</para> <para>Combines two raw translations into a single file</para>
<indexterm zone="ch-system-gettext msgmerge"><primary sortas="b-msgmerge">msgmerge</primary></indexterm> <indexterm zone="ch-system-gettext msgmerge">
<primary sortas="b-msgmerge">msgmerge</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="msgunfmt"> <varlistentry id="msgunfmt">
<term><command>msgunfmt</command></term> <term><command>msgunfmt</command></term>
<listitem> <listitem>
<para>Decompiles a binary message catalog into raw translation text</para> <para>Decompiles a binary message catalog into raw translation
<indexterm zone="ch-system-gettext msgunfmt"><primary sortas="b-msgunfmt">msgunfmt</primary></indexterm> text</para>
<indexterm zone="ch-system-gettext msgunfmt">
<primary sortas="b-msgunfmt">msgunfmt</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -237,7 +308,9 @@ information with values from the user's environment</para>
<term><command>msguniq</command></term> <term><command>msguniq</command></term>
<listitem> <listitem>
<para>Unifies duplicate translations in a translation catalog</para> <para>Unifies duplicate translations in a translation catalog</para>
<indexterm zone="ch-system-gettext msguniq"><primary sortas="b-msguniq">msguniq</primary></indexterm> <indexterm zone="ch-system-gettext msguniq">
<primary sortas="b-msguniq">msguniq</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -246,7 +319,9 @@ information with values from the user's environment</para>
<listitem> <listitem>
<para>Displays native language translations of a textual message whose <para>Displays native language translations of a textual message whose
grammatical form depends on a number</para> grammatical form depends on a number</para>
<indexterm zone="ch-system-gettext ngettext"><primary sortas="b-ngettext">ngettext</primary></indexterm> <indexterm zone="ch-system-gettext ngettext">
<primary sortas="b-ngettext">ngettext</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -255,7 +330,9 @@ grammatical form depends on a number</para>
<listitem> <listitem>
<para>Extracts the translatable message lines from the given source <para>Extracts the translatable message lines from the given source
files to make the first translation template</para> files to make the first translation template</para>
<indexterm zone="ch-system-gettext xgettext"><primary sortas="b-xgettext">xgettext</primary></indexterm> <indexterm zone="ch-system-gettext xgettext">
<primary sortas="b-xgettext">xgettext</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -266,43 +343,51 @@ files to make the first translation template</para>
C formatted output routines usable in C++ programs, for use with the C formatted output routines usable in C++ programs, for use with the
<emphasis>&lt;string&gt;</emphasis> strings and the <emphasis>&lt;string&gt;</emphasis> strings and the
<emphasis>&lt;iostream&gt;</emphasis> streams</para> <emphasis>&lt;iostream&gt;</emphasis> streams</para>
<indexterm zone="ch-system-gettext libasprintf"><primary sortas="c-libasprintf">libasprintf</primary></indexterm> <indexterm zone="ch-system-gettext libasprintf">
<primary sortas="c-libasprintf">libasprintf</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="libgettextlib"> <varlistentry id="libgettextlib">
<term><filename class="libraryfile">libgettextlib</filename></term> <term><filename class="libraryfile">libgettextlib</filename></term>
<listitem> <listitem>
<para>a private library containing common routines used by the various Gettext <para>a private library containing common routines used by the
programs; these are not intended for general use</para> various Gettext programs; these are not intended for general use</para>
<indexterm zone="ch-system-gettext libgettextlib"><primary sortas="c-libgettextlib">libgettextlib</primary></indexterm> <indexterm zone="ch-system-gettext libgettextlib">
<primary sortas="c-libgettextlib">libgettextlib</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="libgettextpo"> <varlistentry id="libgettextpo">
<term><filename class="libraryfile">libgettextpo</filename></term> <term><filename class="libraryfile">libgettextpo</filename></term>
<listitem> <listitem>
<para>Used to write specialized programs that process <filename <para>Used to write specialized programs that process
class="extension">.po</filename> files; this library is used when the <filename class="extension">.po</filename> files; this library is
standard applications shipped with Gettext (such as used when the standard applications shipped with Gettext (such as
<command>msgcomm</command>, <command>msgcmp</command>, <command>msgcomm</command>, <command>msgcmp</command>,
<command>msgattrib</command>, and <command>msgen</command>) will not <command>msgattrib</command>, and <command>msgen</command>) will
suffice</para> not suffice</para>
<indexterm zone="ch-system-gettext libgettextpo"><primary sortas="c-libgettextpo">libgettextpo</primary></indexterm> <indexterm zone="ch-system-gettext libgettextpo">
<primary sortas="c-libgettextpo">libgettextpo</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="libgettextsrc"> <varlistentry id="libgettextsrc">
<term><filename class="libraryfile">libgettextsrc</filename></term> <term><filename class="libraryfile">libgettextsrc</filename></term>
<listitem> <listitem>
<para>A private library containing common routines used by the various Gettext <para>A private library containing common routines used by the
programs; these are not intended for general use</para> various Gettext programs; these are not intended for general use</para>
<indexterm zone="ch-system-gettext libgettextsrc"><primary sortas="c-libgettextsrc">libgettextsrc</primary></indexterm> <indexterm zone="ch-system-gettext libgettextsrc">
<primary sortas="c-libgettextsrc">libgettextsrc</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

518
chapter06/glibc.xml
View File

@ -1,15 +1,22 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-glibc" role="wrap"> <sect1 id="ch-system-glibc" role="wrap">
<title>Glibc-&glibc-version;</title>
<?dbhtml filename="glibc.html"?> <?dbhtml filename="glibc.html"?>
<indexterm zone="ch-system-glibc"><primary sortas="a-Glibc">Glibc</primary></indexterm> <title>Glibc-&glibc-version;</title>
<indexterm zone="ch-system-glibc">
<primary sortas="a-Glibc">Glibc</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Glibc package contains the main C library. This library provides <para>The Glibc package contains the main C library. This library provides
the basic routines for allocating memory, searching directories, opening and the basic routines for allocating memory, searching directories, opening and
closing files, reading and writing files, string handling, pattern matching, closing files, reading and writing files, string handling, pattern matching,
@ -18,27 +25,37 @@ arithmetic, and so on.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>16.7 SBU</seg><seg>500 MB</seg></seglistitem>
<seglistitem>
<seg>16.7 SBU</seg>
<seg>500 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
Gawk, GCC, Gettext, Grep, Make, Perl, Sed, and Texinfo</seg></seglistitem> <seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, Gawk, GCC, Gettext, Grep,
Make, Perl, Sed, and Texinfo</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
<title>Installation of Glibc</title> <title>Installation of Glibc</title>
<note><para>Some packages outside of LFS suggest installing GNU libiconv in <note>
order to translate data from one encoding to another. The project's home page <para>Some packages outside of LFS suggest installing GNU libiconv in
(<ulink url="http://www.gnu.org/software/libiconv/"/>) says <quote>This library order to translate data from one encoding to another. The project's
provides an <function>iconv()</function> implementation, for use on systems home page (<ulink url="http://www.gnu.org/software/libiconv/"/>) says
which don't have one, or whose implementation cannot convert from/to Unicode. <quote>This library provides an <function>iconv()</function>
</quote> Glibc provides an <function>iconv()</function> implementation and can implementation, for use on systems which don't have one, or whose
convert from/to Unicode, therefore libiconv is not required on an LFS implementation cannot convert from/to Unicode.</quote> Glibc provides
system.</para></note> an <function>iconv()</function> implementation and can convert from/to
Unicode, therefore libiconv is not required on an LFS system.</para>
</note>
<para>The Glibc build system is self-contained and will install <para>The Glibc build system is self-contained and will install
perfectly, even though the compiler specs file and linker are still perfectly, even though the compiler specs file and linker are still
@ -47,13 +64,11 @@ and linker cannot be adjusted before the Glibc install because the
Glibc autoconf tests would give false results and defeat the goal Glibc autoconf tests would give false results and defeat the goal
of achieving a clean build.</para> of achieving a clean build.</para>
<para>The glibc-libidn tarball adds support for internationalized <para>The glibc-libidn tarball adds support for internationalized domain
domain names (IDN) to Glibc. Many programs that names (IDN) to Glibc. Many programs that support IDN require the full
support IDN require the full libidn library (see <filename class="libraryfile">libidn</filename> library (see
<ulink url="&blfs-root;view/svn/general/libidn.html"/>), <ulink url="&blfs-root;view/svn/general/libidn.html"/>), not this add-on.
not this add-on. Unpack the tarball from within the Glibc source directory:</para>
Unpack the tarball from within the Glibc source
directory:</para>
<screen><userinput>tar -xf ../glibc-libidn-&glibc-version;.tar.bz2</userinput></screen> <screen><userinput>tar -xf ../glibc-libidn-&glibc-version;.tar.bz2</userinput></screen>
@ -65,11 +80,11 @@ problem:</para>
<screen><userinput>sed -i '/vi_VN.TCVN/d' localedata/SUPPORTED</userinput></screen> <screen><userinput>sed -i '/vi_VN.TCVN/d' localedata/SUPPORTED</userinput></screen>
<para>When running <command>make install</command>, a script called <para>When running <command>make install</command>, a script called
<filename>test-installation.pl</filename> performs a small sanity test <filename>test-installation.pl</filename> performs a small sanity test on
on our newly installed Glibc. However, because our toolchain still points to the our newly installed Glibc. However, because our toolchain still points to
<filename class="directory">/tools</filename> directory, the sanity test would the <filename class="directory">/tools</filename> directory, the sanity
be carried out against the wrong Glibc. We can force the script to check the test would be carried out against the wrong Glibc. We can force the script
Glibc we have just installed with the following:</para> to check the Glibc we have just installed with the following:</para>
<screen><userinput>sed -i \ <screen><userinput>sed -i \
's|libs -o|libs -L/usr/lib -Wl,-dynamic-linker=/lib/ld-linux.so.2 -o|' \ 's|libs -o|libs -L/usr/lib -Wl,-dynamic-linker=/lib/ld-linux.so.2 -o|' \
@ -87,36 +102,40 @@ cd ../glibc-build</userinput></screen>
--disable-profile --enable-add-ons \ --disable-profile --enable-add-ons \
--enable-kernel=2.6.0 --libexecdir=/usr/lib/glibc</userinput></screen> --enable-kernel=2.6.0 --libexecdir=/usr/lib/glibc</userinput></screen>
<para>The meaning of the new configure options:</para>
<variablelist> <variablelist>
<title>The meaning of the new configure options:</title>
<varlistentry> <varlistentry>
<term><parameter>--libexecdir=/usr/lib/glibc</parameter></term> <term><parameter>--libexecdir=/usr/lib/glibc</parameter></term>
<listitem><para>This changes the location of the <listitem>
<command>pt_chown</command> program from its default of <filename <para>This changes the location of the <command>pt_chown</command>
program from its default of <filename
class="directory">/usr/libexec</filename> to <filename class="directory">/usr/libexec</filename> to <filename
class="directory">/usr/lib/glibc</filename>.</para></listitem> class="directory">/usr/lib/glibc</filename>.</para>
</listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Compile the package:</para> <para>Compile the package:</para>
<screen><userinput>make</userinput></screen> <screen><userinput>make</userinput></screen>
<important><para>In this section, the test suite for Glibc is <important>
considered critical. Do not skip it under any <para>In this section, the test suite for Glibc is considered critical.
circumstance.</para></important> Do not skip it under any circumstance.</para>
</important>
<para>Test the results:</para> <para>Test the results:</para>
<screen><userinput>make -k check &gt;glibc-check-log 2&gt;&amp;1 <screen><userinput>make -k check &gt;glibc-check-log 2&gt;&amp;1
grep Error glibc-check-log</userinput></screen> grep Error glibc-check-log</userinput></screen>
<para>On at least i686 you can expect to see failures in the <emphasis>test-double <para>On at least i686 you can expect to see failures in the
</emphasis> and <emphasis>test-idouble</emphasis> math tests with <emphasis>test-double </emphasis> and <emphasis>test-idouble</emphasis>
gcc-&gcc-version;, as well as an expected (ignored) failure in <emphasis> math tests with gcc-&gcc-version;, as well as an expected (ignored)
posix/annexc</emphasis>. These two failures in the math tests appear to be failure in <emphasis> posix/annexc</emphasis>. These two failures in
harmless.</para> the math tests appear to be harmless.</para>
<para>The Glibc test suite is highly dependent on certain functions of <para>The Glibc test suite is highly dependent on certain functions of
the host system, in particular the kernel. In certain circumstances, the host system, in particular the kernel. In certain circumstances,
@ -124,21 +143,26 @@ some failures are unavoidable. This is a list of the most common
issues:</para> issues:</para>
<itemizedlist> <itemizedlist>
<listitem><para>The <emphasis>math</emphasis> tests sometimes fail in other tests <listitem>
when running <para>The <emphasis>math</emphasis> tests sometimes fail in other
on systems where the CPU is not a relatively new genuine Intel or authentic AMD. tests when running on systems where the CPU is not a relatively
Certain optimization settings are also known to be a factor here.</para></listitem> new genuine Intel or authentic AMD. Certain optimization settings
are also known to be a factor here.</para>
<listitem><para>The <emphasis>gettext</emphasis> test sometimes fails due to </listitem>
host system issues. The exact reasons are not yet clear.</para></listitem> <listitem>
<para>The <emphasis>gettext</emphasis> test sometimes fails due to
<listitem><para>If you have mounted the LFS partition with the host system issues. The exact reasons are not yet clear.</para>
<parameter>noatime</parameter> option, the <emphasis>atime</emphasis> test will </listitem>
fail. As mentioned in <xref linkend="space-mounting"/>, do not use the <listitem>
<parameter>noatime</parameter> option while building LFS.</para></listitem> <para>If you have mounted the LFS partition with the
<parameter>noatime</parameter> option, the <emphasis>atime</emphasis>
<listitem><para>When running on older and slower hardware, some tests test will fail. As mentioned in <xref linkend="space-mounting"/>, do not
can fail because of test timeouts being exceeded.</para></listitem> use the <parameter>noatime</parameter> option while building LFS.</para>
</listitem>
<listitem>
<para>When running on older and slower hardware, some tests
can fail because of test timeouts being exceeded.</para>
</listitem>
</itemizedlist> </itemizedlist>
<para>Though it is a harmless message, the install stage of Glibc will <para>Though it is a harmless message, the install stage of Glibc will
@ -151,20 +175,21 @@ Prevent this warning with:</para>
<screen><userinput>make install</userinput></screen> <screen><userinput>make install</userinput></screen>
<para>The locales that can make the system respond in a different <para>The locales that can make the system respond in a different language
language were not installed by the above command. None of the were not installed by the above command. None of the locales are required,
locales are required, but, if some of them are misssing, testuites of the but, if some of them are misssing, testuites of the future packages would
future packages would skip important testcases.</para> skip important testcases.</para>
<para>Individual locales can be installed using the <command>localedef</command> <para>Individual locales can be installed using the
program. E.g., the first <command>localedef</command> command below combines <command>localedef</command> program. E.g., the first
the <filename>/usr/share/i18n/locales/de_DE</filename> charset-independent <command>localedef</command> command below combines the
locale definition with the <filename>/usr/share/i18n/locales/de_DE</filename>
<filename>/usr/share/i18n/charmaps/ISO-8859-1.gz</filename> charmap definition charset-independent locale definition with the
and appends the result to the <filename>/usr/share/i18n/charmaps/ISO-8859-1.gz</filename>
<filename>/usr/lib/locale/locale-archive</filename> file. The following charmap definition and appends the result to the
instructions will install the minimum set of locales necessary <filename>/usr/lib/locale/locale-archive</filename> file.
for the optimal coverage of tests:</para> The following instructions will install the minimum set of
locales necessary for the optimal coverage of tests:</para>
<screen role="nodump"><userinput>mkdir -pv /usr/lib/locale <screen role="nodump"><userinput>mkdir -pv /usr/lib/locale
localedef -i de_DE -f ISO-8859-1 de_DE localedef -i de_DE -f ISO-8859-1 de_DE
@ -184,10 +209,10 @@ localedef -i ja_JP -f EUC-JP ja_JP</userinput></screen>
<para>In addition, install the locale for your own country, language and <para>In addition, install the locale for your own country, language and
character set.</para> character set.</para>
<para>Alternatively, install all locales <para>Alternatively, install all locales listed in the
listed in the <filename>glibc-&glibc-version;/localedata/SUPPORTED</filename> <filename>glibc-&glibc-version;/localedata/SUPPORTED</filename> file
file (it includes every locale listed above and many more) (it includes every locale listed above and many more) at once with the
at once with the following time-consuming command:</para> following time-consuming command:</para>
<screen><userinput>make localedata/install-locales</userinput></screen> <screen><userinput>make localedata/install-locales</userinput></screen>
@ -200,9 +225,16 @@ running localedef, the results are equivalent -->
</sect2> </sect2>
<sect2 id="conf-glibc" role="configuration"><title>Configuring Glibc</title> <sect2 id="conf-glibc" role="configuration">
<indexterm zone="conf-glibc"><primary sortas="e-/etc/nsswitch.conf">/etc/nsswitch.conf</primary></indexterm> <title>Configuring Glibc</title>
<indexterm zone="conf-glibc"><primary sortas="e-/etc/localtime">/etc/localtime</primary></indexterm>
<indexterm zone="conf-glibc">
<primary sortas="e-/etc/nsswitch.conf">/etc/nsswitch.conf</primary>
</indexterm>
<indexterm zone="conf-glibc">
<primary sortas="e-/etc/localtime">/etc/localtime</primary>
</indexterm>
<para>The <filename>/etc/nsswitch.conf</filename> file needs to be created <para>The <filename>/etc/nsswitch.conf</filename> file needs to be created
because, although Glibc provides defaults when this file is missing or corrupt, because, although Glibc provides defaults when this file is missing or corrupt,
@ -234,11 +266,10 @@ EOF</userinput></screen>
<screen role="nodump"><userinput>tzselect</userinput></screen> <screen role="nodump"><userinput>tzselect</userinput></screen>
<para>After answering a few questions about the location, the script <para>After answering a few questions about the location, the script will
will output the name of the time zone (e.g., output the name of the time zone (e.g., <emphasis>EST5EDT</emphasis> or
<emphasis>EST5EDT</emphasis> or <emphasis>Canada/Eastern</emphasis>). <emphasis>Canada/Eastern</emphasis>). Then create the
Then create the <filename>/etc/localtime</filename> file by <filename>/etc/localtime</filename> file by running:</para>
running:</para>
<screen><userinput>cp -v --remove-destination /usr/share/zoneinfo/<replaceable>[xxx]</replaceable> \ <screen><userinput>cp -v --remove-destination /usr/share/zoneinfo/<replaceable>[xxx]</replaceable> \
/etc/localtime</userinput></screen> /etc/localtime</userinput></screen>
@ -246,26 +277,30 @@ running:</para>
<para>Replace <replaceable>[xxx]</replaceable> with the name of the time zone <para>Replace <replaceable>[xxx]</replaceable> with the name of the time zone
that <command>tzselect</command> provided (e.g., Canada/Eastern).</para> that <command>tzselect</command> provided (e.g., Canada/Eastern).</para>
<para>The meaning of the cp option:</para>
<variablelist> <variablelist>
<title>The meaning of the cp option:</title>
<varlistentry> <varlistentry>
<term><parameter>--remove-destination</parameter></term> <term><parameter>--remove-destination</parameter></term>
<listitem><para>This is needed to force removal of the already <listitem>
existing symbolic link. The reason for copying the file instead of <para>This is needed to force removal of the already existing symbolic
using a symlink is to cover the situation where <filename link. The reason for copying the file instead of using a symlink is to
class="directory">/usr</filename> is on a separate partition. This cover the situation where <filename class="directory">/usr</filename>
could be important when booted into single user is on a separate partition. This could be important when booted into
mode.</para></listitem> single user mode.</para>
</listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
<sect2 id="conf-ld" role="configuration"> <sect2 id="conf-ld" role="configuration">
<title>Configuring the Dynamic Loader</title> <title>Configuring the Dynamic Loader</title>
<indexterm zone="conf-ld"><primary sortas="e-/etc/ld.so.conf">/etc/ld.so.conf</primary></indexterm>
<indexterm zone="conf-ld">
<primary sortas="e-/etc/ld.so.conf">/etc/ld.so.conf</primary>
</indexterm>
<para>By default, the dynamic loader (<filename <para>By default, the dynamic loader (<filename
class="libraryfile">/lib/ld-linux.so.2</filename>) searches through class="libraryfile">/lib/ld-linux.so.2</filename>) searches through
@ -273,10 +308,10 @@ class="libraryfile">/lib/ld-linux.so.2</filename>) searches through
class="directory">/usr/lib</filename> for dynamic libraries that are class="directory">/usr/lib</filename> for dynamic libraries that are
needed by programs as they are run. However, if there are libraries in needed by programs as they are run. However, if there are libraries in
directories other than <filename class="directory">/lib</filename> and directories other than <filename class="directory">/lib</filename> and
<filename class="directory">/usr/lib</filename>, these need to be <filename class="directory">/usr/lib</filename>, these need to be added
added to the <filename>/etc/ld.so.conf</filename> file in order to the <filename>/etc/ld.so.conf</filename> file in order for the
for the dynamic loader to find them. Two directories that are commonly dynamic loader to find them. Two directories that are commonly known
known to contain additional libraries are <filename to contain additional libraries are <filename
class="directory">/usr/local/lib</filename> and <filename class="directory">/usr/local/lib</filename> and <filename
class="directory">/opt/lib</filename>, so add those directories to the class="directory">/opt/lib</filename>, so add those directories to the
dynamic loader's search path.</para> dynamic loader's search path.</para>
@ -295,25 +330,30 @@ EOF</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-glibc" role="content"><title>Contents of Glibc</title> <sect2 id="contents-glibc" role="content">
<title>Contents of Glibc</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<segtitle>Installed libraries</segtitle> <segtitle>Installed libraries</segtitle>
<seglistitem><seg>catchsegv, gencat, getconf,
getent, iconv, iconvconfig, ldconfig, ldd, lddlibc4, locale, <seglistitem>
localedef, mtrace, nscd, nscd_nischeck, pcprofiledump, pt_chown, rpcgen, <seg>catchsegv, gencat, getconf, getent, iconv, iconvconfig, ldconfig,
rpcinfo, sln, sprof, tzselect, xtrace, zdump, and zic</seg> ldd, lddlibc4, locale, localedef, mtrace, nscd, nscd_nischeck,
<seg>ld.so, libBrokenLocale.[a,so], pcprofiledump, pt_chown, rpcgen, rpcinfo, sln, sprof, tzselect, xtrace,
libSegFault.so, libanl.[a,so], libbsd-compat.a, libc.[a,so], libcidn.so, zdump, and zic</seg>
libcrypt.[a,so], libdl.[a,so], libg.a, libieee.a, libm.[a,so], libmcheck.a, <seg>ld.so, libBrokenLocale.[a,so], libSegFault.so, libanl.[a,so],
libmemusage.so, libnsl.a, libnss_compat.so, libnss_dns.so, libnss_files.so, libbsd-compat.a, libc.[a,so], libcidn.so, libcrypt.[a,so], libdl.[a,so],
libnss_hesiod.so, libnss_nis.so, libnss_nisplus.so, libpcprofile.so, libg.a, libieee.a, libm.[a,so], libmcheck.a, libmemusage.so, libnsl.a,
libpthread.[a,so], libresolv.[a,so], librpcsvc.a, librt.[a,so], libnss_compat.so, libnss_dns.so, libnss_files.so, libnss_hesiod.so,
libthread_db.so, and libutil.[a,so]</seg></seglistitem> libnss_nis.so, libnss_nisplus.so, libpcprofile.so, libpthread.[a,so],
libresolv.[a,so], librpcsvc.a, librt.[a,so], libthread_db.so, and
libutil.[a,so]</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
@ -322,7 +362,9 @@ libthread_db.so, and libutil.[a,so]</seg></seglistitem>
<listitem> <listitem>
<para>Can be used to create a stack trace when a program <para>Can be used to create a stack trace when a program
terminates with a segmentation fault</para> terminates with a segmentation fault</para>
<indexterm zone="ch-system-glibc catchsegv"><primary sortas="b-catchsegv">catchsegv</primary></indexterm> <indexterm zone="ch-system-glibc catchsegv">
<primary sortas="b-catchsegv">catchsegv</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -330,15 +372,20 @@ terminates with a segmentation fault</para>
<term><command>gencat</command></term> <term><command>gencat</command></term>
<listitem> <listitem>
<para>Generates message catalogues</para> <para>Generates message catalogues</para>
<indexterm zone="ch-system-glibc gencat"><primary sortas="b-gencat">gencat</primary></indexterm> <indexterm zone="ch-system-glibc gencat">
<primary sortas="b-gencat">gencat</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="getconf"> <varlistentry id="getconf">
<term><command>getconf</command></term> <term><command>getconf</command></term>
<listitem> <listitem>
<para>Displays the system configuration values for file system specific variables</para> <para>Displays the system configuration values for file system
<indexterm zone="ch-system-glibc getconf"><primary sortas="b-getconf">getconf</primary></indexterm> specific variables</para>
<indexterm zone="ch-system-glibc getconf">
<primary sortas="b-getconf">getconf</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -346,7 +393,9 @@ terminates with a segmentation fault</para>
<term><command>getent</command></term> <term><command>getent</command></term>
<listitem> <listitem>
<para>Gets entries from an administrative database</para> <para>Gets entries from an administrative database</para>
<indexterm zone="ch-system-glibc getent"><primary sortas="b-getent">getent</primary></indexterm> <indexterm zone="ch-system-glibc getent">
<primary sortas="b-getent">getent</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -354,15 +403,20 @@ terminates with a segmentation fault</para>
<term><command>iconv</command></term> <term><command>iconv</command></term>
<listitem> <listitem>
<para>Performs character set conversion</para> <para>Performs character set conversion</para>
<indexterm zone="ch-system-glibc iconv"><primary sortas="b-iconv">iconv</primary></indexterm> <indexterm zone="ch-system-glibc iconv">
<primary sortas="b-iconv">iconv</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="iconvconfig"> <varlistentry id="iconvconfig">
<term><command>iconvconfig</command></term> <term><command>iconvconfig</command></term>
<listitem> <listitem>
<para>Creates fastloading <command>iconv</command> module configuration files</para> <para>Creates fastloading <command>iconv</command> module configuration
<indexterm zone="ch-system-glibc iconvconfig"><primary sortas="b-iconvconfig">iconvconfig</primary></indexterm> files</para>
<indexterm zone="ch-system-glibc iconvconfig">
<primary sortas="b-iconvconfig">iconvconfig</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -370,7 +424,9 @@ terminates with a segmentation fault</para>
<term><command>ldconfig</command></term> <term><command>ldconfig</command></term>
<listitem> <listitem>
<para>Configures the dynamic linker runtime bindings</para> <para>Configures the dynamic linker runtime bindings</para>
<indexterm zone="ch-system-glibc ldconfig"><primary sortas="b-ldconfig">ldconfig</primary></indexterm> <indexterm zone="ch-system-glibc ldconfig">
<primary sortas="b-ldconfig">ldconfig</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -379,7 +435,9 @@ terminates with a segmentation fault</para>
<listitem> <listitem>
<para>Reports which shared libraries are required <para>Reports which shared libraries are required
by each given program or shared library</para> by each given program or shared library</para>
<indexterm zone="ch-system-glibc ldd"><primary sortas="b-ldd">ldd</primary></indexterm> <indexterm zone="ch-system-glibc ldd">
<primary sortas="b-ldd">ldd</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -387,7 +445,9 @@ by each given program or shared library</para>
<term><command>lddlibc4</command></term> <term><command>lddlibc4</command></term>
<listitem> <listitem>
<para>Assists <command>ldd</command> with object files</para> <para>Assists <command>ldd</command> with object files</para>
<indexterm zone="ch-system-glibc lddlibc4"><primary sortas="b-lddlibc4">lddlibc4</primary></indexterm> <indexterm zone="ch-system-glibc lddlibc4">
<primary sortas="b-lddlibc4">lddlibc4</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -395,7 +455,9 @@ by each given program or shared library</para>
<term><command>locale</command></term> <term><command>locale</command></term>
<listitem> <listitem>
<para>Prints various information about the current locale</para> <para>Prints various information about the current locale</para>
<indexterm zone="ch-system-glibc locale"><primary sortas="b-locale">locale</primary></indexterm> <indexterm zone="ch-system-glibc locale">
<primary sortas="b-locale">locale</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -403,15 +465,20 @@ by each given program or shared library</para>
<term><command>localedef</command></term> <term><command>localedef</command></term>
<listitem> <listitem>
<para>Compiles locale specifications</para> <para>Compiles locale specifications</para>
<indexterm zone="ch-system-glibc localedef"><primary sortas="b-localedef">localedef</primary></indexterm> <indexterm zone="ch-system-glibc localedef">
<primary sortas="b-localedef">localedef</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="mtrace"> <varlistentry id="mtrace">
<term><command>mtrace</command></term> <term><command>mtrace</command></term>
<listitem> <listitem>
<para>Reads and interprets a memory trace file and displays a summary in human-readable format</para> <para>Reads and interprets a memory trace file and displays a summary
<indexterm zone="ch-system-glibc mtrace"><primary sortas="b-mtrace">mtrace</primary></indexterm> in human-readable format</para>
<indexterm zone="ch-system-glibc mtrace">
<primary sortas="b-mtrace">mtrace</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -420,15 +487,20 @@ by each given program or shared library</para>
<listitem> <listitem>
<para>A daemon that provides a cache for the most common name <para>A daemon that provides a cache for the most common name
service requests</para> service requests</para>
<indexterm zone="ch-system-glibc nscd"><primary sortas="b-nscd">nscd</primary></indexterm> <indexterm zone="ch-system-glibc nscd">
<primary sortas="b-nscd">nscd</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="nscd_nischeck"> <varlistentry id="nscd_nischeck">
<term><command>nscd_nischeck</command></term> <term><command>nscd_nischeck</command></term>
<listitem> <listitem>
<para>Checks whether or not secure mode is necessary for NIS+ lookup</para> <para>Checks whether or not secure mode is necessary for NIS+
<indexterm zone="ch-system-glibc nscd_nischeck"><primary sortas="b-nscd_nischeck">nscd_nischeck</primary></indexterm> lookup</para>
<indexterm zone="ch-system-glibc nscd_nischeck">
<primary sortas="b-nscd_nischeck">nscd_nischeck</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -436,24 +508,31 @@ service requests</para>
<term><command>pcprofiledump</command></term> <term><command>pcprofiledump</command></term>
<listitem> <listitem>
<para>Dumps information generated by PC profiling</para> <para>Dumps information generated by PC profiling</para>
<indexterm zone="ch-system-glibc pcprofiledump"><primary sortas="b-pcprofiledump">pcprofiledump</primary></indexterm> <indexterm zone="ch-system-glibc pcprofiledump">
<primary sortas="b-pcprofiledump">pcprofiledump</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="pt_chown"> <varlistentry id="pt_chown">
<term><command>pt_chown</command></term> <term><command>pt_chown</command></term>
<listitem> <listitem>
<para>A helper program for <command>grantpt</command> to set <para>A helper program for <command>grantpt</command> to set the owner,
the owner, group and access permissions of a slave pseudo terminal</para> group and access permissions of a slave pseudo terminal</para>
<indexterm zone="ch-system-glibc pt_chown"><primary sortas="b-pt_chown">pt_chown</primary></indexterm> <indexterm zone="ch-system-glibc pt_chown">
<primary sortas="b-pt_chown">pt_chown</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="rpcgen"> <varlistentry id="rpcgen">
<term><command>rpcgen</command></term> <term><command>rpcgen</command></term>
<listitem> <listitem>
<para>Generates C code to implement the Remote Procecure Call (RPC) protocol</para> <para>Generates C code to implement the Remote Procecure Call (RPC)
<indexterm zone="ch-system-glibc rpcgen"><primary sortas="b-rpcgen">rpcgen</primary></indexterm> protocol</para>
<indexterm zone="ch-system-glibc rpcgen">
<primary sortas="b-rpcgen">rpcgen</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -461,7 +540,9 @@ the owner, group and access permissions of a slave pseudo terminal</para>
<term><command>rpcinfo</command></term> <term><command>rpcinfo</command></term>
<listitem> <listitem>
<para>Makes an RPC call to an RPC server</para> <para>Makes an RPC call to an RPC server</para>
<indexterm zone="ch-system-glibc rpcinfo"><primary sortas="b-rpcinfo">rpcinfo</primary></indexterm> <indexterm zone="ch-system-glibc rpcinfo">
<primary sortas="b-rpcinfo">rpcinfo</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -469,7 +550,9 @@ the owner, group and access permissions of a slave pseudo terminal</para>
<term><command>sln</command></term> <term><command>sln</command></term>
<listitem> <listitem>
<para>A statically linked <command>ln</command> program</para> <para>A statically linked <command>ln</command> program</para>
<indexterm zone="ch-system-glibc sln"><primary sortas="b-sln">sln</primary></indexterm> <indexterm zone="ch-system-glibc sln">
<primary sortas="b-sln">sln</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -477,25 +560,31 @@ the owner, group and access permissions of a slave pseudo terminal</para>
<term><command>sprof</command></term> <term><command>sprof</command></term>
<listitem> <listitem>
<para>Reads and displays shared object profiling data</para> <para>Reads and displays shared object profiling data</para>
<indexterm zone="ch-system-glibc sprof"><primary sortas="b-sprof">sprof</primary></indexterm> <indexterm zone="ch-system-glibc sprof">
<primary sortas="b-sprof">sprof</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="tzselect"> <varlistentry id="tzselect">
<term><command>tzselect</command></term> <term><command>tzselect</command></term>
<listitem> <listitem>
<para>Asks the user about the location of the <para>Asks the user about the location of the system and reports
system and reports the corresponding time zone description</para> the corresponding time zone description</para>
<indexterm zone="ch-system-glibc tzselect"><primary sortas="b-tzselect">tzselect</primary></indexterm> <indexterm zone="ch-system-glibc tzselect">
<primary sortas="b-tzselect">tzselect</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="xtrace"> <varlistentry id="xtrace">
<term><command>xtrace</command></term> <term><command>xtrace</command></term>
<listitem> <listitem>
<para>Traces the execution of a program by <para>Traces the execution of a program by printing the currently
printing the currently executed function</para> executed function</para>
<indexterm zone="ch-system-glibc xtrace"><primary sortas="b-xtrace">xtrace</primary></indexterm> <indexterm zone="ch-system-glibc xtrace">
<primary sortas="b-xtrace">xtrace</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -503,7 +592,9 @@ printing the currently executed function</para>
<term><command>zdump</command></term> <term><command>zdump</command></term>
<listitem> <listitem>
<para>The time zone dumper</para> <para>The time zone dumper</para>
<indexterm zone="ch-system-glibc zdump"><primary sortas="b-zdump">zdump</primary></indexterm> <indexterm zone="ch-system-glibc zdump">
<primary sortas="b-zdump">zdump</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -511,7 +602,9 @@ printing the currently executed function</para>
<term><command>zic</command></term> <term><command>zic</command></term>
<listitem> <listitem>
<para>The time zone compiler</para> <para>The time zone compiler</para>
<indexterm zone="ch-system-glibc zic"><primary sortas="b-zic">zic</primary></indexterm> <indexterm zone="ch-system-glibc zic">
<primary sortas="b-zic">zic</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -519,7 +612,9 @@ printing the currently executed function</para>
<term><filename class="libraryfile">ld.so</filename></term> <term><filename class="libraryfile">ld.so</filename></term>
<listitem> <listitem>
<para>The helper program for shared library executables</para> <para>The helper program for shared library executables</para>
<indexterm zone="ch-system-glibc ld.so"><primary sortas="c-ld.so">ld.so</primary></indexterm> <indexterm zone="ch-system-glibc ld.so">
<primary sortas="c-ld.so">ld.so</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -528,9 +623,11 @@ printing the currently executed function</para>
<listitem> <listitem>
<para>Used internally by Glibc as a gross hack to get broken programs <para>Used internally by Glibc as a gross hack to get broken programs
(e.g., some Motif applications) running. See comments in (e.g., some Motif applications) running. See comments in
<filename>glibc-&glibc-version;/locale/broken_cur_max.c</filename> for more <filename>glibc-&glibc-version;/locale/broken_cur_max.c</filename>
information</para> for more information</para>
<indexterm zone="ch-system-glibc libBrokenLocale"><primary sortas="c-libBrokenLocale">libBrokenLocale</primary></indexterm> <indexterm zone="ch-system-glibc libBrokenLocale">
<primary sortas="c-libBrokenLocale">libBrokenLocale</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -539,7 +636,9 @@ information</para>
<listitem> <listitem>
<para>The segmentation fault signal handler, used by <para>The segmentation fault signal handler, used by
<command>catchsegv</command></para> <command>catchsegv</command></para>
<indexterm zone="ch-system-glibc libSegFault"><primary sortas="c-libSegFault">libSegFault</primary></indexterm> <indexterm zone="ch-system-glibc libSegFault">
<primary sortas="c-libSegFault">libSegFault</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -547,16 +646,20 @@ information</para>
<term><filename class="libraryfile">libanl</filename></term> <term><filename class="libraryfile">libanl</filename></term>
<listitem> <listitem>
<para>An asynchronous name lookup library</para> <para>An asynchronous name lookup library</para>
<indexterm zone="ch-system-glibc libanl"><primary sortas="c-libanl">libanl</primary></indexterm> <indexterm zone="ch-system-glibc libanl">
<primary sortas="c-libanl">libanl</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="libbsd-compat"> <varlistentry id="libbsd-compat">
<term><filename class="libraryfile">libbsd-compat</filename></term> <term><filename class="libraryfile">libbsd-compat</filename></term>
<listitem> <listitem>
<para>Provides the portability needed <para>Provides the portability needed in order to run certain Berkey
in order to run certain Berkey Software Distribution (BSD) programs under Linux</para> Software Distribution (BSD) programs under Linux</para>
<indexterm zone="ch-system-glibc libbsd-compat"><primary sortas="c-libbsd-compat">libbsd-compat</primary></indexterm> <indexterm zone="ch-system-glibc libbsd-compat">
<primary sortas="c-libbsd-compat">libbsd-compat</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -564,16 +667,20 @@ in order to run certain Berkey Software Distribution (BSD) programs under Linux<
<term><filename class="libraryfile">libc</filename></term> <term><filename class="libraryfile">libc</filename></term>
<listitem> <listitem>
<para>The main C library</para> <para>The main C library</para>
<indexterm zone="ch-system-glibc libc"><primary sortas="c-libc">libc</primary></indexterm> <indexterm zone="ch-system-glibc libc">
<primary sortas="c-libc">libc</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="libcidn"> <varlistentry id="libcidn">
<term><filename class="libraryfile">libcidn</filename></term> <term><filename class="libraryfile">libcidn</filename></term>
<listitem> <listitem>
<para>Used internally by Glibc for handling internationalized domain names in <para>Used internally by Glibc for handling internationalized domain
the <function>getaddrinfo()</function> function</para> names in the <function>getaddrinfo()</function> function</para>
<indexterm zone="ch-system-glibc libcrypt"><primary sortas="c-libcrypt">libcrypt</primary></indexterm> <indexterm zone="ch-system-glibc libcrypt">
<primary sortas="c-libcrypt">libcrypt</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -581,7 +688,9 @@ the <function>getaddrinfo()</function> function</para>
<term><filename class="libraryfile">libcrypt</filename></term> <term><filename class="libraryfile">libcrypt</filename></term>
<listitem> <listitem>
<para>The cryptography library</para> <para>The cryptography library</para>
<indexterm zone="ch-system-glibc libcrypt"><primary sortas="c-libcrypt">libcrypt</primary></indexterm> <indexterm zone="ch-system-glibc libcrypt">
<primary sortas="c-libcrypt">libcrypt</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -589,26 +698,32 @@ the <function>getaddrinfo()</function> function</para>
<term><filename class="libraryfile">libdl</filename></term> <term><filename class="libraryfile">libdl</filename></term>
<listitem> <listitem>
<para>The dynamic linking interface library</para> <para>The dynamic linking interface library</para>
<indexterm zone="ch-system-glibc libdl"><primary sortas="c-libdl">libdl</primary></indexterm> <indexterm zone="ch-system-glibc libdl">
<primary sortas="c-libdl">libdl</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="libg"> <varlistentry id="libg">
<term><filename class="libraryfile">libg</filename></term> <term><filename class="libraryfile">libg</filename></term>
<listitem> <listitem>
<para>Dummy library containing no functions. Previously was a runtime library <para>Dummy library containing no functions. Previously was a runtime
for <command>g++</command></para> library for <command>g++</command></para>
<indexterm zone="ch-system-glibc libg"><primary sortas="c-libg">libg</primary></indexterm> <indexterm zone="ch-system-glibc libg">
<primary sortas="c-libg">libg</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="libieee"> <varlistentry id="libieee">
<term><filename class="libraryfile">libieee</filename></term> <term><filename class="libraryfile">libieee</filename></term>
<listitem> <listitem>
<para>Linking in this module forces error handling rules for math functions as <para>Linking in this module forces error handling rules for math
defined by the Institute of Electrical and Electronic Engineers (IEEE). functions as defined by the Institute of Electrical and Electronic
The default is POSIX.1 error handling</para> Engineers (IEEE). The default is POSIX.1 error handling</para>
<indexterm zone="ch-system-glibc libieee"><primary sortas="c-libieee">libieee</primary></indexterm> <indexterm zone="ch-system-glibc libieee">
<primary sortas="c-libieee">libieee</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -616,7 +731,9 @@ The default is POSIX.1 error handling</para>
<term><filename class="libraryfile">libm</filename></term> <term><filename class="libraryfile">libm</filename></term>
<listitem> <listitem>
<para>The mathematical library</para> <para>The mathematical library</para>
<indexterm zone="ch-system-glibc libm"><primary sortas="c-libm">libm</primary></indexterm> <indexterm zone="ch-system-glibc libm">
<primary sortas="c-libm">libm</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -624,7 +741,9 @@ The default is POSIX.1 error handling</para>
<term><filename class="libraryfile">libmcheck</filename></term> <term><filename class="libraryfile">libmcheck</filename></term>
<listitem> <listitem>
<para>Turns on memory allocation checking when linked to</para> <para>Turns on memory allocation checking when linked to</para>
<indexterm zone="ch-system-glibc libmcheck"><primary sortas="c-libmcheck">libmcheck</primary></indexterm> <indexterm zone="ch-system-glibc libmcheck">
<primary sortas="c-libmcheck">libmcheck</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -633,7 +752,9 @@ The default is POSIX.1 error handling</para>
<listitem> <listitem>
<para>Used by <command>memusage</command> to help collect <para>Used by <command>memusage</command> to help collect
information about the memory usage of a program</para> information about the memory usage of a program</para>
<indexterm zone="ch-system-glibc libmemusage"><primary sortas="c-libmemusage">libmemusage</primary></indexterm> <indexterm zone="ch-system-glibc libmemusage">
<primary sortas="c-libmemusage">libmemusage</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -641,26 +762,32 @@ information about the memory usage of a program</para>
<term><filename class="libraryfile">libnsl</filename></term> <term><filename class="libraryfile">libnsl</filename></term>
<listitem> <listitem>
<para>The network services library</para> <para>The network services library</para>
<indexterm zone="ch-system-glibc libnsl"><primary sortas="c-libnsl">libnsl</primary></indexterm> <indexterm zone="ch-system-glibc libnsl">
<primary sortas="c-libnsl">libnsl</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="libnss"> <varlistentry id="libnss">
<term><filename class="libraryfile">libnss</filename></term> <term><filename class="libraryfile">libnss</filename></term>
<listitem> <listitem>
<para>The Name Service Switch libraries, <para>The Name Service Switch libraries, containing functions for
containing functions for resolving host names, user names, group names, resolving host names, user names, group names, aliases, services,
aliases, services, protocols, etc.</para> protocols, etc.</para>
<indexterm zone="ch-system-glibc libnss"><primary sortas="c-libnss">libnss</primary></indexterm> <indexterm zone="ch-system-glibc libnss">
<primary sortas="c-libnss">libnss</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="libpcprofile"> <varlistentry id="libpcprofile">
<term><filename class="libraryfile">libpcprofile</filename></term> <term><filename class="libraryfile">libpcprofile</filename></term>
<listitem> <listitem>
<para>Contains profiling functions used <para>Contains profiling functions used to track the amount of CPU
to track the amount of CPU time spent in specific source code lines</para> time spent in specific source code lines</para>
<indexterm zone="ch-system-glibc libpcprofile"><primary sortas="c-libpcprofile">libpcprofile</primary></indexterm> <indexterm zone="ch-system-glibc libpcprofile">
<primary sortas="c-libpcprofile">libpcprofile</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -668,16 +795,20 @@ to track the amount of CPU time spent in specific source code lines</para>
<term><filename class="libraryfile">libpthread</filename></term> <term><filename class="libraryfile">libpthread</filename></term>
<listitem> <listitem>
<para>The POSIX threads library</para> <para>The POSIX threads library</para>
<indexterm zone="ch-system-glibc libpthread"><primary sortas="c-libpthread">libpthread</primary></indexterm> <indexterm zone="ch-system-glibc libpthread">
<primary sortas="c-libpthread">libpthread</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="libresolv"> <varlistentry id="libresolv">
<term><filename class="libraryfile">libresolv</filename></term> <term><filename class="libraryfile">libresolv</filename></term>
<listitem> <listitem>
<para>Contains functions for creating, <para>Contains functions for creating, sending, and interpreting
sending, and interpreting packets to the Internet domain name servers</para> packets to the Internet domain name servers</para>
<indexterm zone="ch-system-glibc libresolv"><primary sortas="c-libresolv">libresolv</primary></indexterm> <indexterm zone="ch-system-glibc libresolv">
<primary sortas="c-libresolv">libresolv</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -685,38 +816,47 @@ sending, and interpreting packets to the Internet domain name servers</para>
<term><filename class="libraryfile">librpcsvc</filename></term> <term><filename class="libraryfile">librpcsvc</filename></term>
<listitem> <listitem>
<para>Contains functions providing miscellaneous RPC services</para> <para>Contains functions providing miscellaneous RPC services</para>
<indexterm zone="ch-system-glibc librpcsvc"><primary sortas="c-librpcsvc">librpcsvc</primary></indexterm> <indexterm zone="ch-system-glibc librpcsvc">
<primary sortas="c-librpcsvc">librpcsvc</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="librt"> <varlistentry id="librt">
<term><filename class="libraryfile">librt</filename></term> <term><filename class="libraryfile">librt</filename></term>
<listitem> <listitem>
<para>Contains functions providing most of the <para>Contains functions providing most of the interfaces specified
interfaces specified by the POSIX.1b Realtime Extension</para> by the POSIX.1b Realtime Extension</para>
<indexterm zone="ch-system-glibc librt"><primary sortas="c-librt">librt</primary></indexterm> <indexterm zone="ch-system-glibc librt">
<primary sortas="c-librt">librt</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="libthread_db"> <varlistentry id="libthread_db">
<term><filename class="libraryfile">libthread_db</filename></term> <term><filename class="libraryfile">libthread_db</filename></term>
<listitem> <listitem>
<para>Contains functions useful for <para>Contains functions useful for building debuggers for
building debuggers for multi-threaded programs</para> multi-threaded programs</para>
<indexterm zone="ch-system-glibc libthread_db"><primary sortas="c-libthread_db">libthread_db</primary></indexterm> <indexterm zone="ch-system-glibc libthread_db">
<primary sortas="c-libthread_db">libthread_db</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="libutil"> <varlistentry id="libutil">
<term><filename class="libraryfile">libutil</filename></term> <term><filename class="libraryfile">libutil</filename></term>
<listitem> <listitem>
<para>Contains code for <quote>standard</quote> functions used in many different Unix utilities</para> <para>Contains code for <quote>standard</quote> functions used in
<indexterm zone="ch-system-glibc libutil"><primary sortas="c-libutil">libutil</primary></indexterm> many different Unix utilities</para>
<indexterm zone="ch-system-glibc libutil">
<primary sortas="c-libutil">libutil</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

55
chapter06/grep.xml
View File

@ -1,28 +1,43 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-grep" role="wrap"> <sect1 id="ch-system-grep" role="wrap">
<title>Grep-&grep-version;</title>
<?dbhtml filename="grep.html"?> <?dbhtml filename="grep.html"?>
<indexterm zone="ch-system-grep"><primary sortas="a-Grep">Grep</primary></indexterm> <title>Grep-&grep-version;</title>
<indexterm zone="ch-system-grep">
<primary sortas="a-Grep">Grep</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Grep package contains programs for searching through files.</para> <para>The Grep package contains programs for searching through files.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>4.5 MB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>4.5 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils,
Diffutils, GCC, Gettext, Glibc, Make, Sed, and Texinfo</seg></seglistitem> <seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc, Make,
Sed, and Texinfo</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
@ -55,15 +70,19 @@ the test file have to be changed:</para>
</sect2> </sect2>
<sect2 id="contents-grep" role="content">
<sect2 id="contents-grep" role="content"><title>Contents of Grep</title> <title>Contents of Grep</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<seglistitem><seg>egrep (link to grep), fgrep (link to grep), and grep</seg></seglistitem>
<seglistitem>
<seg>egrep (link to grep), fgrep (link to grep), and grep</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
@ -71,7 +90,9 @@ the test file have to be changed:</para>
<term><command>egrep</command></term> <term><command>egrep</command></term>
<listitem> <listitem>
<para>Prints lines matching an extended regular expression</para> <para>Prints lines matching an extended regular expression</para>
<indexterm zone="ch-system-grep egrep"><primary sortas="b-egrep">egrep</primary></indexterm> <indexterm zone="ch-system-grep egrep">
<primary sortas="b-egrep">egrep</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -79,7 +100,9 @@ the test file have to be changed:</para>
<term><command>fgrep</command></term> <term><command>fgrep</command></term>
<listitem> <listitem>
<para>Prints lines matching a list of fixed strings</para> <para>Prints lines matching a list of fixed strings</para>
<indexterm zone="ch-system-grep fgrep"><primary sortas="b-fgrep">fgrep</primary></indexterm> <indexterm zone="ch-system-grep fgrep">
<primary sortas="b-fgrep">fgrep</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -87,12 +110,14 @@ the test file have to be changed:</para>
<term><command>grep</command></term> <term><command>grep</command></term>
<listitem> <listitem>
<para>Prints lines matching a basic regular expression</para> <para>Prints lines matching a basic regular expression</para>
<indexterm zone="ch-system-grep grep"><primary sortas="b-grep">grep</primary></indexterm> <indexterm zone="ch-system-grep grep">
<primary sortas="b-grep">grep</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>