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

Finished the XML indentation plus few tags changes.

Browse Source 
git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7369 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
This commit is contained in:
Manuel Canales Esparcia 2006-02-10 19:05:30 +00:00
parent 3f3931b0a8
commit ddd554266c
12 changed files with 2434 additions and 1879 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
chapter01/changelog.xml
View File

@ -36,6 +36,16 @@
</listitem> </listitem>
--> -->
<listitem>
<para>Febraury 10, 2006</para>
<itemizedlist>
<listitem>
<para>[manuel] - Finished the XML indentation plus few tags
changes.</para>
</listitem>
</itemizedlist>
</listitem>
<listitem> <listitem>
<para>January 30, 2006</para> <para>January 30, 2006</para>
<itemizedlist> <itemizedlist>

291
chapter06/shadow.xml
View File

@ -1,61 +1,83 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-shadow" role="wrap"> <sect1 id="ch-system-shadow" role="wrap">
<title>Shadow-&shadow-version;</title>
<?dbhtml filename="shadow.html"?> <?dbhtml filename="shadow.html"?>
<indexterm zone="ch-system-shadow"><primary sortas="a-Shadow">Shadow</primary></indexterm> <title>Shadow-&shadow-version;</title>
<indexterm zone="ch-system-shadow">
<primary sortas="a-Shadow">Shadow</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Shadow package contains programs for handling passwords in a secure <para>The Shadow package contains programs for handling passwords in a secure
way.</para> way.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.4 SBU</seg><seg>14.7 MB</seg></seglistitem>
<seglistitem>
<seg>0.4 SBU</seg>
<seg>14.7 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Bison, Coreutils,
Diffutils, GCC, Gettext, Glibc, Grep, Make, and Sed</seg></seglistitem> <seglistitem>
<seg>Bash, Binutils, Bison, Coreutils, Diffutils, GCC, Gettext,
Glibc, Grep, Make, and Sed</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
<title>Installation of Shadow</title> <title>Installation of Shadow</title>
<note><para>If you would like to enforce the use of strong passwords, refer to <note>
<ulink url="&blfs-root;view/svn/postlfs/cracklib.html"/> for installing Cracklib <para>If you would like to enforce the use of strong passwords, refer to
prior to building Shadow. Then add <parameter>--with-libcrack</parameter> to the <ulink url="&blfs-root;view/svn/postlfs/cracklib.html"/> for installing
<command>configure</command> command below.</para></note> 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> <screen><userinput>./configure --libdir=/lib --enable-shared --without-selinux</userinput></screen>
<para>The meaning of the configure options:</para>
<variablelist> <variablelist>
<title>The meaning of the configure options:</title>
<varlistentry> <varlistentry>
<term><parameter>--without-selinux</parameter></term> <term><parameter>--without-selinux</parameter></term>
<listitem><para>Support for selinux is enabled by default, but selinux is not <listitem>
built in a base LFS system. The <command>configure</command> script will fail <para>Support for selinux is enabled by default, but selinux is not
if this option is not used.</para></listitem> built in a base LFS system. The <command>configure</command> script
will fail if this option is not used.</para>
</listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Disable the installation of the <command>groups</command> program and its man page, as Coreutils provides a better version:</para> <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 <screen><userinput>sed -i 's/groups$(EXEEXT) //' src/Makefile
find man -name Makefile -exec sed -i '/groups/d' {} \;</userinput></screen> find man -name Makefile -exec sed -i '/groups/d' {} \;</userinput></screen>
<para>Disable the installation of Chinese and Korean manual pages, since Man-DB <para>Disable the installation of Chinese and Korean manual pages, since
cannot format them properly:</para> Man-DB cannot format them properly:</para>
<screen><userinput>sed -i -e 's/ ko//' -e 's/ zh_CN zh_TW//' man/Makefile</userinput></screen> <screen><userinput>sed -i -e 's/ ko//' -e 's/ zh_CN zh_TW//' man/Makefile</userinput></screen>
@ -73,24 +95,32 @@ cannot format them properly:</para>
authentication settings for the system. Install these two configuration authentication settings for the system. Install these two configuration
files:</para> files:</para>
<indexterm zone="shadow-limits-login_access"><primary sortas="e-/etc/limits">/etc/limits</primary></indexterm> <indexterm zone="shadow-limits-login_access">
<indexterm zone="shadow-limits-login_access"><primary sortas="e-/etc/login.access">/etc/login.access</primary></indexterm> <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>
<screen><userinput>cp -v etc/{limits,login.access} /etc</userinput></screen> <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, <para id="shadow-login_defs">Instead of using the default
use the more secure <emphasis>MD5</emphasis> method of password <emphasis>crypt</emphasis> method, use the more secure
encryption, which also allows passwords longer than 8 characters. It <emphasis>MD5</emphasis> method of password encryption, which also allows
is also necessary to change the obsolete <filename passwords longer than 8 characters. It is also necessary to change the
class="directory">/var/spool/mail</filename> location for user obsolete <filename class="directory">/var/spool/mail</filename> location
mailboxes that Shadow uses by default to the <filename for user mailboxes that Shadow uses by default to the <filename
class="directory">/var/mail</filename> location used currently. Both class="directory">/var/mail</filename> location used currently. Both of
of these can be accomplished by changing the relevant configuration these can be accomplished by changing the relevant configuration file
file while copying it to its destination:</para> 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 <note>
<para>If you built Shadow with Cracklib support, insert the following into
the <command>sed</command> given below:</para> the <command>sed</command> given below:</para>
<screen><literal>-e 's@DICTPATH.*@DICTPATH\t/lib/cracklib/pw_dict@'</literal></screen> <screen><literal>-e 's@DICTPATH.*@DICTPATH\t/lib/cracklib/pw_dict@'</literal></screen>
@ -119,19 +149,20 @@ properly:</para>
</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"> <indexterm zone="conf-shadow">
<primary sortas="a-Shadow">Shadow</primary> <primary sortas="a-Shadow">Shadow</primary>
<secondary>configuring</secondary></indexterm> <secondary>configuring</secondary>
</indexterm>
<para>This package contains utilities to add, modify, and delete users <para>This package contains utilities to add, modify, and delete users and
and groups; set and change their passwords; and perform other groups; set and change their passwords; and perform other administrative
administrative tasks. For a full explanation of what tasks. For a full explanation of what <emphasis>password shadowing</emphasis>
<emphasis>password shadowing</emphasis> means, see the means, see the <filename>doc/HOWTO</filename> file within the unpacked
<filename>doc/HOWTO</filename> file within the unpacked source tree. source tree. If using Shadow support, keep in mind that programs which need
If using Shadow support, keep in mind that programs which need to to verify passwords (display managers, FTP programs, pop3 daemons, etc.)
verify passwords (display managers, FTP programs, pop3 daemons, etc.)
must be Shadow-compliant. That is, they need to be able to work with must be Shadow-compliant. That is, they need to be able to work with
shadowed passwords.</para> shadowed passwords.</para>
@ -151,7 +182,6 @@ command.</para>
</sect2> </sect2>
<sect2 role="configuration"> <sect2 role="configuration">
<title>Setting the root password</title> <title>Setting the root password</title>
@ -159,23 +189,27 @@ command.</para>
by running:</para> by running:</para>
<screen role="nodump"><userinput>passwd root</userinput></screen> <screen role="nodump"><userinput>passwd root</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-shadow" role="content">
<sect2 id="contents-shadow" role="content"><title>Contents of Shadow</title> <title>Contents of Shadow</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<segtitle>Installed libraries</segtitle> <segtitle>Installed libraries</segtitle>
<seglistitem><seg>chage, chfn, chpasswd, chsh, expiry, faillog, gpasswd,
groupadd, groupdel, groupmod, grpck, grpconv, grpunconv, lastlog, login, <seglistitem>
logoutd, newgrp, newusers, passwd, pwck, pwconv, pwunconv, sg (link to newgrp), <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> su, useradd, userdel, usermod, vigr (link to vipw), and vipw</seg>
<seg>libshadow.[a,so]</seg> <seg>libshadow.[a,so]</seg>
</seglistitem> </seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
@ -184,7 +218,9 @@ su, useradd, userdel, usermod, vigr (link to vipw), and vipw</seg>
<listitem> <listitem>
<para>Used to change the maximum number of days between obligatory <para>Used to change the maximum number of days between obligatory
password changes</para> password changes</para>
<indexterm zone="ch-system-shadow chage"><primary sortas="b-chage">chage</primary></indexterm> <indexterm zone="ch-system-shadow chage">
<primary sortas="b-chage">chage</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -192,7 +228,9 @@ password changes</para>
<term><command>chfn</command></term> <term><command>chfn</command></term>
<listitem> <listitem>
<para>Used to change a user's full name and other information</para> <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> <indexterm zone="ch-system-shadow chfn">
<primary sortas="b-chfn">chfn</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -201,7 +239,9 @@ password changes</para>
<listitem> <listitem>
<para>Used to update the passwords of an entire series of user <para>Used to update the passwords of an entire series of user
accounts</para> accounts</para>
<indexterm zone="ch-system-shadow chpasswd"><primary sortas="b-chpasswd">chpasswd</primary></indexterm> <indexterm zone="ch-system-shadow chpasswd">
<primary sortas="b-chpasswd">chpasswd</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -209,7 +249,9 @@ accounts</para>
<term><command>chsh</command></term> <term><command>chsh</command></term>
<listitem> <listitem>
<para>Used to change a user's default login shell</para> <para>Used to change a user's default login shell</para>
<indexterm zone="ch-system-shadow chsh"><primary sortas="b-chsh">chsh</primary></indexterm> <indexterm zone="ch-system-shadow chsh">
<primary sortas="b-chsh">chsh</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -217,24 +259,32 @@ accounts</para>
<term><command>expiry</command></term> <term><command>expiry</command></term>
<listitem> <listitem>
<para>Checks and enforces the current password expiration policy</para> <para>Checks and enforces the current password expiration policy</para>
<indexterm zone="ch-system-shadow expiry"><primary sortas="b-expiry">expiry</primary></indexterm> <indexterm zone="ch-system-shadow expiry">
<primary sortas="b-expiry">expiry</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="faillog"> <varlistentry id="faillog">
<term><command>faillog</command></term> <term><command>faillog</command></term>
<listitem> <listitem>
<para>Is used to examine the log of login failures, to set a maximum number of <para>Is used to examine the log of login failures, to set a maximum
failures before an account is blocked, or to reset the failure count</para> number of failures before an account is blocked, or to reset the
<indexterm zone="ch-system-shadow faillog"><primary sortas="b-faillog">faillog</primary></indexterm> failure count</para>
<indexterm zone="ch-system-shadow faillog">
<primary sortas="b-faillog">faillog</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="gpasswd"> <varlistentry id="gpasswd">
<term><command>gpasswd</command></term> <term><command>gpasswd</command></term>
<listitem> <listitem>
<para>Is used to add and delete members and administrators to groups</para> <para>Is used to add and delete members and administrators to
<indexterm zone="ch-system-shadow gpasswd"><primary sortas="b-gpasswd">gpasswd</primary></indexterm> groups</para>
<indexterm zone="ch-system-shadow gpasswd">
<primary sortas="b-gpasswd">gpasswd</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -242,7 +292,9 @@ failures before an account is blocked, or to reset the failure count</para>
<term><command>groupadd</command></term> <term><command>groupadd</command></term>
<listitem> <listitem>
<para>Creates a group with the given name</para> <para>Creates a group with the given name</para>
<indexterm zone="ch-system-shadow groupadd"><primary sortas="b-groupadd">groupadd</primary></indexterm> <indexterm zone="ch-system-shadow groupadd">
<primary sortas="b-groupadd">groupadd</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -250,7 +302,9 @@ failures before an account is blocked, or to reset the failure count</para>
<term><command>groupdel</command></term> <term><command>groupdel</command></term>
<listitem> <listitem>
<para>Deletes the group with the given name</para> <para>Deletes the group with the given name</para>
<indexterm zone="ch-system-shadow groupdel"><primary sortas="b-groupdel">groupdel</primary></indexterm> <indexterm zone="ch-system-shadow groupdel">
<primary sortas="b-groupdel">groupdel</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -258,41 +312,54 @@ failures before an account is blocked, or to reset the failure count</para>
<term><command>groupmod</command></term> <term><command>groupmod</command></term>
<listitem> <listitem>
<para>Is used to modify the given group's name or GID</para> <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> <indexterm zone="ch-system-shadow groupmod">
<primary sortas="b-groupmod">groupmod</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="grpck"> <varlistentry id="grpck">
<term><command>grpck</command></term> <term><command>grpck</command></term>
<listitem> <listitem>
<para>Verifies the integrity of the group files <filename>/etc/group</filename> <para>Verifies the integrity of the group files
and <filename>/etc/gshadow</filename></para> <filename>/etc/group</filename> and
<indexterm zone="ch-system-shadow grpck"><primary sortas="b-grpck">grpck</primary></indexterm> <filename>/etc/gshadow</filename></para>
<indexterm zone="ch-system-shadow grpck">
<primary sortas="b-grpck">grpck</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="grpconv"> <varlistentry id="grpconv">
<term><command>grpconv</command></term> <term><command>grpconv</command></term>
<listitem> <listitem>
<para>Creates or updates the shadow group file from the normal group file</para> <para>Creates or updates the shadow group file from the normal
<indexterm zone="ch-system-shadow grpconv"><primary sortas="b-grpconv">grpconv</primary></indexterm> group file</para>
<indexterm zone="ch-system-shadow grpconv">
<primary sortas="b-grpconv">grpconv</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="grpunconv"> <varlistentry id="grpunconv">
<term><command>grpunconv</command></term> <term><command>grpunconv</command></term>
<listitem> <listitem>
<para>Updates <filename>/etc/group</filename> <para>Updates <filename>/etc/group</filename> from
from <filename>/etc/gshadow</filename> and then deletes the latter</para> <filename>/etc/gshadow</filename> and then deletes the latter</para>
<indexterm zone="ch-system-shadow grpunconv"><primary sortas="b-grpunconv">grpunconv</primary></indexterm> <indexterm zone="ch-system-shadow grpunconv">
<primary sortas="b-grpunconv">grpunconv</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="lastlog"> <varlistentry id="lastlog">
<term><command>lastlog</command></term> <term><command>lastlog</command></term>
<listitem> <listitem>
<para>Reports the most recent login of all users or of a given user</para> <para>Reports the most recent login of all users or of a
<indexterm zone="ch-system-shadow lastlog"><primary sortas="b-lastlog">lastlog</primary></indexterm> given user</para>
<indexterm zone="ch-system-shadow lastlog">
<primary sortas="b-lastlog">lastlog</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -300,15 +367,20 @@ from <filename>/etc/gshadow</filename> and then deletes the latter</para>
<term><command>login</command></term> <term><command>login</command></term>
<listitem> <listitem>
<para>Is used by the system to let users sign on</para> <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> <indexterm zone="ch-system-shadow login">
<primary sortas="b-login">login</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="logoutd"> <varlistentry id="logoutd">
<term><command>logoutd</command></term> <term><command>logoutd</command></term>
<listitem> <listitem>
<para>Is a daemon used to enforce restrictions on log-on time and ports</para> <para>Is a daemon used to enforce restrictions on log-on time
<indexterm zone="ch-system-shadow logoutd"><primary sortas="b-logoutd">logoutd</primary></indexterm> and ports</para>
<indexterm zone="ch-system-shadow logoutd">
<primary sortas="b-logoutd">logoutd</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -316,15 +388,20 @@ from <filename>/etc/gshadow</filename> and then deletes the latter</para>
<term><command>newgrp</command></term> <term><command>newgrp</command></term>
<listitem> <listitem>
<para>Is used to change the current GID during a login session</para> <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> <indexterm zone="ch-system-shadow newgrp">
<primary sortas="b-newgrp">newgrp</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="newusers"> <varlistentry id="newusers">
<term><command>newusers</command></term> <term><command>newusers</command></term>
<listitem> <listitem>
<para>Is used to create or update an entire series of user accounts</para> <para>Is used to create or update an entire series of user
<indexterm zone="ch-system-shadow newusers"><primary sortas="b-newusers">newusers</primary></indexterm> accounts</para>
<indexterm zone="ch-system-shadow newusers">
<primary sortas="b-newusers">newusers</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -332,7 +409,9 @@ from <filename>/etc/gshadow</filename> and then deletes the latter</para>
<term><command>passwd</command></term> <term><command>passwd</command></term>
<listitem> <listitem>
<para>Is used to change the password for a user or group account</para> <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> <indexterm zone="ch-system-shadow passwd">
<primary sortas="b-passwd">passwd</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -340,8 +419,11 @@ from <filename>/etc/gshadow</filename> and then deletes the latter</para>
<term><command>pwck</command></term> <term><command>pwck</command></term>
<listitem> <listitem>
<para>Verifies the integrity of the password files <para>Verifies the integrity of the password files
<filename>/etc/passwd</filename> and <filename>/etc/shadow</filename></para> <filename>/etc/passwd</filename> and
<indexterm zone="ch-system-shadow pwck"><primary sortas="b-pwck">pwck</primary></indexterm> <filename>/etc/shadow</filename></para>
<indexterm zone="ch-system-shadow pwck">
<primary sortas="b-pwck">pwck</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -350,16 +432,20 @@ from <filename>/etc/gshadow</filename> and then deletes the latter</para>
<listitem> <listitem>
<para>Creates or updates the shadow password file from the normal <para>Creates or updates the shadow password file from the normal
password file</para> password file</para>
<indexterm zone="ch-system-shadow pwconv"><primary sortas="b-pwconv">pwconv</primary></indexterm> <indexterm zone="ch-system-shadow pwconv">
<primary sortas="b-pwconv">pwconv</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="pwunconv"> <varlistentry id="pwunconv">
<term><command>pwunconv</command></term> <term><command>pwunconv</command></term>
<listitem> <listitem>
<para>Updates <filename>/etc/passwd</filename> <para>Updates <filename>/etc/passwd</filename> from
from <filename>/etc/shadow</filename> and then deletes the latter</para> <filename>/etc/shadow</filename> and then deletes the latter</para>
<indexterm zone="ch-system-shadow pwunconv"><primary sortas="b-pwunconv">pwunconv</primary></indexterm> <indexterm zone="ch-system-shadow pwunconv">
<primary sortas="b-pwunconv">pwunconv</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -368,15 +454,19 @@ from <filename>/etc/shadow</filename> and then deletes the latter</para>
<listitem> <listitem>
<para>Executes a given command while the user's GID <para>Executes a given command while the user's GID
is set to that of the given group</para> is set to that of the given group</para>
<indexterm zone="ch-system-shadow sg"><primary sortas="b-sg">sg</primary></indexterm> <indexterm zone="ch-system-shadow sg">
<primary sortas="b-sg">sg</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="su"> <varlistentry id="su">
<term><command>su</command></term> <term><command>su</command></term>
<listitem> <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> <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> </listitem>
</varlistentry> </varlistentry>
@ -385,7 +475,9 @@ is set to that of the given group</para>
<listitem> <listitem>
<para>Creates a new user with the given name, or updates the default <para>Creates a new user with the given name, or updates the default
new-user information</para> new-user information</para>
<indexterm zone="ch-system-shadow useradd"><primary sortas="b-useradd">useradd</primary></indexterm> <indexterm zone="ch-system-shadow useradd">
<primary sortas="b-useradd">useradd</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -393,7 +485,9 @@ new-user information</para>
<term><command>userdel</command></term> <term><command>userdel</command></term>
<listitem> <listitem>
<para>Deletes the given user account</para> <para>Deletes the given user account</para>
<indexterm zone="ch-system-shadow userdel"><primary sortas="b-userdel">userdel</primary></indexterm> <indexterm zone="ch-system-shadow userdel">
<primary sortas="b-userdel">userdel</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -401,9 +495,10 @@ new-user information</para>
<term><command>usermod</command></term> <term><command>usermod</command></term>
<listitem> <listitem>
<para>Is used to modify the given user's login name, User <para>Is used to modify the given user's login name, User
Identification (UID), Identification (UID), shell, initial group, home directory, etc.</para>
shell, initial group, home directory, etc.</para> <indexterm zone="ch-system-shadow usermod">
<indexterm zone="ch-system-shadow usermod"><primary sortas="b-usermod">usermod</primary></indexterm> <primary sortas="b-usermod">usermod</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -412,7 +507,9 @@ shell, initial group, home directory, etc.</para>
<listitem> <listitem>
<para>Edits the <filename>/etc/group</filename> or <para>Edits the <filename>/etc/group</filename> or
<filename>/etc/gshadow</filename> files</para> <filename>/etc/gshadow</filename> files</para>
<indexterm zone="ch-system-shadow vigr"><primary sortas="b-vigr">vigr</primary></indexterm> <indexterm zone="ch-system-shadow vigr">
<primary sortas="b-vigr">vigr</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -421,7 +518,9 @@ shell, initial group, home directory, etc.</para>
<listitem> <listitem>
<para>Edits the <filename>/etc/passwd</filename> or <para>Edits the <filename>/etc/passwd</filename> or
<filename>/etc/shadow</filename> files</para> <filename>/etc/shadow</filename> files</para>
<indexterm zone="ch-system-shadow vipw"><primary sortas="b-vipw">vipw</primary></indexterm> <indexterm zone="ch-system-shadow vipw">
<primary sortas="b-vipw">vipw</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -429,12 +528,14 @@ shell, initial group, home directory, etc.</para>
<term><filename class="libraryfile">libshadow</filename></term> <term><filename class="libraryfile">libshadow</filename></term>
<listitem> <listitem>
<para>Contains functions used by most programs in this package</para> <para>Contains functions used by most programs in this package</para>
<indexterm zone="ch-system-shadow libshadow"><primary sortas="c-libshadow">libshadow</primary></indexterm> <indexterm zone="ch-system-shadow libshadow">
<primary sortas="c-libshadow">libshadow</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

