gronod/lfs
1
0
Fork 0
mirror of https://git.linuxfromscratch.org/lfs.git synced 2025-06-23 21:59:21 +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>
<para>Febraury 10, 2006</para>
<itemizedlist>
<listitem>
<para>[manuel] - Finished the XML indentation plus few tags
changes.</para>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para>January 30, 2006</para>
<itemizedlist>

291
chapter06/shadow.xml
View File

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

8
chapter06/strippingagain.xml
View File

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

72
chapter06/sysklogd.xml
View File

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

139
chapter06/sysvinit.xml
View File

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

53
chapter06/tar.xml
View File

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

121
chapter06/texinfo.xml
View File

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

173
chapter06/udev.xml
View File

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

351
chapter06/util-linux.xml
View File

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

236
chapter06/vim.xml
View File

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

63
chapter06/zlib.xml
View File

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

4
general.ent
View File

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