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

Indenting chapter 6, part 4

Browse Source 
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7340 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
This commit is contained in:
Manuel Canales Esparcia 2006-02-03 20:54:03 +00:00
parent 45b032ff25
commit 54e422c1d9
7 changed files with 1107 additions and 830 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

170
chapter06/db.xml
View File

@ -1,37 +1,52 @@
<?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">
%general-entities;
]>
<sect1 id="ch-system-db" role="wrap">
<title>Berkeley DB-&db-version;</title>
<?dbhtml filename="db.html"?>
<indexterm zone="ch-system-db"><primary sortas="a-Berkeley-DB">Berkeley DB</primary></indexterm>
<title>Berkeley DB-&db-version;</title>
<sect2 role="package"><title/>
<para>The Berkeley DB package contains programs and utilities used by many other
applications for database related functions.</para>
<indexterm zone="ch-system-db">
<primary sortas="a-Berkeley-DB">Berkeley DB</primary>
</indexterm>
<sect2 role="package">
<title/>
<para>The Berkeley DB package contains programs and utilities used by many
other applications for database related functions.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>1.2 SBU</seg><seg>78 MB</seg></seglistitem>
<seglistitem>
<seg>1.2 SBU</seg>
<seg>78 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils,
Diffutils, GCC, Glibc, Make and Sed.</seg></seglistitem>
<seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Make and Sed.</seg>
</seglistitem>
</segmentedlist>
<tip>
<title>Extra functionality for Berkeley DB in BLFS</title>
<para>There are instructions to build this package in the BLFS book if you need to build the RPC server or additional language bindings. The
additional language bindings will require additional packages to be
installed. The BLFS instructions are located at
<ulink url="&blfs-root;view/svn/server/databases.html#db"/>
for suggested installation instructions.</para>
<para>There are instructions to build this package in the BLFS
book if you need to build the RPC server or additional language
bindings. The additional language bindings will require additional
packages to be installed. The BLFS instructions are located at
<ulink url="&blfs-root;view/svn/server/databases.html#db"/> for
suggested installation instructions.</para>
</tip>
</sect2>
@ -44,40 +59,51 @@ for suggested installation instructions.</para>
<screen><userinput>cd build_unix &amp;&amp;
../dist/configure --prefix=/usr --enable-compat185 --enable-cxx</userinput></screen>
<para>The meaning of the configure options:</para>
<variablelist>
<title>The meaning of the configure options:</title>
<varlistentry>
<term><parameter>--enable-compat185</parameter></term>
<listitem><para>This option enables building Berkeley DB 1.85 compatibility API.</para></listitem>
<listitem>
<para>This option enables building Berkeley DB 1.85 compatibility
API.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>--enable-cxx</parameter></term>
<listitem><para>This option enables building C++ API libraries.</para></listitem>
<listitem>
<para>This option enables building C++ API libraries.</para>
</listitem>
</varlistentry>
</variablelist>
<para>Compile the package:</para>
<screen><userinput>make</userinput></screen>
<para>It is not possible to test the package meaningfully, because that
would involve building TCL bindings. TCL bindings cannot be built properly
now because TCL is linked against Glibc in <filename class="directory">/tools</filename>,
not against Glibc in <filename class="directory">/usr</filename>.</para>
<para>It is not possible to test the package meaningfully, because
that would involve building TCL bindings. TCL bindings cannot be
built properly now because TCL is linked against Glibc in
<filename class="directory">/tools</filename>, not against Glibc in
<filename class="directory">/usr</filename>.</para>
<para>Install the package:</para>
<screen><userinput>make docdir=/usr/share/doc/db-&db-version; install</userinput></screen>
<para>The meaning of the make option:</para>
<variablelist>
<title>The meaning of the make parameter:</title>
<varlistentry>
<term><parameter>docdir=...</parameter></term>
<listitem><para>This variable specifies the correct place for the documentation.</para></listitem>
<listitem>
<para>This variable specifies the correct place for the
documentation.</para>
</listitem>
</varlistentry>
</variablelist>
<para>Fix the ownerships of the installed files:</para>
@ -88,22 +114,22 @@ chown -R root:root /usr/share/doc/db-&db-version;</userinput></screen>
</sect2>
<sect2 id="contents-db" role="content">
<title>Contents of Berkeley DB</title>
<sect2 id="contents-db" role="content"><title>Contents of Berkeley DB</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<seglistitem><seg>db_archive, db_checkpoint, db_deadlock, db_dump,
db_hotbackup, db_load, db_printlog, db_recover, db_stat, db_upgrade and
db_verify
</seg></seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>Installed libraries</segtitle>
<seglistitem><seg>libdb.[so,a] and libdb_cxx.[so,a]</seg></seglistitem>
<seglistitem>
<seg>db_archive, db_checkpoint, db_deadlock, db_dump, db_hotbackup,
db_load, db_printlog, db_recover, db_stat, db_upgrade, and db_verify</seg>
<seg>libdb.[so,a] and libdb_cxx.[so,a]</seg>
</seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
@ -111,7 +137,9 @@ db_verify
<term><command>db_archive</command></term>
<listitem>
<para>Prints the pathnames of log files that are no longer in use</para>
<indexterm zone="ch-system-db db_archive"><primary sortas="b-db_archive">db_archive</primary></indexterm>
<indexterm zone="ch-system-db db_archive">
<primary sortas="b-db_archive">db_archive</primary>
</indexterm>
</listitem>
</varlistentry>
@ -119,31 +147,42 @@ db_verify
<term><command>db_checkpoint</command></term>
<listitem>
<para>A daemon used to monitor and checkpoint database logs</para>
<indexterm zone="ch-system-db db_checkpoint"><primary sortas="b-db_checkpoint">db_checkpoint</primary></indexterm>
<indexterm zone="ch-system-db db_checkpoint">
<primary sortas="b-db_checkpoint">db_checkpoint</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_deadlock">
<term><command>db_deadlock</command></term>
<listitem>
<para>A daemon used to abort lock requests when deadlocks are detected</para>
<indexterm zone="ch-system-db db_deadlock"><primary sortas="b-db_deadlock">db_deadlock</primary></indexterm>
<para>A daemon used to abort lock requests when deadlocks are
detected</para>
<indexterm zone="ch-system-db db_deadlock">
<primary sortas="b-db_deadlock">db_deadlock</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_dump">
<term><command>db_dump</command></term>
<listitem>
<para>Converts database files to a plain-text file format readable by <command>db_load</command></para>
<indexterm zone="ch-system-db db_dump"><primary sortas="b-db_dump">db_dump</primary></indexterm>
<para>Converts database files to a plain-text file format readable
by <command>db_load</command></para>
<indexterm zone="ch-system-db db_dump">
<primary sortas="b-db_dump">db_dump</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_hotbackup">
<term><command>db_hotbackup</command></term>
<listitem>
<para>Creates <quote>hot backup</quote> or <quote>hot failover</quote> snapshots of Berkeley DB databases</para>
<indexterm zone="ch-system-db db_hotbackup"><primary sortas="b-db_hotbackup">db_hotbackup</primary></indexterm>
<para>Creates <quote>hot backup</quote> or <quote>hot failover</quote>
snapshots of Berkeley DB databases</para>
<indexterm zone="ch-system-db db_hotbackup">
<primary sortas="b-db_hotbackup">db_hotbackup</primary>
</indexterm>
</listitem>
</varlistentry>
@ -151,7 +190,9 @@ db_verify
<term><command>db_load</command></term>
<listitem>
<para>Is used to create database files from plain-text files</para>
<indexterm zone="ch-system-db db_load"><primary sortas="b-db_load">db_load</primary></indexterm>
<indexterm zone="ch-system-db db_load">
<primary sortas="b-db_load">db_load</primary>
</indexterm>
</listitem>
</varlistentry>
@ -159,15 +200,20 @@ db_verify
<term><command>db_printlog</command></term>
<listitem>
<para>Converts database log files to human readable text</para>
<indexterm zone="ch-system-db db_printlog"><primary sortas="b-db_printlog">db_printlog</primary></indexterm>
<indexterm zone="ch-system-db db_printlog">
<primary sortas="b-db_printlog">db_printlog</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_recover">
<term><command>db_recover</command></term>
<listitem>
<para>Is used to restore a database to a consistent state after a failure</para>
<indexterm zone="ch-system-db db_recover"><primary sortas="b-db_recover">db_recover</primary></indexterm>
<para>Is used to restore a database to a consistent state after a
failure</para>
<indexterm zone="ch-system-db db_recover">
<primary sortas="b-db_recover">db_recover</primary>
</indexterm>
</listitem>
</varlistentry>
@ -175,15 +221,20 @@ db_verify
<term><command>db_stat</command></term>
<listitem>
<para>Displays statistics for Berkeley databases</para>
<indexterm zone="ch-system-db db_stat"><primary sortas="b-db_stat">db_stat</primary></indexterm>
<indexterm zone="ch-system-db db_stat">
<primary sortas="b-db_stat">db_stat</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="db_upgrade">
<term><command>db_upgrade</command></term>
<listitem>
<para>Is used to upgrade database files to a newer version of Berkeley DB</para>
<indexterm zone="ch-system-db db_upgrade"><primary sortas="b-db_upgrade">db_upgrade</primary></indexterm>
<para>Is used to upgrade database files to a newer version of
Berkeley DB</para>
<indexterm zone="ch-system-db db_upgrade">
<primary sortas="b-db_upgrade">db_upgrade</primary>
</indexterm>
</listitem>
</varlistentry>
@ -191,7 +242,9 @@ db_verify
<term><command>db_verify</command></term>
<listitem>
<para>Is used to run consistency checks on database files</para>
<indexterm zone="ch-system-db db_verify"><primary sortas="b-db_verify">db_verify</primary></indexterm>
<indexterm zone="ch-system-db db_verify">
<primary sortas="b-db_verify">db_verify</primary>
</indexterm>
</listitem>
</varlistentry>
@ -199,18 +252,25 @@ db_verify
<varlistentry id="libdb">
<term><filename class="libraryfile">libdb.[so,a]</filename></term>
<listitem>
<para>Contains functions to manipulate database files from C programs</para>
<indexterm zone="ch-system-db libdb"><primary sortas="c-libdb">libdb</primary></indexterm>
<para>Contains functions to manipulate database files from C
programs</para>
<indexterm zone="ch-system-db libdb">
<primary sortas="c-libdb">libdb</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libdb_cxx">
<term><filename class="libraryfile">libdb_cxx.[so,a]</filename></term>
<listitem>
<para>Contains functions to manipulate database files from C++ programs</para>
<indexterm zone="ch-system-db libdb_cxx"><primary sortas="c-libdb_cxx">libdb_cxx</primary></indexterm>
<para>Contains functions to manipulate database files from C++
programs</para>
<indexterm zone="ch-system-db libdb_cxx">
<primary sortas="c-libdb_cxx">libdb_cxx</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>