8
chapter06/strippingagain.xml
View File

@ -1,12 +1,15 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-strippingagain"> <sect1 id="ch-system-strippingagain">
<title>Stripping Again</title>
<?dbhtml filename="strippingagain.html"?> <?dbhtml filename="strippingagain.html"?>
<title>Stripping Again</title>
<para>If the intended user is not a programmer and does not plan to do <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 any debugging on the system software, the system size can be decreased
by about 200 MB by removing the debugging symbols from binaries and by about 200 MB by removing the debugging symbols from binaries and
@ -51,4 +54,3 @@ several more megabytes. Do not use this option on libraries&mdash;they will
be destroyed.</para> be destroyed.</para>
</sect1> </sect1>

72
chapter06/sysklogd.xml
View File

@ -1,28 +1,43 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-sysklogd" xreflabel="Sysklogd" role="wrap">
<title>Sysklogd-&sysklogd-version;</title> <sect1 id="ch-system-sysklogd" role="wrap">
<?dbhtml filename="sysklogd.html"?> <?dbhtml filename="sysklogd.html"?>
<indexterm zone="ch-system-sysklogd"><primary sortas="a-Sysklogd">Sysklogd</primary></indexterm> <title>Sysklogd-&sysklogd-version;</title>
<sect2 role="package"><title/> <indexterm zone="ch-system-sysklogd">
<para>The Sysklogd package contains programs for logging system messages, such <primary sortas="a-Sysklogd">Sysklogd</primary>
as those given by the kernel when unusual things happen.</para> </indexterm>
<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>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>704 KB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>704 KB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Binutils, Coreutils, GCC, Glibc, Make</seg></seglistitem>
<seglistitem>
<seg>Binutils, Coreutils, GCC, Glibc, Make</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
@ -51,13 +66,17 @@ codes. Unpatched sysklogd would damage messages in the UTF-8 encoding.</para>
</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"> <indexterm zone="conf-sysklogd">
<primary sortas="a-Sysklogd">Sysklogd</primary> <primary sortas="a-Sysklogd">Sysklogd</primary>
<secondary>configuring</secondary></indexterm> <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 <para>Create a new <filename>/etc/syslog.conf</filename> file by running the
following:</para> following:</para>
@ -81,15 +100,19 @@ EOF</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-sysklogd" role="content">
<sect2 id="contents-sysklogd" role="content"><title>Contents of Sysklogd</title> <title>Contents of Sysklogd</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<seglistitem><seg>klogd and syslogd</seg></seglistitem>
<seglistitem>
<seg>klogd and syslogd</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
@ -97,20 +120,25 @@ EOF</userinput></screen>
<term><command>klogd</command></term> <term><command>klogd</command></term>
<listitem> <listitem>
<para>A system daemon for intercepting and logging kernel messages</para> <para>A system daemon for intercepting and logging kernel messages</para>
<indexterm zone="ch-system-sysklogd klogd"><primary sortas="b-klogd">klogd</primary></indexterm> <indexterm zone="ch-system-sysklogd klogd">
<primary sortas="b-klogd">klogd</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="syslogd"> <varlistentry id="syslogd">
<term><command>syslogd</command></term> <term><command>syslogd</command></term>
<listitem> <listitem>
<para>Logs the messages that system programs offer for logging. Every logged <para>Logs the messages that system programs offer for logging. Every
message contains at least a date stamp and a hostname, and normally the logged message contains at least a date stamp and a hostname, and
program's name too, but that depends on how trusting the logging daemon is told normally the program's name too, but that depends on how trusting the
to be</para> logging daemon is told to be</para>
<indexterm zone="ch-system-sysklogd syslogd"><primary sortas="b-syslogd">syslogd</primary></indexterm> <indexterm zone="ch-system-sysklogd syslogd">
<primary sortas="b-syslogd">syslogd</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>

139
chapter06/sysvinit.xml
View File

