diff options
author | Manuel Canales Esparcia <manuel@linuxfromscratch.org> | 2006-02-10 19:05:30 +0000 |
---|---|---|
committer | Manuel Canales Esparcia <manuel@linuxfromscratch.org> | 2006-02-10 19:05:30 +0000 |
commit | ddd554266cd757b9da553e430eeb408bf8bbc5c4 (patch) | |
tree | eadcaf24fd53730a285cddd18631dc26a39413f8 /chapter06 | |
parent | 3f3931b0a87f6b5e217b5ffd8bbfcd758045f8c0 (diff) |
Finished the XML indentation plus few tags changes.
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7369 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
Diffstat (limited to 'chapter06')
-rw-r--r-- | chapter06/shadow.xml | 837 | ||||
-rw-r--r-- | chapter06/strippingagain.xml | 70 | ||||
-rw-r--r-- | chapter06/sysklogd.xml | 170 | ||||
-rw-r--r-- | chapter06/sysvinit.xml | 479 | ||||
-rw-r--r-- | chapter06/tar.xml | 137 | ||||
-rw-r--r-- | chapter06/texinfo.xml | 303 | ||||
-rw-r--r-- | chapter06/udev.xml | 407 | ||||
-rw-r--r-- | chapter06/util-linux.xml | 1349 | ||||
-rw-r--r-- | chapter06/vim.xml | 680 | ||||
-rw-r--r-- | chapter06/zlib.xml | 141 |
10 files changed, 2559 insertions, 2014 deletions
diff --git a/chapter06/shadow.xml b/chapter06/shadow.xml index f4f2cff01..c5a5ebc9c 100644 --- a/chapter06/shadow.xml +++ b/chapter06/shadow.xml @@ -1,440 +1,541 @@ <?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-shadow" role="wrap"> -<title>Shadow-&shadow-version;</title> -<?dbhtml filename="shadow.html"?> + <?dbhtml filename="shadow.html"?> + + <title>Shadow-&shadow-version;</title> + + <indexterm zone="ch-system-shadow"> + <primary sortas="a-Shadow">Shadow</primary> + </indexterm> + + <sect2 role="package"> + <title/> + + <para>The Shadow package contains programs for handling passwords in a secure + way.</para> + + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<indexterm zone="ch-system-shadow"><primary sortas="a-Shadow">Shadow</primary></indexterm> + <seglistitem> + <seg>0.4 SBU</seg> + <seg>14.7 MB</seg> + </seglistitem> + </segmentedlist> -<sect2 role="package"><title/> -<para>The Shadow package contains programs for handling passwords in a secure -way.</para> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.4 SBU</seg><seg>14.7 MB</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>Bash, Binutils, Bison, Coreutils, Diffutils, GCC, Gettext, + Glibc, Grep, Make, and Sed</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Bash, Binutils, Bison, Coreutils, -Diffutils, GCC, Gettext, Glibc, Grep, Make, and Sed</seg></seglistitem> -</segmentedlist> -</sect2> + </sect2> -<sect2 role="installation"> -<title>Installation of Shadow</title> + <sect2 role="installation"> + <title>Installation of Shadow</title> -<note><para>If you would like to enforce the use of strong passwords, refer to -<ulink url="&blfs-root;view/svn/postlfs/cracklib.html"/> for installing Cracklib -prior to building Shadow. Then add <parameter>--with-libcrack</parameter> to the -<command>configure</command> command below.</para></note> + <note> + <para>If you would like to enforce the use of strong passwords, refer to + <ulink url="&blfs-root;view/svn/postlfs/cracklib.html"/> for installing + Cracklib prior to building Shadow. Then add + <parameter>--with-libcrack</parameter> to the <command>configure</command> + command below.</para> + </note> -<para>Prepare Shadow for compilation:</para> + <para>Prepare Shadow for compilation:</para> <screen><userinput>./configure --libdir=/lib --enable-shared --without-selinux</userinput></screen> -<para>The meaning of the configure options:</para> + <variablelist> + <title>The meaning of the configure options:</title> -<variablelist> -<varlistentry> -<term><parameter>--without-selinux</parameter></term> -<listitem><para>Support for selinux is enabled by default, but selinux is not -built in a base LFS system. The <command>configure</command> script will fail -if this option is not used.</para></listitem> -</varlistentry> -</variablelist> + <varlistentry> + <term><parameter>--without-selinux</parameter></term> + <listitem> + <para>Support for selinux is enabled by default, but selinux is not + built in a base LFS system. The <command>configure</command> script + will fail if this option is not used.</para> + </listitem> + </varlistentry> -<para>Disable the installation of the <command>groups</command> program and its man page, as Coreutils provides a better version:</para> + </variablelist> + + <para>Disable the installation of the <command>groups</command> program + and its man page, as Coreutils provides a better version:</para> <screen><userinput>sed -i 's/groups$(EXEEXT) //' src/Makefile find man -name Makefile -exec sed -i '/groups/d' {} \;</userinput></screen> -<para>Disable the installation of Chinese and Korean manual pages, since Man-DB -cannot format them properly:</para> + <para>Disable the installation of Chinese and Korean manual pages, since + Man-DB cannot format them properly:</para> <screen><userinput>sed -i -e 's/ ko//' -e 's/ zh_CN zh_TW//' man/Makefile</userinput></screen> -<para>Compile the package:</para> + <para>Compile the package:</para> <screen><userinput>make</userinput></screen> -<para>This package does not come with a test suite.</para> + <para>This package does not come with a test suite.</para> -<para>Install the package:</para> + <para>Install the package:</para> <screen><userinput>make install</userinput></screen> -<para id="shadow-limits-login_access">Shadow uses two files to configure -authentication settings for the system. Install these two configuration -files:</para> + <para id="shadow-limits-login_access">Shadow uses two files to configure + authentication settings for the system. Install these two configuration + files:</para> + + <indexterm zone="shadow-limits-login_access"> + <primary sortas="e-/etc/limits">/etc/limits</primary> + </indexterm> -<indexterm zone="shadow-limits-login_access"><primary sortas="e-/etc/limits">/etc/limits</primary></indexterm> -<indexterm zone="shadow-limits-login_access"><primary sortas="e-/etc/login.access">/etc/login.access</primary></indexterm> + <indexterm zone="shadow-limits-login_access"> + <primary sortas="e-/etc/login.access">/etc/login.access</primary> + </indexterm> <screen><userinput>cp -v etc/{limits,login.access} /etc</userinput></screen> -<para id="shadow-login_defs">Instead of using the default <emphasis>crypt</emphasis> method, -use the more secure <emphasis>MD5</emphasis> method of password -encryption, which also allows passwords longer than 8 characters. It -is also necessary to change the obsolete <filename -class="directory">/var/spool/mail</filename> location for user -mailboxes that Shadow uses by default to the <filename -class="directory">/var/mail</filename> location used currently. Both -of these can be accomplished by changing the relevant configuration -file while copying it to its destination:</para> + <para id="shadow-login_defs">Instead of using the default + <emphasis>crypt</emphasis> method, use the more secure + <emphasis>MD5</emphasis> method of password encryption, which also allows + passwords longer than 8 characters. It is also necessary to change the + obsolete <filename class="directory">/var/spool/mail</filename> location + for user mailboxes that Shadow uses by default to the <filename + class="directory">/var/mail</filename> location used currently. Both of + these can be accomplished by changing the relevant configuration file + while copying it to its destination:</para> -<indexterm zone="shadow-login_defs"><primary sortas="e-/etc/login.defs">/etc/login.defs</primary></indexterm> + <indexterm zone="shadow-login_defs"> + <primary sortas="e-/etc/login.defs">/etc/login.defs</primary> + </indexterm> -<note><para>If you built Shadow with Cracklib support, insert the following into -the <command>sed</command> given below:</para> + <note> + <para>If you built Shadow with Cracklib support, insert the following into + the <command>sed</command> given below:</para> <screen><literal>-e 's@DICTPATH.*@DICTPATH\t/lib/cracklib/pw_dict@'</literal></screen> -</note> + </note> <screen><userinput>sed -e's@#MD5_CRYPT_ENAB.no@MD5_CRYPT_ENAB yes@' \ -e 's@/var/spool/mail@/var/mail@' \ etc/login.defs > /etc/login.defs</userinput></screen> -<para>Move a misplaced program to its proper location:</para> + <para>Move a misplaced program to its proper location:</para> <screen><userinput>mv -v /usr/bin/passwd /bin</userinput></screen> -<para>Move Shadow's libraries to more appropriate locations:</para> + <para>Move Shadow's libraries to more appropriate locations:</para> <screen><userinput>mv -v /lib/libshadow.*a /usr/lib rm -v /lib/libshadow.so ln -sfv ../../lib/libshadow.so.0 /usr/lib/libshadow.so</userinput></screen> -<para>The <parameter>-D</parameter> option of the -<command>useradd</command> program requires the <filename -class="directory">/etc/default</filename> directory for it to work -properly:</para> + <para>The <parameter>-D</parameter> option of the + <command>useradd</command> program requires the <filename + class="directory">/etc/default</filename> directory for it to work + properly:</para> <screen><userinput>mkdir -v /etc/default</userinput></screen> -</sect2> + </sect2> + <sect2 id="conf-shadow" role="configuration"> + <title>Configuring Shadow</title> -<sect2 id="conf-shadow" role="configuration"><title>Configuring Shadow</title> -<indexterm zone="conf-shadow"> -<primary sortas="a-Shadow">Shadow</primary> -<secondary>configuring</secondary></indexterm> + <indexterm zone="conf-shadow"> + <primary sortas="a-Shadow">Shadow</primary> + <secondary>configuring</secondary> + </indexterm> -<para>This package contains utilities to add, modify, and delete users -and groups; set and change their passwords; and perform other -administrative tasks. For a full explanation of what -<emphasis>password shadowing</emphasis> means, see the -<filename>doc/HOWTO</filename> file within the unpacked source tree. -If using Shadow support, keep in mind that programs which need to -verify passwords (display managers, FTP programs, pop3 daemons, etc.) -must be Shadow-compliant. That is, they need to be able to work with -shadowed passwords.</para> + <para>This package contains utilities to add, modify, and delete users and + groups; set and change their passwords; and perform other administrative + tasks. For a full explanation of what <emphasis>password shadowing</emphasis> + means, see the <filename>doc/HOWTO</filename> file within the unpacked + source tree. If using Shadow support, keep in mind that programs which need + to verify passwords (display managers, FTP programs, pop3 daemons, etc.) + must be Shadow-compliant. That is, they need to be able to work with + shadowed passwords.</para> -<para>To enable shadowed passwords, run the following command:</para> + <para>To enable shadowed passwords, run the following command:</para> <screen><userinput>pwconv</userinput></screen> -<para>To enable shadowed group passwords, run:</para> + <para>To enable shadowed group passwords, run:</para> <screen><userinput>grpconv</userinput></screen> -<para>Under normal circumstances, passwords will not have been created -yet. However, if returning to this section later to enable shadowing, -reset any current user passwords with the <command>passwd</command> -command or any group passwords with the <command>gpasswd</command> -command.</para> - -</sect2> + <para>Under normal circumstances, passwords will not have been created + yet. However, if returning to this section later to enable shadowing, + reset any current user passwords with the <command>passwd</command> + command or any group passwords with the <command>gpasswd</command> + command.</para> + </sect2> -<sect2 role="configuration"> -<title>Setting the root password</title> + <sect2 role="configuration"> + <title>Setting the root password</title> -<para>Choose a password for user <emphasis>root</emphasis> and set it -by running:</para> + <para>Choose a password for user <emphasis>root</emphasis> and set it + by running:</para> <screen role="nodump"><userinput>passwd root</userinput></screen> -</sect2> - - -<sect2 id="contents-shadow" role="content"><title>Contents of Shadow</title> - -<segmentedlist> -<segtitle>Installed programs</segtitle> -<segtitle>Installed libraries</segtitle> -<seglistitem><seg>chage, chfn, chpasswd, chsh, expiry, faillog, gpasswd, -groupadd, groupdel, groupmod, grpck, grpconv, grpunconv, lastlog, login, -logoutd, newgrp, newusers, passwd, pwck, pwconv, pwunconv, sg (link to newgrp), -su, useradd, userdel, usermod, vigr (link to vipw), and vipw</seg> -<seg>libshadow.[a,so]</seg> -</seglistitem> -</segmentedlist> - -<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> -<?dbhtml list-presentation="table"?> - -<varlistentry id="chage"> -<term><command>chage</command></term> -<listitem> -<para>Used to change the maximum number of days between obligatory -password changes</para> -<indexterm zone="ch-system-shadow chage"><primary sortas="b-chage">chage</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="chfn"> -<term><command>chfn</command></term> -<listitem> -<para>Used to change a user's full name and other information</para> -<indexterm zone="ch-system-shadow chfn"><primary sortas="b-chfn">chfn</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="chpasswd"> -<term><command>chpasswd</command></term> -<listitem> -<para>Used to update the passwords of an entire series of user -accounts</para> -<indexterm zone="ch-system-shadow chpasswd"><primary sortas="b-chpasswd">chpasswd</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="chsh"> -<term><command>chsh</command></term> -<listitem> -<para>Used to change a user's default login shell</para> -<indexterm zone="ch-system-shadow chsh"><primary sortas="b-chsh">chsh</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="expiry"> -<term><command>expiry</command></term> -<listitem> -<para>Checks and enforces the current password expiration policy</para> -<indexterm zone="ch-system-shadow expiry"><primary sortas="b-expiry">expiry</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="faillog"> -<term><command>faillog</command></term> -<listitem> -<para>Is used to examine the log of login failures, to set a maximum number of -failures before an account is blocked, or to reset the failure count</para> -<indexterm zone="ch-system-shadow faillog"><primary sortas="b-faillog">faillog</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="gpasswd"> -<term><command>gpasswd</command></term> -<listitem> -<para>Is used to add and delete members and administrators to groups</para> -<indexterm zone="ch-system-shadow gpasswd"><primary sortas="b-gpasswd">gpasswd</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="groupadd"> -<term><command>groupadd</command></term> -<listitem> -<para>Creates a group with the given name</para> -<indexterm zone="ch-system-shadow groupadd"><primary sortas="b-groupadd">groupadd</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="groupdel"> -<term><command>groupdel</command></term> -<listitem> -<para>Deletes the group with the given name</para> -<indexterm zone="ch-system-shadow groupdel"><primary sortas="b-groupdel">groupdel</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="groupmod"> -<term><command>groupmod</command></term> -<listitem> -<para>Is used to modify the given group's name or GID</para> -<indexterm zone="ch-system-shadow groupmod"><primary sortas="b-groupmod">groupmod</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="grpck"> -<term><command>grpck</command></term> -<listitem> -<para>Verifies the integrity of the group files <filename>/etc/group</filename> -and <filename>/etc/gshadow</filename></para> -<indexterm zone="ch-system-shadow grpck"><primary sortas="b-grpck">grpck</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="grpconv"> -<term><command>grpconv</command></term> -<listitem> -<para>Creates or updates the shadow group file from the normal group file</para> -<indexterm zone="ch-system-shadow grpconv"><primary sortas="b-grpconv">grpconv</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="grpunconv"> -<term><command>grpunconv</command></term> -<listitem> -<para>Updates <filename>/etc/group</filename> -from <filename>/etc/gshadow</filename> and then deletes the latter</para> -<indexterm zone="ch-system-shadow grpunconv"><primary sortas="b-grpunconv">grpunconv</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="lastlog"> -<term><command>lastlog</command></term> -<listitem> -<para>Reports the most recent login of all users or of a given user</para> -<indexterm zone="ch-system-shadow lastlog"><primary sortas="b-lastlog">lastlog</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="login"> -<term><command>login</command></term> -<listitem> -<para>Is used by the system to let users sign on</para> -<indexterm zone="ch-system-shadow login"><primary sortas="b-login">login</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="logoutd"> -<term><command>logoutd</command></term> -<listitem> -<para>Is a daemon used to enforce restrictions on log-on time and ports</para> -<indexterm zone="ch-system-shadow logoutd"><primary sortas="b-logoutd">logoutd</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="newgrp"> -<term><command>newgrp</command></term> -<listitem> -<para>Is used to change the current GID during a login session</para> -<indexterm zone="ch-system-shadow newgrp"><primary sortas="b-newgrp">newgrp</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="newusers"> -<term><command>newusers</command></term> -<listitem> -<para>Is used to create or update an entire series of user accounts</para> -<indexterm zone="ch-system-shadow newusers"><primary sortas="b-newusers">newusers</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="passwd"> -<term><command>passwd</command></term> -<listitem> -<para>Is used to change the password for a user or group account</para> -<indexterm zone="ch-system-shadow passwd"><primary sortas="b-passwd">passwd</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="pwck"> -<term><command>pwck</command></term> -<listitem> -<para>Verifies the integrity of the password files -<filename>/etc/passwd</filename> and <filename>/etc/shadow</filename></para> -<indexterm zone="ch-system-shadow pwck"><primary sortas="b-pwck">pwck</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="pwconv"> -<term><command>pwconv</command></term> -<listitem> -<para>Creates or updates the shadow password file from the normal -password file</para> -<indexterm zone="ch-system-shadow pwconv"><primary sortas="b-pwconv">pwconv</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="pwunconv"> -<term><command>pwunconv</command></term> -<listitem> -<para>Updates <filename>/etc/passwd</filename> -from <filename>/etc/shadow</filename> and then deletes the latter</para> -<indexterm zone="ch-system-shadow pwunconv"><primary sortas="b-pwunconv">pwunconv</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="sg"> -<term><command>sg</command></term> -<listitem> -<para>Executes a given command while the user's GID -is set to that of the given group</para> -<indexterm zone="ch-system-shadow sg"><primary sortas="b-sg">sg</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="su"> -<term><command>su</command></term> -<listitem> -<indexterm zone="ch-system-shadow su"><primary sortas="b-su">su</primary></indexterm> -<para>Runs a shell with substitute user and group IDs</para> -</listitem> -</varlistentry> - -<varlistentry id="useradd"> -<term><command>useradd</command></term> -<listitem> -<para>Creates a new user with the given name, or updates the default -new-user information</para> -<indexterm zone="ch-system-shadow useradd"><primary sortas="b-useradd">useradd</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="userdel"> -<term><command>userdel</command></term> -<listitem> -<para>Deletes the given user account</para> -<indexterm zone="ch-system-shadow userdel"><primary sortas="b-userdel">userdel</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="usermod"> -<term><command>usermod</command></term> -<listitem> -<para>Is used to modify the given user's login name, User -Identification (UID), -shell, initial group, home directory, etc.</para> -<indexterm zone="ch-system-shadow usermod"><primary sortas="b-usermod">usermod</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="vigr"> -<term><command>vigr</command></term> -<listitem> -<para>Edits the <filename>/etc/group</filename> or -<filename>/etc/gshadow</filename> files</para> -<indexterm zone="ch-system-shadow vigr"><primary sortas="b-vigr">vigr</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="vipw"> -<term><command>vipw</command></term> -<listitem> -<para>Edits the <filename>/etc/passwd</filename> or -<filename>/etc/shadow</filename> files</para> -<indexterm zone="ch-system-shadow vipw"><primary sortas="b-vipw">vipw</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="libshadow"> -<term><filename class="libraryfile">libshadow</filename></term> -<listitem> -<para>Contains functions used by most programs in this package</para> -<indexterm zone="ch-system-shadow libshadow"><primary sortas="c-libshadow">libshadow</primary></indexterm> -</listitem> -</varlistentry> -</variablelist> - -</sect2> -</sect1> + </sect2> + + <sect2 id="contents-shadow" role="content"> + <title>Contents of Shadow</title> + + <segmentedlist> + <segtitle>Installed programs</segtitle> + <segtitle>Installed libraries</segtitle> + + <seglistitem> + <seg>chage, chfn, chpasswd, chsh, expiry, faillog, gpasswd, groupadd, + groupdel, groupmod, grpck, grpconv, grpunconv, lastlog, login, logoutd, + newgrp, newusers, passwd, pwck, pwconv, pwunconv, sg (link to newgrp), + su, useradd, userdel, usermod, vigr (link to vipw), and vipw</seg> + <seg>libshadow.[a,so]</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="chage"> + <term><command>chage</command></term> + <listitem> + <para>Used to change the maximum number of days between obligatory + password changes</para> + <indexterm zone="ch-system-shadow chage"> + <primary sortas="b-chage">chage</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="chfn"> + <term><command>chfn</command></term> + <listitem> + <para>Used to change a user's full name and other information</para> + <indexterm zone="ch-system-shadow chfn"> + <primary sortas="b-chfn">chfn</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="chpasswd"> + <term><command>chpasswd</command></term> + <listitem> + <para>Used to update the passwords of an entire series of user + accounts</para> + <indexterm zone="ch-system-shadow chpasswd"> + <primary sortas="b-chpasswd">chpasswd</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="chsh"> + <term><command>chsh</command></term> + <listitem> + <para>Used to change a user's default login shell</para> + <indexterm zone="ch-system-shadow chsh"> + <primary sortas="b-chsh">chsh</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="expiry"> + <term><command>expiry</command></term> + <listitem> + <para>Checks and enforces the current password expiration policy</para> + <indexterm zone="ch-system-shadow expiry"> + <primary sortas="b-expiry">expiry</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="faillog"> + <term><command>faillog</command></term> + <listitem> + <para>Is used to examine the log of login failures, to set a maximum + number of failures before an account is blocked, or to reset the + failure count</para> + <indexterm zone="ch-system-shadow faillog"> + <primary sortas="b-faillog">faillog</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="gpasswd"> + <term><command>gpasswd</command></term> + <listitem> + <para>Is used to add and delete members and administrators to + groups</para> + <indexterm zone="ch-system-shadow gpasswd"> + <primary sortas="b-gpasswd">gpasswd</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="groupadd"> + <term><command>groupadd</command></term> + <listitem> + <para>Creates a group with the given name</para> + <indexterm zone="ch-system-shadow groupadd"> + <primary sortas="b-groupadd">groupadd</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="groupdel"> + <term><command>groupdel</command></term> + <listitem> + <para>Deletes the group with the given name</para> + <indexterm zone="ch-system-shadow groupdel"> + <primary sortas="b-groupdel">groupdel</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="groupmod"> + <term><command>groupmod</command></term> + <listitem> + <para>Is used to modify the given group's name or GID</para> + <indexterm zone="ch-system-shadow groupmod"> + <primary sortas="b-groupmod">groupmod</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="grpck"> + <term><command>grpck</command></term> + <listitem> + <para>Verifies the integrity of the group files + <filename>/etc/group</filename> and + <filename>/etc/gshadow</filename></para> + <indexterm zone="ch-system-shadow grpck"> + <primary sortas="b-grpck">grpck</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="grpconv"> + <term><command>grpconv</command></term> + <listitem> + <para>Creates or updates the shadow group file from the normal + group file</para> + <indexterm zone="ch-system-shadow grpconv"> + <primary sortas="b-grpconv">grpconv</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="grpunconv"> + <term><command>grpunconv</command></term> + <listitem> + <para>Updates <filename>/etc/group</filename> from + <filename>/etc/gshadow</filename> and then deletes the latter</para> + <indexterm zone="ch-system-shadow grpunconv"> + <primary sortas="b-grpunconv">grpunconv</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="lastlog"> + <term><command>lastlog</command></term> + <listitem> + <para>Reports the most recent login of all users or of a + given user</para> + <indexterm zone="ch-system-shadow lastlog"> + <primary sortas="b-lastlog">lastlog</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="login"> + <term><command>login</command></term> + <listitem> + <para>Is used by the system to let users sign on</para> + <indexterm zone="ch-system-shadow login"> + <primary sortas="b-login">login</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="logoutd"> + <term><command>logoutd</command></term> + <listitem> + <para>Is a daemon used to enforce restrictions on log-on time + and ports</para> + <indexterm zone="ch-system-shadow logoutd"> + <primary sortas="b-logoutd">logoutd</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="newgrp"> + <term><command>newgrp</command></term> + <listitem> + <para>Is used to change the current GID during a login session</para> + <indexterm zone="ch-system-shadow newgrp"> + <primary sortas="b-newgrp">newgrp</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="newusers"> + <term><command>newusers</command></term> + <listitem> + <para>Is used to create or update an entire series of user + accounts</para> + <indexterm zone="ch-system-shadow newusers"> + <primary sortas="b-newusers">newusers</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="passwd"> + <term><command>passwd</command></term> + <listitem> + <para>Is used to change the password for a user or group account</para> + <indexterm zone="ch-system-shadow passwd"> + <primary sortas="b-passwd">passwd</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pwck"> + <term><command>pwck</command></term> + <listitem> + <para>Verifies the integrity of the password files + <filename>/etc/passwd</filename> and + <filename>/etc/shadow</filename></para> + <indexterm zone="ch-system-shadow pwck"> + <primary sortas="b-pwck">pwck</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pwconv"> + <term><command>pwconv</command></term> + <listitem> + <para>Creates or updates the shadow password file from the normal + password file</para> + <indexterm zone="ch-system-shadow pwconv"> + <primary sortas="b-pwconv">pwconv</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pwunconv"> + <term><command>pwunconv</command></term> + <listitem> + <para>Updates <filename>/etc/passwd</filename> from + <filename>/etc/shadow</filename> and then deletes the latter</para> + <indexterm zone="ch-system-shadow pwunconv"> + <primary sortas="b-pwunconv">pwunconv</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="sg"> + <term><command>sg</command></term> + <listitem> + <para>Executes a given command while the user's GID + is set to that of the given group</para> + <indexterm zone="ch-system-shadow sg"> + <primary sortas="b-sg">sg</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="su"> + <term><command>su</command></term> + <listitem> + <para>Runs a shell with substitute user and group IDs</para> + <indexterm zone="ch-system-shadow su"> + <primary sortas="b-su">su</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="useradd"> + <term><command>useradd</command></term> + <listitem> + <para>Creates a new user with the given name, or updates the default + new-user information</para> + <indexterm zone="ch-system-shadow useradd"> + <primary sortas="b-useradd">useradd</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="userdel"> + <term><command>userdel</command></term> + <listitem> + <para>Deletes the given user account</para> + <indexterm zone="ch-system-shadow userdel"> + <primary sortas="b-userdel">userdel</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="usermod"> + <term><command>usermod</command></term> + <listitem> + <para>Is used to modify the given user's login name, User + Identification (UID), shell, initial group, home directory, etc.</para> + <indexterm zone="ch-system-shadow usermod"> + <primary sortas="b-usermod">usermod</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="vigr"> + <term><command>vigr</command></term> + <listitem> + <para>Edits the <filename>/etc/group</filename> or + <filename>/etc/gshadow</filename> files</para> + <indexterm zone="ch-system-shadow vigr"> + <primary sortas="b-vigr">vigr</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="vipw"> + <term><command>vipw</command></term> + <listitem> + <para>Edits the <filename>/etc/passwd</filename> or + <filename>/etc/shadow</filename> files</para> + <indexterm zone="ch-system-shadow vipw"> + <primary sortas="b-vipw">vipw</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="libshadow"> + <term><filename class="libraryfile">libshadow</filename></term> + <listitem> + <para>Contains functions used by most programs in this package</para> + <indexterm zone="ch-system-shadow libshadow"> + <primary sortas="c-libshadow">libshadow</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> +</sect1> diff --git a/chapter06/strippingagain.xml b/chapter06/strippingagain.xml index af1352e04..6ca4196eb 100644 --- a/chapter06/strippingagain.xml +++ b/chapter06/strippingagain.xml @@ -1,54 +1,56 @@ <?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-strippingagain"> -<title>Stripping Again</title> -<?dbhtml filename="strippingagain.html"?> - -<para>If the intended user is not a programmer and does not plan to do -any debugging on the system software, the system size can be decreased -by about 200 MB by removing the debugging symbols from binaries and -libraries. This causes no inconvenience other than not being able to -debug the software fully anymore.</para> - -<para>Most people who use the command mentioned below do not -experience any difficulties. However, it is easy to make a typo and -render the new system unusable, so before running the -<command>strip</command> command, it is a good idea to make a -backup of the LFS system in its current state.</para> - -<para>Before performing the stripping, take special care to ensure that -none of the binaries that are about to be stripped are running. If -unsure whether the user entered chroot with the command given in -<xref linkend="ch-system-chroot" role=","/> first exit from -chroot:</para> + <?dbhtml filename="strippingagain.html"?> + + <title>Stripping Again</title> + + <para>If the intended user is not a programmer and does not plan to do + any debugging on the system software, the system size can be decreased + by about 200 MB by removing the debugging symbols from binaries and + libraries. This causes no inconvenience other than not being able to + debug the software fully anymore.</para> + + <para>Most people who use the command mentioned below do not + experience any difficulties. However, it is easy to make a typo and + render the new system unusable, so before running the + <command>strip</command> command, it is a good idea to make a + backup of the LFS system in its current state.</para> + + <para>Before performing the stripping, take special care to ensure that + none of the binaries that are about to be stripped are running. If + unsure whether the user entered chroot with the command given in + <xref linkend="ch-system-chroot" role=","/> first exit from + chroot:</para> <screen role="nodump"><userinput>logout</userinput></screen> -<para>Then reenter it with:</para> + <para>Then reenter it with:</para> <screen role="nodump"><userinput>chroot $LFS /tools/bin/env -i \ HOME=/root TERM=$TERM PS1='\u:\w\$ ' \ PATH=/bin:/usr/bin:/sbin:/usr/sbin \ /tools/bin/bash --login</userinput></screen> -<para>Now the binaries and libraries can be safely stripped:</para> + <para>Now the binaries and libraries can be safely stripped:</para> <screen><userinput>/tools/bin/find /{,usr/}{bin,lib,sbin} -type f \ - -exec /tools/bin/strip --strip-debug '{}' ';'</userinput></screen> + -exec /tools/bin/strip --strip-debug '{}' ';'</userinput></screen> -<para>A large number of files will be reported as having their file -format not recognized. These warnings can be safely ignored. These -warnings indicate that those files are scripts instead of -binaries.</para> + <para>A large number of files will be reported as having their file + format not recognized. These warnings can be safely ignored. These + warnings indicate that those files are scripts instead of + binaries.</para> -<para>If disk space is very tight, the -<parameter>--strip-all</parameter> option can be used on the binaries -in <filename class="directory">/{,usr/}{bin,sbin}</filename> to gain -several more megabytes. Do not use this option on libraries—they will -be destroyed.</para> + <para>If disk space is very tight, the + <parameter>--strip-all</parameter> option can be used on the binaries + in <filename class="directory">/{,usr/}{bin,sbin}</filename> to gain + several more megabytes. Do not use this option on libraries—they will + be destroyed.</para> </sect1> - diff --git a/chapter06/sysklogd.xml b/chapter06/sysklogd.xml index 221e62074..37ebda9c1 100644 --- a/chapter06/sysklogd.xml +++ b/chapter06/sysklogd.xml @@ -1,66 +1,85 @@ <?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-sysklogd" xreflabel="Sysklogd" role="wrap"> -<title>Sysklogd-&sysklogd-version;</title> -<?dbhtml filename="sysklogd.html"?> -<indexterm zone="ch-system-sysklogd"><primary sortas="a-Sysklogd">Sysklogd</primary></indexterm> +<sect1 id="ch-system-sysklogd" role="wrap"> + <?dbhtml filename="sysklogd.html"?> -<sect2 role="package"><title/> -<para>The Sysklogd package contains programs for logging system messages, such -as those given by the kernel when unusual things happen.</para> + <title>Sysklogd-&sysklogd-version;</title> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.1 SBU</seg><seg>704 KB</seg></seglistitem> -</segmentedlist> + <indexterm zone="ch-system-sysklogd"> + <primary sortas="a-Sysklogd">Sysklogd</primary> + </indexterm> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Binutils, Coreutils, GCC, Glibc, Make</seg></seglistitem> -</segmentedlist> -</sect2> + <sect2 role="package"> + <title/> -<sect2 role="installation"> -<title>Installation of Sysklogd</title> + <para>The Sysklogd package contains programs for logging system messages, + such as those given by the kernel when unusual things happen.</para> -<para>The following patch fixes various issues, including a problem building -Sysklogd with Linux 2.6 series kernels</para> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> + + <seglistitem> + <seg>0.1 SBU</seg> + <seg>704 KB</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&dependencies;</segtitle> + + <seglistitem> + <seg>Binutils, Coreutils, GCC, Glibc, Make</seg> + </seglistitem> + </segmentedlist> + + </sect2> + + <sect2 role="installation"> + <title>Installation of Sysklogd</title> + + <para>The following patch fixes various issues, including a problem building + Sysklogd with Linux 2.6 series kernels</para> <screen><userinput>patch -Np1 -i ../&sysklogd-fixes-patch;</userinput></screen> -<para>The following patch makes sysklogd treat bytes in the 0x80--0x9f range -literally in the messages being logged, instead of replacing them with octal -codes. Unpatched sysklogd would damage messages in the UTF-8 encoding.</para> + <para>The following patch makes sysklogd treat bytes in the 0x80--0x9f range + literally in the messages being logged, instead of replacing them with octal + codes. Unpatched sysklogd would damage messages in the UTF-8 encoding.</para> <screen><userinput>patch -Np1 -i ../&sysklogd-8bit-patch;</userinput></screen> -<para>Compile the package:</para> + <para>Compile the package:</para> <screen><userinput>make</userinput></screen> -<para>This package does not come with a test suite.</para> + <para>This package does not come with a test suite.</para> -<para>Install the package:</para> + <para>Install the package:</para> <screen><userinput>make install</userinput></screen> -</sect2> + </sect2> + <sect2 id="conf-sysklogd" role="configuration"> + <title>Configuring Sysklogd</title> -<sect2 id="conf-sysklogd" role="configuration"><title>Configuring Sysklogd</title> -<indexterm zone="conf-sysklogd"> -<primary sortas="a-Sysklogd">Sysklogd</primary> -<secondary>configuring</secondary></indexterm> + <indexterm zone="conf-sysklogd"> + <primary sortas="a-Sysklogd">Sysklogd</primary> + <secondary>configuring</secondary> + </indexterm> -<indexterm zone="conf-sysklogd"><primary sortas="e-/etc/syslog.conf">/etc/syslog.conf</primary></indexterm> + <indexterm zone="conf-sysklogd"> + <primary sortas="e-/etc/syslog.conf">/etc/syslog.conf</primary> + </indexterm> -<para>Create a new <filename>/etc/syslog.conf</filename> file by running the -following:</para> + <para>Create a new <filename>/etc/syslog.conf</filename> file by running the + following:</para> <screen><userinput>cat > /etc/syslog.conf << "EOF" <literal># Begin /etc/syslog.conf @@ -79,40 +98,49 @@ local2.* -/var/log/boot.log # End /etc/syslog.conf</literal> EOF</userinput></screen> -</sect2> - - -<sect2 id="contents-sysklogd" role="content"><title>Contents of Sysklogd</title> - -<segmentedlist> -<segtitle>Installed programs</segtitle> -<seglistitem><seg>klogd and syslogd</seg></seglistitem> -</segmentedlist> - -<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> -<?dbhtml list-presentation="table"?> - -<varlistentry id="klogd"> -<term><command>klogd</command></term> -<listitem> -<para>A system daemon for intercepting and logging kernel messages</para> -<indexterm zone="ch-system-sysklogd klogd"><primary sortas="b-klogd">klogd</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="syslogd"> -<term><command>syslogd</command></term> -<listitem> -<para>Logs the messages that system programs offer for logging. Every logged -message contains at least a date stamp and a hostname, and normally the -program's name too, but that depends on how trusting the logging daemon is told -to be</para> -<indexterm zone="ch-system-sysklogd syslogd"><primary sortas="b-syslogd">syslogd</primary></indexterm> -</listitem> -</varlistentry> -</variablelist> - -</sect2> + </sect2> + + <sect2 id="contents-sysklogd" role="content"> + <title>Contents of Sysklogd</title> + + <segmentedlist> + <segtitle>Installed programs</segtitle> + + <seglistitem> + <seg>klogd and syslogd</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="klogd"> + <term><command>klogd</command></term> + <listitem> + <para>A system daemon for intercepting and logging kernel messages</para> + <indexterm zone="ch-system-sysklogd klogd"> + <primary sortas="b-klogd">klogd</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="syslogd"> + <term><command>syslogd</command></term> + <listitem> + <para>Logs the messages that system programs offer for logging. Every + logged message contains at least a date stamp and a hostname, and + normally the program's name too, but that depends on how trusting the + logging daemon is told to be</para> + <indexterm zone="ch-system-sysklogd syslogd"> + <primary sortas="b-syslogd">syslogd</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> </sect1> diff --git a/chapter06/sysvinit.xml b/chapter06/sysvinit.xml index a82fdd9a8..e2d8677cb 100644 --- a/chapter06/sysvinit.xml +++ b/chapter06/sysvinit.xml @@ -1,69 +1,87 @@ <?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-sysvinit" role="wrap"> -<title>Sysvinit-&sysvinit-version;</title> -<?dbhtml filename="sysvinit.html"?> - -<indexterm zone="ch-system-sysvinit"><primary sortas="a-Sysvinit">Sysvinit</primary></indexterm> - -<sect2 role="package"><title/> -<para>The Sysvinit package contains programs for controlling the startup, -running, and shutdown of the system.</para> - -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.1 SBU</seg><seg>1012 KB</seg></seglistitem> -</segmentedlist> - -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Binutils, Coreutils, GCC, Glibc, and Make</seg></seglistitem> -</segmentedlist> -</sect2> - -<sect2 role="installation"> -<title>Installation of Sysvinit</title> - -<para>When run-levels are changed (for example, when halting the -system), <command>init</command> sends termination signals to those -processes that <command>init</command> itself started and that should -not be running in the new run-level. While doing this, -<command>init</command> outputs messages like <quote>Sending processes -the TERM signal</quote> which seem to imply that it is sending these -signals to all currently running processes. To avoid this -misinterpretation, modify the source so that these messages read like -<quote>Sending processes started by init the TERM signal</quote> -instead:</para> + <?dbhtml filename="sysvinit.html"?> + + <title>Sysvinit-&sysvinit-version;</title> + + <indexterm zone="ch-system-sysvinit"> + <primary sortas="a-Sysvinit">Sysvinit</primary> + </indexterm> + + <sect2 role="package"> + <title/> + + <para>The Sysvinit package contains programs for controlling the startup, + running, and shutdown of the system.</para> + + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> + + <seglistitem> + <seg>0.1 SBU</seg><seg>1012 KB</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&dependencies;</segtitle> + + <seglistitem> + <seg>Binutils, Coreutils, GCC, Glibc, and Make</seg> + </seglistitem> + </segmentedlist> + + </sect2> + + <sect2 role="installation"> + <title>Installation of Sysvinit</title> + + <para>When run-levels are changed (for example, when halting the + system), <command>init</command> sends termination signals to those + processes that <command>init</command> itself started and that should + not be running in the new run-level. While doing this, + <command>init</command> outputs messages like <quote>Sending processes + the TERM signal</quote> which seem to imply that it is sending these + signals to all currently running processes. To avoid this + misinterpretation, modify the source so that these messages read like + <quote>Sending processes started by init the TERM signal</quote> + instead:</para> <screen><userinput>sed -i 's@Sending processes@& started by init@g' \ src/init.c</userinput></screen> -<para>Compile the package:</para> + <para>Compile the package:</para> <screen><userinput>make -C src</userinput></screen> -<para>This package does not come with a test suite.</para> + <para>This package does not come with a test suite.</para> -<para>Install the package:</para> + <para>Install the package:</para> <screen><userinput>make -C src install</userinput></screen> -</sect2> + </sect2> + <sect2 id="conf-sysvinit" role="configuration"> + <title>Configuring Sysvinit</title> -<sect2 id="conf-sysvinit" role="configuration"><title>Configuring Sysvinit</title> -<indexterm zone="conf-sysvinit"> -<primary sortas="a-Sysvinit">Sysvinit</primary> -<secondary>configuring</secondary></indexterm> + <indexterm zone="conf-sysvinit"> + <primary sortas="a-Sysvinit">Sysvinit</primary> + <secondary>configuring</secondary> + </indexterm> -<indexterm zone="conf-sysvinit"><primary sortas="e-/etc/inittab">/etc/inittab</primary></indexterm> + <indexterm zone="conf-sysvinit"> + <primary sortas="e-/etc/inittab">/etc/inittab</primary> + </indexterm> -<para>Create a new file <filename>/etc/inittab</filename> by running the -following:</para> + <para>Create a new file <filename>/etc/inittab</filename> by running the + following:</para> <screen><userinput>cat > /etc/inittab << "EOF" <literal># Begin /etc/inittab @@ -93,170 +111,209 @@ su:S016:once:/sbin/sulogin # End /etc/inittab</literal> EOF</userinput></screen> -</sect2> - - -<sect2 id="contents-sysvinit" role="content"><title>Contents of Sysvinit</title> - -<segmentedlist> -<segtitle>Installed programs</segtitle> -<seglistitem><seg>halt, init, killall5, last, lastb (link to last), mesg, pidof (link to -killall5), poweroff (link to halt), reboot (link to halt), runlevel, shutdown, sulogin, telinit -(link to init), utmpdump, and wall</seg></seglistitem> -</segmentedlist> - -<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> -<?dbhtml list-presentation="table"?> - -<varlistentry id="halt"> -<term><command>halt</command></term> -<listitem> -<para>Normally invokes <command>shutdown</command> with the -<parameter>-h</parameter> option, except when already in run-level 0, -then it tells the kernel to halt the system; it notes in the -file <filename>/var/log/wtmp</filename> that the system is being -brought down</para> -<indexterm zone="ch-system-sysvinit halt"><primary sortas="b-halt">halt</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="init"> -<term><command>init</command></term> -<listitem> -<para>The first process to be started when the kernel has initialized -the hardware which takes over the boot process and -starts all the proceses it is instructed to</para> -<indexterm zone="ch-system-sysvinit init"><primary sortas="b-init">init</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="killall5"> -<term><command>killall5</command></term> -<listitem> -<para>Sends a signal to all processes, except the processes in its own -session so it will not kill the shell running the script that called -it</para> -<indexterm zone="ch-system-sysvinit killall5"><primary sortas="b-killall5">killall5</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="last"> -<term><command>last</command></term> -<listitem> -<para>Shows which users last logged in (and out), -searching back through the <filename>/var/log/wtmp</filename> file; it -also shows system boots, shutdowns, and run-level changes</para> -<indexterm zone="ch-system-sysvinit last"><primary sortas="b-last">last</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="lastb"> -<term><command>lastb</command></term> -<listitem> -<para>Shows the failed login attempts, as logged in -<filename>/var/log/btmp</filename></para> -<indexterm zone="ch-system-sysvinit lastb"><primary sortas="b-lastb">lastb</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="mesg"> -<term><command>mesg</command></term> -<listitem> -<para>Controls whether other users can send messages to the current -user's terminal</para> -<indexterm zone="ch-system-sysvinit mesg"><primary sortas="b-mesg">mesg</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="mountpoint"> -<term><command>mountpoint</command></term> -<listitem> -<para>Checks if the directory is a mountpoint</para> -<indexterm zone="ch-system-sysvinit mountpoint"><primary sortas="b-mountpoint">mountpoint</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="pidof"> -<term><command>pidof</command></term> -<listitem> -<para>Reports the PIDs of the given programs</para> -<indexterm zone="ch-system-sysvinit pidof"><primary sortas="b-pidof">pidof</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="poweroff"> -<term><command>poweroff</command></term> -<listitem> -<para>Tells the kernel to halt the system and switch off the computer -(see <command>halt</command>)</para> -<indexterm zone="ch-system-sysvinit poweroff"><primary sortas="b-poweroff">poweroff</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="reboot"> -<term><command>reboot</command></term> -<listitem> -<para>Tells the kernel to reboot the system (see -<command>halt</command>)</para> -<indexterm zone="ch-system-sysvinit reboot"><primary sortas="b-reboot">reboot</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="runlevel"> -<term><command>runlevel</command></term> -<listitem> -<para>Reports the previous and the current run-level, as noted in the last run-level -record in <filename>/var/run/utmp</filename></para> -<indexterm zone="ch-system-sysvinit runlevel"><primary sortas="b-runlevel">runlevel</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="shutdown"> -<term><command>shutdown</command></term> -<listitem> -<para>Brings the system down in a secure way, signaling all processes -and notifying all logged-in users</para> -<indexterm zone="ch-system-sysvinit shutdown"><primary sortas="b-shutdown">shutdown</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="sulogin"> -<term><command>sulogin</command></term> -<listitem> -<para>Allows <emphasis>root</emphasis> to log in; it is -normally invoked by <command>init</command> when the system goes into single user mode</para> -<indexterm zone="ch-system-sysvinit sulogin"><primary sortas="b-sulogin">sulogin</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="telinit"> -<term><command>telinit</command></term> -<listitem> -<para>Tells <command>init</command> which run-level to change to</para> -<indexterm zone="ch-system-sysvinit telinit"><primary sortas="b-telinit">telinit</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="utmpdump"> -<term><command>utmpdump</command></term> -<listitem> -<para>Displays the content of the given login file in a more -user-friendly format</para> -<indexterm zone="ch-system-sysvinit utmpdump"><primary sortas="b-utmpdump">utmpdump</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="wall"> -<term><command>wall</command></term> -<listitem> -<para>Writes a message to all logged-in users</para> -<indexterm zone="ch-system-sysvinit wall"><primary sortas="b-wall">wall</primary></indexterm> -</listitem> -</varlistentry> -</variablelist> - -</sect2> -</sect1> + </sect2> + + <sect2 id="contents-sysvinit" role="content"> + <title>Contents of Sysvinit</title> + + <segmentedlist> + <segtitle>Installed programs</segtitle> + + <seglistitem> + <seg>halt, init, killall5, last, lastb (link to last), mesg, mountpoint, + pidof (link to killall5), poweroff (link to halt), reboot (link to halt), + runlevel, shutdown, sulogin, telinit (link to init), utmpdump, and + wall</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="halt"> + <term><command>halt</command></term> + <listitem> + <para>Normally invokes <command>shutdown</command> with the + <parameter>-h</parameter> option, except when already in run-level 0, + then it tells the kernel to halt the system; it notes in the + file <filename>/var/log/wtmp</filename> that the system is being + brought down</para> + <indexterm zone="ch-system-sysvinit halt"> + <primary sortas="b-halt">halt</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="init"> + <term><command>init</command></term> + <listitem> + <para>The first process to be started when the kernel has initialized + the hardware which takes over the boot process and starts all the + proceses it is instructed to</para> + <indexterm zone="ch-system-sysvinit init"> + <primary sortas="b-init">init</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="killall5"> + <term><command>killall5</command></term> + <listitem> + <para>Sends a signal to all processes, except the processes in its own + session so it will not kill the shell running the script that called + it</para> + <indexterm zone="ch-system-sysvinit killall5"> + <primary sortas="b-killall5">killall5</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="last"> + <term><command>last</command></term> + <listitem> + <para>Shows which users last logged in (and out), searching back + through the <filename>/var/log/wtmp</filename> file; it also shows + system boots, shutdowns, and run-level changes</para> + <indexterm zone="ch-system-sysvinit last"> + <primary sortas="b-last">last</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="lastb"> + <term><command>lastb</command></term> + <listitem> + <para>Shows the failed login attempts, as logged in + <filename>/var/log/btmp</filename></para> + <indexterm zone="ch-system-sysvinit lastb"> + <primary sortas="b-lastb">lastb</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="mesg"> + <term><command>mesg</command></term> + <listitem> + <para>Controls whether other users can send messages to the current + user's terminal</para> + <indexterm zone="ch-system-sysvinit mesg"> + <primary sortas="b-mesg">mesg</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="mountpoint"> + <term><command>mountpoint</command></term> + <listitem> + <para>Checks if the directory is a mountpoint</para> + <indexterm zone="ch-system-sysvinit mountpoint"> + <primary sortas="b-mountpoint">mountpoint</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pidof"> + <term><command>pidof</command></term> + <listitem> + <para>Reports the PIDs of the given programs</para> + <indexterm zone="ch-system-sysvinit pidof"> + <primary sortas="b-pidof">pidof</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="poweroff"> + <term><command>poweroff</command></term> + <listitem> + <para>Tells the kernel to halt the system and switch off the computer + (see <command>halt</command>)</para> + <indexterm zone="ch-system-sysvinit poweroff"> + <primary sortas="b-poweroff">poweroff</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="reboot"> + <term><command>reboot</command></term> + <listitem> + <para>Tells the kernel to reboot the system (see + <command>halt</command>)</para> + <indexterm zone="ch-system-sysvinit reboot"> + <primary sortas="b-reboot">reboot</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="runlevel"> + <term><command>runlevel</command></term> + <listitem> + <para>Reports the previous and the current run-level, as noted in the + last run-level record in <filename>/var/run/utmp</filename></para> + <indexterm zone="ch-system-sysvinit runlevel"> + <primary sortas="b-runlevel">runlevel</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="shutdown"> + <term><command>shutdown</command></term> + <listitem> + <para>Brings the system down in a secure way, signaling all processes + and notifying all logged-in users</para> + <indexterm zone="ch-system-sysvinit shutdown"> + <primary sortas="b-shutdown">shutdown</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="sulogin"> + <term><command>sulogin</command></term> + <listitem> + <para>Allows <systemitem class="username">root</systemitem> to log in; + it is normally invoked by <command>init</command> when the system goes + into single user mode</para> + <indexterm zone="ch-system-sysvinit sulogin"> + <primary sortas="b-sulogin">sulogin</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="telinit"> + <term><command>telinit</command></term> + <listitem> + <para>Tells <command>init</command> which run-level to change to</para> + <indexterm zone="ch-system-sysvinit telinit"> + <primary sortas="b-telinit">telinit</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="utmpdump"> + <term><command>utmpdump</command></term> + <listitem> + <para>Displays the content of the given login file in a more + user-friendly format</para> + <indexterm zone="ch-system-sysvinit utmpdump"> + <primary sortas="b-utmpdump">utmpdump</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="wall"> + <term><command>wall</command></term> + <listitem> + <para>Writes a message to all logged-in users</para> + <indexterm zone="ch-system-sysvinit wall"> + <primary sortas="b-wall">wall</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> +</sect1> diff --git a/chapter06/tar.xml b/chapter06/tar.xml index c4fb7d67b..939b73f44 100644 --- a/chapter06/tar.xml +++ b/chapter06/tar.xml @@ -1,92 +1,117 @@ <?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-tar" role="wrap"> -<title>Tar-&tar-version;</title> -<?dbhtml filename="tar.html"?> + <?dbhtml filename="tar.html"?> + + <title>Tar-&tar-version;</title> + + <indexterm zone="ch-system-tar"> + <primary sortas="a-Tar">Tar</primary> + </indexterm> + + <sect2 role="package"> + <title/> + + <para>The Tar package contains an archiving program.</para> -<indexterm zone="ch-system-tar"><primary sortas="a-Tar">Tar</primary></indexterm> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<sect2 role="package"><title/> -<para>The Tar package contains an archiving program.</para> + <seglistitem> + <seg>0.2 SBU</seg> + <seg>12.7 MB</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.2 SBU</seg><seg>12.7 MB</seg></seglistitem> -</segmentedlist> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Bash, Binutils, Coreutils, -Diffutils, GCC, Gettext, Glibc, Grep, Make, and Sed</seg></seglistitem> -</segmentedlist> -</sect2> + <seglistitem> + <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc, + Grep, Make, and Sed</seg> + </seglistitem> + </segmentedlist> -<sect2 role="installation"> -<title>Installation of Tar</title> + </sect2> -<para>Apply a patch to fix some issues with the test suite when using -GCC-&gcc-version;:</para> + <sect2 role="installation"> + <title>Installation of Tar</title> + + <para>Apply a patch to fix some issues with the test suite when using + GCC-&gcc-version;:</para> <screen><userinput>patch -Np1 -i ../&tar-gcc4_fix-patch;</userinput></screen> -<para>Tar has a bug when the <parameter>-S</parameter> option is used -with files larger than 4 GB. The following patch properly fixes this issue:</para> + <para>Tar has a bug when the <parameter>-S</parameter> option is used + with files larger than 4 GB. The following patch properly fixes this + issue:</para> <screen><userinput>patch -Np1 -i ../&tar-sparse_fix-patch;</userinput></screen> -<para>Prepare Tar for compilation:</para> + <para>Prepare Tar for compilation:</para> <screen><userinput>./configure --prefix=/usr --bindir=/bin --libexecdir=/usr/sbin</userinput></screen> -<para>Compile the package:</para> + <para>Compile the package:</para> <screen><userinput>make</userinput></screen> -<para>To test the results, issue: -<userinput>make check</userinput>.</para> + <para>To test the results, issue: + <userinput>make check</userinput>.</para> -<para>Install the package:</para> + <para>Install the package:</para> <screen><userinput>make install</userinput></screen> -</sect2> + </sect2> -<sect2 id="contents-tar" role="content"><title>Contents of Tar</title> + <sect2 id="contents-tar" role="content"> + <title>Contents of Tar</title> -<segmentedlist> -<segtitle>Installed programs</segtitle> -<seglistitem><seg>rmt and tar</seg></seglistitem> -</segmentedlist> + <segmentedlist> + <segtitle>Installed programs</segtitle> -<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> -<?dbhtml list-presentation="table"?> + <seglistitem> + <seg>rmt and tar</seg> + </seglistitem> + </segmentedlist> -<varlistentry id="rmt"> -<term><command>rmt</command></term> -<listitem> -<para>Remotely manipulates a magnetic -tape drive through an interprocess communication connection</para> -<indexterm zone="ch-system-tar rmt"><primary sortas="b-rmt">rmt</primary></indexterm> -</listitem> -</varlistentry> + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> -<varlistentry id="tar"> -<term><command>tar</command></term> -<listitem> -<para>Creates, extracts files from, and lists the contents of archives, -also known as tarballs</para> -<indexterm zone="ch-system-tar tar"><primary sortas="b-tar">tar</primary></indexterm> -</listitem> -</varlistentry> -</variablelist> + <varlistentry id="rmt"> + <term><command>rmt</command></term> + <listitem> + <para>Remotely manipulates a magnetic + tape drive through an interprocess communication connection</para> + <indexterm zone="ch-system-tar rmt"> + <primary sortas="b-rmt">rmt</primary> + </indexterm> + </listitem> + </varlistentry> -</sect2> + <varlistentry id="tar"> + <term><command>tar</command></term> + <listitem> + <para>Creates, extracts files from, and lists the contents of archives, + also known as tarballs</para> + <indexterm zone="ch-system-tar tar"> + <primary sortas="b-tar">tar</primary> + </indexterm> + </listitem> + </varlistentry> -</sect1> + </variablelist> + </sect2> + +</sect1> diff --git a/chapter06/texinfo.xml b/chapter06/texinfo.xml index 93c83c465..db6f979bd 100644 --- a/chapter06/texinfo.xml +++ b/chapter06/texinfo.xml @@ -1,86 +1,103 @@ <?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-texinfo" role="wrap"> -<title>Texinfo-&texinfo-version;</title> -<?dbhtml filename="texinfo.html"?> + <?dbhtml filename="texinfo.html"?> + + <title>Texinfo-&texinfo-version;</title> + + <indexterm zone="ch-system-texinfo"> + <primary sortas="a-Texinfo">Texinfo</primary> + </indexterm> + + <sect2 role="package"> + <title/> + + <para>The Texinfo package contains programs for reading, writing, and + converting info pages.</para> -<indexterm zone="ch-system-texinfo"><primary sortas="a-Texinfo">Texinfo</primary></indexterm> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<sect2 role="package"><title/> -<para>The Texinfo package contains programs for reading, writing, and -converting info pages.</para> + <seglistitem> + <seg>0.2 SBU</seg> + <seg>14.7 MB</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.2 SBU</seg><seg>14.7 MB</seg></seglistitem> -</segmentedlist> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Bash, Binutils, Coreutils, -Diffutils, GCC, Gettext, Glibc, Grep, Make, Ncurses, and Sed</seg></seglistitem> -</segmentedlist> -</sect2> + <seglistitem> + <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc, + Grep, Make, Ncurses, and Sed</seg> + </seglistitem> + </segmentedlist> -<sect2 role="installation"> -<title>Installation of Texinfo</title> + </sect2> -<para>The <command>info</command> program makes assumptions such as that -a string occupies the same number of character cells on the screen and bytes -in memory and that one can break the string anywhere, which fail in -UTF-8 based locales. The patch below makes them valid -by falling back to English messages when a multibyte locale is in use:</para> + <sect2 role="installation"> + <title>Installation of Texinfo</title> + + <para>The <command>info</command> program makes assumptions such as that + a string occupies the same number of character cells on the screen and + bytes in memory and that one can break the string anywhere, which fail + in UTF-8 based locales. The patch below makes them valid by falling back + to English messages when a multibyte locale is in use:</para> <screen><userinput>patch -Np1 -i ../&texinfo-multibyte-patch;</userinput></screen> -<para>Texinfo allows local users to overwrite arbitrary files via a symlink -attack on temporary files. Apply the following patch to fix this:</para> + <para>Texinfo allows local users to overwrite arbitrary files via a symlink + attack on temporary files. Apply the following patch to fix this:</para> <screen><userinput>patch -Np1 -i ../&texinfo-tempfile_fix-patch;</userinput></screen> -<para>Prepare Texinfo for compilation:</para> + <para>Prepare Texinfo for compilation:</para> <screen><userinput>./configure --prefix=/usr</userinput></screen> -<para>Compile the package:</para> + <para>Compile the package:</para> <screen><userinput>make</userinput></screen> -<para>To test the results, issue: -<userinput>make check</userinput>.</para> + <para>To test the results, issue: + <userinput>make check</userinput>.</para> -<para>Install the package:</para> + <para>Install the package:</para> <screen><userinput>make install</userinput></screen> -<para>Optionally, install the components belonging in a TeX installation:</para> + <para>Optionally, install the components belonging in a TeX + installation:</para> + <!-- FIXME: doesn't the TeX installation in BLFS overwrite files there? --> <screen><userinput>make TEXMF=/usr/share/texmf install-tex</userinput></screen> -<para>The meaning of the make parameter:</para> - -<variablelist> -<varlistentry> -<term><parameter>TEXMF=/usr/share/texmf</parameter></term> -<listitem><para>The <envar>TEXMF</envar> makefile variable holds the location of the -root of the TeX tree if, for example, a TeX package will be installed -later.</para></listitem> -</varlistentry> -</variablelist> -<!-- FIXME: doesn't the TeX installation in BLFS overwrite files there? --> - -<para>The Info documentation system uses a plain text file to hold its -list of menu entries. The file is located at -<filename>/usr/share/info/dir</filename>. Unfortunately, due to -occasional problems in the Makefiles of various packages, it can -sometimes get out of sync with the info pages installed on the -system. If the <filename>/usr/share/info/dir</filename> file ever -needs to be recreated, the following optional commands will accomplish -the task:</para> + <variablelist> + <title>The meaning of the make parameter:</title> + + <varlistentry> + <term><parameter>TEXMF=/usr/share/texmf</parameter></term> + <listitem> + <para>The <envar>TEXMF</envar> makefile variable holds the location + of the root of the TeX tree if, for example, a TeX package will be + installed later.</para> + </listitem> + </varlistentry> + + </variablelist> + + <para>The Info documentation system uses a plain text file to hold its list of + menu entries. The file is located at <filename>/usr/share/info/dir</filename>. + Unfortunately, due to occasional problems in the Makefiles of various packages, + it can sometimes get out of sync with the info pages installed on the system. + If the <filename>/usr/share/info/dir</filename> file ever needs to be + recreated, the following optional commands will accomplish the task:</para> <screen role="nodump"><userinput>cd /usr/share/info rm dir @@ -88,85 +105,105 @@ for f in * do install-info $f dir 2>/dev/null done</userinput></screen> -</sect2> - -<sect2 id="contents-texinfo" role="content"><title>Contents of Texinfo</title> - -<segmentedlist> -<segtitle>Installed programs</segtitle> -<seglistitem><seg>info, infokey, install-info, -makeinfo, texi2dvi, texi2pdf, and texindex</seg></seglistitem> -</segmentedlist> - -<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> -<?dbhtml list-presentation="table"?> - -<varlistentry id="info"> -<term><command>info</command></term> -<listitem> -<para>Used to read info pages which are similar to man pages, but often go much -deeper than just explaining all the available command line options. For example, -compare <command>man bison</command> and <command>info bison</command>.</para> -<indexterm zone="ch-system-texinfo info"><primary sortas="b-info">info</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="infokey"> -<term><command>infokey</command></term> -<listitem> -<para>Compiles a source file containing Info customizations into a -binary format</para> -<indexterm zone="ch-system-texinfo infokey"><primary sortas="b-infokey">infokey</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="install-info"> -<term><command>install-info</command></term> -<listitem> -<para>Used to install info pages; it updates entries in the -<command>info</command> index file</para> -<indexterm zone="ch-system-texinfo install-info"><primary sortas="b-install-info">install-info</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="makeinfo"> -<term><command>makeinfo</command></term> -<listitem> -<para>Translates the given Texinfo source documents into -info pages, plain text, or HTML</para> -<indexterm zone="ch-system-texinfo makeinfo"><primary sortas="b-makeinfo">makeinfo</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="texi2dvi"> -<term><command>texi2dvi</command></term> -<listitem> -<para>Used to format the given Texinfo document into a -device-independent file that can be printed</para> -<indexterm zone="ch-system-texinfo texi2dvi"><primary sortas="b-texi2dvi">texi2dvi</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="texi2pdf"> -<term><command>texi2pdf</command></term> -<listitem> -<para>Used to format the given Texinfo document into a -Portable Document Format (PDF) file</para> -<indexterm zone="ch-system-texinfo texi2pdf"><primary sortas="b-texi2pdf">texi2pdf</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="texindex"> -<term><command>texindex</command></term> -<listitem> -<para>Used to sort Texinfo index files</para> -<indexterm zone="ch-system-texinfo texindex"><primary sortas="b-texindex">texindex</primary></indexterm> -</listitem> -</varlistentry> -</variablelist> - -</sect2> + </sect2> + + <sect2 id="contents-texinfo" role="content"> + <title>Contents of Texinfo</title> + + <segmentedlist> + <segtitle>Installed programs</segtitle> + + <seglistitem> + <seg>info, infokey, install-info, makeinfo, texi2dvi, texi2pdf, and + texindex</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="info"> + <term><command>info</command></term> + <listitem> + <para>Used to read info pages which are similar to man pages, but + often go much deeper than just explaining all the available command + line options. For example, compare <command>man bison</command> and + <command>info bison</command>.</para> + <indexterm zone="ch-system-texinfo info"> + <primary sortas="b-info">info</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="infokey"> + <term><command>infokey</command></term> + <listitem> + <para>Compiles a source file containing Info customizations into a + binary format</para> + <indexterm zone="ch-system-texinfo infokey"> + <primary sortas="b-infokey">infokey</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="install-info"> + <term><command>install-info</command></term> + <listitem> + <para>Used to install info pages; it updates entries in the + <command>info</command> index file</para> + <indexterm zone="ch-system-texinfo install-info"> + <primary sortas="b-install-info">install-info</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="makeinfo"> + <term><command>makeinfo</command></term> + <listitem> + <para>Translates the given Texinfo source documents into + info pages, plain text, or HTML</para> + <indexterm zone="ch-system-texinfo makeinfo"> + <primary sortas="b-makeinfo">makeinfo</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="texi2dvi"> + <term><command>texi2dvi</command></term> + <listitem> + <para>Used to format the given Texinfo document into a + device-independent file that can be printed</para> + <indexterm zone="ch-system-texinfo texi2dvi"> + <primary sortas="b-texi2dvi">texi2dvi</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="texi2pdf"> + <term><command>texi2pdf</command></term> + <listitem> + <para>Used to format the given Texinfo document into a + Portable Document Format (PDF) file</para> + <indexterm zone="ch-system-texinfo texi2pdf"> + <primary sortas="b-texi2pdf">texi2pdf</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="texindex"> + <term><command>texindex</command></term> + <listitem> + <para>Used to sort Texinfo index files</para> + <indexterm zone="ch-system-texinfo texindex"> + <primary sortas="b-texindex">texindex</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> </sect1> - diff --git a/chapter06/udev.xml b/chapter06/udev.xml index 8b77b1b58..c53977ed2 100644 --- a/chapter06/udev.xml +++ b/chapter06/udev.xml @@ -1,217 +1,258 @@ <?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-udev" role="wrap"> -<title>Udev-&udev-version;</title> -<?dbhtml filename="udev.html"?> + <?dbhtml filename="udev.html"?> + + <title>Udev-&udev-version;</title> + + <indexterm zone="ch-system-udev"> + <primary sortas="a-Udev">Udev</primary> + </indexterm> + + <sect2 role="package"> + <title/> -<indexterm zone="ch-system-udev"><primary sortas="a-Udev">Udev</primary></indexterm> + <para>The Udev package contains programs for dynamic creation of device + nodes.</para> -<sect2 role="package"><title/> -<para>The Udev package contains programs for dynamic creation of device nodes.</para> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.1 SBU</seg><seg>3.8 MB</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>0.1 SBU</seg> + <seg>3.8 MB</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Coreutils and Make</seg></seglistitem> -</segmentedlist> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -</sect2> + <seglistitem> + <seg>Coreutils and Make</seg> + </seglistitem> + </segmentedlist> -<sect2 role="installation"> -<title>Installation of Udev</title> + </sect2> -<para>Compile the package:</para> + <sect2 role="installation"> + <title>Installation of Udev</title> + + <para>Compile the package:</para> <screen><userinput>make EXTRAS=extras/run_directory</userinput></screen> -<para>The meaning of the make option:</para> + <variablelist> + <title>The meaning of the make option:</title> + + <varlistentry> + <term><parameter>EXTRAS=extras/run_directory</parameter></term> + <listitem> + <para>This builds the <command>udev_run_devd</command> and + <command>udev_run_hotplugd</command> binaries, which are required + for correct handling of hotpluggable devices.</para> + </listitem> + </varlistentry> -<variablelist> - <varlistentry> - <term><parameter>EXTRAS=extras/run_directory</parameter> - </term> - <listitem> - <para>This builds the <command>udev_run_devd</command> and - <command>udev_run_hotplugd</command> binaries, which are required for - correct handling of hotpluggable devices. - </para> - </listitem> - </varlistentry> -</variablelist> + </variablelist> -<para>To test the results, issue: -<userinput>make test</userinput>.</para> + <para>To test the results, issue: + <userinput>make test</userinput>.</para> -<para>Install the package:</para> + <para>Install the package:</para> <screen><userinput>make DESTDIR=/ EXTRAS=extras/run_directory install</userinput></screen> -<para>The meaning of the make option:</para> + <variablelist> + <title>The meaning of the make parameter:</title> -<variablelist> - <varlistentry> - <term><parameter>DESTDIR=/</parameter> - </term> - <listitem> - <para>This prevents the Udev build process from killing any - <command>udevd</command> processes that may be running on the host - system. - </para> - </listitem> - </varlistentry> -</variablelist> + <varlistentry> + <term><parameter>DESTDIR=/</parameter></term> + <listitem> + <para>This prevents the Udev build process from killing any + <command>udevd</command> processes that may be running on the + host system.</para> + </listitem> + </varlistentry> -<para>Udev's configuration is far from ideal by default, so install -the configuration files here:</para> + </variablelist> + + <para>Udev's configuration is far from ideal by default, so install + the configuration files here:</para> <screen><userinput>cp -v ../&udev-config-file; /etc/udev/rules.d/25-lfs.rules</userinput></screen> -<para>Install the documentation that explains how to create Udev rules:</para> + <para>Install the documentation that explains how to create Udev rules:</para> <screen><userinput>install -m644 -D -v docs/writing_udev_rules/index.html /usr/share/doc/udev-&udev-version;/index.html</userinput></screen> -<!-- Not for the LiveCD --> -<!-- Edit Me --> -<para>Run the <command>udevstart</command> program to create our full -complement of device nodes.</para> + <!-- Not for the LiveCD --> + <!-- Edit Me --> + <para>Run the <command>udevstart</command> program to create our full + complement of device nodes.</para> <screen><userinput>/sbin/udevstart</userinput></screen> -</sect2> - -<sect2 id="contents-udev" role="content"><title>Contents of Udev</title> - -<segmentedlist> -<segtitle>Installed programs</segtitle> -<segtitle>Installed directory</segtitle> -<seglistitem><seg>udev, udev_run_devd, udev_run_hotplugd, udevcontrol, udevd, -udevinfo, udevmonitor, udevsend, udevstart, and udevtest</seg> -<seg>/etc/udev</seg></seglistitem> -</segmentedlist> - -<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> -<?dbhtml list-presentation="table"?> - -<varlistentry id="udev"> -<term><command>udev</command></term> -<listitem> -<para>Creates device nodes in <filename -class="directory">/dev</filename> or renames network interfaces (not -in LFS) in response to hotplug events</para> -<indexterm zone="ch-system-udev udev"><primary sortas="b-udev">udev</primary></indexterm> -</listitem></varlistentry> - -<varlistentry id="udev_run_devd"> - <term><command>udev_run_devd</command></term> - <listitem> - <para>Executes programs and scripts in the - <filename class="directory">/etc/dev.d/</filename> directory in response - to hotplug events - </para> - <indexterm zone="ch-system-udev udev_run_devd"> - <primary sortas="b-udev_run_devd">udev_run_devd</primary> - </indexterm> - </listitem> -</varlistentry> - -<varlistentry id="udev_run_hotplugd"> - <term><command>udev_run_hotplugd</command></term> - <listitem> - <para>Executes programs and scripts in the - <filename class="directory">/etc/hotplug.d/</filename> directory in - response to hotplug events - </para> - <indexterm zone="ch-system-udev udev_run_hotplugd"> - <primary sortas="b-udev_run_hotplugd">udev_run_hotplugd</primary> - </indexterm> - </listitem> -</varlistentry> - -<varlistentry id="udevcontrol"> -<term><command>udevcontrol</command></term> -<listitem> -<para>Configures a number of options for the running <command>udevd</command> -daemon, such as the log level.</para> -<indexterm zone="ch-system-udev udevcontrol"><primary sortas="b-udevcontrol">udevcontrol</primary> -</indexterm> -</listitem></varlistentry> - -<varlistentry id="udevd"> -<term><command>udevd</command></term> -<listitem> -<para>A daemon that reorders hotplug events before submitting them to -<command>udev</command>, -thus avoiding various race conditions</para> -<indexterm zone="ch-system-udev udevd"><primary sortas="b-udevd">udevd</primary></indexterm> -</listitem></varlistentry> - -<varlistentry id="udevinfo"> -<term><command>udevinfo</command></term> -<listitem> -<para>Allows users to query the <command>udev</command> database for -information on any device currently present on the system; it also -provides a way to query any device in the <systemitem -class="filesystem">sysfs</systemitem> tree to help create udev -rules</para> -<indexterm zone="ch-system-udev udevinfo"><primary sortas="b-udevinfo">udevinfo</primary></indexterm> -</listitem></varlistentry> - -<varlistentry id="udevmonitor"> -<term><command>udevmonitor</command></term> -<listitem> -<para>Prints the event received from the kernel and the event which -<command>udev</command> sends out after rule processing</para> -<indexterm zone="ch-system-udev udevmonitor"><primary sortas="b-udevmonitor">udevmonitor</primary> -</indexterm> -</listitem></varlistentry> - -<varlistentry id="udevsend"> -<term><command>udevsend</command></term> -<listitem> -<para>Delivers hotplug events to <command>udevd</command></para> -<indexterm zone="ch-system-udev udevsend"><primary sortas="b-udevsend">udevsend</primary></indexterm> -</listitem></varlistentry> - -<varlistentry id="udevstart"> -<term><command>udevstart</command></term> -<listitem> -<para>Creates device nodes in <filename -class="directory">/dev</filename> that correspond to drivers compiled directly -into the kernel; it performs that task by simulating hotplug events presumably -dropped by the kernel before invocation of this program (e.g., because the root -filesystem has not been mounted) and submitting such synthetic hotplug events -to <command>udev</command></para> -<indexterm zone="ch-system-udev udevstart"><primary sortas="b-udevstart">udevstart</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="udevtest"> -<term><command>udevtest</command></term> -<listitem> -<para>Simulates a <command>udev</command> run for the given device, -and prints out the name of the node the real <command>udev</command> would -have created or (not in LFS) the name of the renamed network interface</para> -<indexterm zone="ch-system-udev udevtest"><primary sortas="b-udevtest">udevtest</primary></indexterm> -</listitem></varlistentry> - -<varlistentry id="etc-udev"> -<term><filename class="directory">/etc/udev</filename></term> -<listitem> -<para>Contains <command>udev</command> configuation files, -device permissions, and rules for device naming</para> -<indexterm zone="ch-system-udev etc-udev"><primary sortas="e-/etc/udev">/etc/udev</primary></indexterm> -</listitem></varlistentry> -</variablelist> -</sect2> + </sect2> + + <sect2 id="contents-udev" role="content"> + <title>Contents of Udev</title> + + <segmentedlist> + <segtitle>Installed programs</segtitle> + <segtitle>Installed directory</segtitle> + + <seglistitem> + <seg>udev, udev_run_devd, udev_run_hotplugd, udevcontrol, udevd, + udevinfo, udevmonitor, udevsend, udevstart, and udevtest</seg> + <seg>/etc/udev</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="udev"> + <term><command>udev</command></term> + <listitem> + <para>Creates device nodes in <filename class="directory">/dev</filename> + or renames network interfaces (not in LFS) in response to hotplug + events</para> + <indexterm zone="ch-system-udev udev"> + <primary sortas="b-udev">udev</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udev_run_devd"> + <term><command>udev_run_devd</command></term> + <listitem> + <para>Executes programs and scripts in the <filename + class="directory">/etc/dev.d/</filename> directory in response to + hotplug events</para> + <indexterm zone="ch-system-udev udev_run_devd"> + <primary sortas="b-udev_run_devd">udev_run_devd</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udev_run_hotplugd"> + <term><command>udev_run_hotplugd</command></term> + <listitem> + <para>Executes programs and scripts in the <filename + class="directory">/etc/hotplug.d/</filename> directory in response + to hotplug events</para> + <indexterm zone="ch-system-udev udev_run_hotplugd"> + <primary sortas="b-udev_run_hotplugd">udev_run_hotplugd</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udevcontrol"> + <term><command>udevcontrol</command></term> + <listitem> + <para>Configures a number of options for the running + <command>udevd</command> daemon, such as the log level.</para> + <indexterm zone="ch-system-udev udevcontrol"> + <primary sortas="b-udevcontrol">udevcontrol</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udevd"> + <term><command>udevd</command></term> + <listitem> + <para>A daemon that reorders hotplug events before submitting them to + <command>udev</command>, thus avoiding various race conditions</para> + <indexterm zone="ch-system-udev udevd"> + <primary sortas="b-udevd">udevd</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udevinfo"> + <term><command>udevinfo</command></term> + <listitem> + <para>Allows users to query the <command>udev</command> database for + information on any device currently present on the system; it also + provides a way to query any device in the <systemitem + class="filesystem">sysfs</systemitem> tree to help create udev + rules</para> + <indexterm zone="ch-system-udev udevinfo"> + <primary sortas="b-udevinfo">udevinfo</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udevmonitor"> + <term><command>udevmonitor</command></term> + <listitem> + <para>Prints the event received from the kernel and the event which + <command>udev</command> sends out after rule processing</para> + <indexterm zone="ch-system-udev udevmonitor"> + <primary sortas="b-udevmonitor">udevmonitor</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udevsend"> + <term><command>udevsend</command></term> + <listitem> + <para>Delivers hotplug events to <command>udevd</command></para> + <indexterm zone="ch-system-udev udevsend"> + <primary sortas="b-udevsend">udevsend</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udevstart"> + <term><command>udevstart</command></term> + <listitem> + <para>Creates device nodes in <filename class="directory">/dev</filename> + that correspond to drivers compiled directly into the kernel; it + performs that task by simulating hotplug events presumably dropped by + the kernel before invocation of this program (e.g., because the root + filesystem has not been mounted) and submitting such synthetic hotplug + events to <command>udev</command></para> + <indexterm zone="ch-system-udev udevstart"> + <primary sortas="b-udevstart">udevstart</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="udevtest"> + <term><command>udevtest</command></term> + <listitem> + <para>Simulates a <command>udev</command> run for the given device, + and prints out the name of the node the real <command>udev</command> + would have created or (not in LFS) the name of the renamed network + interface</para> + <indexterm zone="ch-system-udev udevtest"> + <primary sortas="b-udevtest">udevtest</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="etc-udev"> + <term><filename class="directory">/etc/udev</filename></term> + <listitem> + <para>Contains <command>udev</command> configuation files, + device permissions, and rules for device naming</para> + <indexterm zone="ch-system-udev etc-udev"> + <primary sortas="e-/etc/udev">/etc/udev</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> </sect1> - diff --git a/chapter06/util-linux.xml b/chapter06/util-linux.xml index 1903d7aea..a0c759294 100644 --- a/chapter06/util-linux.xml +++ b/chapter06/util-linux.xml @@ -1,629 +1,782 @@ <?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-util-linux" role="wrap"> -<title>Util-linux-&util-linux-version;</title> -<?dbhtml filename="util-linux.html"?> - -<indexterm zone="ch-system-util-linux"><primary sortas="a-Util-linux">Util-linux</primary></indexterm> - -<sect2 role="package"><title/> -<para>The Util-linux package contains miscellaneous utility programs. Among -them are utilities for handling file systems, consoles, partitions, and -messages.</para> - -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.2 SBU</seg><seg>11.6 MB</seg></seglistitem> -</segmentedlist> - -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Bash, Binutils, Coreutils, -Diffutils, GCC, Gettext, Glibc, Grep, Make, Ncurses, Sed, and Zlib</seg></seglistitem> -</segmentedlist> -</sect2> - -<sect2 role="installation"> -<title>FHS compliance notes</title> - -<para>The FHS recommends using the <filename -class="directory">/var/lib/hwclock</filename> directory instead of the -usual <filename class="directory">/etc</filename> directory as the -location for the <filename>adjtime</filename> file. To make the -<command>hwclock</command> program FHS-compliant, run the -following:</para> + <?dbhtml filename="util-linux.html"?> + + <title>Util-linux-&util-linux-version;</title> + + <indexterm zone="ch-system-util-linux"> + <primary sortas="a-Util-linux">Util-linux</primary> + </indexterm> + + <sect2 role="package"> + <title/> + + <para>The Util-linux package contains miscellaneous utility programs. Among + them are utilities for handling file systems, consoles, partitions, and + messages.</para> + + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> + + <seglistitem> + <seg>0.2 SBU</seg> + <seg>11.6 MB</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&dependencies;</segtitle> + + <seglistitem> + <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc, + Grep, Make, Ncurses, Sed, and Zlib</seg> + </seglistitem> + </segmentedlist> + + </sect2> + + <sect2 role="installation"> + <title>FHS compliance notes</title> + + <para>The FHS recommends using the <filename + class="directory">/var/lib/hwclock</filename> directory instead of the + usual <filename class="directory">/etc</filename> directory as the + location for the <filename>adjtime</filename> file. To make the + <command>hwclock</command> program FHS-compliant, run the + following:</para> <screen><userinput>sed -i 's@etc/adjtime@var/lib/hwclock/adjtime@g' \ hwclock/hwclock.c mkdir -p /var/lib/hwclock</userinput></screen> -</sect2> + </sect2> -<sect2 role="installation"> -<title>Installation of Util-linux</title> + <sect2 role="installation"> + <title>Installation of Util-linux</title> -<para>Util-linux fails to compile against newer versions of Linux-Libc-Headers. -The following patch properly fixes this issue:</para> + <para>Util-linux fails to compile against newer versions of Linux-Libc-Headers. + The following patch properly fixes this issue:</para> <screen><userinput>patch -Np1 -i ../&util-linux-cramfs-patch;</userinput></screen> -<para>Prepare Util-linux for compilation:</para> + <para>Prepare Util-linux for compilation:</para> <screen><userinput>./configure</userinput></screen> -<para>Compile the package:</para> + <para>Compile the package:</para> <screen><userinput>make HAVE_KILL=yes HAVE_SLN=yes</userinput></screen> -<para>The meaning of the make parameters:</para> + <variablelist> + <title>The meaning of the make parameters:</title> + + <varlistentry> + <term><parameter>HAVE_KILL=yes</parameter></term> + <listitem> + <para>This prevents the <command>kill</command> program (already + installed by Procps) from being built and installed again.</para> + </listitem> + </varlistentry> -<variablelist> -<varlistentry> -<term><parameter>HAVE_KILL=yes</parameter></term> -<listitem><para>This prevents the -<command>kill</command> program (already installed by Procps) from being -built and installed again.</para></listitem> -</varlistentry> + <varlistentry> + <term><parameter>HAVE_SLN=yes</parameter></term> + <listitem> + <para>This prevents the <command>sln</command> program (a + statically linked version of <command>ln</command> already installed + by Glibc) from being built and installed again.</para> + </listitem> + </varlistentry> -<varlistentry> -<term><parameter>HAVE_SLN=yes</parameter></term> -<listitem><para>This prevents the <command>sln</command> program (a -statically linked version of <command>ln</command> already installed -by Glibc) from being built and installed again.</para></listitem> -</varlistentry> -</variablelist> + </variablelist> -<para>This package does not come with a test suite.</para> + <para>This package does not come with a test suite.</para> -<para>Install the package and move the <command>logger</command> binary to -<filename class="directory">/bin</filename> as it is needed by the -LFS-Bootscripts package:</para> + <para>Install the package and move the <command>logger</command> binary to + <filename class="directory">/bin</filename> as it is needed by the + LFS-Bootscripts package:</para> <screen><userinput>make HAVE_KILL=yes HAVE_SLN=yes install mv /usr/bin/logger /bin</userinput></screen> -</sect2> - -<sect2 id="contents-utillinux" role="content"><title>Contents of Util-linux</title> - -<segmentedlist> -<segtitle>Installed programs</segtitle> -<seglistitem><seg>agetty, arch, blockdev, cal, cfdisk, chkdupexe, col, colcrt, -colrm, column, ctrlaltdel, cytune, ddate, dmesg, elvtune, fdformat, fdisk, -fsck.cramfs, fsck.minix, getopt, hexdump, hwclock, ipcrm, ipcs, isosize, line, -logger, look, losetup, mcookie, mkfs, mkfs.bfs, mkfs.cramfs, mkfs.minix, mkswap, -more, mount, namei, pg, pivot_root, ramsize (link to rdev), raw, rdev, readprofile, -rename, renice, rev, rootflags (link to rdev), script, setfdprm, setsid, setterm, -sfdisk, swapdev, swapoff (link to swapon), swapon, tunelp, ul, umount, vidmode (link to rdev), -whereis, and write</seg></seglistitem> -</segmentedlist> - -<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> -<?dbhtml list-presentation="table"?> - -<varlistentry id="agetty"> -<term><command>agetty</command></term> -<listitem> -<para>Opens a tty port, prompts for a login name, -and then invokes the <command>login</command> program</para> -<indexterm zone="ch-system-util-linux agetty"><primary sortas="b-agetty">agetty</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="arch"> -<term><command>arch</command></term> -<listitem> -<para>Reports the machine's architecture</para> -<indexterm zone="ch-system-util-linux arch"><primary sortas="b-arch">arch</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="blockdev"> -<term><command>blockdev</command></term> -<listitem> -<para>Allows users to call block device ioctls from the command line</para> -<indexterm zone="ch-system-util-linux blockdev"><primary sortas="b-blockdev">blockdev</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="cal"> -<term><command>cal</command></term> -<listitem> -<para>Displays a simple calendar</para> -<indexterm zone="ch-system-util-linux cal"><primary sortas="b-cal">cal</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="cfdisk"> -<term><command>cfdisk</command></term> -<listitem> -<para>Manipulates the partition table of the given device</para> -<indexterm zone="ch-system-util-linux cfdisk"><primary sortas="b-cfdisk">cfdisk</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="chkdupexe"> -<term><command>chkdupexe</command></term> -<listitem> -<para>Finds duplicate executables</para> -<indexterm zone="ch-system-util-linux chkdupexe"><primary sortas="b-chkdupexe">chkdupexe</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="col"> -<term><command>col</command></term> -<listitem> -<para>Filters out reverse line feeds</para> -<indexterm zone="ch-system-util-linux col"><primary sortas="b-col">col</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="colcrt"> -<term><command>colcrt</command></term> -<listitem> -<para>Filters <command>nroff</command> output for terminals -that lack some capabilities, such as overstriking and half-lines</para> -<indexterm zone="ch-system-util-linux colcrt"><primary sortas="b-colcrt">colcrt</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="colrm"> -<term><command>colrm</command></term> -<listitem> -<para>Filters out the given columns</para> -<indexterm zone="ch-system-util-linux colrm"><primary sortas="b-colrm">colrm</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="column"> -<term><command>column</command></term> -<listitem> -<para>Formats a given file into multiple columns</para> -<indexterm zone="ch-system-util-linux column"><primary sortas="b-column">column</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="ctrlaltdel"> -<term><command>ctrlaltdel</command></term> -<listitem> -<para>Sets the function of the Ctrl+Alt+Del key combination to a hard or a -soft reset</para> -<indexterm zone="ch-system-util-linux ctrlaltdel"><primary sortas="b-ctrlaltdel">ctrlaltdel</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="cytune"> -<term><command>cytune</command></term> -<listitem> -<para>Tunes the parameters of the serial line drivers for -Cyclades cards</para> -<indexterm zone="ch-system-util-linux cytune"><primary sortas="b-cytune">cytune</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="ddate"> -<term><command>ddate</command></term> -<listitem> -<para>Gives the Discordian date or converts the given Gregorian date -to a Discordian one</para> -<indexterm zone="ch-system-util-linux ddate"><primary sortas="b-ddate">ddate</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="dmesg"> -<term><command>dmesg</command></term> -<listitem> -<para>Dumps the kernel boot messages</para> -<indexterm zone="ch-system-util-linux dmesg"><primary sortas="b-dmesg">dmesg</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="elvtune"> -<term><command>elvtune</command></term> -<listitem> -<para>Tunes the performance and interactivity of a block -device</para> -<indexterm zone="ch-system-util-linux elvtune"><primary sortas="b-elvtune">elvtune</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="fdformat"> -<term><command>fdformat</command></term> -<listitem> -<para>Low-level formats a floppy disk</para> -<indexterm zone="ch-system-util-linux fdformat"><primary sortas="b-fdformat">fdformat</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="fdisk"> -<term><command>fdisk</command></term> -<listitem> -<para>Manipulates the partition table of the given device</para> -<indexterm zone="ch-system-util-linux fdisk"><primary sortas="b-fdisk">fdisk</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="fsck.cramfs"> -<term><command>fsck.cramfs</command></term> -<listitem> -<para>Performs a consistency check on the Cramfs file system on the -given device</para> -<indexterm zone="ch-system-util-linux fsck.cramfs"><primary sortas="b-fsck.cramfs">fsck.cramfs</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="fsck.minix"> -<term><command>fsck.minix</command></term> -<listitem> -<para>Performs a consistency check on the Minix file system on the -given device</para> -<indexterm zone="ch-system-util-linux fsck.minix"><primary sortas="b-fsck.minix">fsck.minix</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="getopt"> -<term><command>getopt</command></term> -<listitem> -<para>Parses options in the given command line</para> -<indexterm zone="ch-system-util-linux getopt"><primary sortas="b-getopt">getopt</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="hexdump"> -<term><command>hexdump</command></term> -<listitem> -<para>Dumps the given file in hexadecimal or in another given format</para> -<indexterm zone="ch-system-util-linux hexdump"><primary sortas="b-hexdump">hexdump</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="hwclock"> -<term><command>hwclock</command></term> -<listitem> -<para>Reads or sets the system's hardware clock, also called -the Real-Time Clock (RTC) or Basic Input-Output System (BIOS) -clock</para> -<indexterm zone="ch-system-util-linux hwclock"><primary sortas="b-hwclock">hwclock</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="ipcrm"> -<term><command>ipcrm</command></term> -<listitem> -<para>Removes the given Inter-Process Communication (IPC) resource</para> -<indexterm zone="ch-system-util-linux ipcrm"><primary sortas="b-ipcrm">ipcrm</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="ipcs"> -<term><command>ipcs</command></term> -<listitem> -<para>Provides IPC status information</para> -<indexterm zone="ch-system-util-linux ipcs"><primary sortas="b-ipcs">ipcs</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="isosize"> -<term><command>isosize</command></term> -<listitem> -<para>Reports the size of an iso9660 file system</para> -<indexterm zone="ch-system-util-linux isosize"><primary sortas="b-isosize">isosize</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="line"> -<term><command>line</command></term> -<listitem> -<para>Copies a single line</para> -<indexterm zone="ch-system-util-linux line"><primary sortas="b-line">line</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="logger"> -<term><command>logger</command></term> -<listitem> -<para>Enters the given message into the system log</para> -<indexterm zone="ch-system-util-linux logger"><primary sortas="b-logger">logger</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="look"> -<term><command>look</command></term> -<listitem> -<para>Displays lines that begin with the given string</para> -<indexterm zone="ch-system-util-linux look"><primary sortas="b-look">look</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="losetup"> -<term><command>losetup</command></term> -<listitem> -<para>Sets up and controls loop devices</para> -<indexterm zone="ch-system-util-linux losetup"><primary sortas="b-losetup">losetup</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="mcookie"> -<term><command>mcookie</command></term> -<listitem> -<para>Generates magic cookies (128-bit random hexadecimal numbers) for -<command>xauth</command></para> -<indexterm zone="ch-system-util-linux mcookie"><primary sortas="b-mcookie">mcookie</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="mkfs"> -<term><command>mkfs</command></term> -<listitem> -<para>Builds a file system on a device (usually a hard disk -partition)</para> -<indexterm zone="ch-system-util-linux mkfs"><primary sortas="b-mkfs">mkfs</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="mkfs.bfs"> -<term><command>mkfs.bfs</command></term> -<listitem> -<para>Creates a Santa Cruz Operations (SCO) bfs file system</para> -<indexterm zone="ch-system-util-linux mkfs.bfs"><primary sortas="b-mkfs.bfs">mkfs.bfs</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="mkfs.cramfs"> -<term><command>mkfs.cramfs</command></term> -<listitem> -<para>Creates a cramfs file system</para> -<indexterm zone="ch-system-util-linux mkfs.cramfs"><primary sortas="b-mkfs.cramfs">mkfs.cramfs</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="mkfs.minix"> -<term><command>mkfs.minix</command></term> -<listitem> -<para>Creates a Minix file system</para> -<indexterm zone="ch-system-util-linux mkfs.minix"><primary sortas="b-mkfs.minix">mkfs.minix</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="mkswap"> -<term><command>mkswap</command></term> -<listitem> -<para>Initializes the given device or file to be used as a swap area</para> -<indexterm zone="ch-system-util-linux mkswap"><primary sortas="b-mkswap">mkswap</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="more"> -<term><command>more</command></term> -<listitem> -<para>A filter for paging through text one screen at a time</para> -<indexterm zone="ch-system-util-linux more"><primary sortas="b-more">more</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="mount"> -<term><command>mount</command></term> -<listitem> -<para>Attaches the file system on the given device to a specified -directory in the file-system tree</para> -<indexterm zone="ch-system-util-linux mount"><primary sortas="b-mount">mount</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="namei"> -<term><command>namei</command></term> -<listitem> -<para>Shows the symbolic links in the given pathnames</para> -<indexterm zone="ch-system-util-linux namei"><primary sortas="b-namei">namei</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="pg"> -<term><command>pg</command></term> -<listitem> -<para>Displays a text file one screen full at a time</para> -<indexterm zone="ch-system-util-linux pg"><primary sortas="b-pg">pg</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="pivot_root"> -<term><command>pivot_root</command></term> -<listitem> -<para>Makes the given file system the new root file system of the -current process</para> -<indexterm zone="ch-system-util-linux pivot_root"><primary sortas="b-pivot_root">pivot_root</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="ramsize"> -<term><command>ramsize</command></term> -<listitem> -<para>Sets the size of the RAM disk in a bootable image</para> -<indexterm zone="ch-system-util-linux ramsize"><primary sortas="b-ramsize">ramsize</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="raw"> -<term><command>raw</command></term> -<listitem> -<para>Used to bind a Linux raw character device to a block -device</para> -<indexterm zone="ch-system-util-linux raw"><primary sortas="b-raw">raw</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="rdev"> -<term><command>rdev</command></term> -<listitem> -<para>Queries and sets the root device, among other things, in a -bootable image</para> -<indexterm zone="ch-system-util-linux rdev"><primary sortas="b-rdev">rdev</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="readprofile"> -<term><command>readprofile</command></term> -<listitem> -<para>Reads kernel profiling information</para> -<indexterm zone="ch-system-util-linux readprofile"><primary sortas="b-readprofile">readprofile</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="rename"> -<term><command>rename</command></term> -<listitem> -<para>Renames the given files, replacing a given string with another</para> -<indexterm zone="ch-system-util-linux rename"><primary sortas="b-rename">rename</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="renice"> -<term><command>renice</command></term> -<listitem> -<para>Alters the priority of running processes</para> -<indexterm zone="ch-system-util-linux renice"><primary sortas="b-renice">renice</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="rev"> -<term><command>rev</command></term> -<listitem> -<para>Reverses the lines of a given file</para> -<indexterm zone="ch-system-util-linux rev"><primary sortas="b-rev">rev</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="rootflags"> -<term><command>rootflags</command></term> -<listitem> -<para>Sets the rootflags in a bootable image</para> -<indexterm zone="ch-system-util-linux rootflags"><primary sortas="b-rootflags">rootflags</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="script"> -<term><command>script</command></term> -<listitem> -<para>Makes a typescript of a terminal session</para> -<indexterm zone="ch-system-util-linux script"><primary sortas="b-script">script</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="setfdprm"> -<term><command>setfdprm</command></term> -<listitem> -<para>Sets user-provided floppy disk parameters</para> -<indexterm zone="ch-system-util-linux setfdprm"><primary sortas="b-setfdprm">setfdprm</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="setsid"> -<term><command>setsid</command></term> -<listitem> -<para>Runs the given program in a new session</para> -<indexterm zone="ch-system-util-linux setsid"><primary sortas="b-setsid">setsid</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="setterm"> -<term><command>setterm</command></term> -<listitem> -<para>Sets terminal attributes</para> -<indexterm zone="ch-system-util-linux setterm"><primary sortas="b-setterm">setterm</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="sfdisk"> -<term><command>sfdisk</command></term> -<listitem> -<para>A disk partition table manipulator</para> -<indexterm zone="ch-system-util-linux sfdisk"><primary sortas="b-sfdisk">sfdisk</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="swapdev"> -<term><command>swapdev</command></term> -<listitem> -<para>Sets the swap device in a bootable image</para> -<indexterm zone="ch-system-util-linux swapdev"><primary sortas="b-swapdev">swapdev</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="swapoff"> -<term><command>swapoff</command></term> -<listitem> -<para>Disables devices and files for paging and swapping</para> -<indexterm zone="ch-system-util-linux swapoff"><primary sortas="b-swapoff">swapoff</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="swapon"> -<term><command>swapon</command></term> -<listitem> -<para>Enables devices and files for paging and swapping and lists the devices -and files currently in use</para> -<indexterm zone="ch-system-util-linux swapon"><primary sortas="b-swapon">swapon</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="tunelp"> -<term><command>tunelp</command></term> -<listitem> -<para>Tunes the parameters of the line printer</para> -<indexterm zone="ch-system-util-linux tunelp"><primary sortas="b-tunelp">tunelp</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="ul"> -<term><command>ul</command></term> -<listitem> -<para>A filter for translating underscores into -escape sequences indicating underlining for the terminal in use</para> -<indexterm zone="ch-system-util-linux ul"><primary sortas="b-ul">ul</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="umount"> -<term><command>umount</command></term> -<listitem> -<para>Disconnects a file system from the system's file tree</para> -<indexterm zone="ch-system-util-linux umount"><primary sortas="b-umount">umount</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="vidmode"> -<term><command>vidmode</command></term> -<listitem> -<para>Sets the video mode in a bootable image</para> -<indexterm zone="ch-system-util-linux vidmode"><primary sortas="b-vidmode">vidmode</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="whereis"> -<term><command>whereis</command></term> -<listitem> -<para>Reports the location of the binary, source, and man page -for the given command</para> -<indexterm zone="ch-system-util-linux whereis"><primary sortas="b-whereis">whereis</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="write"> -<term><command>write</command></term> -<listitem> -<para>Sends a message to the given user -<emphasis>if</emphasis> that user has not disabled receipt of such messages</para> -<indexterm zone="ch-system-util-linux write"><primary sortas="b-write">write</primary></indexterm> -</listitem> -</varlistentry> -</variablelist> - -</sect2> + </sect2> + + <sect2 id="contents-utillinux" role="content"> + <title>Contents of Util-linux</title> + + <segmentedlist> + <segtitle>Installed programs</segtitle> + + <seglistitem> + <seg>agetty, arch, blockdev, cal, cfdisk, chkdupexe, col, colcrt, + colrm, column, ctrlaltdel, cytune, ddate, dmesg, elvtune, fdformat, + fdisk, fsck.cramfs, fsck.minix, getopt, hexdump, hwclock, ipcrm, + ipcs, isosize, line, logger, look, losetup, mcookie, mkfs, mkfs.bfs, + mkfs.cramfs, mkfs.minix, mkswap, more, mount, namei, pg, pivot_root, + ramsize (link to rdev), raw, rdev, readprofile, rename, renice, rev, + rootflags (link to rdev), script, setfdprm, setsid, setterm, sfdisk, + swapdev, swapoff (link to swapon), swapon, tunelp, ul, umount, vidmode + (link to rdev), whereis, and write</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="agetty"> + <term><command>agetty</command></term> + <listitem> + <para>Opens a tty port, prompts for a login name, + and then invokes the <command>login</command> program</para> + <indexterm zone="ch-system-util-linux agetty"> + <primary sortas="b-agetty">agetty</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="arch"> + <term><command>arch</command></term> + <listitem> + <para>Reports the machine's architecture</para> + <indexterm zone="ch-system-util-linux arch"> + <primary sortas="b-arch">arch</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="blockdev"> + <term><command>blockdev</command></term> + <listitem> + <para>Allows users to call block device ioctls from the command + line</para> + <indexterm zone="ch-system-util-linux blockdev"> + <primary sortas="b-blockdev">blockdev</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="cal"> + <term><command>cal</command></term> + <listitem> + <para>Displays a simple calendar</para> + <indexterm zone="ch-system-util-linux cal"> + <primary sortas="b-cal">cal</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="cfdisk"> + <term><command>cfdisk</command></term> + <listitem> + <para>Manipulates the partition table of the given device</para> + <indexterm zone="ch-system-util-linux cfdisk"> + <primary sortas="b-cfdisk">cfdisk</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="chkdupexe"> + <term><command>chkdupexe</command></term> + <listitem> + <para>Finds duplicate executables</para> + <indexterm zone="ch-system-util-linux chkdupexe"> + <primary sortas="b-chkdupexe">chkdupexe</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="col"> + <term><command>col</command></term> + <listitem> + <para>Filters out reverse line feeds</para> + <indexterm zone="ch-system-util-linux col"> + <primary sortas="b-col">col</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="colcrt"> + <term><command>colcrt</command></term> + <listitem> + <para>Filters <command>nroff</command> output for terminals + that lack some capabilities, such as overstriking and half-lines</para> + <indexterm zone="ch-system-util-linux colcrt"> + <primary sortas="b-colcrt">colcrt</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="colrm"> + <term><command>colrm</command></term> + <listitem> + <para>Filters out the given columns</para> + <indexterm zone="ch-system-util-linux colrm"> + <primary sortas="b-colrm">colrm</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="column"> + <term><command>column</command></term> + <listitem> + <para>Formats a given file into multiple columns</para> + <indexterm zone="ch-system-util-linux column"> + <primary sortas="b-column">column</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="ctrlaltdel"> + <term><command>ctrlaltdel</command></term> + <listitem> + <para>Sets the function of the Ctrl+Alt+Del key combination to a + hard or a soft reset</para> + <indexterm zone="ch-system-util-linux ctrlaltdel"> + <primary sortas="b-ctrlaltdel">ctrlaltdel</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="cytune"> + <term><command>cytune</command></term> + <listitem> + <para>Tunes the parameters of the serial line drivers for + Cyclades cards</para> + <indexterm zone="ch-system-util-linux cytune"> + <primary sortas="b-cytune">cytune</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="ddate"> + <term><command>ddate</command></term> + <listitem> + <para>Gives the Discordian date or converts the given Gregorian date + to a Discordian one</para> + <indexterm zone="ch-system-util-linux ddate"> + <primary sortas="b-ddate">ddate</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="dmesg"> + <term><command>dmesg</command></term> + <listitem> + <para>Dumps the kernel boot messages</para> + <indexterm zone="ch-system-util-linux dmesg"> + <primary sortas="b-dmesg">dmesg</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="elvtune"> + <term><command>elvtune</command></term> + <listitem> + <para>Tunes the performance and interactivity of a block + device</para> + <indexterm zone="ch-system-util-linux elvtune"> + <primary sortas="b-elvtune">elvtune</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="fdformat"> + <term><command>fdformat</command></term> + <listitem> + <para>Low-level formats a floppy disk</para> + <indexterm zone="ch-system-util-linux fdformat"> + <primary sortas="b-fdformat">fdformat</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="fdisk"> + <term><command>fdisk</command></term> + <listitem> + <para>Manipulates the partition table of the given device</para> + <indexterm zone="ch-system-util-linux fdisk"> + <primary sortas="b-fdisk">fdisk</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="fsck.cramfs"> + <term><command>fsck.cramfs</command></term> + <listitem> + <para>Performs a consistency check on the Cramfs file system on the + given device</para> + <indexterm zone="ch-system-util-linux fsck.cramfs"> + <primary sortas="b-fsck.cramfs">fsck.cramfs</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="fsck.minix"> + <term><command>fsck.minix</command></term> + <listitem> + <para>Performs a consistency check on the Minix file system on the + given device</para> + <indexterm zone="ch-system-util-linux fsck.minix"> + <primary sortas="b-fsck.minix">fsck.minix</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="getopt"> + <term><command>getopt</command></term> + <listitem> + <para>Parses options in the given command line</para> + <indexterm zone="ch-system-util-linux getopt"> + <primary sortas="b-getopt">getopt</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="hexdump"> + <term><command>hexdump</command></term> + <listitem> + <para>Dumps the given file in hexadecimal or in another given + format</para> + <indexterm zone="ch-system-util-linux hexdump"> + <primary sortas="b-hexdump">hexdump</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="hwclock"> + <term><command>hwclock</command></term> + <listitem> + <para>Reads or sets the system's hardware clock, also called + the Real-Time Clock (RTC) or Basic Input-Output System (BIOS) + clock</para> + <indexterm zone="ch-system-util-linux hwclock"> + <primary sortas="b-hwclock">hwclock</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="ipcrm"> + <term><command>ipcrm</command></term> + <listitem> + <para>Removes the given Inter-Process Communication (IPC) resource</para> + <indexterm zone="ch-system-util-linux ipcrm"> + <primary sortas="b-ipcrm">ipcrm</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="ipcs"> + <term><command>ipcs</command></term> + <listitem> + <para>Provides IPC status information</para> + <indexterm zone="ch-system-util-linux ipcs"> + <primary sortas="b-ipcs">ipcs</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="isosize"> + <term><command>isosize</command></term> + <listitem> + <para>Reports the size of an iso9660 file system</para> + <indexterm zone="ch-system-util-linux isosize"> + <primary sortas="b-isosize">isosize</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="line"> + <term><command>line</command></term> + <listitem> + <para>Copies a single line</para> + <indexterm zone="ch-system-util-linux line"> + <primary sortas="b-line">line</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="logger"> + <term><command>logger</command></term> + <listitem> + <para>Enters the given message into the system log</para> + <indexterm zone="ch-system-util-linux logger"> + <primary sortas="b-logger">logger</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="look"> + <term><command>look</command></term> + <listitem> + <para>Displays lines that begin with the given string</para> + <indexterm zone="ch-system-util-linux look"> + <primary sortas="b-look">look</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="losetup"> + <term><command>losetup</command></term> + <listitem> + <para>Sets up and controls loop devices</para> + <indexterm zone="ch-system-util-linux losetup"> + <primary sortas="b-losetup">losetup</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="mcookie"> + <term><command>mcookie</command></term> + <listitem> + <para>Generates magic cookies (128-bit random hexadecimal numbers) for + <command>xauth</command></para> + <indexterm zone="ch-system-util-linux mcookie"> + <primary sortas="b-mcookie">mcookie</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="mkfs"> + <term><command>mkfs</command></term> + <listitem> + <para>Builds a file system on a device (usually a hard disk + partition)</para> + <indexterm zone="ch-system-util-linux mkfs"> + <primary sortas="b-mkfs">mkfs</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="mkfs.bfs"> + <term><command>mkfs.bfs</command></term> + <listitem> + <para>Creates a Santa Cruz Operations (SCO) bfs file system</para> + <indexterm zone="ch-system-util-linux mkfs.bfs"> + <primary sortas="b-mkfs.bfs">mkfs.bfs</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="mkfs.cramfs"> + <term><command>mkfs.cramfs</command></term> + <listitem> + <para>Creates a cramfs file system</para> + <indexterm zone="ch-system-util-linux mkfs.cramfs"> + <primary sortas="b-mkfs.cramfs">mkfs.cramfs</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="mkfs.minix"> + <term><command>mkfs.minix</command></term> + <listitem> + <para>Creates a Minix file system</para> + <indexterm zone="ch-system-util-linux mkfs.minix"> + <primary sortas="b-mkfs.minix">mkfs.minix</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="mkswap"> + <term><command>mkswap</command></term> + <listitem> + <para>Initializes the given device or file to be used as a swap + area</para> + <indexterm zone="ch-system-util-linux mkswap"> + <primary sortas="b-mkswap">mkswap</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="more"> + <term><command>more</command></term> + <listitem> + <para>A filter for paging through text one screen at a time</para> + <indexterm zone="ch-system-util-linux more"> + <primary sortas="b-more">more</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="mount"> + <term><command>mount</command></term> + <listitem> + <para>Attaches the file system on the given device to a specified + directory in the file-system tree</para> + <indexterm zone="ch-system-util-linux mount"> + <primary sortas="b-mount">mount</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="namei"> + <term><command>namei</command></term> + <listitem> + <para>Shows the symbolic links in the given pathnames</para> + <indexterm zone="ch-system-util-linux namei"> + <primary sortas="b-namei">namei</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pg"> + <term><command>pg</command></term> + <listitem> + <para>Displays a text file one screen full at a time</para> + <indexterm zone="ch-system-util-linux pg"> + <primary sortas="b-pg">pg</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pivot_root"> + <term><command>pivot_root</command></term> + <listitem> + <para>Makes the given file system the new root file system of the + current process</para> + <indexterm zone="ch-system-util-linux pivot_root"> + <primary sortas="b-pivot_root">pivot_root</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="ramsize"> + <term><command>ramsize</command></term> + <listitem> + <para>Sets the size of the RAM disk in a bootable image</para> + <indexterm zone="ch-system-util-linux ramsize"> + <primary sortas="b-ramsize">ramsize</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="raw"> + <term><command>raw</command></term> + <listitem> + <para>Used to bind a Linux raw character device to a block + device</para> + <indexterm zone="ch-system-util-linux raw"> + <primary sortas="b-raw">raw</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="rdev"> + <term><command>rdev</command></term> + <listitem> + <para>Queries and sets the root device, among other things, in a + bootable image</para> + <indexterm zone="ch-system-util-linux rdev"> + <primary sortas="b-rdev">rdev</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="readprofile"> + <term><command>readprofile</command></term> + <listitem> + <para>Reads kernel profiling information</para> + <indexterm zone="ch-system-util-linux readprofile"> + <primary sortas="b-readprofile">readprofile</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="rename"> + <term><command>rename</command></term> + <listitem> + <para>Renames the given files, replacing a given string with + another</para> + <indexterm zone="ch-system-util-linux rename"> + <primary sortas="b-rename">rename</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="renice"> + <term><command>renice</command></term> + <listitem> + <para>Alters the priority of running processes</para> + <indexterm zone="ch-system-util-linux renice"> + <primary sortas="b-renice">renice</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="rev"> + <term><command>rev</command></term> + <listitem> + <para>Reverses the lines of a given file</para> + <indexterm zone="ch-system-util-linux rev"> + <primary sortas="b-rev">rev</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="rootflags"> + <term><command>rootflags</command></term> + <listitem> + <para>Sets the rootflags in a bootable image</para> + <indexterm zone="ch-system-util-linux rootflags"> + <primary sortas="b-rootflags">rootflags</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="script"> + <term><command>script</command></term> + <listitem> + <para>Makes a typescript of a terminal session</para> + <indexterm zone="ch-system-util-linux script"> + <primary sortas="b-script">script</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="setfdprm"> + <term><command>setfdprm</command></term> + <listitem> + <para>Sets user-provided floppy disk parameters</para> + <indexterm zone="ch-system-util-linux setfdprm"> + <primary sortas="b-setfdprm">setfdprm</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="setsid"> + <term><command>setsid</command></term> + <listitem> + <para>Runs the given program in a new session</para> + <indexterm zone="ch-system-util-linux setsid"> + <primary sortas="b-setsid">setsid</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="setterm"> + <term><command>setterm</command></term> + <listitem> + <para>Sets terminal attributes</para> + <indexterm zone="ch-system-util-linux setterm"> + <primary sortas="b-setterm">setterm</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="sfdisk"> + <term><command>sfdisk</command></term> + <listitem> + <para>A disk partition table manipulator</para> + <indexterm zone="ch-system-util-linux sfdisk"> + <primary sortas="b-sfdisk">sfdisk</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="swapdev"> + <term><command>swapdev</command></term> + <listitem> + <para>Sets the swap device in a bootable image</para> + <indexterm zone="ch-system-util-linux swapdev"> + <primary sortas="b-swapdev">swapdev</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="swapoff"> + <term><command>swapoff</command></term> + <listitem> + <para>Disables devices and files for paging and swapping</para> + <indexterm zone="ch-system-util-linux swapoff"> + <primary sortas="b-swapoff">swapoff</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="swapon"> + <term><command>swapon</command></term> + <listitem> + <para>Enables devices and files for paging and swapping and + lists the devices and files currently in use</para> + <indexterm zone="ch-system-util-linux swapon"> + <primary sortas="b-swapon">swapon</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="tunelp"> + <term><command>tunelp</command></term> + <listitem> + <para>Tunes the parameters of the line printer</para> + <indexterm zone="ch-system-util-linux tunelp"> + <primary sortas="b-tunelp">tunelp</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="ul"> + <term><command>ul</command></term> + <listitem> + <para>A filter for translating underscores into escape sequences + indicating underlining for the terminal in use</para> + <indexterm zone="ch-system-util-linux ul"> + <primary sortas="b-ul">ul</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="umount"> + <term><command>umount</command></term> + <listitem> + <para>Disconnects a file system from the system's file tree</para> + <indexterm zone="ch-system-util-linux umount"> + <primary sortas="b-umount">umount</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="vidmode"> + <term><command>vidmode</command></term> + <listitem> + <para>Sets the video mode in a bootable image</para> + <indexterm zone="ch-system-util-linux vidmode"> + <primary sortas="b-vidmode">vidmode</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="whereis"> + <term><command>whereis</command></term> + <listitem> + <para>Reports the location of the binary, source, and man page + for the given command</para> + <indexterm zone="ch-system-util-linux whereis"> + <primary sortas="b-whereis">whereis</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="write"> + <term><command>write</command></term> + <listitem> + <para>Sends a message to the given user <emphasis>if</emphasis> that + user has not disabled receipt of such messages</para> + <indexterm zone="ch-system-util-linux write"> + <primary sortas="b-write">write</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> </sect1> - diff --git a/chapter06/vim.xml b/chapter06/vim.xml index d58dbb6b7..08e2d3661 100644 --- a/chapter06/vim.xml +++ b/chapter06/vim.xml @@ -1,128 +1,151 @@ <?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-vim" role="wrap"> -<title>Vim-&vim-version;</title> -<?dbhtml filename="vim.html"?> - -<indexterm zone="ch-system-vim"><primary sortas="a-Vim">Vim</primary></indexterm> - -<sect2 role="package"><title/> -<para>The Vim package contains a powerful text editor.</para> - -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.4 SBU</seg><seg>38.0 MB</seg></seglistitem> -</segmentedlist> - -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, -GCC, Glibc, Grep, Make, Ncurses, and Sed</seg></seglistitem> -</segmentedlist> - -<tip> -<title>Alternatives to Vim</title> -<para>If you prefer another editor—such as Emacs, Joe, or -Nano—please refer to <ulink url="&blfs-root;view/svn/postlfs/editors.html"/> -for suggested installation instructions.</para> -</tip> -</sect2> - -<sect2 role="installation"> -<title>Installation of Vim</title> - -<para>First, unpack both -<filename>vim-&vim-version;.tar.bz2</filename> and (optionally) -<filename>vim-&vim-version;-lang.tar.gz</filename> archives into the -same directory. Then, change the default location of the -<filename>vimrc</filename> configuration file to <filename -class="directory">/etc</filename>:</para> + <?dbhtml filename="vim.html"?> + + <title>Vim-&vim-version;</title> + + <indexterm zone="ch-system-vim"> + <primary sortas="a-Vim">Vim</primary> + </indexterm> + + <sect2 role="package"> + <title/> + + <para>The Vim package contains a powerful text editor.</para> + + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> + + <seglistitem> + <seg>0.4 SBU</seg> + <seg>38.0 MB</seg> + </seglistitem> + </segmentedlist> + + <segmentedlist> + <segtitle>&dependencies;</segtitle> + + <seglistitem> + <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep, Make, + Ncurses, and Sed</seg> + </seglistitem> + </segmentedlist> + + <tip> + <title>Alternatives to Vim</title> + + <para>If you prefer another editor—such as Emacs, Joe, or + Nano—please refer to <ulink + url="&blfs-root;view/svn/postlfs/editors.html"/> for suggested + installation instructions.</para> + </tip> + + </sect2> + + <sect2 role="installation"> + <title>Installation of Vim</title> + + <para>First, unpack both + <filename>vim-&vim-version;.tar.bz2</filename> and (optionally) + <filename>vim-&vim-version;-lang.tar.gz</filename> archives into the + same directory. Then, change the default location of the + <filename>vimrc</filename> configuration file to <filename + class="directory">/etc</filename>:</para> <screen><userinput>echo '#define SYS_VIMRC_FILE "/etc/vimrc"' >> src/feature.h</userinput></screen> -<para>Now prepare Vim for compilation:</para> + <para>Now prepare Vim for compilation:</para> <screen><userinput>./configure --prefix=/usr --enable-multibyte</userinput></screen> -<para>The meaning of the configure options:</para> + <variablelist> + <title>The meaning of the configure options:</title> + + <varlistentry> + <term><parameter>--enable-multibyte</parameter></term> + <listitem> + <para>This switch enables support for editing files in multibyte + character encodings. This is needed if using a locale with a + multibyte character set. This switch is also helpful to be able + to edit text files initially created in Linux distributions like + Fedora Core that use UTF-8 as a default character set.</para> + </listitem> + </varlistentry> -<variablelist> -<varlistentry> -<term><parameter>--enable-multibyte</parameter></term> -<listitem><para>This switch enables support for -editing files in multibyte character encodings. This is needed if using a -locale with a multibyte character set. This switch is also helpful to be able to -edit text files initially created in Linux distributions like Fedora Core that -use UTF-8 as a default character set.</para> -</listitem> -</varlistentry> -</variablelist> + </variablelist> -<para>Compile the package:</para> + <para>Compile the package:</para> <screen><userinput>make</userinput></screen> -<para>To test the results, issue: <userinput>make test</userinput>. However, -this test suite outputs a lot of binary data to the screen, which can cause -issues with the settings of the current terminal. This can be resolved by -redirecting the output to a log file.</para> + <para>To test the results, issue: <userinput>make test</userinput>. However, + this test suite outputs a lot of binary data to the screen, which can cause + issues with the settings of the current terminal. This can be resolved by + redirecting the output to a log file.</para> -<para>Install the package:</para> + <para>Install the package:</para> <screen><userinput>make install</userinput></screen> -<para>In UTF-8 locales, the <command>vimtutor</command> program -tries to convert the tutorials from ISO-8859-1 to UTF-8. Since -some tutorials are not in ISO-8859-1, the text in them is thus made unreadable. -If you unpacked the <filename>vim-&vim-version;-lang.tar.gz</filename> -archive and are going to use a UTF-8 based locale, remove non-ISO-8859-1 -tutorials. An English tutorial will be used instead.</para> -<!-- Removal is used instead of conversion in order for the user to be able to -painlessly revert his UTF-8 locale choice. --> + <para>In UTF-8 locales, the <command>vimtutor</command> program tries to + convert the tutorials from ISO-8859-1 to UTF-8. Since some tutorials are + not in ISO-8859-1, the text in them is thus made unreadable. If you + unpacked the <filename>vim-&vim-version;-lang.tar.gz</filename> archive + and are going to use a UTF-8 based locale, remove non-ISO-8859-1 tutorials. + An English tutorial will be used instead.</para> + <!-- Removal is used instead of conversion in order for the user to be able to + painlessly revert his UTF-8 locale choice. --> <screen><userinput>rm -f /usr/share/vim/vim64/tutor/tutor.{gr,pl,ru,sk} rm -f /usr/share/vim/vim64/tutor/tutor.??.*</userinput></screen> -<para>Many users are used to using <command>vi</command> instead of -<command>vim</command>. To allow execution of <command>vim</command> -when users habitually enter <command>vi</command>, create a -symlink:</para> + <para>Many users are used to using <command>vi</command> instead of + <command>vim</command>. To allow execution of <command>vim</command> + when users habitually enter <command>vi</command>, create a + symlink:</para> <screen><userinput>ln -sv vim /usr/bin/vi</userinput></screen> -<para>By default, Vim's documentation is installed in -<filename class="directory">/usr/share/vim</filename>. The following symlink -allows the documentation to be accessed via -<filename class="directory">/usr/share/doc/vim-&vim-version;</filename>, making -it consistent with the location of documentation for other packages:</para> + <para>By default, Vim's documentation is installed in <filename + class="directory">/usr/share/vim</filename>. The following symlink + allows the documentation to be accessed via <filename + class="directory">/usr/share/doc/vim-&vim-version;</filename>, making + it consistent with the location of documentation for other packages:</para> <screen><userinput>ln -sv ../vim/vim64/doc /usr/share/doc/vim-&vim-version;</userinput></screen> -<para>If an X Window System is going to be installed on the LFS -system, it may be necessary to recompile Vim after installing X. Vim -comes with a GUI version of the editor that requires X and some -additional libraries to be installed. For more information on this -process, refer to the Vim documentation and the Vim installation page -in the BLFS book at <ulink -url="&blfs-root;view/svn/postlfs/editors.html#postlfs-editors-vim"/>.</para> + <para>If an X Window System is going to be installed on the LFS + system, it may be necessary to recompile Vim after installing X. Vim + comes with a GUI version of the editor that requires X and some + additional libraries to be installed. For more information on this + process, refer to the Vim documentation and the Vim installation page + in the BLFS book at <ulink + url="&blfs-root;view/svn/postlfs/editors.html#postlfs-editors-vim"/>.</para> -</sect2> + </sect2> -<sect2 id="conf-vim" role="configuration"><title>Configuring Vim</title> -<indexterm zone="conf-vim"><primary sortas="e-/etc/vimrc">/etc/vimrc</primary></indexterm> + <sect2 id="conf-vim" role="configuration"> + <title>Configuring Vim</title> -<para>By default, <command>vim</command> runs in vi-incompatible mode. This may -be new to users who have used other editors in the past. The -<quote>nocompatible</quote> setting is included below to highlight the fact that -a new behavior is being used. It also reminds those who would change to -<quote>compatible</quote> mode that it should be the first setting in the -configuration file. This is necessary because it changes other settings, and -overrides must come after this setting. Create a default <command>vim</command> -configuration file by running the following:</para> + <indexterm zone="conf-vim"> + <primary sortas="e-/etc/vimrc">/etc/vimrc</primary> + </indexterm> + + <para>By default, <command>vim</command> runs in vi-incompatible mode. + This may be new to users who have used other editors in the past. The + <quote>nocompatible</quote> setting is included below to highlight the + fact that a new behavior is being used. It also reminds those who would + change to <quote>compatible</quote> mode that it should be the first + setting in the configuration file. This is necessary because it changes + other settings, and overrides must come after this setting. Create a default + <command>vim</command> configuration file by running the following:</para> <screen><userinput>cat > /etc/vimrc << "EOF" <literal>" Begin /etc/vimrc @@ -137,217 +160,272 @@ endif " End /etc/vimrc</literal> EOF</userinput></screen> -<para>The <parameter>set nocompatible</parameter> makes -<command>vim</command> behave in a more useful way (the default) than -the vi-compatible manner. Remove the <quote>no</quote> to keep the -old <command>vi</command> behavior. The <parameter>set -backspace=2</parameter> allows backspacing over line breaks, -autoindents, and the start of insert. The <parameter>syntax -on</parameter> enables vim's syntax highlighting. Finally, the -<emphasis>if</emphasis> statement with the <parameter>set -background=dark</parameter> corrects <command>vim</command>'s guess -about the background color of some terminal emulators. This gives the -highlighting a better color scheme for use on the black background of -these programs.</para> - -<para>Documentation for other available options can be obtained by -running the following command:</para> + <para>The <parameter>set nocompatible</parameter> makes + <command>vim</command> behave in a more useful way (the default) than + the vi-compatible manner. Remove the <quote>no</quote> to keep the + old <command>vi</command> behavior. The <parameter>set + backspace=2</parameter> allows backspacing over line breaks, + autoindents, and the start of insert. The <parameter>syntax + on</parameter> enables vim's syntax highlighting. Finally, the + <emphasis>if</emphasis> statement with the <parameter>set + background=dark</parameter> corrects <command>vim</command>'s guess + about the background color of some terminal emulators. This gives the + highlighting a better color scheme for use on the black background of + these programs.</para> + + <para>Documentation for other available options can be obtained by + running the following command:</para> <screen role="nodump"><userinput>vim -c ':options'</userinput></screen> -</sect2> - -<sect2 id="contents-vim" role="content"><title>Contents of Vim</title> - -<segmentedlist> -<segtitle>Installed programs</segtitle> -<seglistitem><seg>efm_filter.pl, efm_perl.pl, ex (link to vim), less.sh, mve.awk, -pltags.pl, ref, rview (link to vim), rvim (link to vim), shtags.pl, tcltags, vi (link to vim), -view (link to vim), vim, vim132, vim2html.pl, vimdiff (link to vim), vimm, vimspell.sh, -vimtutor, and xxd</seg></seglistitem> -</segmentedlist> - -<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> -<?dbhtml list-presentation="table"?> - -<varlistentry id="efm_filter.pl"> -<term><command>efm_filter.pl</command></term> -<listitem> -<para>A filter for creating an error file that can be read by <command>vim</command></para> -<indexterm zone="ch-system-vim efm_filter.pl"><primary sortas="b-efm_filter.pl">efm_filter.pl</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="efm_perl.pl"> -<term><command>efm_perl.pl</command></term> -<listitem> -<para>Reformats the error messages of the -Perl interpreter for use with the <quote>quickfix</quote> mode of <command>vim</command></para> -<indexterm zone="ch-system-vim efm_perl.pl"><primary sortas="b-efm_perl.pl">efm_perl.pl</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="ex"> -<term><command>ex</command></term> -<listitem> -<para>Starts <command>vim</command> in ex mode</para> -<indexterm zone="ch-system-vim ex"><primary sortas="b-ex">ex</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="less.sh"> -<term><command>less.sh</command></term> -<listitem> -<para>A script that starts <command>vim</command> with less.vim</para> -<indexterm zone="ch-system-vim less.sh"><primary sortas="b-less.sh">less.sh</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="mve.awk"> -<term><command>mve.awk</command></term> -<listitem> -<para>Processes <command>vim</command> errors</para> -<indexterm zone="ch-system-vim mve.awk"><primary sortas="b-mve.awk">mve.awk</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="pltags.pl"> -<term><command>pltags.pl</command></term> -<listitem> -<para>Creates a tags file for Perl code for use by <command>vim</command></para> -<indexterm zone="ch-system-vim pltags.pl"><primary sortas="b-pltags.pl">pltags.pl</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="ref"> -<term><command>ref</command></term> -<listitem> -<para>Checks the spelling of arguments</para> -<indexterm zone="ch-system-vim ref"><primary sortas="b-ref">ref</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="rview"> -<term><command>rview</command></term> -<listitem> -<para>Is a restricted version of <command>view</command>; no shell -commands can be started and <command>view</command> cannot be suspended</para> -<indexterm zone="ch-system-vim rview"><primary sortas="b-rview">rview</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="rvim"> -<term><command>rvim</command></term> -<listitem> -<para>Is a restricted version of <command>vim</command>; no shell -commands can be started and <command>vim</command> cannot be suspended</para> -<indexterm zone="ch-system-vim rvim"><primary sortas="b-rvim">rvim</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="shtags.pl"> -<term><command>shtags.pl</command></term> -<listitem> -<para>Generates a tags file for Perl scripts</para> -<indexterm zone="ch-system-vim shtags.pl"><primary sortas="b-shtags.pl">shtags.pl</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="tcltags"> -<term><command>tcltags</command></term> -<listitem> -<para>Generates a tags file for TCL code</para> -<indexterm zone="ch-system-vim tcltags"><primary sortas="b-tcltags">tcltags</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="view"> -<term><command>view</command></term> -<listitem> -<para>Starts <command>vim</command> in read-only mode</para> -<indexterm zone="ch-system-vim view"><primary sortas="b-view">view</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="vi"> -<term><command>vi</command></term> -<listitem> -<para>Is the editor</para> -<indexterm zone="ch-system-vim vi"><primary sortas="b-vi">vi</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="vim"> -<term><command>vim</command></term> -<listitem> -<para>Is the editor</para> -<indexterm zone="ch-system-vim vim"><primary sortas="b-vim">vim</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="vim132"> -<term><command>vim132</command></term> -<listitem> -<para>Starts <command>vim</command> with the terminal in 132-column mode</para> -<indexterm zone="ch-system-vim vim132"><primary sortas="b-vim132">vim132</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="vim2html.pl"> -<term><command>vim2html.pl</command></term> -<listitem> -<para>Converts Vim documentation to HypterText Markup Language (HTML)</para> -<indexterm zone="ch-system-vim vim2html.pl"><primary sortas="b-vim2html.pl">vim2html.pl</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="vimdiff"> -<term><command>vimdiff</command></term> -<listitem> -<para>Edits two or three versions of a file with <command>vim</command> and show differences</para> -<indexterm zone="ch-system-vim vimdiff"><primary sortas="b-vimdiff">vimdiff</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="vimm"> -<term><command>vimm</command></term> -<listitem> -<para>Enables the DEC locator input model on a remote terminal</para> -<indexterm zone="ch-system-vim vimm"><primary sortas="b-vimm">vimm</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="vimspell.sh"> -<term><command>vimspell.sh</command></term> -<listitem> -<para>Spell checks a file and generates the syntax statements necessary to -highlight in <command>vim</command>. This script requires the old Unix -<command>spell</command> command, which is provided neither in LFS nor in -BLFS</para> -<indexterm zone="ch-system-vim vimspell.sh"><primary sortas="b-vimspell.sh">vimspell.sh</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="vimtutor"> -<term><command>vimtutor</command></term> -<listitem> -<para>Teaches the basic keys and commands of <command>vim</command></para> -<indexterm zone="ch-system-vim vimtutor"><primary sortas="b-vimtutor">vimtutor</primary></indexterm> -</listitem> -</varlistentry> - -<varlistentry id="xxd"> -<term><command>xxd</command></term> -<listitem> -<para>Creates a hex dump of the given file; it can -also do the reverse, so it can be used for binary patching</para> -<indexterm zone="ch-system-vim xxd"><primary sortas="b-xxd">xxd</primary></indexterm> -</listitem> -</varlistentry> -</variablelist> - -</sect2> + </sect2> + + <sect2 id="contents-vim" role="content"> + <title>Contents of Vim</title> + + <segmentedlist> + <segtitle>Installed programs</segtitle> + + <seglistitem> + <seg>efm_filter.pl, efm_perl.pl, ex (link to vim), less.sh, mve.awk, + pltags.pl, ref, rview (link to vim), rvim (link to vim), shtags.pl, + tcltags, vi (link to vim), view (link to vim), vim, vim132, vim2html.pl, + vimdiff (link to vim), vimm, vimspell.sh, vimtutor, and xxd</seg> + </seglistitem> + </segmentedlist> + + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> + + <varlistentry id="efm_filter.pl"> + <term><command>efm_filter.pl</command></term> + <listitem> + <para>A filter for creating an error file that can be read + by <command>vim</command></para> + <indexterm zone="ch-system-vim efm_filter.pl"> + <primary sortas="b-efm_filter.pl">efm_filter.pl</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="efm_perl.pl"> + <term><command>efm_perl.pl</command></term> + <listitem> + <para>Reformats the error messages of the Perl interpreter for use + with the <quote>quickfix</quote> mode of <command>vim</command></para> + <indexterm zone="ch-system-vim efm_perl.pl"> + <primary sortas="b-efm_perl.pl">efm_perl.pl</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="ex"> + <term><command>ex</command></term> + <listitem> + <para>Starts <command>vim</command> in ex mode</para> + <indexterm zone="ch-system-vim ex"> + <primary sortas="b-ex">ex</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="less.sh"> + <term><command>less.sh</command></term> + <listitem> + <para>A script that starts <command>vim</command> with less.vim</para> + <indexterm zone="ch-system-vim less.sh"> + <primary sortas="b-less.sh">less.sh</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="mve.awk"> + <term><command>mve.awk</command></term> + <listitem> + <para>Processes <command>vim</command> errors</para> + <indexterm zone="ch-system-vim mve.awk"> + <primary sortas="b-mve.awk">mve.awk</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="pltags.pl"> + <term><command>pltags.pl</command></term> + <listitem> + <para>Creates a tags file for Perl code for use by + <command>vim</command></para> + <indexterm zone="ch-system-vim pltags.pl"> + <primary sortas="b-pltags.pl">pltags.pl</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="ref"> + <term><command>ref</command></term> + <listitem> + <para>Checks the spelling of arguments</para> + <indexterm zone="ch-system-vim ref"> + <primary sortas="b-ref">ref</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="rview"> + <term><command>rview</command></term> + <listitem> + <para>Is a restricted version of <command>view</command>; no shell + commands can be started and <command>view</command> cannot be + suspended</para> + <indexterm zone="ch-system-vim rview"> + <primary sortas="b-rview">rview</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="rvim"> + <term><command>rvim</command></term> + <listitem> + <para>Is a restricted version of <command>vim</command>; no shell + commands can be started and <command>vim</command> cannot be + suspended</para> + <indexterm zone="ch-system-vim rvim"> + <primary sortas="b-rvim">rvim</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="shtags.pl"> + <term><command>shtags.pl</command></term> + <listitem> + <para>Generates a tags file for Perl scripts</para> + <indexterm zone="ch-system-vim shtags.pl"> + <primary sortas="b-shtags.pl">shtags.pl</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="tcltags"> + <term><command>tcltags</command></term> + <listitem> + <para>Generates a tags file for TCL code</para> + <indexterm zone="ch-system-vim tcltags"> + <primary sortas="b-tcltags">tcltags</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="view"> + <term><command>view</command></term> + <listitem> + <para>Starts <command>vim</command> in read-only mode</para> + <indexterm zone="ch-system-vim view"> + <primary sortas="b-view">view</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="vi"> + <term><command>vi</command></term> + <listitem> + <para>Link to <command>vim</command></para> + <indexterm zone="ch-system-vim vi"> + <primary sortas="b-vi">vi</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="vim"> + <term><command>vim</command></term> + <listitem> + <para>Is the editor</para> + <indexterm zone="ch-system-vim vim"> + <primary sortas="b-vim">vim</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="vim132"> + <term><command>vim132</command></term> + <listitem> + <para>Starts <command>vim</command> with the terminal in 132-column + mode</para> + <indexterm zone="ch-system-vim vim132"> + <primary sortas="b-vim132">vim132</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="vim2html.pl"> + <term><command>vim2html.pl</command></term> + <listitem> + <para>Converts Vim documentation to HypterText Markup Language + (HTML)</para> + <indexterm zone="ch-system-vim vim2html.pl"> + <primary sortas="b-vim2html.pl">vim2html.pl</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="vimdiff"> + <term><command>vimdiff</command></term> + <listitem> + <para>Edits two or three versions of a file with <command>vim</command> + and show differences</para> + <indexterm zone="ch-system-vim vimdiff"> + <primary sortas="b-vimdiff">vimdiff</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="vimm"> + <term><command>vimm</command></term> + <listitem> + <para>Enables the DEC locator input model on a remote terminal</para> + <indexterm zone="ch-system-vim vimm"> + <primary sortas="b-vimm">vimm</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="vimspell.sh"> + <term><command>vimspell.sh</command></term> + <listitem> + <para>Spell checks a file and generates the syntax statements + necessary to highlight in <command>vim</command>. This script + requires the old Unix <command>spell</command> command, which + is provided neither in LFS nor in BLFS</para> + <indexterm zone="ch-system-vim vimspell.sh"> + <primary sortas="b-vimspell.sh">vimspell.sh</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="vimtutor"> + <term><command>vimtutor</command></term> + <listitem> + <para>Teaches the basic keys and commands of + <command>vim</command></para> + <indexterm zone="ch-system-vim vimtutor"> + <primary sortas="b-vimtutor">vimtutor</primary> + </indexterm> + </listitem> + </varlistentry> + + <varlistentry id="xxd"> + <term><command>xxd</command></term> + <listitem> + <para>Creates a hex dump of the given file; it can + also do the reverse, so it can be used for binary patching</para> + <indexterm zone="ch-system-vim xxd"> + <primary sortas="b-xxd">xxd</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> </sect1> - diff --git a/chapter06/zlib.xml b/chapter06/zlib.xml index efe52b533..14dbbdbbe 100644 --- a/chapter06/zlib.xml +++ b/chapter06/zlib.xml @@ -1,105 +1,128 @@ <?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-zlib" role="wrap"> -<title>Zlib-&zlib-version;</title> -<?dbhtml filename="zlib.html"?> + <?dbhtml filename="zlib.html"?> + + <title>Zlib-&zlib-version;</title> + + <indexterm zone="ch-system-zlib"> + <primary sortas="a-Zlib">Zlib</primary> + </indexterm> + + <sect2 role="package"> + <title/> -<indexterm zone="ch-system-zlib"><primary sortas="a-Zlib">Zlib</primary></indexterm> + <para>The Zlib package contains compression and decompression routines used by + some programs.</para> -<sect2 role="package"><title/> -<para>The Zlib package contains compression and decompression routines used by -some programs.</para> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.1 SBU</seg><seg>2.7 MB</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>0.1 SBU</seg> + <seg>2.7 MB</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Binutils, Coreutils, GCC, Glibc, Make, and Sed</seg></seglistitem> -</segmentedlist> -</sect2> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -<sect2 role="installation"> -<title>Installation of Zlib</title> + <seglistitem> + <seg>Binutils, Coreutils, GCC, Glibc, Make, and Sed</seg> + </seglistitem> + </segmentedlist> -<note><para>Zlib is known to build its shared library incorrectly if -<envar>CFLAGS</envar> is specified in the environment. If using a -specified <envar>CFLAGS</envar> -variable, be sure to add the <parameter>-fPIC</parameter> directive to -the <envar>CFLAGS</envar> variable for the duration of the -configure command below, then remove it afterwards.</para></note> + </sect2> -<para>Prepare Zlib for compilation:</para> + <sect2 role="installation"> + <title>Installation of Zlib</title> + + <note> + <para>Zlib is known to build its shared library incorrectly if + <envar>CFLAGS</envar> is specified in the environment. If using + a specified <envar>CFLAGS</envar> variable, be sure to add the + <parameter>-fPIC</parameter> directive to the <envar>CFLAGS</envar> + variable for the duration of the configure command below, then + remove it afterwards.</para> + </note> + + <para>Prepare Zlib for compilation:</para> <screen><userinput>./configure --prefix=/usr --shared --libdir=/lib</userinput></screen> -<para>Compile the package:</para> + <para>Compile the package:</para> <screen><userinput>make</userinput></screen> -<para>To test the results, issue: -<userinput>make check</userinput>.</para> + <para>To test the results, issue: + <userinput>make check</userinput>.</para> -<para>Install the shared library:</para> + <para>Install the shared library:</para> <screen><userinput>make install</userinput></screen> -<para>The previous command installed a <filename -class="extension">.so</filename> file in <filename -class="directory">/lib</filename>. We will remove it and relink it into -<filename class="directory">/usr/lib</filename>:</para> + <para>The previous command installed a <filename + class="extension">.so</filename> file in <filename + class="directory">/lib</filename>. We will remove it and relink it into + <filename class="directory">/usr/lib</filename>:</para> <screen><userinput>rm -v /lib/libz.so ln -sfv ../../lib/libz.so.&zlib-version; /usr/lib/libz.so</userinput></screen> -<para>Build the static library:</para> + <para>Build the static library:</para> <screen><userinput>make clean ./configure --prefix=/usr make</userinput></screen> -<para>To test the results again, issue: -<userinput>make check</userinput>.</para> + <para>To test the results again, issue: + <userinput>make check</userinput>.</para> -<para>Install the static library:</para> + <para>Install the static library:</para> <screen><userinput>make install</userinput></screen> -<para>Fix the permissions on the static library:</para> + <para>Fix the permissions on the static library:</para> <screen><userinput>chmod -v 644 /usr/lib/libz.a</userinput></screen> -</sect2> + </sect2> + <sect2 id="contents-zlib" role="content"> + <title>Contents of Zlib</title> -<sect2 id="contents-zlib" role="content"><title>Contents of Zlib</title> + <segmentedlist> + <segtitle>Installed libraries</segtitle> -<segmentedlist> -<segtitle>Installed libraries</segtitle> -<seglistitem><seg>libz.[a,so]</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>libz.[a,so]</seg> + </seglistitem> + </segmentedlist> -<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> -<?dbfo list-presentation="list"?> -<?dbhtml list-presentation="table"?> + <variablelist> + <bridgehead renderas="sect3">Short Descriptions</bridgehead> + <?dbfo list-presentation="list"?> + <?dbhtml list-presentation="table"?> -<varlistentry id="libz"> -<term><filename class="libraryfile">libz</filename></term> -<listitem> -<para>Contains compression and decompression -functions used by some programs</para> -<indexterm zone="ch-system-zlib libz"><primary sortas="c-libz">libz</primary></indexterm> -</listitem> -</varlistentry> -</variablelist> + <varlistentry id="libz"> + <term><filename class="libraryfile">libz</filename></term> + <listitem> + <para>Contains compression and decompression functions used by + some programs</para> + <indexterm zone="ch-system-zlib libz"> + <primary sortas="c-libz">libz</primary> + </indexterm> + </listitem> + </varlistentry> -</sect2> + </variablelist> -</sect1> + </sect2> +</sect1> |