53
chapter06/devices.xml
View File

@ -1,41 +1,48 @@
<?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">
%general-entities;
]>
<sect1 id="ch-system-devices">
<title>Populating /dev</title>
<?dbhtml filename="devices.html"?>
<indexterm zone="ch-system-devices"><primary sortas="e-/dev/">/dev/*</primary></indexterm>
<title>Populating /dev</title>
<indexterm zone="ch-system-devices">
<primary sortas="e-/dev/">/dev/*</primary>
</indexterm>
<sect2>
<title>Creating Initial Device Nodes</title>
<para>When the kernel boots the system, it requires the presence of a few device
nodes, in particular the <filename class="devicefile">console</filename> and
<filename class="devicefile">null</filename> devices. The device nodes will
be created on the hard disk so that they are available before
<command>udev</command> has been started, and additionally when Linux is started
in single user mode (hence the restrictive permissions on
<filename class="devicefile">console</filename>). Create the devices by running
the following commands:</para>
<para>When the kernel boots the system, it requires the presence of a few
device nodes, in particular the <filename class="devicefile">console</filename>
and <filename class="devicefile">null</filename> devices. The device nodes
will be created on the hard disk so that they are available before
<command>udev</command> has been started, and additionally when Linux is
started in single user mode (hence the restrictive permissions on
<filename class="devicefile">console</filename>). Create the devices by
running the following commands:</para>
<screen><userinput>mknod -m 600 /dev/console c 5 1
mknod -m 666 /dev/null c 1 3</userinput></screen>
</sect2>
<sect2>
<title>Mounting tmpfs and Populating /dev</title>
<para>The recommended method of populating the <filename
class="directory">/dev</filename> directory with devices is to mount a virtual
filesystem (such as <systemitem class="filesystem">tmpfs</systemitem>) on the
<filename class="directory">/dev</filename> directory, and allow the devices to
be created dynamically on that virtual filesystem as they are detected or
accessed. This is generally done during the boot process. Since this new system
has not been booted, it is necessary to do what the LFS-Bootscripts package would
otherwise do by mounting <filename class="directory">/dev</filename>:</para>
class="directory">/dev</filename> directory with devices is to mount a
virtual filesystem (such as <systemitem class="filesystem">tmpfs</systemitem>)
on the <filename class="directory">/dev</filename> directory, and allow the
devices to be created dynamically on that virtual filesystem as they are
detected or accessed. This is generally done during the boot process. Since
this new system has not been booted, it is necessary to do what the
LFS-Bootscripts package would otherwise do by mounting <filename
class="directory">/dev</filename>:</para>
<screen><userinput>mount -nvt tmpfs none /dev</userinput></screen>
@ -53,10 +60,10 @@ mknod -m 444 /dev/random c 1 8
mknod -m 444 /dev/urandom c 1 9
chown -v root:tty /dev/{console,ptmx,tty}</userinput></screen>
<para>There are some symlinks and directories required by LFS that are created
during system startup by the LFS-Bootscripts package. Since this is a chroot
environment and not a booted environment, those symlinks and directories need to
be created here:</para>
<para>There are some symlinks and directories required by LFS that are
created during system startup by the LFS-Bootscripts package. Since this
is a chroot environment and not a booted environment, those symlinks and
directories need to be created here:</para>
<screen><userinput>ln -sv /proc/self/fd /dev/fd
ln -sv /proc/self/fd/0 /dev/stdin
@ -80,7 +87,7 @@ in the following warning message:</para>
<para>This file&mdash;<filename>/etc/fstab</filename>&mdash;has not
been created yet but is also not required for the file systems to be
properly mounted. As such, the warning can be safely ignored.</para>
</sect2>
</sect1>

64
chapter06/diffutils.xml
View File

@ -1,29 +1,44 @@
<?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">
%general-entities;
]>
<sect1 id="ch-system-diffutils" role="wrap">
<title>Diffutils-&diffutils-version;</title>
<?dbhtml filename="diffutils.html"?>
<indexterm zone="ch-system-diffutils"><primary sortas="a-Diffutils">Diffutils</primary></indexterm>
<title>Diffutils-&diffutils-version;</title>
<indexterm zone="ch-system-diffutils">
<primary sortas="a-Diffutils">Diffutils</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Diffutils package contains programs that show the differences
between files or directories.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>5.6 MB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>5.6 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<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>
</sect2>
<sect2 role="installation">
@ -52,30 +67,41 @@ non-compliance issue:</para>
</sect2>
<sect2 id="contents-diffutils" role="content"><title>Contents of Diffutils</title>
<sect2 id="contents-diffutils" role="content">
<title>Contents of Diffutils</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<seglistitem><seg>cmp, diff, diff3, and sdiff</seg></seglistitem>
<seglistitem>
<seg>cmp, diff, diff3, and sdiff</seg>
</seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="cmp">
<term><command>cmp</command></term>
<listitem>
<para>Compares two files and reports whether or in which bytes they differ</para>
<indexterm zone="ch-system-diffutils cmp"><primary sortas="b-cmp">cmp</primary></indexterm>
<para>Compares two files and reports whether or in which bytes they
differ</para>
<indexterm zone="ch-system-diffutils cmp">
<primary sortas="b-cmp">cmp</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="diff">
<term><command>diff</command></term>
<listitem>
<para>Compares two files or directories and reports which lines in the files differ</para>
<indexterm zone="ch-system-diffutils diff"><primary sortas="b-diff">diff</primary></indexterm>
<para>Compares two files or directories and reports which lines in
the files differ</para>
<indexterm zone="ch-system-diffutils diff">
<primary sortas="b-diff">diff</primary>
</indexterm>
</listitem>
</varlistentry>
@ -83,7 +109,9 @@ non-compliance issue:</para>
<term><command>diff3</command></term>
<listitem>
<para>Compares three files line by line</para>
<indexterm zone="ch-system-diffutils diff3"><primary sortas="b-diff3">diff3</primary></indexterm>
<indexterm zone="ch-system-diffutils diff3">
<primary sortas="b-diff3">diff3</primary>
</indexterm>
</listitem>
</varlistentry>
@ -91,12 +119,14 @@ non-compliance issue:</para>
<term><command>sdiff</command></term>
<listitem>
<para>Merges two files and interactively outputs the results</para>
<indexterm zone="ch-system-diffutils sdiff"><primary sortas="b-sdiff">sdiff</primary></indexterm>
<indexterm zone="ch-system-diffutils sdiff">
<primary sortas="b-sdiff">sdiff</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

277
chapter06/e2fsprogs.xml
View File

@ -1,37 +1,53 @@
<?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">
%general-entities;
]>
<sect1 id="ch-system-e2fsprogs" role="wrap">
<title>E2fsprogs-&e2fsprogs-version;</title>
<?dbhtml filename="e2fsprogs.html"?>
<indexterm zone="ch-system-e2fsprogs"><primary sortas="a-E2fsprogs">E2fsprogs</primary></indexterm>
<title>E2fsprogs-&e2fsprogs-version;</title>
<indexterm zone="ch-system-e2fsprogs">
<primary sortas="a-E2fsprogs">E2fsprogs</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The E2fsprogs package contains the utilities for handling the
<systemitem class="filesystem">ext2</systemitem> file system. It also supports
the <systemitem class="filesystem">ext3</systemitem> journaling file system.</para>
<systemitem class="filesystem">ext2</systemitem> file system. It also
supports the <systemitem class="filesystem">ext3</systemitem> journaling
file system.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.6 SBU</seg><seg>40.0 MB</seg></seglistitem>
<seglistitem>
<seg>0.6 SBU</seg>
<seg>40.0 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils,
Diffutils, Gawk, GCC, Gettext, Glibc, Grep, Make, Sed, and Texinfo</seg></seglistitem>
<seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, Gawk, GCC, Gettext, Glibc,
Grep, Make, Sed, and Texinfo</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of E2fsprogs</title>
<para>It is recommended that E2fsprogs be built in a subdirectory of the source tree:
</para>
<para>It is recommended that E2fsprogs be built in a subdirectory of
the source tree: </para>
<screen><userinput>mkdir -v build
cd build</userinput></screen>
@ -41,37 +57,43 @@ cd build</userinput></screen>
<screen><userinput>../configure --prefix=/usr --with-root-prefix="" \
--enable-elf-shlibs --disable-evms</userinput></screen>
<para>The meaning of the configure options:</para>
<variablelist>
<title>The meaning of the configure options:</title>
<varlistentry>
<term><parameter>--with-root-prefix=""</parameter></term>
<listitem><para>Certain programs (such as the <command>e2fsck</command> program)
are considered essential programs. When, for example, <filename
class="directory">/usr</filename> is not mounted, these programs still need
to be available. They belong in directories like <filename
class="directory">/lib</filename> and <filename
class="directory">/sbin</filename>. If this option is not passed to E2fsprogs'
configure, the programs are installed into the <filename
class="directory">/usr</filename> directory.</para></listitem>
<listitem>
<para>Certain programs (such as the <command>e2fsck</command>
program) are considered essential programs. When, for example,
<filename class="directory">/usr</filename> is not mounted, these
programs still need to be available. They belong in directories
like <filename class="directory">/lib</filename> and <filename
class="directory">/sbin</filename>. If this option is not passed
to E2fsprogs' configure, the programs are installed into the
<filename class="directory">/usr</filename> directory.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>--enable-elf-shlibs</parameter></term>
<listitem><para>This creates the shared libraries which some programs
in this package use.</para></listitem>
<listitem>
<para>This creates the shared libraries which some programs
in this package use.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>--disable-evms</parameter></term>
<listitem><para>This disables the building of the Enterprise Volume
<listitem>
<para>This disables the building of the Enterprise Volume
Management System (EVMS) plugin. This plugin is not up-to-date with
the latest EVMS internal interfaces and EVMS is not installed as part
of a base LFS system, so the plugin is not required. See the EVMS
website at <ulink url="http://evms.sourceforge.net/"/> for more
information regarding EVMS.</para></listitem>
information regarding EVMS.</para>
</listitem>
</varlistentry>
</variablelist>
<para>Compile the package:</para>
@ -91,38 +113,47 @@ information regarding EVMS.</para></listitem>
</sect2>
<sect2 id="contents-e2fsprogs" role="content"><title>Contents of E2fsprogs</title>
<sect2 id="contents-e2fsprogs" role="content">
<title>Contents of E2fsprogs</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<segtitle>Installed libraries</segtitle>
<seglistitem><seg>badblocks, blkid, chattr,
compile_et, debugfs, dumpe2fs, e2fsck, e2image, e2label, findfs, fsck,
fsck.ext2, fsck.ext3, logsave, lsattr, mk_cmds, mke2fs, mkfs.ext2, mkfs.ext3,
mklost+found, resize2fs, tune2fs, and uuidgen.</seg>
<seglistitem>
<seg>badblocks, blkid, chattr, compile_et, debugfs, dumpe2fs, e2fsck,
e2image, e2label, findfs, fsck, fsck.ext2, fsck.ext3, logsave, lsattr,
mk_cmds, mke2fs, mkfs.ext2, mkfs.ext3, mklost+found, resize2fs,
tune2fs, and uuidgen.</seg>
<seg>libblkid.[a,so], libcom_err.[a,so], libe2p.[a,so],
libext2fs.[a,so], libss.[a,so], and libuuid.[a,so]</seg></seglistitem>
libext2fs.[a,so], libss.[a,so], and libuuid.[a,so]</seg>
</seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="badblocks">
<term><command>badblocks</command></term>
<listitem>
<para>Searches a device (usually a disk partition) for bad blocks</para>
<indexterm zone="ch-system-e2fsprogs badblocks"><primary sortas="b-badblocks">badblocks</primary></indexterm>
<para>Searches a device (usually a disk partition) for bad
blocks</para>
<indexterm zone="ch-system-e2fsprogs badblocks">
<primary sortas="b-badblocks">badblocks</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="blkid">
<term><command>blkid</command></term>
<listitem>
<para>A command line utility to locate and print block device attributes</para>
<indexterm zone="ch-system-e2fsprogs blkid"><primary sortas="b-blkid">blkid</primary></indexterm>
<para>A command line utility to locate and print block device
attributes</para>
<indexterm zone="ch-system-e2fsprogs blkid">
<primary sortas="b-blkid">blkid</primary>
</indexterm>
</listitem>
</varlistentry>
@ -130,38 +161,48 @@ libext2fs.[a,so], libss.[a,so], and libuuid.[a,so]</seg></seglistitem>
<term><command>chattr</command></term>
<listitem>
<para>Changes the attributes of files on an <systemitem
class="filesystem">ext2</systemitem> file system; it also changes <systemitem
class="filesystem">ext3</systemitem> file systems, the journaling version of
<systemitem class="filesystem">ext2</systemitem> file systems</para>
<indexterm zone="ch-system-e2fsprogs chattr"><primary sortas="b-chattr">chattr</primary></indexterm>
class="filesystem">ext2</systemitem> file system; it also
changes <systemitem class="filesystem">ext3</systemitem>
file systems, the journaling version of <systemitem
class="filesystem">ext2</systemitem> file systems</para>
<indexterm zone="ch-system-e2fsprogs chattr">
<primary sortas="b-chattr">chattr</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="compile_et">
<term><command>compile_et</command></term>
<listitem>
<para>An error table compiler; it converts a table of error-code names and
messages into a C source file suitable for use with the <filename
class="libraryfile">com_err</filename> library</para>
<indexterm zone="ch-system-e2fsprogs compile_et"><primary sortas="b-compile_et">compile_et</primary></indexterm>
<para>An error table compiler; it converts a table of error-code
names and messages into a C source file suitable for use with the
<filename class="libraryfile">com_err</filename> library</para>
<indexterm zone="ch-system-e2fsprogs compile_et">
<primary sortas="b-compile_et">compile_et</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="debugfs">
<term><command>debugfs</command></term>
<listitem>
<para>A file system debugger; it can be used to examine and change the
state of an <systemitem class="filesystem">ext2</systemitem> file system</para>
<indexterm zone="ch-system-e2fsprogs debugfs"><primary sortas="b-debugfs">debugfs</primary></indexterm>
<para>A file system debugger; it can be used to examine and change
the state of an <systemitem class="filesystem">ext2</systemitem>
file system</para>
<indexterm zone="ch-system-e2fsprogs debugfs">
<primary sortas="b-debugfs">debugfs</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="dumpe2fs">
<term><command>dumpe2fs</command></term>
<listitem>
<para>Prints the super block and blocks group information for the file
system present on a given device</para>
<indexterm zone="ch-system-e2fsprogs dumpe2fs"><primary sortas="b-dumpe2fs">dumpe2fs</primary></indexterm>
<para>Prints the super block and blocks group information for the
file system present on a given device</para>
<indexterm zone="ch-system-e2fsprogs dumpe2fs">
<primary sortas="b-dumpe2fs">dumpe2fs</primary>
</indexterm>
</listitem>
</varlistentry>
@ -171,16 +212,20 @@ system present on a given device</para>
<para>Is used to check, and optionally repair <systemitem
class="filesystem">ext2</systemitem> file systems and <systemitem
class="filesystem">ext3</systemitem> file systems</para>
<indexterm zone="ch-system-e2fsprogs e2fsck"><primary sortas="b-e2fsck">e2fsck</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs e2fsck">
<primary sortas="b-e2fsck">e2fsck</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="e2image">
<term><command>e2image</command></term>
<listitem>
<para>Is used to save critical <systemitem class="filesystem">ext2</systemitem>
file system data to a file</para>
<indexterm zone="ch-system-e2fsprogs e2image"><primary sortas="b-e2image">e2image</primary></indexterm>
<para>Is used to save critical <systemitem
class="filesystem">ext2</systemitem> file system data to a file</para>
<indexterm zone="ch-system-e2fsprogs e2image">
<primary sortas="b-e2image">e2image</primary>
</indexterm>
</listitem>
</varlistentry>
@ -188,16 +233,22 @@ file system data to a file</para>
<term><command>e2label</command></term>
<listitem>
<para>Displays or changes the file system label on the <systemitem
class="filesystem">ext2</systemitem> file system present on a given device</para>
<indexterm zone="ch-system-e2fsprogs e2label"><primary sortas="b-e2label">e2label</primary></indexterm>
class="filesystem">ext2</systemitem> file system present on a given
device</para>
<indexterm zone="ch-system-e2fsprogs e2label">
<primary sortas="b-e2label">e2label</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="findfs">
<term><command>findfs</command></term>
<listitem>
<para>Finds a file system by label or Universally Unique Identifier (UUID)</para>
<indexterm zone="ch-system-e2fsprogs findfs"><primary sortas="b-findfs">findfs</primary></indexterm>
<para>Finds a file system by label or Universally Unique Identifier
(UUID)</para>
<indexterm zone="ch-system-e2fsprogs findfs">
<primary sortas="b-findfs">findfs</primary>
</indexterm>
</listitem>
</varlistentry>
@ -205,7 +256,9 @@ class="filesystem">ext2</systemitem> file system present on a given device</para
<term><command>fsck</command></term>
<listitem>
<para>Is used to check, and optionally repair, file systems</para>
<indexterm zone="ch-system-e2fsprogs fsck"><primary sortas="b-fsck">fsck</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs fsck">
<primary sortas="b-fsck">fsck</primary>
</indexterm>
</listitem>
</varlistentry>
@ -214,8 +267,9 @@ class="filesystem">ext2</systemitem> file system present on a given device</para
<listitem>
<para>By default checks <systemitem class="filesystem">ext2</systemitem>
file systems</para>
<indexterm zone="ch-system-e2fsprogs fsck.ext2"><primary
sortas="b-fsck.ext2">fsck.ext2</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs fsck.ext2">
<primary sortas="b-fsck.ext2">fsck.ext2</primary>
</indexterm>
</listitem>
</varlistentry>
@ -224,8 +278,9 @@ sortas="b-fsck.ext2">fsck.ext2</primary></indexterm>
<listitem>
<para>By default checks <systemitem class="filesystem">ext3</systemitem>
file systems</para>
<indexterm zone="ch-system-e2fsprogs fsck.ext3"><primary
sortas="b-fsck.ext3">fsck.ext3</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs fsck.ext3">
<primary sortas="b-fsck.ext3">fsck.ext3</primary>
</indexterm>
</listitem>
</varlistentry>
@ -233,15 +288,20 @@ sortas="b-fsck.ext3">fsck.ext3</primary></indexterm>
<term><command>logsave</command></term>
<listitem>
<para>Saves the output of a command in a log file</para>
<indexterm zone="ch-system-e2fsprogs logsave"><primary sortas="b-logsave">logsave</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs logsave">
<primary sortas="b-logsave">logsave</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="lsattr">
<term><command>lsattr</command></term>
<listitem>
<para>Lists the attributes of files on a second extended file system</para>
<indexterm zone="ch-system-e2fsprogs lsattr"><primary sortas="b-lsattr">lsattr</primary></indexterm>
<para>Lists the attributes of files on a second extended file
system</para>
<indexterm zone="ch-system-e2fsprogs lsattr">
<primary sortas="b-lsattr">lsattr</primary>
</indexterm>
</listitem>
</varlistentry>
@ -251,15 +311,21 @@ sortas="b-fsck.ext3">fsck.ext3</primary></indexterm>
<para>Converts a table of command names and help messages into a C
source file suitable for use with the <filename
class="libraryfile">libss</filename> subsystem library</para>
<indexterm zone="ch-system-e2fsprogs mk_cmds"><primary sortas="b-mk_cmds">mk_cmds</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs mk_cmds">
<primary sortas="b-mk_cmds">mk_cmds</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mke2fs">
<term><command>mke2fs</command></term>
<listitem>
<para>Creates an ext2 or ext3 file system on the given device</para>
<indexterm zone="ch-system-e2fsprogs mke2fs"><primary sortas="b-mke2fs">mke2fs</primary></indexterm>
<para>Creates an <systemitem class="filesystem">ext2</systemitem>
or <systemitem class="filesystem">ext3</systemitem> file system on
the given device</para>
<indexterm zone="ch-system-e2fsprogs mke2fs">
<primary sortas="b-mke2fs">mke2fs</primary>
</indexterm>
</listitem>
</varlistentry>
@ -268,8 +334,9 @@ class="libraryfile">libss</filename> subsystem library</para>
<listitem>
<para>By default creates <systemitem class="filesystem">ext2</systemitem>
file systems</para>
<indexterm zone="ch-system-e2fsprogs mkfs.ext2"><primary
sortas="b-mkfs.ext2">mkfs.ext2</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs mkfs.ext2">
<primary sortas="b-mkfs.ext2">mkfs.ext2</primary>
</indexterm>
</listitem>
</varlistentry>
@ -278,8 +345,9 @@ sortas="b-mkfs.ext2">mkfs.ext2</primary></indexterm>
<listitem>
<para>By default creates <systemitem class="filesystem">ext3</systemitem>
file systems</para>
<indexterm zone="ch-system-e2fsprogs mkfs.ext3"><primary
sortas="b-mkfs.ext3">mkfs.ext3</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs mkfs.ext3">
<primary sortas="b-mkfs.ext3">mkfs.ext3</primary>
</indexterm>
</listitem>
</varlistentry>
@ -287,10 +355,12 @@ sortas="b-mkfs.ext3">mkfs.ext3</primary></indexterm>
<term><command>mklost+found</command></term>
<listitem>
<para>Used to create a <filename class="directory">lost+found</filename>
directory on an <systemitem class="filesystem">ext2</systemitem> file system;
it pre-allocates disk blocks to this directory to lighten the task of
<command>e2fsck</command></para>
<indexterm zone="ch-system-e2fsprogs mklost-found"><primary sortas="b-mklost+found">mklost+found</primary></indexterm>
directory on an <systemitem class="filesystem">ext2</systemitem> file
system; it pre-allocates disk blocks to this directory to lighten the
task of <command>e2fsck</command></para>
<indexterm zone="ch-system-e2fsprogs mklost-found">
<primary sortas="b-mklost+found">mklost+found</primary>
</indexterm>
</listitem>
</varlistentry>
@ -299,7 +369,9 @@ it pre-allocates disk blocks to this directory to lighten the task of
<listitem>
<para>Can be used to enlarge or shrink an <systemitem
class="filesystem">ext2</systemitem> file system</para>
<indexterm zone="ch-system-e2fsprogs resize2fs"><primary sortas="b-resize2fs">resize2fs</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs resize2fs">
<primary sortas="b-resize2fs">resize2fs</primary>
</indexterm>
</listitem>
</varlistentry>
@ -308,25 +380,32 @@ class="filesystem">ext2</systemitem> file system</para>
<listitem>
<para>Adjusts tunable file system parameters on an <systemitem
class="filesystem">ext2</systemitem> file system</para>
<indexterm zone="ch-system-e2fsprogs tune2fs"><primary sortas="b-tune2fs">tune2fs</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs tune2fs">
<primary sortas="b-tune2fs">tune2fs</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="uuidgen">
<term><command>uuidgen</command></term>
<listitem>
<para>Creates new UUIDs. Each new UUID can reasonably be considered unique
among all UUIDs created, on the local system and on other systems, in the
past and in the future</para>
<indexterm zone="ch-system-e2fsprogs uuidgen"><primary sortas="b-uuidgen">uuidgen</primary></indexterm>
<para>Creates new UUIDs. Each new UUID can reasonably be considered
unique among all UUIDs created, on the local system and on other
systems, in the past and in the future</para>
<indexterm zone="ch-system-e2fsprogs uuidgen">
<primary sortas="b-uuidgen">uuidgen</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libblkid">
<term><filename class="libraryfile">libblkid</filename></term>
<listitem>
<para>Contains routines for device identification and token extraction</para>
<indexterm zone="ch-system-e2fsprogs libblkid"><primary sortas="c-libblkid">libblkid</primary></indexterm>
<para>Contains routines for device identification and token
extraction</para>
<indexterm zone="ch-system-e2fsprogs libblkid">
<primary sortas="c-libblkid">libblkid</primary>
</indexterm>
</listitem>
</varlistentry>
@ -334,7 +413,9 @@ past and in the future</para>
<term><filename class="libraryfile">libcom_err</filename></term>
<listitem>
<para>The common error display routine</para>
<indexterm zone="ch-system-e2fsprogs libcom_err"><primary sortas="c-libcom_err">libcom_err</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs libcom_err">
<primary sortas="c-libcom_err">libcom_err</primary>
</indexterm>
</listitem>
</varlistentry>
@ -343,7 +424,9 @@ past and in the future</para>
<listitem>
<para>Used by <command>dumpe2fs</command>, <command>chattr</command>,
and <command>lsattr</command></para>
<indexterm zone="ch-system-e2fsprogs libe2p"><primary sortas="c-libe2p">libe2p</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs libe2p">
<primary sortas="c-libe2p">libe2p</primary>
</indexterm>
</listitem>
</varlistentry>
@ -352,7 +435,9 @@ and <command>lsattr</command></para>
<listitem>
<para>Contains routines to enable user-level programs to manipulate an
<systemitem class="filesystem">ext2</systemitem> file system</para>
<indexterm zone="ch-system-e2fsprogs libext2fs"><primary sortas="c-libext2fs">libext2fs</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs libext2fs">
<primary sortas="c-libext2fs">libext2fs</primary>
</indexterm>
</listitem>
</varlistentry>
@ -360,7 +445,9 @@ and <command>lsattr</command></para>
<term><filename class="libraryfile">libss</filename></term>
<listitem>
<para>Used by <command>debugfs</command></para>
<indexterm zone="ch-system-e2fsprogs libss"><primary sortas="c-libss">libss</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs libss">
<primary sortas="c-libss">libss</primary>
</indexterm>
</listitem>
</varlistentry>
@ -369,12 +456,14 @@ and <command>lsattr</command></para>
<listitem>
<para>Contains routines for generating unique identifiers for objects
that may be accessible beyond the local system</para>
<indexterm zone="ch-system-e2fsprogs libuuid"><primary sortas="c-libuuid">libuuid</primary></indexterm>
<indexterm zone="ch-system-e2fsprogs libuuid">
<primary sortas="c-libuuid">libuuid</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

51
chapter06/file.xml
View File

@ -1,29 +1,44 @@
<?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">
%general-entities;
]>
<sect1 id="ch-system-file" role="wrap">
<title>File-&file-version;</title>
<?dbhtml filename="file.html"?>
<indexterm zone="ch-system-file"><primary sortas="a-File">File</primary></indexterm>
<title>File-&file-version;</title>
<indexterm zone="ch-system-file">
<primary sortas="a-File">File</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The File package contains a utility for determining the type of a given
file or files.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>6.2 MB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>6.2 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
GCC, Glibc, Grep, Make, Sed, and Zlib</seg></seglistitem>
<seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep, Make,
Sed, and Zlib</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
@ -46,15 +61,21 @@ GCC, Glibc, Grep, Make, Sed, and Zlib</seg></seglistitem>
</sect2>
<sect2 id="contents-file" role="content"><title>Contents of File</title>
<sect2 id="contents-file" role="content">
<title>Contents of File</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<segtitle>Installed library</segtitle>
<seglistitem><seg>file</seg><seg>libmagic.[a,so]</seg></seglistitem>
<seglistitem>
<seg>file</seg>
<seg>libmagic.[a,so]</seg>
</seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
@ -64,7 +85,9 @@ GCC, Glibc, Grep, Make, Sed, and Zlib</seg></seglistitem>
<para>Tries to classify each given file; it does this by performing
several tests&mdash;file system tests, magic number tests, and language
tests</para>
<indexterm zone="ch-system-file file"><primary sortas="b-file">file</primary></indexterm>
<indexterm zone="ch-system-file file">
<primary sortas="b-file">file</primary>
</indexterm>
</listitem>
</varlistentry>
@ -73,12 +96,14 @@ tests</para>
<listitem>
<para>Contains routines for magic number recognition, used by the
<command>file</command> program</para>
<indexterm zone="ch-system-file libmagic"><primary sortas="c-libmagic">libmagic</primary></indexterm>
<indexterm zone="ch-system-file libmagic">
<primary sortas="c-libmagic">libmagic</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

102
chapter06/findutils.xml
View File

@ -1,15 +1,22 @@
<?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">
%general-entities;
]>
<sect1 id="ch-system-findutils" role="wrap">
<title>Findutils-&findutils-version;</title>
<?dbhtml filename="findutils.html"?>
<indexterm zone="ch-system-findutils"><primary sortas="a-Findutils">Findutils</primary></indexterm>
<title>Findutils-&findutils-version;</title>
<indexterm zone="ch-system-findutils">
<primary sortas="a-Findutils">Findutils</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Findutils package contains programs to find files. These programs
are provided to recursively search through a directory tree and to
create, maintain, and search a database (often faster than the recursive
@ -18,14 +25,22 @@ find, but unreliable if the database has not been recently updated).</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>9.4 MB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>9.4 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<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>
</sect2>
<sect2 role="installation">
@ -36,15 +51,18 @@ Diffutils, GCC, Gettext, Glibc, Grep, Make and Sed</seg></seglistitem>
<screen><userinput>./configure --prefix=/usr --libexecdir=/usr/lib/findutils \
--localstatedir=/var/lib/locate</userinput></screen>
<para>The meaning of the configure options:</para>
<variablelist>
<title>The meaning of the configure options:</title>
<varlistentry>
<term><parameter>--localstatedir</parameter></term>
<listitem><para>This option changes the location of the <command>locate</command>
database to be in <filename class="directory">/var/lib/locate</filename>, which
is FHS-compliant.</para></listitem>
<listitem>
<para>This option changes the location of the <command>locate</command>
database to be in <filename class="directory">/var/lib/locate</filename>,
which is FHS-compliant.</para>
</listitem>
</varlistentry>
</variablelist>
<para>Compile the package:</para>
@ -60,22 +78,30 @@ is FHS-compliant.</para></listitem>
</sect2>
<sect2 id="contents-findutils" role="content"><title>Contents of Findutils</title>
<sect2 id="contents-findutils" role="content">
<title>Contents of Findutils</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<seglistitem><seg>bigram, code, find, frcode, locate, updatedb, and xargs</seg></seglistitem>
<seglistitem>
<seg>bigram, code, find, frcode, locate, updatedb, and xargs</seg>
</seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="bigram">
<term><command>bigram</command></term>
<listitem>
<para>Was formerly used to produce <command>locate</command> databases</para>
<indexterm zone="ch-system-findutils bigram"><primary sortas="b-bigram">bigram</primary></indexterm>
<para>Was formerly used to produce <command>locate</command>
databases</para>
<indexterm zone="ch-system-findutils bigram">
<primary sortas="b-bigram">bigram</primary>
</indexterm>
</listitem>
</varlistentry>
@ -84,25 +110,32 @@ is FHS-compliant.</para></listitem>
<listitem>
<para>Was formerly used to produce <command>locate</command>
databases; it is the ancestor of <command>frcode</command>.</para>
<indexterm zone="ch-system-findutils code"><primary sortas="b-code">code</primary></indexterm>
<indexterm zone="ch-system-findutils code">
<primary sortas="b-code">code</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="find">
<term><command>find</command></term>
<listitem>
<para>Searches given directory trees for files matching the specified criteria</para>
<indexterm zone="ch-system-findutils find"><primary sortas="b-find">find</primary></indexterm>
<para>Searches given directory trees for files matching the specified
criteria</para>
<indexterm zone="ch-system-findutils find">
<primary sortas="b-find">find</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="frcode">
<term><command>frcode</command></term>
<listitem>
<para>Is called by <command>updatedb</command> to compress the list of file names; it uses
front-compression, reducing the database size by a factor of four to
five.</para>
<indexterm zone="ch-system-findutils frcode"><primary sortas="b-frcode">frcode</primary></indexterm>
<para>Is called by <command>updatedb</command> to compress the list
of file names; it uses front-compression, reducing the database size
by a factor of four to five.</para>
<indexterm zone="ch-system-findutils frcode">
<primary sortas="b-frcode">frcode</primary>
</indexterm>
</listitem>
</varlistentry>
@ -111,17 +144,22 @@ five.</para>
<listitem>
<para>Searches through a database of file names and reports the names
that contain a given string or match a given pattern</para>
<indexterm zone="ch-system-findutils locate"><primary sortas="b-locate">locate</primary></indexterm>
<indexterm zone="ch-system-findutils locate">
<primary sortas="b-locate">locate</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="updatedb">
<term><command>updatedb</command></term>
<listitem>
<para>Updates the <command>locate</command> database; it scans
the entire file system (including other file systems that are currently mounted,
unless told not to) and puts every file name it finds into the database</para>
<indexterm zone="ch-system-findutils updatedb"><primary sortas="b-updatedb">updatedb</primary></indexterm>
<para>Updates the <command>locate</command> database; it scans the
entire file system (including other file systems that are currently
mounted, unless told not to) and puts every file name it finds into
the database</para>
<indexterm zone="ch-system-findutils updatedb">
<primary sortas="b-updatedb">updatedb</primary>
</indexterm>
</listitem>
</varlistentry>
@ -129,12 +167,14 @@ unless told not to) and puts every file name it finds into the database</para>
<term><command>xargs</command></term>
<listitem>
<para>Can be used to apply a given command to a list of files</para>
<indexterm zone="ch-system-findutils xargs"><primary sortas="b-xargs">xargs</primary></indexterm>
<indexterm zone="ch-system-findutils xargs">
<primary sortas="b-xargs">xargs</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

72
chapter06/flex.xml
View File

@ -1,35 +1,51 @@
<?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">
%general-entities;
]>
<sect1 id="ch-system-flex" role="wrap">
<title>Flex-&flex-version;</title>
<?dbhtml filename="flex.html"?>
<indexterm zone="ch-system-flex"><primary sortas="a-Flex">Flex</primary></indexterm>
<title>Flex-&flex-version;</title>
<indexterm zone="ch-system-flex">
<primary sortas="a-Flex">Flex</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Flex package contains a utility for generating programs that
recognize patterns in text.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>22.5 MB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>22.5 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Bison, Coreutils, Diffutils,
GCC, Gettext, Glibc, Grep, M4, Make, and Sed</seg></seglistitem>
<seglistitem>
<seg>Bash, Binutils, Bison, Coreutils, Diffutils, GCC, Gettext,
Glibc, Grep, M4, Make, and Sed</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Flex</title>
<para>Flex contains several known bugs. Fix these with the following patch:</para>
<para>Flex contains several known bugs. Fix these with the following
patch:</para>
<screen><userinput>patch -Np1 -i ../&flex-fixes-patch;</userinput></screen>
@ -65,7 +81,8 @@ this:</para>
<para>A few programs do not know about <command>flex</command> yet and
try to run its predecessor, <command>lex</command>. To support those
programs, create a wrapper script named <filename>lex</filename> that
calls <filename>flex</filename> in <command>lex</command> emulation mode:</para>
calls <filename>flex</filename> in <command>lex</command> emulation
mode:</para>
<screen><userinput>cat &gt; /usr/bin/lex &lt;&lt; "EOF"
<literal>#!/bin/sh
@ -79,17 +96,21 @@ chmod -v 755 /usr/bin/lex</userinput></screen>
</sect2>
<sect2 id="contents-flex" role="content"><title>Contents of Flex</title>
<sect2 id="contents-flex" role="content">
<title>Contents of Flex</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<segtitle>Installed library</segtitle>
<seglistitem><seg>flex and lex</seg>
<seg>libfl.a</seg></seglistitem>
<seglistitem>
<seg>flex and lex</seg>
<seg>libfl.a</seg>
</seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
@ -97,19 +118,22 @@ chmod -v 755 /usr/bin/lex</userinput></screen>
<term><command>flex</command></term>
<listitem>
<para>A tool for generating programs that recognize patterns in text;
it allows for the versatility to specify the rules for
pattern-finding, eradicating the need to develop a specialized
program</para>
<indexterm zone="ch-system-flex flex"><primary sortas="b-flex">flex</primary></indexterm>
it allows for the versatility to specify the rules for pattern-finding,
eradicating the need to develop a specialized program</para>
<indexterm zone="ch-system-flex flex">
<primary sortas="b-flex">flex</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="lex">
<term><command>lex</command></term>
<listitem>
<para>A script that runs <command>flex</command> in <command>lex</command>
emulation mode</para>
<indexterm zone="ch-system-flex lex"><primary sortas="b-lex">lex</primary></indexterm>
<para>A script that runs <command>flex</command> in
<command>lex</command> emulation mode</para>
<indexterm zone="ch-system-flex lex">
<primary sortas="b-lex">lex</primary>
</indexterm>
</listitem>
</varlistentry>
@ -117,12 +141,14 @@ emulation mode</para>
<term><filename class="libraryfile">libfl.a</filename></term>
<listitem>
<para>The <filename class="libraryfile">flex</filename> library</para>
<indexterm zone="ch-system-flex libfl.a"><primary sortas="c-libfl.a">libfl.a</primary></indexterm>
<indexterm zone="ch-system-flex libfl.a">
<primary sortas="c-libfl.a">libfl.a</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>