@ -1,28 +1,42 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-sysvinit" role="wrap"> <sect1 id="ch-system-sysvinit" role="wrap">
<title>Sysvinit-&sysvinit-version;</title>
<?dbhtml filename="sysvinit.html"?> <?dbhtml filename="sysvinit.html"?>
<indexterm zone="ch-system-sysvinit"><primary sortas="a-Sysvinit">Sysvinit</primary></indexterm> <title>Sysvinit-&sysvinit-version;</title>
<indexterm zone="ch-system-sysvinit">
<primary sortas="a-Sysvinit">Sysvinit</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Sysvinit package contains programs for controlling the startup, <para>The Sysvinit package contains programs for controlling the startup,
running, and shutdown of the system.</para> running, and shutdown of the system.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>1012 KB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg><seg>1012 KB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Binutils, Coreutils, GCC, Glibc, and Make</seg></seglistitem>
<seglistitem>
<seg>Binutils, Coreutils, GCC, Glibc, and Make</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
@ -54,13 +68,17 @@ instead:</para>
</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"> <indexterm zone="conf-sysvinit">
<primary sortas="a-Sysvinit">Sysvinit</primary> <primary sortas="a-Sysvinit">Sysvinit</primary>
<secondary>configuring</secondary></indexterm> <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 <para>Create a new file <filename>/etc/inittab</filename> by running the
following:</para> following:</para>
@ -93,19 +111,25 @@ su:S016:once:/sbin/sulogin
# End /etc/inittab</literal> # End /etc/inittab</literal>
EOF</userinput></screen> EOF</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-sysvinit" role="content">
<sect2 id="contents-sysvinit" role="content"><title>Contents of Sysvinit</title> <title>Contents of Sysvinit</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <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 <seglistitem>
(link to init), utmpdump, and wall</seg></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> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
@ -117,7 +141,9 @@ killall5), poweroff (link to halt), reboot (link to halt), runlevel, shutdown, s
then it tells the kernel to halt the system; it notes in the then it tells the kernel to halt the system; it notes in the
file <filename>/var/log/wtmp</filename> that the system is being file <filename>/var/log/wtmp</filename> that the system is being
brought down</para> brought down</para>
<indexterm zone="ch-system-sysvinit halt"><primary sortas="b-halt">halt</primary></indexterm> <indexterm zone="ch-system-sysvinit halt">
<primary sortas="b-halt">halt</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -125,9 +151,11 @@ brought down</para>
<term><command>init</command></term> <term><command>init</command></term>
<listitem> <listitem>
<para>The first process to be started when the kernel has initialized <para>The first process to be started when the kernel has initialized
the hardware which takes over the boot process and the hardware which takes over the boot process and starts all the
starts all the proceses it is instructed to</para> proceses it is instructed to</para>
<indexterm zone="ch-system-sysvinit init"><primary sortas="b-init">init</primary></indexterm> <indexterm zone="ch-system-sysvinit init">
<primary sortas="b-init">init</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -137,17 +165,21 @@ starts all the proceses it is instructed to</para>
<para>Sends a signal to all processes, except the processes in its own <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 session so it will not kill the shell running the script that called
it</para> it</para>
<indexterm zone="ch-system-sysvinit killall5"><primary sortas="b-killall5">killall5</primary></indexterm> <indexterm zone="ch-system-sysvinit killall5">
<primary sortas="b-killall5">killall5</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="last"> <varlistentry id="last">
<term><command>last</command></term> <term><command>last</command></term>
<listitem> <listitem>
<para>Shows which users last logged in (and out), <para>Shows which users last logged in (and out), searching back
searching back through the <filename>/var/log/wtmp</filename> file; it through the <filename>/var/log/wtmp</filename> file; it also shows
also shows system boots, shutdowns, and run-level changes</para> system boots, shutdowns, and run-level changes</para>
<indexterm zone="ch-system-sysvinit last"><primary sortas="b-last">last</primary></indexterm> <indexterm zone="ch-system-sysvinit last">
<primary sortas="b-last">last</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -156,7 +188,9 @@ also shows system boots, shutdowns, and run-level changes</para>
<listitem> <listitem>
<para>Shows the failed login attempts, as logged in <para>Shows the failed login attempts, as logged in
<filename>/var/log/btmp</filename></para> <filename>/var/log/btmp</filename></para>
<indexterm zone="ch-system-sysvinit lastb"><primary sortas="b-lastb">lastb</primary></indexterm> <indexterm zone="ch-system-sysvinit lastb">
<primary sortas="b-lastb">lastb</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -165,7 +199,9 @@ also shows system boots, shutdowns, and run-level changes</para>
<listitem> <listitem>
<para>Controls whether other users can send messages to the current <para>Controls whether other users can send messages to the current
user's terminal</para> user's terminal</para>
<indexterm zone="ch-system-sysvinit mesg"><primary sortas="b-mesg">mesg</primary></indexterm> <indexterm zone="ch-system-sysvinit mesg">
<primary sortas="b-mesg">mesg</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -173,7 +209,9 @@ user's terminal</para>
<term><command>mountpoint</command></term> <term><command>mountpoint</command></term>
<listitem> <listitem>
<para>Checks if the directory is a mountpoint</para> <para>Checks if the directory is a mountpoint</para>
<indexterm zone="ch-system-sysvinit mountpoint"><primary sortas="b-mountpoint">mountpoint</primary></indexterm> <indexterm zone="ch-system-sysvinit mountpoint">
<primary sortas="b-mountpoint">mountpoint</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -181,7 +219,9 @@ user's terminal</para>
<term><command>pidof</command></term> <term><command>pidof</command></term>
<listitem> <listitem>
<para>Reports the PIDs of the given programs</para> <para>Reports the PIDs of the given programs</para>
<indexterm zone="ch-system-sysvinit pidof"><primary sortas="b-pidof">pidof</primary></indexterm> <indexterm zone="ch-system-sysvinit pidof">
<primary sortas="b-pidof">pidof</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -190,7 +230,9 @@ user's terminal</para>
<listitem> <listitem>
<para>Tells the kernel to halt the system and switch off the computer <para>Tells the kernel to halt the system and switch off the computer
(see <command>halt</command>)</para> (see <command>halt</command>)</para>
<indexterm zone="ch-system-sysvinit poweroff"><primary sortas="b-poweroff">poweroff</primary></indexterm> <indexterm zone="ch-system-sysvinit poweroff">
<primary sortas="b-poweroff">poweroff</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -199,16 +241,20 @@ user's terminal</para>
<listitem> <listitem>
<para>Tells the kernel to reboot the system (see <para>Tells the kernel to reboot the system (see
<command>halt</command>)</para> <command>halt</command>)</para>
<indexterm zone="ch-system-sysvinit reboot"><primary sortas="b-reboot">reboot</primary></indexterm> <indexterm zone="ch-system-sysvinit reboot">
<primary sortas="b-reboot">reboot</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="runlevel"> <varlistentry id="runlevel">
<term><command>runlevel</command></term> <term><command>runlevel</command></term>
<listitem> <listitem>
<para>Reports the previous and the current run-level, as noted in the last run-level <para>Reports the previous and the current run-level, as noted in the
record in <filename>/var/run/utmp</filename></para> last run-level record in <filename>/var/run/utmp</filename></para>
<indexterm zone="ch-system-sysvinit runlevel"><primary sortas="b-runlevel">runlevel</primary></indexterm> <indexterm zone="ch-system-sysvinit runlevel">
<primary sortas="b-runlevel">runlevel</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -217,16 +263,21 @@ record in <filename>/var/run/utmp</filename></para>
<listitem> <listitem>
<para>Brings the system down in a secure way, signaling all processes <para>Brings the system down in a secure way, signaling all processes
and notifying all logged-in users</para> and notifying all logged-in users</para>
<indexterm zone="ch-system-sysvinit shutdown"><primary sortas="b-shutdown">shutdown</primary></indexterm> <indexterm zone="ch-system-sysvinit shutdown">
<primary sortas="b-shutdown">shutdown</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="sulogin"> <varlistentry id="sulogin">
<term><command>sulogin</command></term> <term><command>sulogin</command></term>
<listitem> <listitem>
<para>Allows <emphasis>root</emphasis> to log in; it is <para>Allows <systemitem class="username">root</systemitem> to log in;
normally invoked by <command>init</command> when the system goes into single user mode</para> it is normally invoked by <command>init</command> when the system goes
<indexterm zone="ch-system-sysvinit sulogin"><primary sortas="b-sulogin">sulogin</primary></indexterm> into single user mode</para>
<indexterm zone="ch-system-sysvinit sulogin">
<primary sortas="b-sulogin">sulogin</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -234,7 +285,9 @@ normally invoked by <command>init</command> when the system goes into single use
<term><command>telinit</command></term> <term><command>telinit</command></term>
<listitem> <listitem>
<para>Tells <command>init</command> which run-level to change to</para> <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> <indexterm zone="ch-system-sysvinit telinit">
<primary sortas="b-telinit">telinit</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -243,7 +296,9 @@ normally invoked by <command>init</command> when the system goes into single use
<listitem> <listitem>
<para>Displays the content of the given login file in a more <para>Displays the content of the given login file in a more
user-friendly format</para> user-friendly format</para>
<indexterm zone="ch-system-sysvinit utmpdump"><primary sortas="b-utmpdump">utmpdump</primary></indexterm> <indexterm zone="ch-system-sysvinit utmpdump">
<primary sortas="b-utmpdump">utmpdump</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -251,12 +306,14 @@ user-friendly format</para>
<term><command>wall</command></term> <term><command>wall</command></term>
<listitem> <listitem>
<para>Writes a message to all logged-in users</para> <para>Writes a message to all logged-in users</para>
<indexterm zone="ch-system-sysvinit wall"><primary sortas="b-wall">wall</primary></indexterm> <indexterm zone="ch-system-sysvinit wall">
<primary sortas="b-wall">wall</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

53
chapter06/tar.xml
View File

@ -1,28 +1,43 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-tar" role="wrap"> <sect1 id="ch-system-tar" role="wrap">
<title>Tar-&tar-version;</title>
<?dbhtml filename="tar.html"?> <?dbhtml filename="tar.html"?>
<indexterm zone="ch-system-tar"><primary sortas="a-Tar">Tar</primary></indexterm> <title>Tar-&tar-version;</title>
<indexterm zone="ch-system-tar">
<primary sortas="a-Tar">Tar</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Tar package contains an archiving program.</para> <para>The Tar package contains an archiving program.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>12.7 MB</seg></seglistitem>
<seglistitem>
<seg>0.2 SBU</seg>
<seg>12.7 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils,
Diffutils, GCC, Gettext, Glibc, Grep, Make, and Sed</seg></seglistitem> <seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc,
Grep, Make, and Sed</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
@ -34,7 +49,8 @@ GCC-&gcc-version;:</para>
<screen><userinput>patch -Np1 -i ../&tar-gcc4_fix-patch;</userinput></screen> <screen><userinput>patch -Np1 -i ../&tar-gcc4_fix-patch;</userinput></screen>
<para>Tar has a bug when the <parameter>-S</parameter> option is used <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> 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> <screen><userinput>patch -Np1 -i ../&tar-sparse_fix-patch;</userinput></screen>
@ -56,14 +72,19 @@ with files larger than 4 GB. The following patch properly fixes this issue:</par
</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> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<seglistitem><seg>rmt and tar</seg></seglistitem>
<seglistitem>
<seg>rmt and tar</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
@ -72,7 +93,9 @@ with files larger than 4 GB. The following patch properly fixes this issue:</par
<listitem> <listitem>
<para>Remotely manipulates a magnetic <para>Remotely manipulates a magnetic
tape drive through an interprocess communication connection</para> tape drive through an interprocess communication connection</para>
<indexterm zone="ch-system-tar rmt"><primary sortas="b-rmt">rmt</primary></indexterm> <indexterm zone="ch-system-tar rmt">
<primary sortas="b-rmt">rmt</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -81,12 +104,14 @@ tape drive through an interprocess communication connection</para>
<listitem> <listitem>
<para>Creates, extracts files from, and lists the contents of archives, <para>Creates, extracts files from, and lists the contents of archives,
also known as tarballs</para> also known as tarballs</para>
<indexterm zone="ch-system-tar tar"><primary sortas="b-tar">tar</primary></indexterm> <indexterm zone="ch-system-tar tar">
<primary sortas="b-tar">tar</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

121
chapter06/texinfo.xml
View File

@ -1,39 +1,54 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-texinfo" role="wrap"> <sect1 id="ch-system-texinfo" role="wrap">
<title>Texinfo-&texinfo-version;</title>
<?dbhtml filename="texinfo.html"?> <?dbhtml filename="texinfo.html"?>
<indexterm zone="ch-system-texinfo"><primary sortas="a-Texinfo">Texinfo</primary></indexterm> <title>Texinfo-&texinfo-version;</title>
<indexterm zone="ch-system-texinfo">
<primary sortas="a-Texinfo">Texinfo</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Texinfo package contains programs for reading, writing, and <para>The Texinfo package contains programs for reading, writing, and
converting info pages.</para> converting info pages.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>14.7 MB</seg></seglistitem>
<seglistitem>
<seg>0.2 SBU</seg>
<seg>14.7 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils,
Diffutils, GCC, Gettext, Glibc, Grep, Make, Ncurses, and Sed</seg></seglistitem> <seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc,
Grep, Make, Ncurses, and Sed</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
<title>Installation of Texinfo</title> <title>Installation of Texinfo</title>
<para>The <command>info</command> program makes assumptions such as that <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 a string occupies the same number of character cells on the screen and
in memory and that one can break the string anywhere, which fail in bytes in memory and that one can break the string anywhere, which fail
UTF-8 based locales. The patch below makes them valid in UTF-8 based locales. The patch below makes them valid by falling back
by falling back to English messages when a multibyte locale is in use:</para> to English messages when a multibyte locale is in use:</para>
<screen><userinput>patch -Np1 -i ../&texinfo-multibyte-patch;</userinput></screen> <screen><userinput>patch -Np1 -i ../&texinfo-multibyte-patch;</userinput></screen>
@ -57,30 +72,32 @@ attack on temporary files. Apply the following patch to fix this:</para>
<screen><userinput>make install</userinput></screen> <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> <screen><userinput>make TEXMF=/usr/share/texmf install-tex</userinput></screen>
<para>The meaning of the make parameter:</para>
<variablelist> <variablelist>
<title>The meaning of the make parameter:</title>
<varlistentry> <varlistentry>
<term><parameter>TEXMF=/usr/share/texmf</parameter></term> <term><parameter>TEXMF=/usr/share/texmf</parameter></term>
<listitem><para>The <envar>TEXMF</envar> makefile variable holds the location of the <listitem>
root of the TeX tree if, for example, a TeX package will be installed <para>The <envar>TEXMF</envar> makefile variable holds the location
later.</para></listitem> of the root of the TeX tree if, for example, a TeX package will be
installed later.</para>
</listitem>
</varlistentry> </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 </variablelist>
list of menu entries. The file is located at
<filename>/usr/share/info/dir</filename>. Unfortunately, due to <para>The Info documentation system uses a plain text file to hold its list of
occasional problems in the Makefiles of various packages, it can menu entries. The file is located at <filename>/usr/share/info/dir</filename>.
sometimes get out of sync with the info pages installed on the Unfortunately, due to occasional problems in the Makefiles of various packages,
system. If the <filename>/usr/share/info/dir</filename> file ever it can sometimes get out of sync with the info pages installed on the system.
needs to be recreated, the following optional commands will accomplish If the <filename>/usr/share/info/dir</filename> file ever needs to be
the task:</para> recreated, the following optional commands will accomplish the task:</para>
<screen role="nodump"><userinput>cd /usr/share/info <screen role="nodump"><userinput>cd /usr/share/info
rm dir rm dir
@ -90,25 +107,33 @@ done</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-texinfo" role="content"><title>Contents of Texinfo</title> <sect2 id="contents-texinfo" role="content">
<title>Contents of Texinfo</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<seglistitem><seg>info, infokey, install-info,
makeinfo, texi2dvi, texi2pdf, and texindex</seg></seglistitem> <seglistitem>
<seg>info, infokey, install-info, makeinfo, texi2dvi, texi2pdf, and
texindex</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
<varlistentry id="info"> <varlistentry id="info">
<term><command>info</command></term> <term><command>info</command></term>
<listitem> <listitem>
<para>Used to read info pages which are similar to man pages, but often go much <para>Used to read info pages which are similar to man pages, but
deeper than just explaining all the available command line options. For example, often go much deeper than just explaining all the available command
compare <command>man bison</command> and <command>info bison</command>.</para> line options. For example, compare <command>man bison</command> and
<indexterm zone="ch-system-texinfo info"><primary sortas="b-info">info</primary></indexterm> <command>info bison</command>.</para>
<indexterm zone="ch-system-texinfo info">
<primary sortas="b-info">info</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -117,7 +142,9 @@ compare <command>man bison</command> and <command>info bison</command>.</para>
<listitem> <listitem>
<para>Compiles a source file containing Info customizations into a <para>Compiles a source file containing Info customizations into a
binary format</para> binary format</para>
<indexterm zone="ch-system-texinfo infokey"><primary sortas="b-infokey">infokey</primary></indexterm> <indexterm zone="ch-system-texinfo infokey">
<primary sortas="b-infokey">infokey</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -126,7 +153,9 @@ binary format</para>
<listitem> <listitem>
<para>Used to install info pages; it updates entries in the <para>Used to install info pages; it updates entries in the
<command>info</command> index file</para> <command>info</command> index file</para>
<indexterm zone="ch-system-texinfo install-info"><primary sortas="b-install-info">install-info</primary></indexterm> <indexterm zone="ch-system-texinfo install-info">
<primary sortas="b-install-info">install-info</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -135,7 +164,9 @@ binary format</para>
<listitem> <listitem>
<para>Translates the given Texinfo source documents into <para>Translates the given Texinfo source documents into
info pages, plain text, or HTML</para> info pages, plain text, or HTML</para>
<indexterm zone="ch-system-texinfo makeinfo"><primary sortas="b-makeinfo">makeinfo</primary></indexterm> <indexterm zone="ch-system-texinfo makeinfo">
<primary sortas="b-makeinfo">makeinfo</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -144,7 +175,9 @@ info pages, plain text, or HTML</para>
<listitem> <listitem>
<para>Used to format the given Texinfo document into a <para>Used to format the given Texinfo document into a
device-independent file that can be printed</para> device-independent file that can be printed</para>
<indexterm zone="ch-system-texinfo texi2dvi"><primary sortas="b-texi2dvi">texi2dvi</primary></indexterm> <indexterm zone="ch-system-texinfo texi2dvi">
<primary sortas="b-texi2dvi">texi2dvi</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -153,7 +186,9 @@ device-independent file that can be printed</para>
<listitem> <listitem>
<para>Used to format the given Texinfo document into a <para>Used to format the given Texinfo document into a
Portable Document Format (PDF) file</para> Portable Document Format (PDF) file</para>
<indexterm zone="ch-system-texinfo texi2pdf"><primary sortas="b-texi2pdf">texi2pdf</primary></indexterm> <indexterm zone="ch-system-texinfo texi2pdf">
<primary sortas="b-texi2pdf">texi2pdf</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -161,12 +196,14 @@ Portable Document Format (PDF) file</para>
<term><command>texindex</command></term> <term><command>texindex</command></term>
<listitem> <listitem>
<para>Used to sort Texinfo index files</para> <para>Used to sort Texinfo index files</para>
<indexterm zone="ch-system-texinfo texindex"><primary sortas="b-texindex">texindex</primary></indexterm> <indexterm zone="ch-system-texinfo texindex">
<primary sortas="b-texindex">texindex</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

173
chapter06/udev.xml
View File

@ -1,26 +1,41 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-udev" role="wrap"> <sect1 id="ch-system-udev" role="wrap">
<title>Udev-&udev-version;</title>
<?dbhtml filename="udev.html"?> <?dbhtml filename="udev.html"?>
<indexterm zone="ch-system-udev"><primary sortas="a-Udev">Udev</primary></indexterm> <title>Udev-&udev-version;</title>
<sect2 role="package"><title/> <indexterm zone="ch-system-udev">
<para>The Udev package contains programs for dynamic creation of device nodes.</para> <primary sortas="a-Udev">Udev</primary>
</indexterm>
<sect2 role="package">
<title/>
<para>The Udev package contains programs for dynamic creation of device
nodes.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>3.8 MB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>3.8 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Coreutils and Make</seg></seglistitem>
<seglistitem>
<seg>Coreutils and Make</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
@ -32,19 +47,18 @@
<screen><userinput>make EXTRAS=extras/run_directory</userinput></screen> <screen><userinput>make EXTRAS=extras/run_directory</userinput></screen>
<para>The meaning of the make option:</para>
<variablelist> <variablelist>
<title>The meaning of the make option:</title>
<varlistentry> <varlistentry>
<term><parameter>EXTRAS=extras/run_directory</parameter> <term><parameter>EXTRAS=extras/run_directory</parameter></term>
</term>
<listitem> <listitem>
<para>This builds the <command>udev_run_devd</command> and <para>This builds the <command>udev_run_devd</command> and
<command>udev_run_hotplugd</command> binaries, which are required for <command>udev_run_hotplugd</command> binaries, which are required
correct handling of hotpluggable devices. for correct handling of hotpluggable devices.</para>
</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>To test the results, issue: <para>To test the results, issue:
@ -54,19 +68,18 @@
<screen><userinput>make DESTDIR=/ EXTRAS=extras/run_directory install</userinput></screen> <screen><userinput>make DESTDIR=/ EXTRAS=extras/run_directory install</userinput></screen>
<para>The meaning of the make option:</para>
<variablelist> <variablelist>
<title>The meaning of the make parameter:</title>
<varlistentry> <varlistentry>
<term><parameter>DESTDIR=/</parameter> <term><parameter>DESTDIR=/</parameter></term>
</term>
<listitem> <listitem>
<para>This prevents the Udev build process from killing any <para>This prevents the Udev build process from killing any
<command>udevd</command> processes that may be running on the host <command>udevd</command> processes that may be running on the
system. host system.</para>
</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Udev's configuration is far from ideal by default, so install <para>Udev's configuration is far from ideal by default, so install
@ -87,36 +100,43 @@ complement of device nodes.</para>
</sect2> </sect2>
<sect2 id="contents-udev" role="content"><title>Contents of Udev</title> <sect2 id="contents-udev" role="content">
<title>Contents of Udev</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<segtitle>Installed directory</segtitle> <segtitle>Installed directory</segtitle>
<seglistitem><seg>udev, udev_run_devd, udev_run_hotplugd, udevcontrol, udevd,
<seglistitem>
<seg>udev, udev_run_devd, udev_run_hotplugd, udevcontrol, udevd,
udevinfo, udevmonitor, udevsend, udevstart, and udevtest</seg> udevinfo, udevmonitor, udevsend, udevstart, and udevtest</seg>
<seg>/etc/udev</seg></seglistitem> <seg>/etc/udev</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
<varlistentry id="udev"> <varlistentry id="udev">
<term><command>udev</command></term> <term><command>udev</command></term>
<listitem> <listitem>
<para>Creates device nodes in <filename <para>Creates device nodes in <filename class="directory">/dev</filename>
class="directory">/dev</filename> or renames network interfaces (not or renames network interfaces (not in LFS) in response to hotplug
in LFS) in response to hotplug events</para> events</para>
<indexterm zone="ch-system-udev udev"><primary sortas="b-udev">udev</primary></indexterm> <indexterm zone="ch-system-udev udev">
</listitem></varlistentry> <primary sortas="b-udev">udev</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="udev_run_devd"> <varlistentry id="udev_run_devd">
<term><command>udev_run_devd</command></term> <term><command>udev_run_devd</command></term>
<listitem> <listitem>
<para>Executes programs and scripts in the <para>Executes programs and scripts in the <filename
<filename class="directory">/etc/dev.d/</filename> directory in response class="directory">/etc/dev.d/</filename> directory in response to
to hotplug events hotplug events</para>
</para>
<indexterm zone="ch-system-udev udev_run_devd"> <indexterm zone="ch-system-udev udev_run_devd">
<primary sortas="b-udev_run_devd">udev_run_devd</primary> <primary sortas="b-udev_run_devd">udev_run_devd</primary>
</indexterm> </indexterm>
@ -126,10 +146,9 @@ in LFS) in response to hotplug events</para>
<varlistentry id="udev_run_hotplugd"> <varlistentry id="udev_run_hotplugd">
<term><command>udev_run_hotplugd</command></term> <term><command>udev_run_hotplugd</command></term>
<listitem> <listitem>
<para>Executes programs and scripts in the <para>Executes programs and scripts in the <filename
<filename class="directory">/etc/hotplug.d/</filename> directory in class="directory">/etc/hotplug.d/</filename> directory in response
response to hotplug events to hotplug events</para>
</para>
<indexterm zone="ch-system-udev udev_run_hotplugd"> <indexterm zone="ch-system-udev udev_run_hotplugd">
<primary sortas="b-udev_run_hotplugd">udev_run_hotplugd</primary> <primary sortas="b-udev_run_hotplugd">udev_run_hotplugd</primary>
</indexterm> </indexterm>
@ -139,20 +158,24 @@ in LFS) in response to hotplug events</para>
<varlistentry id="udevcontrol"> <varlistentry id="udevcontrol">
<term><command>udevcontrol</command></term> <term><command>udevcontrol</command></term>
<listitem> <listitem>
<para>Configures a number of options for the running <command>udevd</command> <para>Configures a number of options for the running
daemon, such as the log level.</para> <command>udevd</command> daemon, such as the log level.</para>
<indexterm zone="ch-system-udev udevcontrol"><primary sortas="b-udevcontrol">udevcontrol</primary> <indexterm zone="ch-system-udev udevcontrol">
<primary sortas="b-udevcontrol">udevcontrol</primary>
</indexterm> </indexterm>
</listitem></varlistentry> </listitem>
</varlistentry>
<varlistentry id="udevd"> <varlistentry id="udevd">
<term><command>udevd</command></term> <term><command>udevd</command></term>
<listitem> <listitem>
<para>A daemon that reorders hotplug events before submitting them to <para>A daemon that reorders hotplug events before submitting them to
<command>udev</command>, <command>udev</command>, thus avoiding various race conditions</para>
thus avoiding various race conditions</para> <indexterm zone="ch-system-udev udevd">
<indexterm zone="ch-system-udev udevd"><primary sortas="b-udevd">udevd</primary></indexterm> <primary sortas="b-udevd">udevd</primary>
</listitem></varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="udevinfo"> <varlistentry id="udevinfo">
<term><command>udevinfo</command></term> <term><command>udevinfo</command></term>
@ -162,35 +185,45 @@ information on any device currently present on the system; it also
provides a way to query any device in the <systemitem provides a way to query any device in the <systemitem
class="filesystem">sysfs</systemitem> tree to help create udev class="filesystem">sysfs</systemitem> tree to help create udev
rules</para> rules</para>
<indexterm zone="ch-system-udev udevinfo"><primary sortas="b-udevinfo">udevinfo</primary></indexterm> <indexterm zone="ch-system-udev udevinfo">
</listitem></varlistentry> <primary sortas="b-udevinfo">udevinfo</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="udevmonitor"> <varlistentry id="udevmonitor">
<term><command>udevmonitor</command></term> <term><command>udevmonitor</command></term>
<listitem> <listitem>
<para>Prints the event received from the kernel and the event which <para>Prints the event received from the kernel and the event which
<command>udev</command> sends out after rule processing</para> <command>udev</command> sends out after rule processing</para>
<indexterm zone="ch-system-udev udevmonitor"><primary sortas="b-udevmonitor">udevmonitor</primary> <indexterm zone="ch-system-udev udevmonitor">
<primary sortas="b-udevmonitor">udevmonitor</primary>
</indexterm> </indexterm>
</listitem></varlistentry> </listitem>
</varlistentry>
<varlistentry id="udevsend"> <varlistentry id="udevsend">
<term><command>udevsend</command></term> <term><command>udevsend</command></term>
<listitem> <listitem>
<para>Delivers hotplug events to <command>udevd</command></para> <para>Delivers hotplug events to <command>udevd</command></para>
<indexterm zone="ch-system-udev udevsend"><primary sortas="b-udevsend">udevsend</primary></indexterm> <indexterm zone="ch-system-udev udevsend">
</listitem></varlistentry> <primary sortas="b-udevsend">udevsend</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="udevstart"> <varlistentry id="udevstart">
<term><command>udevstart</command></term> <term><command>udevstart</command></term>
<listitem> <listitem>
<para>Creates device nodes in <filename <para>Creates device nodes in <filename class="directory">/dev</filename>
class="directory">/dev</filename> that correspond to drivers compiled directly that correspond to drivers compiled directly into the kernel; it
into the kernel; it performs that task by simulating hotplug events presumably performs that task by simulating hotplug events presumably dropped by
dropped by the kernel before invocation of this program (e.g., because the root the kernel before invocation of this program (e.g., because the root
filesystem has not been mounted) and submitting such synthetic hotplug events filesystem has not been mounted) and submitting such synthetic hotplug
to <command>udev</command></para> events to <command>udev</command></para>
<indexterm zone="ch-system-udev udevstart"><primary sortas="b-udevstart">udevstart</primary></indexterm> <indexterm zone="ch-system-udev udevstart">
<primary sortas="b-udevstart">udevstart</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -198,20 +231,28 @@ to <command>udev</command></para>
<term><command>udevtest</command></term> <term><command>udevtest</command></term>
<listitem> <listitem>
<para>Simulates a <command>udev</command> run for the given device, <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 and prints out the name of the node the real <command>udev</command>
have created or (not in LFS) the name of the renamed network interface</para> would have created or (not in LFS) the name of the renamed network
<indexterm zone="ch-system-udev udevtest"><primary sortas="b-udevtest">udevtest</primary></indexterm> interface</para>
</listitem></varlistentry> <indexterm zone="ch-system-udev udevtest">
<primary sortas="b-udevtest">udevtest</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="etc-udev"> <varlistentry id="etc-udev">
<term><filename class="directory">/etc/udev</filename></term> <term><filename class="directory">/etc/udev</filename></term>
<listitem> <listitem>
<para>Contains <command>udev</command> configuation files, <para>Contains <command>udev</command> configuation files,
device permissions, and rules for device naming</para> device permissions, and rules for device naming</para>
<indexterm zone="ch-system-udev etc-udev"><primary sortas="e-/etc/udev">/etc/udev</primary></indexterm> <indexterm zone="ch-system-udev etc-udev">
</listitem></varlistentry> <primary sortas="e-/etc/udev">/etc/udev</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

351
chapter06/util-linux.xml
View File

@ -1,15 +1,22 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-util-linux" role="wrap"> <sect1 id="ch-system-util-linux" role="wrap">
<title>Util-linux-&util-linux-version;</title>
<?dbhtml filename="util-linux.html"?> <?dbhtml filename="util-linux.html"?>
<indexterm zone="ch-system-util-linux"><primary sortas="a-Util-linux">Util-linux</primary></indexterm> <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/>
<sect2 role="package"><title/>
<para>The Util-linux package contains miscellaneous utility programs. Among <para>The Util-linux package contains miscellaneous utility programs. Among
them are utilities for handling file systems, consoles, partitions, and them are utilities for handling file systems, consoles, partitions, and
messages.</para> messages.</para>
@ -17,14 +24,22 @@ messages.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>11.6 MB</seg></seglistitem>
<seglistitem>
<seg>0.2 SBU</seg>
<seg>11.6 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils,
Diffutils, GCC, Gettext, Glibc, Grep, Make, Ncurses, Sed, and Zlib</seg></seglistitem> <seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc,
Grep, Make, Ncurses, Sed, and Zlib</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
@ -59,22 +74,26 @@ The following patch properly fixes this issue:</para>
<screen><userinput>make HAVE_KILL=yes HAVE_SLN=yes</userinput></screen> <screen><userinput>make HAVE_KILL=yes HAVE_SLN=yes</userinput></screen>
<para>The meaning of the make parameters:</para>
<variablelist> <variablelist>
<title>The meaning of the make parameters:</title>
<varlistentry> <varlistentry>
<term><parameter>HAVE_KILL=yes</parameter></term> <term><parameter>HAVE_KILL=yes</parameter></term>
<listitem><para>This prevents the <listitem>
<command>kill</command> program (already installed by Procps) from being <para>This prevents the <command>kill</command> program (already
built and installed again.</para></listitem> installed by Procps) from being built and installed again.</para>
</listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><parameter>HAVE_SLN=yes</parameter></term> <term><parameter>HAVE_SLN=yes</parameter></term>
<listitem><para>This prevents the <command>sln</command> program (a <listitem>
<para>This prevents the <command>sln</command> program (a
statically linked version of <command>ln</command> already installed statically linked version of <command>ln</command> already installed
by Glibc) from being built and installed again.</para></listitem> by Glibc) from being built and installed again.</para>
</listitem>
</varlistentry> </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>
@ -88,21 +107,27 @@ mv /usr/bin/logger /bin</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-utillinux" role="content"><title>Contents of Util-linux</title> <sect2 id="contents-utillinux" role="content">
<title>Contents of Util-linux</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<seglistitem><seg>agetty, arch, blockdev, cal, cfdisk, chkdupexe, col, colcrt,
colrm, column, ctrlaltdel, cytune, ddate, dmesg, elvtune, fdformat, fdisk, <seglistitem>
fsck.cramfs, fsck.minix, getopt, hexdump, hwclock, ipcrm, ipcs, isosize, line, <seg>agetty, arch, blockdev, cal, cfdisk, chkdupexe, col, colcrt,
logger, look, losetup, mcookie, mkfs, mkfs.bfs, mkfs.cramfs, mkfs.minix, mkswap, colrm, column, ctrlaltdel, cytune, ddate, dmesg, elvtune, fdformat,
more, mount, namei, pg, pivot_root, ramsize (link to rdev), raw, rdev, readprofile, fdisk, fsck.cramfs, fsck.minix, getopt, hexdump, hwclock, ipcrm,
rename, renice, rev, rootflags (link to rdev), script, setfdprm, setsid, setterm, ipcs, isosize, line, logger, look, losetup, mcookie, mkfs, mkfs.bfs,
sfdisk, swapdev, swapoff (link to swapon), swapon, tunelp, ul, umount, vidmode (link to rdev), mkfs.cramfs, mkfs.minix, mkswap, more, mount, namei, pg, pivot_root,
whereis, and write</seg></seglistitem> 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> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
@ -111,7 +136,9 @@ whereis, and write</seg></seglistitem>
<listitem> <listitem>
<para>Opens a tty port, prompts for a login name, <para>Opens a tty port, prompts for a login name,
and then invokes the <command>login</command> program</para> and then invokes the <command>login</command> program</para>
<indexterm zone="ch-system-util-linux agetty"><primary sortas="b-agetty">agetty</primary></indexterm> <indexterm zone="ch-system-util-linux agetty">
<primary sortas="b-agetty">agetty</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -119,15 +146,20 @@ and then invokes the <command>login</command> program</para>
<term><command>arch</command></term> <term><command>arch</command></term>
<listitem> <listitem>
<para>Reports the machine's architecture</para> <para>Reports the machine's architecture</para>
<indexterm zone="ch-system-util-linux arch"><primary sortas="b-arch">arch</primary></indexterm> <indexterm zone="ch-system-util-linux arch">
<primary sortas="b-arch">arch</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="blockdev"> <varlistentry id="blockdev">
<term><command>blockdev</command></term> <term><command>blockdev</command></term>
<listitem> <listitem>
<para>Allows users to call block device ioctls from the command line</para> <para>Allows users to call block device ioctls from the command
<indexterm zone="ch-system-util-linux blockdev"><primary sortas="b-blockdev">blockdev</primary></indexterm> line</para>
<indexterm zone="ch-system-util-linux blockdev">
<primary sortas="b-blockdev">blockdev</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -135,7 +167,9 @@ and then invokes the <command>login</command> program</para>
<term><command>cal</command></term> <term><command>cal</command></term>
<listitem> <listitem>
<para>Displays a simple calendar</para> <para>Displays a simple calendar</para>
<indexterm zone="ch-system-util-linux cal"><primary sortas="b-cal">cal</primary></indexterm> <indexterm zone="ch-system-util-linux cal">
<primary sortas="b-cal">cal</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -143,7 +177,9 @@ and then invokes the <command>login</command> program</para>
<term><command>cfdisk</command></term> <term><command>cfdisk</command></term>
<listitem> <listitem>
<para>Manipulates the partition table of the given device</para> <para>Manipulates the partition table of the given device</para>
<indexterm zone="ch-system-util-linux cfdisk"><primary sortas="b-cfdisk">cfdisk</primary></indexterm> <indexterm zone="ch-system-util-linux cfdisk">
<primary sortas="b-cfdisk">cfdisk</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -151,7 +187,9 @@ and then invokes the <command>login</command> program</para>
<term><command>chkdupexe</command></term> <term><command>chkdupexe</command></term>
<listitem> <listitem>
<para>Finds duplicate executables</para> <para>Finds duplicate executables</para>
<indexterm zone="ch-system-util-linux chkdupexe"><primary sortas="b-chkdupexe">chkdupexe</primary></indexterm> <indexterm zone="ch-system-util-linux chkdupexe">
<primary sortas="b-chkdupexe">chkdupexe</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -159,7 +197,9 @@ and then invokes the <command>login</command> program</para>
<term><command>col</command></term> <term><command>col</command></term>
<listitem> <listitem>
<para>Filters out reverse line feeds</para> <para>Filters out reverse line feeds</para>
<indexterm zone="ch-system-util-linux col"><primary sortas="b-col">col</primary></indexterm> <indexterm zone="ch-system-util-linux col">
<primary sortas="b-col">col</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -168,7 +208,9 @@ and then invokes the <command>login</command> program</para>
<listitem> <listitem>
<para>Filters <command>nroff</command> output for terminals <para>Filters <command>nroff</command> output for terminals
that lack some capabilities, such as overstriking and half-lines</para> 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> <indexterm zone="ch-system-util-linux colcrt">
<primary sortas="b-colcrt">colcrt</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -176,7 +218,9 @@ that lack some capabilities, such as overstriking and half-lines</para>
<term><command>colrm</command></term> <term><command>colrm</command></term>
<listitem> <listitem>
<para>Filters out the given columns</para> <para>Filters out the given columns</para>
<indexterm zone="ch-system-util-linux colrm"><primary sortas="b-colrm">colrm</primary></indexterm> <indexterm zone="ch-system-util-linux colrm">
<primary sortas="b-colrm">colrm</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -184,16 +228,20 @@ that lack some capabilities, such as overstriking and half-lines</para>
<term><command>column</command></term> <term><command>column</command></term>
<listitem> <listitem>
<para>Formats a given file into multiple columns</para> <para>Formats a given file into multiple columns</para>
<indexterm zone="ch-system-util-linux column"><primary sortas="b-column">column</primary></indexterm> <indexterm zone="ch-system-util-linux column">
<primary sortas="b-column">column</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="ctrlaltdel"> <varlistentry id="ctrlaltdel">
<term><command>ctrlaltdel</command></term> <term><command>ctrlaltdel</command></term>
<listitem> <listitem>
<para>Sets the function of the Ctrl+Alt+Del key combination to a hard or a <para>Sets the function of the Ctrl+Alt+Del key combination to a
soft reset</para> hard or a soft reset</para>
<indexterm zone="ch-system-util-linux ctrlaltdel"><primary sortas="b-ctrlaltdel">ctrlaltdel</primary></indexterm> <indexterm zone="ch-system-util-linux ctrlaltdel">
<primary sortas="b-ctrlaltdel">ctrlaltdel</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -202,7 +250,9 @@ soft reset</para>
<listitem> <listitem>
<para>Tunes the parameters of the serial line drivers for <para>Tunes the parameters of the serial line drivers for
Cyclades cards</para> Cyclades cards</para>
<indexterm zone="ch-system-util-linux cytune"><primary sortas="b-cytune">cytune</primary></indexterm> <indexterm zone="ch-system-util-linux cytune">
<primary sortas="b-cytune">cytune</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -211,7 +261,9 @@ Cyclades cards</para>
<listitem> <listitem>
<para>Gives the Discordian date or converts the given Gregorian date <para>Gives the Discordian date or converts the given Gregorian date
to a Discordian one</para> to a Discordian one</para>
<indexterm zone="ch-system-util-linux ddate"><primary sortas="b-ddate">ddate</primary></indexterm> <indexterm zone="ch-system-util-linux ddate">
<primary sortas="b-ddate">ddate</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -219,7 +271,9 @@ to a Discordian one</para>
<term><command>dmesg</command></term> <term><command>dmesg</command></term>
<listitem> <listitem>
<para>Dumps the kernel boot messages</para> <para>Dumps the kernel boot messages</para>
<indexterm zone="ch-system-util-linux dmesg"><primary sortas="b-dmesg">dmesg</primary></indexterm> <indexterm zone="ch-system-util-linux dmesg">
<primary sortas="b-dmesg">dmesg</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -228,7 +282,9 @@ to a Discordian one</para>
<listitem> <listitem>
<para>Tunes the performance and interactivity of a block <para>Tunes the performance and interactivity of a block
device</para> device</para>
<indexterm zone="ch-system-util-linux elvtune"><primary sortas="b-elvtune">elvtune</primary></indexterm> <indexterm zone="ch-system-util-linux elvtune">
<primary sortas="b-elvtune">elvtune</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -236,7 +292,9 @@ device</para>
<term><command>fdformat</command></term> <term><command>fdformat</command></term>
<listitem> <listitem>
<para>Low-level formats a floppy disk</para> <para>Low-level formats a floppy disk</para>
<indexterm zone="ch-system-util-linux fdformat"><primary sortas="b-fdformat">fdformat</primary></indexterm> <indexterm zone="ch-system-util-linux fdformat">
<primary sortas="b-fdformat">fdformat</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -244,7 +302,9 @@ device</para>
<term><command>fdisk</command></term> <term><command>fdisk</command></term>
<listitem> <listitem>
<para>Manipulates the partition table of the given device</para> <para>Manipulates the partition table of the given device</para>
<indexterm zone="ch-system-util-linux fdisk"><primary sortas="b-fdisk">fdisk</primary></indexterm> <indexterm zone="ch-system-util-linux fdisk">
<primary sortas="b-fdisk">fdisk</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -253,7 +313,9 @@ device</para>
<listitem> <listitem>
<para>Performs a consistency check on the Cramfs file system on the <para>Performs a consistency check on the Cramfs file system on the
given device</para> given device</para>
<indexterm zone="ch-system-util-linux fsck.cramfs"><primary sortas="b-fsck.cramfs">fsck.cramfs</primary></indexterm> <indexterm zone="ch-system-util-linux fsck.cramfs">
<primary sortas="b-fsck.cramfs">fsck.cramfs</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -262,7 +324,9 @@ given device</para>
<listitem> <listitem>
<para>Performs a consistency check on the Minix file system on the <para>Performs a consistency check on the Minix file system on the
given device</para> given device</para>
<indexterm zone="ch-system-util-linux fsck.minix"><primary sortas="b-fsck.minix">fsck.minix</primary></indexterm> <indexterm zone="ch-system-util-linux fsck.minix">
<primary sortas="b-fsck.minix">fsck.minix</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -270,15 +334,20 @@ given device</para>
<term><command>getopt</command></term> <term><command>getopt</command></term>
<listitem> <listitem>
<para>Parses options in the given command line</para> <para>Parses options in the given command line</para>
<indexterm zone="ch-system-util-linux getopt"><primary sortas="b-getopt">getopt</primary></indexterm> <indexterm zone="ch-system-util-linux getopt">
<primary sortas="b-getopt">getopt</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="hexdump"> <varlistentry id="hexdump">
<term><command>hexdump</command></term> <term><command>hexdump</command></term>
<listitem> <listitem>
<para>Dumps the given file in hexadecimal or in another given format</para> <para>Dumps the given file in hexadecimal or in another given
<indexterm zone="ch-system-util-linux hexdump"><primary sortas="b-hexdump">hexdump</primary></indexterm> format</para>
<indexterm zone="ch-system-util-linux hexdump">
<primary sortas="b-hexdump">hexdump</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -288,7 +357,9 @@ given device</para>
<para>Reads or sets the system's hardware clock, also called <para>Reads or sets the system's hardware clock, also called
the Real-Time Clock (RTC) or Basic Input-Output System (BIOS) the Real-Time Clock (RTC) or Basic Input-Output System (BIOS)
clock</para> clock</para>
<indexterm zone="ch-system-util-linux hwclock"><primary sortas="b-hwclock">hwclock</primary></indexterm> <indexterm zone="ch-system-util-linux hwclock">
<primary sortas="b-hwclock">hwclock</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -296,7 +367,9 @@ clock</para>
<term><command>ipcrm</command></term> <term><command>ipcrm</command></term>
<listitem> <listitem>
<para>Removes the given Inter-Process Communication (IPC) resource</para> <para>Removes the given Inter-Process Communication (IPC) resource</para>
<indexterm zone="ch-system-util-linux ipcrm"><primary sortas="b-ipcrm">ipcrm</primary></indexterm> <indexterm zone="ch-system-util-linux ipcrm">
<primary sortas="b-ipcrm">ipcrm</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -304,7 +377,9 @@ clock</para>
<term><command>ipcs</command></term> <term><command>ipcs</command></term>
<listitem> <listitem>
<para>Provides IPC status information</para> <para>Provides IPC status information</para>
<indexterm zone="ch-system-util-linux ipcs"><primary sortas="b-ipcs">ipcs</primary></indexterm> <indexterm zone="ch-system-util-linux ipcs">
<primary sortas="b-ipcs">ipcs</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -312,7 +387,9 @@ clock</para>
<term><command>isosize</command></term> <term><command>isosize</command></term>
<listitem> <listitem>
<para>Reports the size of an iso9660 file system</para> <para>Reports the size of an iso9660 file system</para>
<indexterm zone="ch-system-util-linux isosize"><primary sortas="b-isosize">isosize</primary></indexterm> <indexterm zone="ch-system-util-linux isosize">
<primary sortas="b-isosize">isosize</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -320,7 +397,9 @@ clock</para>
<term><command>line</command></term> <term><command>line</command></term>
<listitem> <listitem>
<para>Copies a single line</para> <para>Copies a single line</para>
<indexterm zone="ch-system-util-linux line"><primary sortas="b-line">line</primary></indexterm> <indexterm zone="ch-system-util-linux line">
<primary sortas="b-line">line</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -328,7 +407,9 @@ clock</para>
<term><command>logger</command></term> <term><command>logger</command></term>
<listitem> <listitem>
<para>Enters the given message into the system log</para> <para>Enters the given message into the system log</para>
<indexterm zone="ch-system-util-linux logger"><primary sortas="b-logger">logger</primary></indexterm> <indexterm zone="ch-system-util-linux logger">
<primary sortas="b-logger">logger</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -336,7 +417,9 @@ clock</para>
<term><command>look</command></term> <term><command>look</command></term>
<listitem> <listitem>
<para>Displays lines that begin with the given string</para> <para>Displays lines that begin with the given string</para>
<indexterm zone="ch-system-util-linux look"><primary sortas="b-look">look</primary></indexterm> <indexterm zone="ch-system-util-linux look">
<primary sortas="b-look">look</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -344,7 +427,9 @@ clock</para>
<term><command>losetup</command></term> <term><command>losetup</command></term>
<listitem> <listitem>
<para>Sets up and controls loop devices</para> <para>Sets up and controls loop devices</para>
<indexterm zone="ch-system-util-linux losetup"><primary sortas="b-losetup">losetup</primary></indexterm> <indexterm zone="ch-system-util-linux losetup">
<primary sortas="b-losetup">losetup</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -353,7 +438,9 @@ clock</para>
<listitem> <listitem>
<para>Generates magic cookies (128-bit random hexadecimal numbers) for <para>Generates magic cookies (128-bit random hexadecimal numbers) for
<command>xauth</command></para> <command>xauth</command></para>
<indexterm zone="ch-system-util-linux mcookie"><primary sortas="b-mcookie">mcookie</primary></indexterm> <indexterm zone="ch-system-util-linux mcookie">
<primary sortas="b-mcookie">mcookie</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -362,7 +449,9 @@ clock</para>
<listitem> <listitem>
<para>Builds a file system on a device (usually a hard disk <para>Builds a file system on a device (usually a hard disk
partition)</para> partition)</para>
<indexterm zone="ch-system-util-linux mkfs"><primary sortas="b-mkfs">mkfs</primary></indexterm> <indexterm zone="ch-system-util-linux mkfs">
<primary sortas="b-mkfs">mkfs</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -370,7 +459,9 @@ partition)</para>
<term><command>mkfs.bfs</command></term> <term><command>mkfs.bfs</command></term>
<listitem> <listitem>
<para>Creates a Santa Cruz Operations (SCO) bfs file system</para> <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> <indexterm zone="ch-system-util-linux mkfs.bfs">
<primary sortas="b-mkfs.bfs">mkfs.bfs</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -378,7 +469,9 @@ partition)</para>
<term><command>mkfs.cramfs</command></term> <term><command>mkfs.cramfs</command></term>
<listitem> <listitem>
<para>Creates a cramfs file system</para> <para>Creates a cramfs file system</para>
<indexterm zone="ch-system-util-linux mkfs.cramfs"><primary sortas="b-mkfs.cramfs">mkfs.cramfs</primary></indexterm> <indexterm zone="ch-system-util-linux mkfs.cramfs">
<primary sortas="b-mkfs.cramfs">mkfs.cramfs</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -386,15 +479,20 @@ partition)</para>
<term><command>mkfs.minix</command></term> <term><command>mkfs.minix</command></term>
<listitem> <listitem>
<para>Creates a Minix file system</para> <para>Creates a Minix file system</para>
<indexterm zone="ch-system-util-linux mkfs.minix"><primary sortas="b-mkfs.minix">mkfs.minix</primary></indexterm> <indexterm zone="ch-system-util-linux mkfs.minix">
<primary sortas="b-mkfs.minix">mkfs.minix</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="mkswap"> <varlistentry id="mkswap">
<term><command>mkswap</command></term> <term><command>mkswap</command></term>
<listitem> <listitem>
<para>Initializes the given device or file to be used as a swap area</para> <para>Initializes the given device or file to be used as a swap
<indexterm zone="ch-system-util-linux mkswap"><primary sortas="b-mkswap">mkswap</primary></indexterm> area</para>
<indexterm zone="ch-system-util-linux mkswap">
<primary sortas="b-mkswap">mkswap</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -402,7 +500,9 @@ partition)</para>
<term><command>more</command></term> <term><command>more</command></term>
<listitem> <listitem>
<para>A filter for paging through text one screen at a time</para> <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> <indexterm zone="ch-system-util-linux more">
<primary sortas="b-more">more</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -411,7 +511,9 @@ partition)</para>
<listitem> <listitem>
<para>Attaches the file system on the given device to a specified <para>Attaches the file system on the given device to a specified
directory in the file-system tree</para> directory in the file-system tree</para>
<indexterm zone="ch-system-util-linux mount"><primary sortas="b-mount">mount</primary></indexterm> <indexterm zone="ch-system-util-linux mount">
<primary sortas="b-mount">mount</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -419,7 +521,9 @@ directory in the file-system tree</para>
<term><command>namei</command></term> <term><command>namei</command></term>
<listitem> <listitem>
<para>Shows the symbolic links in the given pathnames</para> <para>Shows the symbolic links in the given pathnames</para>
<indexterm zone="ch-system-util-linux namei"><primary sortas="b-namei">namei</primary></indexterm> <indexterm zone="ch-system-util-linux namei">
<primary sortas="b-namei">namei</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -427,7 +531,9 @@ directory in the file-system tree</para>
<term><command>pg</command></term> <term><command>pg</command></term>
<listitem> <listitem>
<para>Displays a text file one screen full at a time</para> <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> <indexterm zone="ch-system-util-linux pg">
<primary sortas="b-pg">pg</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -436,7 +542,9 @@ directory in the file-system tree</para>
<listitem> <listitem>
<para>Makes the given file system the new root file system of the <para>Makes the given file system the new root file system of the
current process</para> current process</para>
<indexterm zone="ch-system-util-linux pivot_root"><primary sortas="b-pivot_root">pivot_root</primary></indexterm> <indexterm zone="ch-system-util-linux pivot_root">
<primary sortas="b-pivot_root">pivot_root</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -444,7 +552,9 @@ current process</para>
<term><command>ramsize</command></term> <term><command>ramsize</command></term>
<listitem> <listitem>
<para>Sets the size of the RAM disk in a bootable image</para> <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> <indexterm zone="ch-system-util-linux ramsize">
<primary sortas="b-ramsize">ramsize</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -453,7 +563,9 @@ current process</para>
<listitem> <listitem>
<para>Used to bind a Linux raw character device to a block <para>Used to bind a Linux raw character device to a block
device</para> device</para>
<indexterm zone="ch-system-util-linux raw"><primary sortas="b-raw">raw</primary></indexterm> <indexterm zone="ch-system-util-linux raw">
<primary sortas="b-raw">raw</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -462,7 +574,9 @@ device</para>
<listitem> <listitem>
<para>Queries and sets the root device, among other things, in a <para>Queries and sets the root device, among other things, in a
bootable image</para> bootable image</para>
<indexterm zone="ch-system-util-linux rdev"><primary sortas="b-rdev">rdev</primary></indexterm> <indexterm zone="ch-system-util-linux rdev">
<primary sortas="b-rdev">rdev</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -470,15 +584,20 @@ bootable image</para>
<term><command>readprofile</command></term> <term><command>readprofile</command></term>
<listitem> <listitem>
<para>Reads kernel profiling information</para> <para>Reads kernel profiling information</para>
<indexterm zone="ch-system-util-linux readprofile"><primary sortas="b-readprofile">readprofile</primary></indexterm> <indexterm zone="ch-system-util-linux readprofile">
<primary sortas="b-readprofile">readprofile</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="rename"> <varlistentry id="rename">
<term><command>rename</command></term> <term><command>rename</command></term>
<listitem> <listitem>
<para>Renames the given files, replacing a given string with another</para> <para>Renames the given files, replacing a given string with
<indexterm zone="ch-system-util-linux rename"><primary sortas="b-rename">rename</primary></indexterm> another</para>
<indexterm zone="ch-system-util-linux rename">
<primary sortas="b-rename">rename</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -486,7 +605,9 @@ bootable image</para>
<term><command>renice</command></term> <term><command>renice</command></term>
<listitem> <listitem>
<para>Alters the priority of running processes</para> <para>Alters the priority of running processes</para>
<indexterm zone="ch-system-util-linux renice"><primary sortas="b-renice">renice</primary></indexterm> <indexterm zone="ch-system-util-linux renice">
<primary sortas="b-renice">renice</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -494,7 +615,9 @@ bootable image</para>
<term><command>rev</command></term> <term><command>rev</command></term>
<listitem> <listitem>
<para>Reverses the lines of a given file</para> <para>Reverses the lines of a given file</para>
<indexterm zone="ch-system-util-linux rev"><primary sortas="b-rev">rev</primary></indexterm> <indexterm zone="ch-system-util-linux rev">
<primary sortas="b-rev">rev</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -502,7 +625,9 @@ bootable image</para>
<term><command>rootflags</command></term> <term><command>rootflags</command></term>
<listitem> <listitem>
<para>Sets the rootflags in a bootable image</para> <para>Sets the rootflags in a bootable image</para>
<indexterm zone="ch-system-util-linux rootflags"><primary sortas="b-rootflags">rootflags</primary></indexterm> <indexterm zone="ch-system-util-linux rootflags">
<primary sortas="b-rootflags">rootflags</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -510,7 +635,9 @@ bootable image</para>
<term><command>script</command></term> <term><command>script</command></term>
<listitem> <listitem>
<para>Makes a typescript of a terminal session</para> <para>Makes a typescript of a terminal session</para>
<indexterm zone="ch-system-util-linux script"><primary sortas="b-script">script</primary></indexterm> <indexterm zone="ch-system-util-linux script">
<primary sortas="b-script">script</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -518,7 +645,9 @@ bootable image</para>
<term><command>setfdprm</command></term> <term><command>setfdprm</command></term>
<listitem> <listitem>
<para>Sets user-provided floppy disk parameters</para> <para>Sets user-provided floppy disk parameters</para>
<indexterm zone="ch-system-util-linux setfdprm"><primary sortas="b-setfdprm">setfdprm</primary></indexterm> <indexterm zone="ch-system-util-linux setfdprm">
<primary sortas="b-setfdprm">setfdprm</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -526,7 +655,9 @@ bootable image</para>
<term><command>setsid</command></term> <term><command>setsid</command></term>
<listitem> <listitem>
<para>Runs the given program in a new session</para> <para>Runs the given program in a new session</para>
<indexterm zone="ch-system-util-linux setsid"><primary sortas="b-setsid">setsid</primary></indexterm> <indexterm zone="ch-system-util-linux setsid">
<primary sortas="b-setsid">setsid</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -534,7 +665,9 @@ bootable image</para>
<term><command>setterm</command></term> <term><command>setterm</command></term>
<listitem> <listitem>
<para>Sets terminal attributes</para> <para>Sets terminal attributes</para>
<indexterm zone="ch-system-util-linux setterm"><primary sortas="b-setterm">setterm</primary></indexterm> <indexterm zone="ch-system-util-linux setterm">
<primary sortas="b-setterm">setterm</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -542,7 +675,9 @@ bootable image</para>
<term><command>sfdisk</command></term> <term><command>sfdisk</command></term>
<listitem> <listitem>
<para>A disk partition table manipulator</para> <para>A disk partition table manipulator</para>
<indexterm zone="ch-system-util-linux sfdisk"><primary sortas="b-sfdisk">sfdisk</primary></indexterm> <indexterm zone="ch-system-util-linux sfdisk">
<primary sortas="b-sfdisk">sfdisk</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -550,7 +685,9 @@ bootable image</para>
<term><command>swapdev</command></term> <term><command>swapdev</command></term>
<listitem> <listitem>
<para>Sets the swap device in a bootable image</para> <para>Sets the swap device in a bootable image</para>
<indexterm zone="ch-system-util-linux swapdev"><primary sortas="b-swapdev">swapdev</primary></indexterm> <indexterm zone="ch-system-util-linux swapdev">
<primary sortas="b-swapdev">swapdev</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -558,16 +695,20 @@ bootable image</para>
<term><command>swapoff</command></term> <term><command>swapoff</command></term>
<listitem> <listitem>
<para>Disables devices and files for paging and swapping</para> <para>Disables devices and files for paging and swapping</para>
<indexterm zone="ch-system-util-linux swapoff"><primary sortas="b-swapoff">swapoff</primary></indexterm> <indexterm zone="ch-system-util-linux swapoff">
<primary sortas="b-swapoff">swapoff</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="swapon"> <varlistentry id="swapon">
<term><command>swapon</command></term> <term><command>swapon</command></term>
<listitem> <listitem>
<para>Enables devices and files for paging and swapping and lists the devices <para>Enables devices and files for paging and swapping and
and files currently in use</para> lists the devices and files currently in use</para>
<indexterm zone="ch-system-util-linux swapon"><primary sortas="b-swapon">swapon</primary></indexterm> <indexterm zone="ch-system-util-linux swapon">
<primary sortas="b-swapon">swapon</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -575,16 +716,20 @@ and files currently in use</para>
<term><command>tunelp</command></term> <term><command>tunelp</command></term>
<listitem> <listitem>
<para>Tunes the parameters of the line printer</para> <para>Tunes the parameters of the line printer</para>
<indexterm zone="ch-system-util-linux tunelp"><primary sortas="b-tunelp">tunelp</primary></indexterm> <indexterm zone="ch-system-util-linux tunelp">
<primary sortas="b-tunelp">tunelp</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="ul"> <varlistentry id="ul">
<term><command>ul</command></term> <term><command>ul</command></term>
<listitem> <listitem>
<para>A filter for translating underscores into <para>A filter for translating underscores into escape sequences
escape sequences indicating underlining for the terminal in use</para> indicating underlining for the terminal in use</para>
<indexterm zone="ch-system-util-linux ul"><primary sortas="b-ul">ul</primary></indexterm> <indexterm zone="ch-system-util-linux ul">
<primary sortas="b-ul">ul</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -592,7 +737,9 @@ escape sequences indicating underlining for the terminal in use</para>
<term><command>umount</command></term> <term><command>umount</command></term>
<listitem> <listitem>
<para>Disconnects a file system from the system's file tree</para> <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> <indexterm zone="ch-system-util-linux umount">
<primary sortas="b-umount">umount</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -600,7 +747,9 @@ escape sequences indicating underlining for the terminal in use</para>
<term><command>vidmode</command></term> <term><command>vidmode</command></term>
<listitem> <listitem>
<para>Sets the video mode in a bootable image</para> <para>Sets the video mode in a bootable image</para>
<indexterm zone="ch-system-util-linux vidmode"><primary sortas="b-vidmode">vidmode</primary></indexterm> <indexterm zone="ch-system-util-linux vidmode">
<primary sortas="b-vidmode">vidmode</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -609,21 +758,25 @@ escape sequences indicating underlining for the terminal in use</para>
<listitem> <listitem>
<para>Reports the location of the binary, source, and man page <para>Reports the location of the binary, source, and man page
for the given command</para> for the given command</para>
<indexterm zone="ch-system-util-linux whereis"><primary sortas="b-whereis">whereis</primary></indexterm> <indexterm zone="ch-system-util-linux whereis">
<primary sortas="b-whereis">whereis</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="write"> <varlistentry id="write">
<term><command>write</command></term> <term><command>write</command></term>
<listitem> <listitem>
<para>Sends a message to the given user <para>Sends a message to the given user <emphasis>if</emphasis> that
<emphasis>if</emphasis> that user has not disabled receipt of such messages</para> user has not disabled receipt of such messages</para>
<indexterm zone="ch-system-util-linux write"><primary sortas="b-write">write</primary></indexterm> <indexterm zone="ch-system-util-linux write">
<primary sortas="b-write">write</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

236
chapter06/vim.xml
View File

@ -1,35 +1,52 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-vim" role="wrap"> <sect1 id="ch-system-vim" role="wrap">
<title>Vim-&vim-version;</title>
<?dbhtml filename="vim.html"?> <?dbhtml filename="vim.html"?>
<indexterm zone="ch-system-vim"><primary sortas="a-Vim">Vim</primary></indexterm> <title>Vim-&vim-version;</title>
<indexterm zone="ch-system-vim">
<primary sortas="a-Vim">Vim</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Vim package contains a powerful text editor.</para> <para>The Vim package contains a powerful text editor.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.4 SBU</seg><seg>38.0 MB</seg></seglistitem>
<seglistitem>
<seg>0.4 SBU</seg>
<seg>38.0 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
GCC, Glibc, Grep, Make, Ncurses, and Sed</seg></seglistitem> <seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep, Make,
Ncurses, and Sed</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<tip> <tip>
<title>Alternatives to Vim</title> <title>Alternatives to Vim</title>
<para>If you prefer another editor&mdash;such as Emacs, Joe, or <para>If you prefer another editor&mdash;such as Emacs, Joe, or
Nano&mdash;please refer to <ulink url="&blfs-root;view/svn/postlfs/editors.html"/> Nano&mdash;please refer to <ulink
for suggested installation instructions.</para> url="&blfs-root;view/svn/postlfs/editors.html"/> for suggested
installation instructions.</para>
</tip> </tip>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
@ -48,18 +65,20 @@ class="directory">/etc</filename>:</para>
<screen><userinput>./configure --prefix=/usr --enable-multibyte</userinput></screen> <screen><userinput>./configure --prefix=/usr --enable-multibyte</userinput></screen>
<para>The meaning of the configure options:</para>
<variablelist> <variablelist>
<title>The meaning of the configure options:</title>
<varlistentry> <varlistentry>
<term><parameter>--enable-multibyte</parameter></term> <term><parameter>--enable-multibyte</parameter></term>
<listitem><para>This switch enables support for <listitem>
editing files in multibyte character encodings. This is needed if using a <para>This switch enables support for editing files in multibyte
locale with a multibyte character set. This switch is also helpful to be able to character encodings. This is needed if using a locale with a
edit text files initially created in Linux distributions like Fedora Core that multibyte character set. This switch is also helpful to be able
use UTF-8 as a default character set.</para> to edit text files initially created in Linux distributions like
Fedora Core that use UTF-8 as a default character set.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
<para>Compile the package:</para> <para>Compile the package:</para>
@ -75,12 +94,12 @@ redirecting the output to a log file.</para>
<screen><userinput>make install</userinput></screen> <screen><userinput>make install</userinput></screen>
<para>In UTF-8 locales, the <command>vimtutor</command> program <para>In UTF-8 locales, the <command>vimtutor</command> program tries to
tries to convert the tutorials from ISO-8859-1 to UTF-8. Since convert the tutorials from ISO-8859-1 to UTF-8. Since some tutorials are
some tutorials are not in ISO-8859-1, the text in them is thus made unreadable. not in ISO-8859-1, the text in them is thus made unreadable. If you
If you unpacked the <filename>vim-&vim-version;-lang.tar.gz</filename> unpacked the <filename>vim-&vim-version;-lang.tar.gz</filename> archive
archive and are going to use a UTF-8 based locale, remove non-ISO-8859-1 and are going to use a UTF-8 based locale, remove non-ISO-8859-1 tutorials.
tutorials. An English tutorial will be used instead.</para> An English tutorial will be used instead.</para>
<!-- Removal is used instead of conversion in order for the user to be able to <!-- Removal is used instead of conversion in order for the user to be able to
painlessly revert his UTF-8 locale choice. --> painlessly revert his UTF-8 locale choice. -->
@ -94,10 +113,10 @@ symlink:</para>
<screen><userinput>ln -sv vim /usr/bin/vi</userinput></screen> <screen><userinput>ln -sv vim /usr/bin/vi</userinput></screen>
<para>By default, Vim's documentation is installed in <para>By default, Vim's documentation is installed in <filename
<filename class="directory">/usr/share/vim</filename>. The following symlink class="directory">/usr/share/vim</filename>. The following symlink
allows the documentation to be accessed via allows the documentation to be accessed via <filename
<filename class="directory">/usr/share/doc/vim-&vim-version;</filename>, making class="directory">/usr/share/doc/vim-&vim-version;</filename>, making
it consistent with the location of documentation for other packages:</para> 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> <screen><userinput>ln -sv ../vim/vim64/doc /usr/share/doc/vim-&vim-version;</userinput></screen>
@ -112,17 +131,21 @@ url="&blfs-root;view/svn/postlfs/editors.html#postlfs-editors-vim"/>.</para>
</sect2> </sect2>
<sect2 id="conf-vim" role="configuration"><title>Configuring Vim</title> <sect2 id="conf-vim" role="configuration">
<indexterm zone="conf-vim"><primary sortas="e-/etc/vimrc">/etc/vimrc</primary></indexterm> <title>Configuring Vim</title>
<para>By default, <command>vim</command> runs in vi-incompatible mode. This may <indexterm zone="conf-vim">
be new to users who have used other editors in the past. The <primary sortas="e-/etc/vimrc">/etc/vimrc</primary>
<quote>nocompatible</quote> setting is included below to highlight the fact that </indexterm>
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 <para>By default, <command>vim</command> runs in vi-incompatible mode.
configuration file. This is necessary because it changes other settings, and This may be new to users who have used other editors in the past. The
overrides must come after this setting. Create a default <command>vim</command> <quote>nocompatible</quote> setting is included below to highlight the
configuration file by running the following:</para> 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 &gt; /etc/vimrc &lt;&lt; "EOF" <screen><userinput>cat &gt; /etc/vimrc &lt;&lt; "EOF"
<literal>" Begin /etc/vimrc <literal>" Begin /etc/vimrc
@ -157,34 +180,44 @@ running the following command:</para>
</sect2> </sect2>
<sect2 id="contents-vim" role="content"><title>Contents of Vim</title> <sect2 id="contents-vim" role="content">
<title>Contents of Vim</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <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), <seglistitem>
view (link to vim), vim, vim132, vim2html.pl, vimdiff (link to vim), vimm, vimspell.sh, <seg>efm_filter.pl, efm_perl.pl, ex (link to vim), less.sh, mve.awk,
vimtutor, and xxd</seg></seglistitem> 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> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
<varlistentry id="efm_filter.pl"> <varlistentry id="efm_filter.pl">
<term><command>efm_filter.pl</command></term> <term><command>efm_filter.pl</command></term>
<listitem> <listitem>
<para>A filter for creating an error file that can be read by <command>vim</command></para> <para>A filter for creating an error file that can be read
<indexterm zone="ch-system-vim efm_filter.pl"><primary sortas="b-efm_filter.pl">efm_filter.pl</primary></indexterm> 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> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="efm_perl.pl"> <varlistentry id="efm_perl.pl">
<term><command>efm_perl.pl</command></term> <term><command>efm_perl.pl</command></term>
<listitem> <listitem>
<para>Reformats the error messages of the <para>Reformats the error messages of the Perl interpreter for use
Perl interpreter for use with the <quote>quickfix</quote> mode of <command>vim</command></para> 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> <indexterm zone="ch-system-vim efm_perl.pl">
<primary sortas="b-efm_perl.pl">efm_perl.pl</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -192,7 +225,9 @@ Perl interpreter for use with the <quote>quickfix</quote> mode of <command>vim</
<term><command>ex</command></term> <term><command>ex</command></term>
<listitem> <listitem>
<para>Starts <command>vim</command> in ex mode</para> <para>Starts <command>vim</command> in ex mode</para>
<indexterm zone="ch-system-vim ex"><primary sortas="b-ex">ex</primary></indexterm> <indexterm zone="ch-system-vim ex">
<primary sortas="b-ex">ex</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -200,7 +235,9 @@ Perl interpreter for use with the <quote>quickfix</quote> mode of <command>vim</
<term><command>less.sh</command></term> <term><command>less.sh</command></term>
<listitem> <listitem>
<para>A script that starts <command>vim</command> with less.vim</para> <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> <indexterm zone="ch-system-vim less.sh">
<primary sortas="b-less.sh">less.sh</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -208,15 +245,20 @@ Perl interpreter for use with the <quote>quickfix</quote> mode of <command>vim</
<term><command>mve.awk</command></term> <term><command>mve.awk</command></term>
<listitem> <listitem>
<para>Processes <command>vim</command> errors</para> <para>Processes <command>vim</command> errors</para>
<indexterm zone="ch-system-vim mve.awk"><primary sortas="b-mve.awk">mve.awk</primary></indexterm> <indexterm zone="ch-system-vim mve.awk">
<primary sortas="b-mve.awk">mve.awk</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="pltags.pl"> <varlistentry id="pltags.pl">
<term><command>pltags.pl</command></term> <term><command>pltags.pl</command></term>
<listitem> <listitem>
<para>Creates a tags file for Perl code for use by <command>vim</command></para> <para>Creates a tags file for Perl code for use by
<indexterm zone="ch-system-vim pltags.pl"><primary sortas="b-pltags.pl">pltags.pl</primary></indexterm> <command>vim</command></para>
<indexterm zone="ch-system-vim pltags.pl">
<primary sortas="b-pltags.pl">pltags.pl</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -224,7 +266,9 @@ Perl interpreter for use with the <quote>quickfix</quote> mode of <command>vim</
<term><command>ref</command></term> <term><command>ref</command></term>
<listitem> <listitem>
<para>Checks the spelling of arguments</para> <para>Checks the spelling of arguments</para>
<indexterm zone="ch-system-vim ref"><primary sortas="b-ref">ref</primary></indexterm> <indexterm zone="ch-system-vim ref">
<primary sortas="b-ref">ref</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -232,8 +276,11 @@ Perl interpreter for use with the <quote>quickfix</quote> mode of <command>vim</
<term><command>rview</command></term> <term><command>rview</command></term>
<listitem> <listitem>
<para>Is a restricted version of <command>view</command>; no shell <para>Is a restricted version of <command>view</command>; no shell
commands can be started and <command>view</command> cannot be suspended</para> commands can be started and <command>view</command> cannot be
<indexterm zone="ch-system-vim rview"><primary sortas="b-rview">rview</primary></indexterm> suspended</para>
<indexterm zone="ch-system-vim rview">
<primary sortas="b-rview">rview</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -241,8 +288,11 @@ commands can be started and <command>view</command> cannot be suspended</para>
<term><command>rvim</command></term> <term><command>rvim</command></term>
<listitem> <listitem>
<para>Is a restricted version of <command>vim</command>; no shell <para>Is a restricted version of <command>vim</command>; no shell
commands can be started and <command>vim</command> cannot be suspended</para> commands can be started and <command>vim</command> cannot be
<indexterm zone="ch-system-vim rvim"><primary sortas="b-rvim">rvim</primary></indexterm> suspended</para>
<indexterm zone="ch-system-vim rvim">
<primary sortas="b-rvim">rvim</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -250,7 +300,9 @@ commands can be started and <command>vim</command> cannot be suspended</para>
<term><command>shtags.pl</command></term> <term><command>shtags.pl</command></term>
<listitem> <listitem>
<para>Generates a tags file for Perl scripts</para> <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> <indexterm zone="ch-system-vim shtags.pl">
<primary sortas="b-shtags.pl">shtags.pl</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -258,7 +310,9 @@ commands can be started and <command>vim</command> cannot be suspended</para>
<term><command>tcltags</command></term> <term><command>tcltags</command></term>
<listitem> <listitem>
<para>Generates a tags file for TCL code</para> <para>Generates a tags file for TCL code</para>
<indexterm zone="ch-system-vim tcltags"><primary sortas="b-tcltags">tcltags</primary></indexterm> <indexterm zone="ch-system-vim tcltags">
<primary sortas="b-tcltags">tcltags</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -266,15 +320,19 @@ commands can be started and <command>vim</command> cannot be suspended</para>
<term><command>view</command></term> <term><command>view</command></term>
<listitem> <listitem>
<para>Starts <command>vim</command> in read-only mode</para> <para>Starts <command>vim</command> in read-only mode</para>
<indexterm zone="ch-system-vim view"><primary sortas="b-view">view</primary></indexterm> <indexterm zone="ch-system-vim view">
<primary sortas="b-view">view</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="vi"> <varlistentry id="vi">
<term><command>vi</command></term> <term><command>vi</command></term>
<listitem> <listitem>
<para>Is the editor</para> <para>Link to <command>vim</command></para>
<indexterm zone="ch-system-vim vi"><primary sortas="b-vi">vi</primary></indexterm> <indexterm zone="ch-system-vim vi">
<primary sortas="b-vi">vi</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -282,31 +340,42 @@ commands can be started and <command>vim</command> cannot be suspended</para>
<term><command>vim</command></term> <term><command>vim</command></term>
<listitem> <listitem>
<para>Is the editor</para> <para>Is the editor</para>
<indexterm zone="ch-system-vim vim"><primary sortas="b-vim">vim</primary></indexterm> <indexterm zone="ch-system-vim vim">
<primary sortas="b-vim">vim</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="vim132"> <varlistentry id="vim132">
<term><command>vim132</command></term> <term><command>vim132</command></term>
<listitem> <listitem>
<para>Starts <command>vim</command> with the terminal in 132-column mode</para> <para>Starts <command>vim</command> with the terminal in 132-column
<indexterm zone="ch-system-vim vim132"><primary sortas="b-vim132">vim132</primary></indexterm> mode</para>
<indexterm zone="ch-system-vim vim132">
<primary sortas="b-vim132">vim132</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="vim2html.pl"> <varlistentry id="vim2html.pl">
<term><command>vim2html.pl</command></term> <term><command>vim2html.pl</command></term>
<listitem> <listitem>
<para>Converts Vim documentation to HypterText Markup Language (HTML)</para> <para>Converts Vim documentation to HypterText Markup Language
<indexterm zone="ch-system-vim vim2html.pl"><primary sortas="b-vim2html.pl">vim2html.pl</primary></indexterm> (HTML)</para>
<indexterm zone="ch-system-vim vim2html.pl">
<primary sortas="b-vim2html.pl">vim2html.pl</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="vimdiff"> <varlistentry id="vimdiff">
<term><command>vimdiff</command></term> <term><command>vimdiff</command></term>
<listitem> <listitem>
<para>Edits two or three versions of a file with <command>vim</command> and show differences</para> <para>Edits two or three versions of a file with <command>vim</command>
<indexterm zone="ch-system-vim vimdiff"><primary sortas="b-vimdiff">vimdiff</primary></indexterm> and show differences</para>
<indexterm zone="ch-system-vim vimdiff">
<primary sortas="b-vimdiff">vimdiff</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -314,26 +383,33 @@ commands can be started and <command>vim</command> cannot be suspended</para>
<term><command>vimm</command></term> <term><command>vimm</command></term>
<listitem> <listitem>
<para>Enables the DEC locator input model on a remote terminal</para> <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> <indexterm zone="ch-system-vim vimm">
<primary sortas="b-vimm">vimm</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="vimspell.sh"> <varlistentry id="vimspell.sh">
<term><command>vimspell.sh</command></term> <term><command>vimspell.sh</command></term>
<listitem> <listitem>
<para>Spell checks a file and generates the syntax statements necessary to <para>Spell checks a file and generates the syntax statements
highlight in <command>vim</command>. This script requires the old Unix necessary to highlight in <command>vim</command>. This script
<command>spell</command> command, which is provided neither in LFS nor in requires the old Unix <command>spell</command> command, which
BLFS</para> 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> <indexterm zone="ch-system-vim vimspell.sh">
<primary sortas="b-vimspell.sh">vimspell.sh</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="vimtutor"> <varlistentry id="vimtutor">
<term><command>vimtutor</command></term> <term><command>vimtutor</command></term>
<listitem> <listitem>
<para>Teaches the basic keys and commands of <command>vim</command></para> <para>Teaches the basic keys and commands of
<indexterm zone="ch-system-vim vimtutor"><primary sortas="b-vimtutor">vimtutor</primary></indexterm> <command>vim</command></para>
<indexterm zone="ch-system-vim vimtutor">
<primary sortas="b-vimtutor">vimtutor</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -342,12 +418,14 @@ BLFS</para>
<listitem> <listitem>
<para>Creates a hex dump of the given file; it can <para>Creates a hex dump of the given file; it can
also do the reverse, so it can be used for binary patching</para> 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> <indexterm zone="ch-system-vim xxd">
<primary sortas="b-xxd">xxd</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

63
chapter06/zlib.xml
View File

@ -1,39 +1,56 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-zlib" role="wrap"> <sect1 id="ch-system-zlib" role="wrap">
<title>Zlib-&zlib-version;</title>
<?dbhtml filename="zlib.html"?> <?dbhtml filename="zlib.html"?>
<indexterm zone="ch-system-zlib"><primary sortas="a-Zlib">Zlib</primary></indexterm> <title>Zlib-&zlib-version;</title>
<indexterm zone="ch-system-zlib">
<primary sortas="a-Zlib">Zlib</primary>
</indexterm>
<sect2 role="package">
<title/>
<sect2 role="package"><title/>
<para>The Zlib package contains compression and decompression routines used by <para>The Zlib package contains compression and decompression routines used by
some programs.</para> some programs.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>2.7 MB</seg></seglistitem>
<seglistitem>
<seg>0.1 SBU</seg>
<seg>2.7 MB</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem><seg>Binutils, Coreutils, GCC, Glibc, Make, and Sed</seg></seglistitem>
<seglistitem>
<seg>Binutils, Coreutils, GCC, Glibc, Make, and Sed</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
<title>Installation of Zlib</title> <title>Installation of Zlib</title>
<note><para>Zlib is known to build its shared library incorrectly if <note>
<envar>CFLAGS</envar> is specified in the environment. If using a <para>Zlib is known to build its shared library incorrectly if
specified <envar>CFLAGS</envar> <envar>CFLAGS</envar> is specified in the environment. If using
variable, be sure to add the <parameter>-fPIC</parameter> directive to a specified <envar>CFLAGS</envar> variable, be sure to add the
the <envar>CFLAGS</envar> variable for the duration of the <parameter>-fPIC</parameter> directive to the <envar>CFLAGS</envar>
configure command below, then remove it afterwards.</para></note> variable for the duration of the configure command below, then
remove it afterwards.</para>
</note>
<para>Prepare Zlib for compilation:</para> <para>Prepare Zlib for compilation:</para>
@ -77,29 +94,35 @@ make</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-zlib" role="content">
<sect2 id="contents-zlib" role="content"><title>Contents of Zlib</title> <title>Contents of Zlib</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed libraries</segtitle> <segtitle>Installed libraries</segtitle>
<seglistitem><seg>libz.[a,so]</seg></seglistitem>
<seglistitem>
<seg>libz.[a,so]</seg>
</seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?> <?dbhtml list-presentation="table"?>
<varlistentry id="libz"> <varlistentry id="libz">
<term><filename class="libraryfile">libz</filename></term> <term><filename class="libraryfile">libz</filename></term>
<listitem> <listitem>
<para>Contains compression and decompression <para>Contains compression and decompression functions used by
functions used by some programs</para> some programs</para>
<indexterm zone="ch-system-zlib libz"><primary sortas="c-libz">libz</primary></indexterm> <indexterm zone="ch-system-zlib libz">
<primary sortas="c-libz">libz</primary>
</indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</sect2> </sect2>
</sect1> </sect1>

4
general.ent
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!ENTITY version "SVN-20060207"> <!ENTITY version "SVN-20060210">
<!ENTITY releasedate "Febraury 7, 2006"> <!ENTITY releasedate "Febraury 10, 2006">
<!ENTITY milestone "6.2"> <!ENTITY milestone "6.2">
<!ENTITY generic-version "development"> <!-- Use "development", "testing", or "x.y[-pre{x}]" --> <!ENTITY generic-version "development"> <!-- Use "development", "testing", or "x.y[-pre{x}]" -->