Indenting chapter 6, part 7

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7351 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
This commit is contained in:
Manuel Canales Esparcia 2006-02-05 13:17:43 +00:00
parent 4ae4324957
commit bdea25ce6a
8 changed files with 837 additions and 667 deletions

View File

@ -1,70 +1,83 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-iproute2" role="wrap"> <sect1 id="ch-system-iproute2" role="wrap">
<?dbhtml filename="iproute2.html"?>
<title>IPRoute2-&iproute2-version;</title> <title>IPRoute2-&iproute2-version;</title>
<?dbhtml filename="iproute2.html"?>
<indexterm zone="ch-system-iproute2"> <indexterm zone="ch-system-iproute2">
<primary sortas="a-IPRoute2">IPRoute2</primary> <primary sortas="a-IPRoute2">IPRoute2</primary>
</indexterm> </indexterm>
<sect2 role="package"> <sect2 role="package">
<title/> <title/>
<para>The IPRoute2 package contains programs for basic and advanced
IPV4-based networking. <para>The IPRoute2 package contains programs for basic and advanced IPV4-based
</para> networking.</para>
<segmentedlist> <segmentedlist>
<segtitle>&buildtime;</segtitle> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle> <segtitle>&diskspace;</segtitle>
<seglistitem> <seglistitem>
<seg>0.1 SBU</seg> <seg>0.1 SBU</seg>
<seg>4.3 MB</seg> <seg>4.3 MB</seg>
</seglistitem> </seglistitem>
</segmentedlist> </segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&dependencies;</segtitle>
<seglistitem> <seglistitem>
<seg>Berkeley DB, GCC, Glibc, Make, and Linux-Headers</seg> <seg>Berkeley DB, GCC, Glibc, Make, and Linux-Headers</seg>
</seglistitem> </seglistitem>
</segmentedlist> </segmentedlist>
</sect2> </sect2>
<sect2 role="installation"> <sect2 role="installation">
<title>Installation of IPRoute2</title> <title>Installation of IPRoute2</title>
<para>Prepare IPRoute2 for compilation:</para> <para>Prepare IPRoute2 for compilation:</para>
<screen><userinput>chmod u+x configure &amp;&amp;
<screen><userinput>chmod u+x configure &amp;&amp;
./configure</userinput></screen> ./configure</userinput></screen>
<para>Compile the package:</para> <para>Compile the package:</para>
<screen><userinput>make SBINDIR=/sbin</userinput></screen> <screen><userinput>make SBINDIR=/sbin</userinput></screen>
<para>The meaning of the make option:</para>
<variablelist> <variablelist>
<varlistentry> <title>The meaning of the make option:</title>
<term><parameter>SBINDIR=/sbin</parameter></term>
<listitem><para>This ensures that the IPRoute2 binaries will install into <varlistentry>
<filename class="directory">/sbin</filename>. This is the correct location <term><parameter>SBINDIR=/sbin</parameter></term>
according to the FHS, because some of the IPRoute2 binaries are used by <listitem>
the LFS-Bootscripts package.</para> <para>This ensures that the IPRoute2 binaries will install into
</listitem> <filename class="directory">/sbin</filename>. This is the correct
</varlistentry> location according to the FHS, because some of the IPRoute2 binaries
are used by the LFS-Bootscripts package.</para>
</listitem>
</varlistentry>
</variablelist> </variablelist>
<para>This package does not come with a test suite.</para> <para>This package does not come with a test suite.</para>
<para>Install the package:</para> <para>Install the package:</para>
<screen><userinput>make SBINDIR=/sbin install</userinput></screen> <screen><userinput>make SBINDIR=/sbin install</userinput></screen>
<para>The <command>arpd</command> binary links against the Berkeley DB libraries <para>The <command>arpd</command> binary links against the Berkeley DB
that reside in <filename class="directory">/usr</filename> and libraries that reside in <filename class="directory">/usr</filename> and
uses a database in <filename>/var/lib/arpd/arpd.db</filename>. Thus, uses a database in <filename>/var/lib/arpd/arpd.db</filename>. Thus,
according to the FHS, it must be according to the FHS, it must be in <filename
in <filename class="directory">/usr/sbin</filename>. Move it there: class="directory">/usr/sbin</filename>. Move it there:</para>
</para>
<screen><userinput>mv -v /sbin/arpd /usr/sbin</userinput></screen> <screen><userinput>mv -v /sbin/arpd /usr/sbin</userinput></screen>
@ -72,27 +85,28 @@
<sect2 id="contents-iproute2" role="content"> <sect2 id="contents-iproute2" role="content">
<title>Contents of IPRoute2</title> <title>Contents of IPRoute2</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<seglistitem> <seglistitem>
<seg>arpd, ctstat (link to lnstat), ifcfg, ifstat, ip, lnstat, nstat, <seg>arpd, ctstat (link to lnstat), ifcfg, ifstat, ip, lnstat, nstat,
routef, routel, rtacct, rtmon, rtpr, rtstat (link to lnstat), ss, routef, routel, rtacct, rtmon, rtpr, rtstat (link to lnstat), ss,
and tc. and tc.</seg>
</seg>
</seglistitem> </seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<?dbfo list-presentation="list"?> <bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbhtml list-presentation="table"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="arpd"> <varlistentry id="arpd">
<term> <term><command>arpd</command></term>
<command>arpd</command>
</term>
<listitem> <listitem>
<para>Userspace ARP daemon, useful in really large networks, where <para>Userspace ARP daemon, useful in really large networks, where the
the kernelspace ARP implementation is insufficient, or kernelspace ARP implementation is insufficient, or when setting up a
when setting up a honeypot</para> honeypot</para>
<indexterm zone="ch-system-iproute2 arpd"> <indexterm zone="ch-system-iproute2 arpd">
<primary sortas="b-arpd">arpd</primary> <primary sortas="b-arpd">arpd</primary>
</indexterm> </indexterm>
@ -100,9 +114,7 @@
</varlistentry> </varlistentry>
<varlistentry id="ctstat"> <varlistentry id="ctstat">
<term> <term><command>ctstat</command></term>
<command>ctstat</command>
</term>
<listitem> <listitem>
<para>Connection status utility</para> <para>Connection status utility</para>
<indexterm zone="ch-system-iproute2 ctstat"> <indexterm zone="ch-system-iproute2 ctstat">
@ -112,9 +124,7 @@
</varlistentry> </varlistentry>
<varlistentry id="ifcfg"> <varlistentry id="ifcfg">
<term> <term><command>ifcfg</command></term>
<command>ifcfg</command>
</term>
<listitem> <listitem>
<para>A shell script wrapper for the <command>ip</command> command</para> <para>A shell script wrapper for the <command>ip</command> command</para>
<indexterm zone="ch-system-iproute2 ifcfg"> <indexterm zone="ch-system-iproute2 ifcfg">
@ -124,12 +134,10 @@
</varlistentry> </varlistentry>
<varlistentry id="ifstat"> <varlistentry id="ifstat">
<term> <term><command>ifstat</command></term>
<command>ifstat</command>
</term>
<listitem> <listitem>
<para>Shows the interface statistics, including the amount of transmitted <para>Shows the interface statistics, including the amount of
and received packets by interface</para> transmitted and received packets by interface</para>
<indexterm zone="ch-system-iproute2 ifstat"> <indexterm zone="ch-system-iproute2 ifstat">
<primary sortas="b-ifstat">ifstat</primary> <primary sortas="b-ifstat">ifstat</primary>
</indexterm> </indexterm>
@ -137,49 +145,37 @@
</varlistentry> </varlistentry>
<varlistentry id="ip"> <varlistentry id="ip">
<term> <term><command>ip</command></term>
<command>ip</command>
</term>
<listitem> <listitem>
<para>The main executable. It has several different functions:</para> <para>The main executable. It has several different functions:</para>
<para><command>ip link <replaceable>[device]</replaceable></command> <para><command>ip link <replaceable>[device]</replaceable></command>
allows users to look at the state of devices and to make changes allows users to look at the state of devices and to make changes</para>
</para>
<para><command>ip addr</command> allows users to look at addresses and <para><command>ip addr</command> allows users to look at addresses and
their properties, add new addresses, and delete old ones their properties, add new addresses, and delete old ones</para>
</para>
<para><command>ip neighbor</command> allows users to look at <para><command>ip neighbor</command> allows users to look at neighbor
neighbor bindings and their properties, add new bindings and their properties, add new neighbor entries, and delete
neighbor entries, and delete old ones old ones</para>
</para>
<para><command>ip rule</command> allows users to look at the routing <para><command>ip rule</command> allows users to look at the routing
policies and change them policies and change them</para>
</para>
<para><command>ip route</command> allows users to look at the routing <para><command>ip route</command> allows users to look at the routing
table and change routing table rules table and change routing table rules</para>
</para>
<para><command>ip tunnel</command> allows users to look at the IP <para><command>ip tunnel</command> allows users to look at the IP
tunnels and their properties, and change them tunnels and their properties, and change them</para>
</para>
<para><command>ip maddr</command> allows users to look at the multicast <para><command>ip maddr</command> allows users to look at the multicast
addresses and their properties, and change them addresses and their properties, and change them</para>
</para>
<para><command>ip mroute</command> allows users to set, change, or <para><command>ip mroute</command> allows users to set, change, or
delete the multicast routing delete the multicast routing</para>
</para>
<para><command>ip monitor</command> allows users to <para><command>ip monitor</command> allows users to continously monitor
continously monitor the state of devices, addresses and routes the state of devices, addresses and routes</para>
</para>
<indexterm zone="ch-system-iproute2 ip"> <indexterm zone="ch-system-iproute2 ip">
<primary sortas="b-ip">ip</primary> <primary sortas="b-ip">ip</primary>
</indexterm> </indexterm>
@ -187,13 +183,11 @@
</varlistentry> </varlistentry>
<varlistentry id="lnstat"> <varlistentry id="lnstat">
<term> <term><command>lnstat</command></term>
<command>lnstat</command>
</term>
<listitem> <listitem>
<para>Provides Linux network statistics. It is a generalized and more <para>Provides Linux network statistics. It is a generalized and more
feature-complete replacement for the old feature-complete replacement for the old <command>rtstat</command>
<command>rtstat</command> program</para> program</para>
<indexterm zone="ch-system-iproute2 lnstat"> <indexterm zone="ch-system-iproute2 lnstat">
<primary sortas="b-lnstat">lnstat</primary> <primary sortas="b-lnstat">lnstat</primary>
</indexterm> </indexterm>
@ -201,9 +195,7 @@
</varlistentry> </varlistentry>
<varlistentry id="nstat"> <varlistentry id="nstat">
<term> <term><command>nstat</command></term>
<command>nstat</command>
</term>
<listitem> <listitem>
<para>Shows network statistics</para> <para>Shows network statistics</para>
<indexterm zone="ch-system-iproute2 nstat"> <indexterm zone="ch-system-iproute2 nstat">
@ -213,13 +205,10 @@
</varlistentry> </varlistentry>
<varlistentry id="routef"> <varlistentry id="routef">
<term> <term><command>routef</command></term>
<command>routef</command>
</term>
<listitem> <listitem>
<para>A component of <command>ip route</command>. This is for flushing the routing <para>A component of <command>ip route</command>. This is for flushing
tables the routing tables</para>
</para>
<indexterm zone="ch-system-iproute2 routef"> <indexterm zone="ch-system-iproute2 routef">
<primary sortas="b-routef">routef</primary> <primary sortas="b-routef">routef</primary>
</indexterm> </indexterm>
@ -227,13 +216,10 @@
</varlistentry> </varlistentry>
<varlistentry id="routel"> <varlistentry id="routel">
<term> <term><command>routel</command></term>
<command>routel</command>
</term>
<listitem> <listitem>
<para>A component of <command>ip route</command>. This is for listing the routing <para>A component of <command>ip route</command>. This is for listing
tables the routing tables</para>
</para>
<indexterm zone="ch-system-iproute2 routel"> <indexterm zone="ch-system-iproute2 routel">
<primary sortas="b-routel">routel</primary> <primary sortas="b-routel">routel</primary>
</indexterm> </indexterm>
@ -241,11 +227,10 @@
</varlistentry> </varlistentry>
<varlistentry id="rtacct"> <varlistentry id="rtacct">
<term> <term><command>rtacct</command></term>
<command>rtacct</command>
</term>
<listitem> <listitem>
<para>Displays the contents of <filename>/proc/net/rt_acct</filename></para> <para>Displays the contents of
<filename>/proc/net/rt_acct</filename></para>
<indexterm zone="ch-system-iproute2 rtacct"> <indexterm zone="ch-system-iproute2 rtacct">
<primary sortas="b-rtacct">rtacct</primary> <primary sortas="b-rtacct">rtacct</primary>
</indexterm> </indexterm>
@ -253,9 +238,7 @@
</varlistentry> </varlistentry>
<varlistentry id="rtmon"> <varlistentry id="rtmon">
<term> <term><command>rtmon</command></term>
<command>rtmon</command>
</term>
<listitem> <listitem>
<para>Route monitoring utility</para> <para>Route monitoring utility</para>
<indexterm zone="ch-system-iproute2 rtmon"> <indexterm zone="ch-system-iproute2 rtmon">
@ -265,12 +248,10 @@
</varlistentry> </varlistentry>
<varlistentry id="rtpr"> <varlistentry id="rtpr">
<term> <term><command>rtpr</command></term>
<command>rtpr</command>
</term>
<listitem> <listitem>
<para>Converts the output of <command>ip -o</command> back into a <para>Converts the output of <command>ip -o</command> back into a
readable form</para> readable form</para>
<indexterm zone="ch-system-iproute2 rtpr"> <indexterm zone="ch-system-iproute2 rtpr">
<primary sortas="b-rtpr">rtpr</primary> <primary sortas="b-rtpr">rtpr</primary>
</indexterm> </indexterm>
@ -278,9 +259,7 @@
</varlistentry> </varlistentry>
<varlistentry id="rtstat"> <varlistentry id="rtstat">
<term> <term><command>rtstat</command></term>
<command>rtstat</command>
</term>
<listitem> <listitem>
<para>Route status utility</para> <para>Route status utility</para>
<indexterm zone="ch-system-iproute2 rtstat"> <indexterm zone="ch-system-iproute2 rtstat">
@ -290,11 +269,10 @@
</varlistentry> </varlistentry>
<varlistentry id="ss"> <varlistentry id="ss">
<term> <term><command>ss</command></term>
<command>ss</command>
</term>
<listitem> <listitem>
<para>Similar to the <command>netstat</command> command; shows active connections</para> <para>Similar to the <command>netstat</command> command; shows active
connections</para>
<indexterm zone="ch-system-iproute2 ss"> <indexterm zone="ch-system-iproute2 ss">
<primary sortas="b-ss">ss</primary> <primary sortas="b-ss">ss</primary>
</indexterm> </indexterm>
@ -302,40 +280,33 @@
</varlistentry> </varlistentry>
<varlistentry id="tc"> <varlistentry id="tc">
<term> <term><command>tc</command></term>
<command>tc</command>
</term>
<listitem> <listitem>
<para>Traffic Controlling Executable; this is for Quality Of <para>Traffic Controlling Executable; this is for Quality Of Service
Service (QOS) and Class Of Service (COS) (QOS) and Class Of Service (COS) implementations</para>
implementations
</para>
<para><command>tc qdisc</command> allows users to setup the queueing <para><command>tc qdisc</command> allows users to setup the queueing
discipline discipline</para>
</para>
<para><command>tc class</command> allows users to setup classes based on <para><command>tc class</command> allows users to setup classes based
the queuing discipline scheduling on the queuing discipline scheduling</para>
</para>
<para><command>tc estimator</command> allows users to estimate the <para><command>tc estimator</command> allows users to estimate the
network flow into a network network flow into a network</para>
</para>
<para><command>tc filter</command> allows users to setup the QOS/COS <para><command>tc filter</command> allows users to setup the QOS/COS
packet filtering packet filtering</para>
</para>
<para><command>tc policy</command> allows users to setup the QOS/COS <para><command>tc policy</command> allows users to setup the QOS/COS
policies policies</para>
</para>
<indexterm zone="ch-system-iproute2 ss"> <indexterm zone="ch-system-iproute2 ss">
<primary sortas="b-tc">tc</primary> <primary sortas="b-tc">tc</primary>
</indexterm> </indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist>
</sect2>
</sect1>
</variablelist>
</sect2>
</sect1>

View File

@ -1,310 +1,385 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-kbd" role="wrap"> <sect1 id="ch-system-kbd" role="wrap">
<title>Kbd-&kbd-version;</title> <?dbhtml filename="kbd.html"?>
<?dbhtml filename="kbd.html"?>
<indexterm zone="ch-system-kbd"><primary sortas="a-Kbd">Kbd</primary></indexterm> <title>Kbd-&kbd-version;</title>
<sect2 role="package"><title/> <indexterm zone="ch-system-kbd">
<para>The Kbd package contains key-table files and keyboard utilities.</para> <primary sortas="a-Kbd">Kbd</primary>
</indexterm>
<segmentedlist> <sect2 role="package">
<segtitle>&buildtime;</segtitle> <title/>
<segtitle>&diskspace;</segtitle> <para>The Kbd package contains key-table files and keyboard utilities.</para>
<seglistitem><seg>0.1 SBU</seg><seg>11.8 MB</seg></seglistitem>
</segmentedlist>
<segmentedlist> <segmentedlist>
<segtitle>&dependencies;</segtitle> <segtitle>&buildtime;</segtitle>
<seglistitem><seg>Bash, Binutils, Bison, Coreutils, <segtitle>&diskspace;</segtitle>
Diffutils, Flex, GCC, Gettext, Glibc, Grep, Gzip, M4, Make, and Sed</seg></seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation"> <seglistitem>
<title>Installation of Kbd</title> <seg>0.1 SBU</seg>
<seg>11.8 MB</seg>
</seglistitem>
</segmentedlist>
<para>The behaviour of the Backspace and Delete keys is not consistent across the <segmentedlist>
keymaps in the Kbd package. The following patch fixes this issue for <segtitle>&dependencies;</segtitle>
i386 keymaps:</para>
<seglistitem>
<seg>Bash, Binutils, Bison, Coreutils, Diffutils, Flex, GCC, Gettext,
Glibc, Grep, Gzip, M4, Make, and Sed</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Kbd</title>
<para>The behaviour of the Backspace and Delete keys is not consistent
across the keymaps in the Kbd package. The following patch fixes this
issue for i386 keymaps:</para>
<screen><userinput>patch -Np1 -i ../&kbd-backspace-patch;</userinput></screen> <screen><userinput>patch -Np1 -i ../&kbd-backspace-patch;</userinput></screen>
<para>After patching, the Backspace key generates the character with code 127, <para>After patching, the Backspace key generates the character with code 127,
and the Delete key generates a well-known escape sequence.</para> and the Delete key generates a well-known escape sequence.</para>
<para>Patch Kbd to fix a bug in <command>setfont</command> that is triggered <para>Patch Kbd to fix a bug in <command>setfont</command> that is triggered
when compiling with GCC-&gcc-version;:</para> when compiling with GCC-&gcc-version;:</para>
<screen><userinput>patch -Np1 -i ../&kbd-gcc4_fixes-patch;</userinput></screen> <screen><userinput>patch -Np1 -i ../&kbd-gcc4_fixes-patch;</userinput></screen>
<para>Prepare Kbd for compilation:</para> <para>Prepare Kbd for compilation:</para>
<screen><userinput>./configure</userinput></screen> <screen><userinput>./configure</userinput></screen>
<para>Compile the package:</para> <para>Compile the package:</para>
<screen><userinput>make</userinput></screen> <screen><userinput>make</userinput></screen>
<para>This package does not come with a test suite.</para> <para>This package does not come with a test suite.</para>
<para>Install the package:</para> <para>Install the package:</para>
<screen><userinput>make install</userinput></screen> <screen><userinput>make install</userinput></screen>
<note><para>For some languages (e.g., Belarusian) the Kbd package doesn't <note>
provide a useful keymap (the stock <quote>by</quote> keymap assumes the <para>For some languages (e.g., Belarusian) the Kbd package doesn't
ISO-8859-5 encoding, while everybody uses CP1251 instead). Users of such provide a useful keymap (the stock <quote>by</quote> keymap assumes the
languages have to download working keymaps separately.</para></note> ISO-8859-5 encoding, while everybody uses CP1251 instead). Users of such
languages have to download working keymaps separately.</para>
</note>
</sect2> </sect2>
<sect2 id="contents-kbd" role="content"><title>Contents of Kbd</title> <sect2 id="contents-kbd" role="content">
<title>Contents of Kbd</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<seglistitem><seg>chvt, deallocvt, dumpkeys,
fgconsole, getkeycodes, getunimap, kbd_mode, kbdrate, loadkeys, loadunimap,
mapscrn, openvt, psfaddtable (link to psfxtable), psfgettable (link to
psfxtable), psfstriptable (link to psfxtable), psfxtable, resizecons,
setfont, setkeycodes, setleds, setlogcons, setmetamode, setvesablank,
showconsolefont, showkey, unicode_start, and unicode_stop</seg></seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <seglistitem>
<?dbfo list-presentation="list"?> <seg>chvt, deallocvt, dumpkeys,
<?dbhtml list-presentation="table"?> fgconsole, getkeycodes, getunimap, kbd_mode, kbdrate, loadkeys, loadunimap,
mapscrn, openvt, psfaddtable (link to psfxtable), psfgettable (link to
psfxtable), psfstriptable (link to psfxtable), psfxtable, resizecons,
setfont, setkeycodes, setleds, setlogcons, setmetamode, setvesablank,
showconsolefont, showkey, unicode_start, and unicode_stop</seg>
</seglistitem>
</segmentedlist>
<varlistentry id="chvt"> <variablelist>
<term><command>chvt</command></term> <bridgehead renderas="sect3">Short Descriptions</bridgehead>
<listitem> <?dbfo list-presentation="list"?>
<para>Changes the foreground virtual terminal</para> <?dbhtml list-presentation="table"?>
<indexterm zone="ch-system-kbd chvt"><primary sortas="b-chvt">chvt</primary></indexterm>
</listitem>
</varlistentry>
<varlistentry id="deallocvt"> <varlistentry id="chvt">
<term><command>deallocvt</command></term> <term><command>chvt</command></term>
<listitem> <listitem>
<para>Deallocates unused virtual terminals</para> <para>Changes the foreground virtual terminal</para>
<indexterm zone="ch-system-kbd deallocvt"><primary sortas="b-deallocvt">deallocvt</primary></indexterm> <indexterm zone="ch-system-kbd chvt">
</listitem> <primary sortas="b-chvt">chvt</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="dumpkeys"> <varlistentry id="deallocvt">
<term><command>dumpkeys</command></term> <term><command>deallocvt</command></term>
<listitem> <listitem>
<para>Dumps the keyboard translation tables</para> <para>Deallocates unused virtual terminals</para>
<indexterm zone="ch-system-kbd dumpkeys"><primary sortas="b-dumpkeys">dumpkeys</primary></indexterm> <indexterm zone="ch-system-kbd deallocvt">
</listitem> <primary sortas="b-deallocvt">deallocvt</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="fgconsole"> <varlistentry id="dumpkeys">
<term><command>fgconsole</command></term> <term><command>dumpkeys</command></term>
<listitem> <listitem>
<para>Prints the number of the active virtual terminal</para> <para>Dumps the keyboard translation tables</para>
<indexterm zone="ch-system-kbd fgconsole"><primary sortas="b-fgconsole">fgconsole</primary></indexterm> <indexterm zone="ch-system-kbd dumpkeys">
</listitem> <primary sortas="b-dumpkeys">dumpkeys</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="getkeycodes"> <varlistentry id="fgconsole">
<term><command>getkeycodes</command></term> <term><command>fgconsole</command></term>
<listitem> <listitem>
<para>Prints the kernel scancode-to-keycode mapping table</para> <para>Prints the number of the active virtual terminal</para>
<indexterm zone="ch-system-kbd getkeycodes"><primary sortas="b-getkeycodes">getkeycodes</primary></indexterm> <indexterm zone="ch-system-kbd fgconsole">
</listitem> <primary sortas="b-fgconsole">fgconsole</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="getunimap"> <varlistentry id="getkeycodes">
<term><command>getunimap</command></term> <term><command>getkeycodes</command></term>
<listitem> <listitem>
<para>Prints the currently used unicode-to-font mapping table</para> <para>Prints the kernel scancode-to-keycode mapping table</para>
<indexterm zone="ch-system-kbd getunimap"><primary sortas="b-getunimap">getunimap</primary></indexterm> <indexterm zone="ch-system-kbd getkeycodes">
</listitem> <primary sortas="b-getkeycodes">getkeycodes</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="kbd_mode"> <varlistentry id="getunimap">
<term><command>kbd_mode</command></term> <term><command>getunimap</command></term>
<listitem> <listitem>
<para>Reports or sets the keyboard mode</para> <para>Prints the currently used unicode-to-font mapping table</para>
<indexterm zone="ch-system-kbd kbd_mode"><primary sortas="b-kbd_mode">kbd_mode</primary></indexterm> <indexterm zone="ch-system-kbd getunimap">
</listitem> <primary sortas="b-getunimap">getunimap</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="kbdrate"> <varlistentry id="kbd_mode">
<term><command>kbdrate</command></term> <term><command>kbd_mode</command></term>
<listitem> <listitem>
<para>Sets the keyboard repeat and delay rates</para> <para>Reports or sets the keyboard mode</para>
<indexterm zone="ch-system-kbd kbdrate"><primary sortas="b-kbdrate">kbdrate</primary></indexterm> <indexterm zone="ch-system-kbd kbd_mode">
</listitem> <primary sortas="b-kbd_mode">kbd_mode</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="loadkeys"> <varlistentry id="kbdrate">
<term><command>loadkeys</command></term> <term><command>kbdrate</command></term>
<listitem> <listitem>
<para>Loads the keyboard translation tables</para> <para>Sets the keyboard repeat and delay rates</para>
<indexterm zone="ch-system-kbd loadkeys"><primary sortas="b-loadkeys">loadkeys</primary></indexterm> <indexterm zone="ch-system-kbd kbdrate">
</listitem> <primary sortas="b-kbdrate">kbdrate</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="loadunimap"> <varlistentry id="loadkeys">
<term><command>loadunimap</command></term> <term><command>loadkeys</command></term>
<listitem> <listitem>
<para>Loads the kernel unicode-to-font mapping table</para> <para>Loads the keyboard translation tables</para>
<indexterm zone="ch-system-kbd loadunimap"><primary sortas="b-loadunimap">loadunimap</primary></indexterm> <indexterm zone="ch-system-kbd loadkeys">
</listitem> <primary sortas="b-loadkeys">loadkeys</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="mapscrn"> <varlistentry id="loadunimap">
<term><command>mapscrn</command></term> <term><command>loadunimap</command></term>
<listitem> <listitem>
<para>An obsolete program that used to load <para>Loads the kernel unicode-to-font mapping table</para>
a user-defined output character mapping table into the console driver; this is <indexterm zone="ch-system-kbd loadunimap">
now done by <command>setfont</command></para> <primary sortas="b-loadunimap">loadunimap</primary>
<indexterm zone="ch-system-kbd mapscrn"><primary sortas="b-mapscrn">mapscrn</primary></indexterm> </indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry id="openvt"> <varlistentry id="mapscrn">
<term><command>openvt</command></term> <term><command>mapscrn</command></term>
<listitem> <listitem>
<para>Starts a program on a new virtual terminal (VT)</para> <para>An obsolete program that used to load a user-defined output
<indexterm zone="ch-system-kbd openvt"><primary sortas="b-openvt">openvt</primary></indexterm> character mapping table into the console driver; this is now done
</listitem> by <command>setfont</command></para>
</varlistentry> <indexterm zone="ch-system-kbd mapscrn">
<primary sortas="b-mapscrn">mapscrn</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="psfaddtable"> <varlistentry id="openvt">
<term><command>psfaddtable</command></term> <term><command>openvt</command></term>
<listitem> <listitem>
<para>A link to <command>psfxtable</command></para> <para>Starts a program on a new virtual terminal (VT)</para>
<indexterm zone="ch-system-kbd psfaddtable"><primary sortas="b-psfaddtable">psfaddtable</primary></indexterm> <indexterm zone="ch-system-kbd openvt">
</listitem> <primary sortas="b-openvt">openvt</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="psfgettable"> <varlistentry id="psfaddtable">
<term><command>psfgettable</command></term> <term><command>psfaddtable</command></term>
<listitem> <listitem>
<para>A link to <command>psfxtable</command></para> <para>A link to <command>psfxtable</command></para>
<indexterm zone="ch-system-kbd psfgettable"><primary sortas="b-psfgettable">psfgettable</primary></indexterm> <indexterm zone="ch-system-kbd psfaddtable">
</listitem> <primary sortas="b-psfaddtable">psfaddtable</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="psfstriptable"> <varlistentry id="psfgettable">
<term><command>psfstriptable</command></term> <term><command>psfgettable</command></term>
<listitem> <listitem>
<para>A link to <command>psfxtable</command></para> <para>A link to <command>psfxtable</command></para>
<indexterm zone="ch-system-kbd psfstriptable"><primary sortas="b-psfstriptable">psfstriptable</primary></indexterm> <indexterm zone="ch-system-kbd psfgettable">
</listitem> <primary sortas="b-psfgettable">psfgettable</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="psfxtable"> <varlistentry id="psfstriptable">
<term><command>psfxtable</command></term> <term><command>psfstriptable</command></term>
<listitem> <listitem>
<para>Handle Unicode character tables for console fonts</para> <para>A link to <command>psfxtable</command></para>
<indexterm zone="ch-system-kbd psfxtable"><primary sortas="b-psfxtable">psfxtable</primary></indexterm> <indexterm zone="ch-system-kbd psfstriptable">
</listitem> <primary sortas="b-psfstriptable">psfstriptable</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="resizecons"> <varlistentry id="psfxtable">
<term><command>resizecons</command></term> <term><command>psfxtable</command></term>
<listitem> <listitem>
<para>Changes the kernel idea of the console size</para> <para>Handle Unicode character tables for console fonts</para>
<indexterm zone="ch-system-kbd resizecons"><primary sortas="b-resizecons">resizecons</primary></indexterm> <indexterm zone="ch-system-kbd psfxtable">
</listitem> <primary sortas="b-psfxtable">psfxtable</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="setfont"> <varlistentry id="resizecons">
<term><command>setfont</command></term> <term><command>resizecons</command></term>
<listitem> <listitem>
<para>Changes the Enhanced Graphic Adapter (EGA) and Video Graphics <para>Changes the kernel idea of the console size</para>
Array (VGA) fonts on the console</para> <indexterm zone="ch-system-kbd resizecons">
<indexterm zone="ch-system-kbd setfont"><primary sortas="b-setfont">setfont</primary></indexterm> <primary sortas="b-resizecons">resizecons</primary>
</listitem> </indexterm>
</varlistentry> </listitem>
</varlistentry>
<varlistentry id="setkeycodes"> <varlistentry id="setfont">
<term><command>setkeycodes</command></term> <term><command>setfont</command></term>
<listitem> <listitem>
<para>Loads kernel scancode-to-keycode mapping table entries; this is <para>Changes the Enhanced Graphic Adapter (EGA) and Video Graphics
useful if there are unusual keys on the keyboard</para> Array (VGA) fonts on the console</para>
<indexterm zone="ch-system-kbd setkeycodes"><primary sortas="b-setkeycodes">setkeycodes</primary></indexterm> <indexterm zone="ch-system-kbd setfont">
</listitem> <primary sortas="b-setfont">setfont</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="setleds"> <varlistentry id="setkeycodes">
<term><command>setleds</command></term> <term><command>setkeycodes</command></term>
<listitem> <listitem>
<para>Sets the keyboard flags and Light Emitting Diodes (LEDs)</para> <para>Loads kernel scancode-to-keycode mapping table entries; this is
<indexterm zone="ch-system-kbd setleds"><primary sortas="b-setleds">setleds</primary></indexterm> useful if there are unusual keys on the keyboard</para>
</listitem> <indexterm zone="ch-system-kbd setkeycodes">
</varlistentry> <primary sortas="b-setkeycodes">setkeycodes</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="setlogcons"> <varlistentry id="setleds">
<term><command>setlogcons</command></term> <term><command>setleds</command></term>
<listitem> <listitem>
<para>Sends kernel messages to the console</para> <para>Sets the keyboard flags and Light Emitting Diodes (LEDs)</para>
<indexterm zone="ch-system-kbd setlogcons"><primary sortas="b-setlogcons">setlogcons</primary></indexterm> <indexterm zone="ch-system-kbd setleds">
</listitem> <primary sortas="b-setleds">setleds</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="setmetamode"> <varlistentry id="setlogcons">
<term><command>setmetamode</command></term> <term><command>setlogcons</command></term>
<listitem> <listitem>
<para>Defines the keyboard meta-key handling</para> <para>Sends kernel messages to the console</para>
<indexterm zone="ch-system-kbd setmetamode"><primary sortas="b-setmetamode">setmetamode</primary></indexterm> <indexterm zone="ch-system-kbd setlogcons">
</listitem> <primary sortas="b-setlogcons">setlogcons</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="setvesablank"> <varlistentry id="setmetamode">
<term><command>setvesablank</command></term> <term><command>setmetamode</command></term>
<listitem> <listitem>
<para>Lets the user adjust the built-in hardware screensaver (a blank <para>Defines the keyboard meta-key handling</para>
screen)</para> <indexterm zone="ch-system-kbd setmetamode">
<indexterm zone="ch-system-kbd setvesablank"><primary sortas="b-setvesablank">setvesablank</primary></indexterm> <primary sortas="b-setmetamode">setmetamode</primary>
</listitem> </indexterm>
</varlistentry> </listitem>
</varlistentry>
<varlistentry id="showconsolefont"> <varlistentry id="setvesablank">
<term><command>showconsolefont</command></term> <term><command>setvesablank</command></term>
<listitem> <listitem>
<para>Shows the current EGA/VGA console screen font</para> <para>Lets the user adjust the built-in hardware screensaver (a blank
<indexterm zone="ch-system-kbd showconsolefont"><primary sortas="b-showconsolefont">showconsolefont</primary></indexterm> screen)</para>
</listitem> <indexterm zone="ch-system-kbd setvesablank">
</varlistentry> <primary sortas="b-setvesablank">setvesablank</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="showkey"> <varlistentry id="showconsolefont">
<term><command>showkey</command></term> <term><command>showconsolefont</command></term>
<listitem> <listitem>
<para>Reports the scancodes, keycodes, and ASCII codes of the keys <para>Shows the current EGA/VGA console screen font</para>
pressed on the keyboard</para> <indexterm zone="ch-system-kbd showconsolefont">
<indexterm zone="ch-system-kbd showkey"><primary sortas="b-showkey">showkey</primary></indexterm> <primary sortas="b-showconsolefont">showconsolefont</primary>
</listitem> </indexterm>
</varlistentry> </listitem>
</varlistentry>
<varlistentry id="unicode_start"> <varlistentry id="showkey">
<term><command>unicode_start</command></term> <term><command>showkey</command></term>
<listitem> <listitem>
<para>Puts the keyboard and console in UNICODE mode. Don't use this program <para>Reports the scancodes, keycodes, and ASCII codes of the keys
unless your keymap file is in the ISO-8859-1 encoding. For other encodings, pressed on the keyboard</para>
this utility produces incorrect results.</para> <indexterm zone="ch-system-kbd showkey">
<indexterm zone="ch-system-kbd unicode_start"><primary sortas="b-unicode_start">unicode_start</primary></indexterm> <primary sortas="b-showkey">showkey</primary>
</listitem> </indexterm>
</varlistentry> </listitem>
</varlistentry>
<varlistentry id="unicode_stop"> <varlistentry id="unicode_start">
<term><command>unicode_stop</command></term> <term><command>unicode_start</command></term>
<listitem> <listitem>
<para>Reverts keyboard and console from UNICODE mode</para> <para>Puts the keyboard and console in UNICODE mode. Don't use this
<indexterm zone="ch-system-kbd unicode_stop"><primary sortas="b-unicode_stop">unicode_stop</primary></indexterm> program unless your keymap file is in the ISO-8859-1 encoding. For
</listitem> other encodings, this utility produces incorrect results.</para>
</varlistentry> <indexterm zone="ch-system-kbd unicode_start">
</variablelist> <primary sortas="b-unicode_start">unicode_start</primary>
</indexterm>
</listitem>
</varlistentry>
</sect2> <varlistentry id="unicode_stop">
<term><command>unicode_stop</command></term>
<listitem>
<para>Reverts keyboard and console from UNICODE mode</para>
<indexterm zone="ch-system-kbd unicode_stop">
<primary sortas="b-unicode_stop">unicode_stop</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1> </sect1>

View File

@ -1,37 +1,40 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-kernfs"> <sect1 id="ch-system-kernfs">
<title>Mounting Virtual Kernel File Systems</title> <?dbhtml filename="kernfs.html"?>
<?dbhtml filename="kernfs.html"?>
<para>Various file systems exported by the kernel are used to communicate to and <title>Mounting Virtual Kernel File Systems</title>
from the kernel itself. These file systems are virtual in that no disk space is
used for them. The content of the file systems resides in memory.</para>
<para>Begin by creating directories onto which the file systems will be mounted:</para> <para>Various file systems exported by the kernel are used to communicate to and
from the kernel itself. These file systems are virtual in that no disk space is
used for them. The content of the file systems resides in memory.</para>
<para>Begin by creating directories onto which the file systems will be
mounted:</para>
<screen><userinput>mkdir -pv $LFS/{proc,sys}</userinput></screen> <screen><userinput>mkdir -pv $LFS/{proc,sys}</userinput></screen>
<para>Now mount the file systems:</para> <para>Now mount the file systems:</para>
<screen><userinput>mount -vt proc proc $LFS/proc <screen><userinput>mount -vt proc proc $LFS/proc
mount -vt sysfs sysfs $LFS/sys</userinput></screen> mount -vt sysfs sysfs $LFS/sys</userinput></screen>
<para>Remember that if for any reason you stop working on the LFS <para>Remember that if for any reason you stop working on the LFS
system and start again later, it is important to check that these file system and start again later, it is important to check that these file
systems are mounted again before entering the chroot systems are mounted again before entering the chroot
environment.</para> environment.</para>
<para>Additional file systems will soon be mounted from within the <para>Additional file systems will soon be mounted from within the
chroot environment. To keep the host up to date, perform a <quote>fake chroot environment. To keep the host up to date, perform a <quote>fake
mount</quote> for each of these now:</para> mount</quote> for each of these now:</para>
<screen><userinput>mount -vft tmpfs tmpfs $LFS/dev <screen><userinput>mount -vft tmpfs tmpfs $LFS/dev
mount -vft tmpfs tmpfs $LFS/dev/shm mount -vft tmpfs tmpfs $LFS/dev/shm
mount -vft devpts -o gid=4,mode=620 devpts $LFS/dev/pts</userinput></screen> mount -vft devpts -o gid=4,mode=620 devpts $LFS/dev/pts</userinput></screen>
</sect1> </sect1>

View File

@ -1,97 +1,128 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-less" role="wrap"> <sect1 id="ch-system-less" role="wrap">
<title>Less-&less-version;</title> <?dbhtml filename="less.html"?>
<?dbhtml filename="less.html"?>
<indexterm zone="ch-system-less"><primary sortas="a-Less">Less</primary></indexterm> <title>Less-&less-version;</title>
<sect2 role="package"><title/> <indexterm zone="ch-system-less">
<para>The Less package contains a text file viewer.</para> <primary sortas="a-Less">Less</primary>
</indexterm>
<segmentedlist> <sect2 role="package">
<segtitle>&buildtime;</segtitle> <title/>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>2.3 MB</seg></seglistitem>
</segmentedlist>
<segmentedlist> <para>The Less package contains a text file viewer.</para>
<segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
GCC, Glibc, Grep, Make, Ncurses, and Sed</seg></seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation"> <segmentedlist>
<title>Installation of Less</title> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<para>Prepare Less for compilation:</para> <seglistitem>
<seg>0.1 SBU</seg>
<seg>2.3 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>&dependencies;</segtitle>
<seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep, Make,
Ncurses, and Sed</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Less</title>
<para>Prepare Less for compilation:</para>
<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc</userinput></screen> <screen><userinput>./configure --prefix=/usr --sysconfdir=/etc</userinput></screen>
<para>The meaning of the configure options:</para> <variablelist>
<title>The meaning of the configure options:</title>
<variablelist> <varlistentry>
<varlistentry> <term><parameter>--sysconfdir=/etc</parameter></term>
<term><parameter>--sysconfdir=/etc</parameter></term> <listitem>
<listitem><para>This option tells the programs created by the package to look in <para>This option tells the programs created by the package to look
<filename class="directory">/etc</filename> for the configuration files.</para></listitem> in <filename class="directory">/etc</filename> for the configuration
</varlistentry> files.</para>
</variablelist> </listitem>
</varlistentry>
<para>Compile the package:</para> </variablelist>
<para>Compile the package:</para>
<screen><userinput>make</userinput></screen> <screen><userinput>make</userinput></screen>
<para>This package does not come with a test suite.</para> <para>This package does not come with a test suite.</para>
<para>Install the package:</para> <para>Install the package:</para>
<screen><userinput>make install</userinput></screen> <screen><userinput>make install</userinput></screen>
</sect2>
<sect2 id="contents-less" role="content"><title>Contents of Less</title> </sect2>
<segmentedlist> <sect2 id="contents-less" role="content">
<segtitle>Installed programs</segtitle> <title>Contents of Less</title>
<seglistitem><seg>less, lessecho, and lesskey</seg></seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <segmentedlist>
<?dbfo list-presentation="list"?> <segtitle>Installed programs</segtitle>
<?dbhtml list-presentation="table"?>
<varlistentry id="less"> <seglistitem>
<term><command>less</command></term> <seg>less, lessecho, and lesskey</seg>
<listitem> </seglistitem>
<para>A file viewer or pager; it displays the contents of the given </segmentedlist>
file, letting the user scroll, find strings, and jump to marks</para>
<indexterm zone="ch-system-less less"><primary sortas="b-less">less</primary></indexterm>
</listitem>
</varlistentry>
<varlistentry id="lessecho"> <variablelist>
<term><command>lessecho</command></term> <bridgehead renderas="sect3">Short Descriptions</bridgehead>
<listitem> <?dbfo list-presentation="list"?>
<para>Needed to expand meta-characters, such as <emphasis>*</emphasis> <?dbhtml list-presentation="table"?>
and <emphasis>?</emphasis>, in filenames on Unix systems</para>
<indexterm zone="ch-system-less lessecho"><primary sortas="b-lessecho">lessecho</primary></indexterm>
</listitem>
</varlistentry>
<varlistentry id="lesskey"> <varlistentry id="less">
<term><command>lesskey</command></term> <term><command>less</command></term>
<listitem> <listitem>
<para>Used to specify the key bindings for <command>less</command></para> <para>A file viewer or pager; it displays the contents of the given
<indexterm zone="ch-system-less lesskey"><primary sortas="b-lesskey">lesskey</primary></indexterm> file, letting the user scroll, find strings, and jump to marks</para>
</listitem> <indexterm zone="ch-system-less less">
</varlistentry> <primary sortas="b-less">less</primary>
</variablelist> </indexterm>
</listitem>
</varlistentry>
</sect2> <varlistentry id="lessecho">
<term><command>lessecho</command></term>
<listitem>
<para>Needed to expand meta-characters, such as <emphasis>*</emphasis>
and <emphasis>?</emphasis>, in filenames on Unix systems</para>
<indexterm zone="ch-system-less lessecho">
<primary sortas="b-lessecho">lessecho</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="lesskey">
<term><command>lesskey</command></term>
<listitem>
<para>Used to specify the key bindings for <command>less</command></para>
<indexterm zone="ch-system-less lesskey">
<primary sortas="b-lesskey">lesskey</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1> </sect1>

View File

@ -1,91 +1,119 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-libtool" role="wrap"> <sect1 id="ch-system-libtool" role="wrap">
<title>Libtool-&libtool-version;</title> <?dbhtml filename="libtool.html"?>
<?dbhtml filename="libtool.html"?>
<indexterm zone="ch-system-libtool"><primary sortas="a-Libtool">Libtool</primary></indexterm> <title>Libtool-&libtool-version;</title>
<sect2 role="package"><title/> <indexterm zone="ch-system-libtool">
<para>The Libtool package contains the GNU generic library support script. <primary sortas="a-Libtool">Libtool</primary>
It wraps the complexity of using shared libraries in a consistent, portable </indexterm>
interface.</para>
<segmentedlist> <sect2 role="package">
<segtitle>&buildtime;</segtitle> <title/>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>1.8 SBU</seg><seg>19.0 MB</seg></seglistitem>
</segmentedlist>
<segmentedlist> <para>The Libtool package contains the GNU generic library support script.
<segtitle>&dependencies;</segtitle> It wraps the complexity of using shared libraries in a consistent, portable
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, interface.</para>
GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation"> <segmentedlist>
<title>Installation of Libtool</title> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<para>Prepare Libtool for compilation:</para> <seglistitem>
<seg>1.8 SBU</seg>
<seg>19.0 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>&dependencies;</segtitle>
<seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils,
GCC, Glibc, Grep, Make, and Sed</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Libtool</title>
<para>Prepare Libtool for compilation:</para>
<screen><userinput>./configure --prefix=/usr</userinput></screen> <screen><userinput>./configure --prefix=/usr</userinput></screen>
<para>Compile the package:</para> <para>Compile the package:</para>
<screen><userinput>make</userinput></screen> <screen><userinput>make</userinput></screen>
<para>To test the results, issue: <para>To test the results, issue:
<userinput>make check</userinput>.</para> <userinput>make check</userinput>.</para>
<para>Install the package:</para> <para>Install the package:</para>
<screen><userinput>make install</userinput></screen> <screen><userinput>make install</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-libtool" role="content"><title>Contents of Libtool</title> <sect2 id="contents-libtool" role="content">
<title>Contents of Libtool</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed programs</segtitle> <segtitle>Installed programs</segtitle>
<segtitle>Installed libraries</segtitle> <segtitle>Installed libraries</segtitle>
<seglistitem><seg>libtool and libtoolize</seg><seg>libltdl.[a,so]</seg></seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <seglistitem>
<?dbfo list-presentation="list"?> <seg>libtool and libtoolize</seg>
<?dbhtml list-presentation="table"?> <seg>libltdl.[a,so]</seg>
</seglistitem>
</segmentedlist>
<varlistentry id="libtool"> <variablelist>
<term><command>libtool</command></term> <bridgehead renderas="sect3">Short Descriptions</bridgehead>
<listitem> <?dbfo list-presentation="list"?>
<para>Provides generalized library-building support services</para> <?dbhtml list-presentation="table"?>
<indexterm zone="ch-system-libtool libtool"><primary sortas="b-libtool">libtool</primary></indexterm>
</listitem>
</varlistentry>
<varlistentry id="libtoolize"> <varlistentry id="libtool">
<term><command>libtoolize</command></term> <term><command>libtool</command></term>
<listitem> <listitem>
<para>Provides a standard way to add <command>libtool</command> support to a package</para> <para>Provides generalized library-building support services</para>
<indexterm zone="ch-system-libtool libtoolize"><primary sortas="b-libtoolize">libtoolize</primary></indexterm> <indexterm zone="ch-system-libtool libtool">
</listitem> <primary sortas="b-libtool">libtool</primary>
</varlistentry> </indexterm>
</listitem>
</varlistentry>
<varlistentry id="libltdl"> <varlistentry id="libtoolize">
<term><filename class="libraryfile">libltdl</filename></term> <term><command>libtoolize</command></term>
<listitem> <listitem>
<para>Hides the various difficulties of dlopening libraries</para> <para>Provides a standard way to add <command>libtool</command>
<indexterm zone="ch-system-libtool libltdl"><primary sortas="c-libltdl">libltdl</primary></indexterm> support to a package</para>
</listitem> <indexterm zone="ch-system-libtool libtoolize">
</varlistentry> <primary sortas="b-libtoolize">libtoolize</primary>
</variablelist> </indexterm>
</listitem>
</varlistentry>
</sect2> <varlistentry id="libltdl">
<term><filename class="libraryfile">libltdl</filename></term>
<listitem>
<para>Hides the various difficulties of dlopening libraries</para>
<indexterm zone="ch-system-libtool libltdl">
<primary sortas="c-libltdl">libltdl</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1> </sect1>

View File

@ -1,83 +1,101 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-linux-libc-headers" role="wrap"> <sect1 id="ch-system-linux-libc-headers" role="wrap">
<title>Linux-Libc-Headers-&linux-libc-headers-version;</title> <?dbhtml filename="linux-libc-headers.html"?>
<?dbhtml filename="linux-libc-headers.html"?>
<indexterm zone="ch-system-linux-libc-headers"> <title>Linux-Libc-Headers-&linux-libc-headers-version;</title>
<primary sortas="a-Linux-Libc-Headers">Linux-Libc-Headers</primary>
</indexterm>
<sect2 role="package"><title/> <indexterm zone="ch-system-linux-libc-headers">
<para>The Linux-Libc-Headers package contains the <primary sortas="a-Linux-Libc-Headers">Linux-Libc-Headers</primary>
<quote>sanitized</quote> kernel headers.</para> </indexterm>
<segmentedlist> <sect2 role="package">
<segtitle>&buildtime;</segtitle> <title/>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>26.9 MB</seg></seglistitem>
</segmentedlist>
<segmentedlist> <para>The Linux-Libc-Headers package contains the
<segtitle>&dependencies;</segtitle> <quote>sanitized</quote> kernel headers.</para>
<seglistitem><seg>Coreutils</seg></seglistitem>
</segmentedlist>
</sect2> <segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<sect2 role="installation"> <seglistitem>
<title>Installation of Linux-Libc-Headers</title> <seg>0.1 SBU</seg>
<seg>26.9 MB</seg>
</seglistitem>
</segmentedlist>
<para>For years it has been common practice to use <quote>raw</quote> <segmentedlist>
kernel headers (straight from a kernel tarball) in <filename <segtitle>&dependencies;</segtitle>
class="directory">/usr/include</filename>, but over the last few
years, the kernel developers have taken a strong stance that this
should not be done. This gave birth to the Linux-Libc-Headers Project,
which was designed to maintain an API stable version of the Linux
headers.</para>
<para>Install the header files:</para> <seglistitem>
<seg>Coreutils</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Linux-Libc-Headers</title>
<para>For years it has been common practice to use <quote>raw</quote>
kernel headers (straight from a kernel tarball) in <filename
class="directory">/usr/include</filename>, but over the last few
years, the kernel developers have taken a strong stance that this
should not be done. This gave birth to the Linux-Libc-Headers Project,
which was designed to maintain an API stable version of the Linux
headers.</para>
<para>Install the header files:</para>
<screen><userinput>install -d /usr/include/asm <screen><userinput>install -d /usr/include/asm
cp -Rv include/asm-i386/* /usr/include/asm cp -Rv include/asm-i386/* /usr/include/asm
cp -Rv include/linux /usr/include</userinput></screen> cp -Rv include/linux /usr/include</userinput></screen>
<para>Ensure that all the headers are owned by root:</para> <para>Ensure that all the headers are owned by root:</para>
<screen><userinput>chown -Rv root:root /usr/include/{asm,linux}</userinput></screen> <screen><userinput>chown -Rv root:root /usr/include/{asm,linux}</userinput></screen>
<para>Make sure the users can read the headers:</para> <para>Make sure the users can read the headers:</para>
<screen><userinput>find /usr/include/{asm,linux} -type d -exec chmod -v 755 {} \; <screen><userinput>find /usr/include/{asm,linux} -type d -exec chmod -v 755 {} \;
find /usr/include/{asm,linux} -type f -exec chmod -v 644 {} \;</userinput></screen> find /usr/include/{asm,linux} -type f -exec chmod -v 644 {} \;</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-linux-libc-headers" role="content">
<title>Contents of Linux-Libc-Headers</title>
<sect2 id="contents-linux-libc-headers" role="content"><title>Contents of Linux-Libc-Headers</title> <segmentedlist>
<segtitle>Installed headers</segtitle>
<segmentedlist> <seglistitem>
<segtitle>Installed headers</segtitle> <seg>/usr/include/{asm,linux}/*.h</seg>
<seglistitem><seg>/usr/include/{asm,linux}/*.h</seg></seglistitem> </seglistitem>
</segmentedlist> </segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <variablelist>
<?dbfo list-presentation="list"?> <bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbhtml list-presentation="table"?> <?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="linux-libc-headers"> <varlistentry id="linux-libc-headers">
<term><filename class="headerfile">/usr/include/{asm,linux}/*.h</filename></term> <term><filename class="headerfile">/usr/include/{asm,linux}/*.h</filename></term>
<listitem> <listitem>
<para>The Linux API headers</para> <para>The Linux API headers</para>
<indexterm zone="ch-system-linux-libc-headers linux-libc-headers"><primary sortas="e-/usr/include/{asm,linux}/*.h">/usr/include/{asm,linux}/*.h</primary></indexterm> <indexterm zone="ch-system-linux-libc-headers linux-libc-headers">
</listitem> <primary sortas="e-/usr/include/{asm,linux}/*.h">/usr/include/{asm,linux}/*.h</primary>
</varlistentry> </indexterm>
</variablelist> </listitem>
</varlistentry>
</sect2> </variablelist>
</sect2>
</sect1> </sect1>

View File

@ -1,79 +1,101 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-m4" role="wrap"> <sect1 id="ch-system-m4" role="wrap">
<title>M4-&m4-version;</title> <?dbhtml filename="m4.html"?>
<?dbhtml filename="m4.html"?>
<indexterm zone="ch-system-m4"><primary sortas="a-M4">M4</primary></indexterm> <title>M4-&m4-version;</title>
<sect2 role="package"><title/> <indexterm zone="ch-system-m4">
<para>The M4 package contains a macro processor.</para> <primary sortas="a-M4">M4</primary>
</indexterm>
<segmentedlist> <sect2 role="package">
<segtitle>&buildtime;</segtitle> <title/>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.1 SBU</seg><seg>2.8 MB</seg></seglistitem>
</segmentedlist>
<segmentedlist> <para>The M4 package contains a macro processor.</para>
<segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, GCC,
Gettext, Glibc, Grep, Make, Perl, and Sed</seg></seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation"> <segmentedlist>
<title>Installation of M4</title> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<para>Prepare M4 for compilation:</para> <seglistitem>
<seg>0.1 SBU</seg>
<seg>2.8 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>&dependencies;</segtitle>
<seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc,
Grep, Make, Perl, and Sed</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of M4</title>
<para>Prepare M4 for compilation:</para>
<screen><userinput>./configure --prefix=/usr</userinput></screen> <screen><userinput>./configure --prefix=/usr</userinput></screen>
<para>Compile the package:</para> <para>Compile the package:</para>
<screen><userinput>make</userinput></screen> <screen><userinput>make</userinput></screen>
<para>To test the results, issue: <para>To test the results, issue:
<userinput>make check</userinput>.</para> <userinput>make check</userinput>.</para>
<para>Install the package:</para> <para>Install the package:</para>
<screen><userinput>make install</userinput></screen> <screen><userinput>make install</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-m4" role="content"><title>Contents of M4</title> <sect2 id="contents-m4" role="content">
<title>Contents of M4</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed program</segtitle> <segtitle>Installed program</segtitle>
<seglistitem><seg>m4</seg></seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <seglistitem>
<?dbfo list-presentation="list"?> <seg>m4</seg>
<?dbhtml list-presentation="table"?> </seglistitem>
</segmentedlist>
<varlistentry id="m4"> <variablelist>
<term><command>m4</command></term> <bridgehead renderas="sect3">Short Descriptions</bridgehead>
<listitem> <?dbfo list-presentation="list"?>
<para>copies the given files while expanding the macros that they <?dbhtml list-presentation="table"?>
contain. These macros are either built-in or user-defined and can take
any number of arguments. Besides performing macro expansion,
<command>m4</command> has
built-in functions for including named files, running Unix commands,
performing integer arithmetic, manipulating text, recursion, etc. The
<command>m4</command> program can be used either as a front-end to a compiler or as a
macro processor in its own right.</para>
<indexterm zone="ch-system-m4 m4"><primary sortas="b-m4">m4</primary></indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2> <varlistentry id="m4">
<term><command>m4</command></term>
<listitem>
<para>copies the given files while expanding the macros that they
contain. These macros are either built-in or user-defined and can
take any number of arguments. Besides performing macro expansion,
<command>m4</command> has built-in functions for including named
files, running Unix commands, performing integer arithmetic,
manipulating text, recursion, etc. The <command>m4</command> program
can be used either as a front-end to a compiler or as a macro processor
in its own right.</para>
<indexterm zone="ch-system-m4 m4">
<primary sortas="b-m4">m4</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1> </sect1>

View File

@ -1,73 +1,95 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent"> <!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities; %general-entities;
]> ]>
<sect1 id="ch-system-make" role="wrap"> <sect1 id="ch-system-make" role="wrap">
<title>Make-&make-version;</title> <?dbhtml filename="make.html"?>
<?dbhtml filename="make.html"?>
<indexterm zone="ch-system-make"><primary sortas="a-Make">Make</primary></indexterm> <title>Make-&make-version;</title>
<sect2 role="package"><title/> <indexterm zone="ch-system-make">
<para>The Make package contains a program for compiling packages.</para> <primary sortas="a-Make">Make</primary>
</indexterm>
<segmentedlist> <sect2 role="package">
<segtitle>&buildtime;</segtitle> <title/>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.2 SBU</seg><seg>7.1 MB</seg></seglistitem>
</segmentedlist>
<segmentedlist> <para>The Make package contains a program for compiling packages.</para>
<segtitle>&dependencies;</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
GCC, Gettext, Glibc, Grep, and Sed</seg></seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation"> <segmentedlist>
<title>Installation of Make</title> <segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<para>Prepare Make for compilation:</para> <seglistitem>
<seg>0.2 SBU</seg>
<seg>7.1 MB</seg>
</seglistitem>
</segmentedlist>
<segmentedlist>
<segtitle>&dependencies;</segtitle>
<seglistitem>
<seg>Bash, Binutils, Coreutils, Diffutils, GCC, Gettext, Glibc,
Grep, and Sed</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Make</title>
<para>Prepare Make for compilation:</para>
<screen><userinput>./configure --prefix=/usr</userinput></screen> <screen><userinput>./configure --prefix=/usr</userinput></screen>
<para>Compile the package:</para> <para>Compile the package:</para>
<screen><userinput>make</userinput></screen> <screen><userinput>make</userinput></screen>
<para>To test the results, issue: <para>To test the results, issue:
<userinput>make check</userinput>.</para> <userinput>make check</userinput>.</para>
<para>Install the package:</para> <para>Install the package:</para>
<screen><userinput>make install</userinput></screen> <screen><userinput>make install</userinput></screen>
</sect2> </sect2>
<sect2 id="contents-make" role="content"><title>Contents of Make</title> <sect2 id="contents-make" role="content">
<title>Contents of Make</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed program</segtitle> <segtitle>Installed program</segtitle>
<seglistitem><seg>make</seg></seglistitem>
</segmentedlist>
<variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead> <seglistitem>
<?dbfo list-presentation="list"?> <seg>make</seg>
<?dbhtml list-presentation="table"?> </seglistitem>
</segmentedlist>
<varlistentry id="make"> <variablelist>
<term><command>make</command></term> <bridgehead renderas="sect3">Short Descriptions</bridgehead>
<listitem> <?dbfo list-presentation="list"?>
<para>Automatically determines which pieces of a package need to <?dbhtml list-presentation="table"?>
be (re)compiled and then issues the relevant commands</para>
<indexterm zone="ch-system-make make"><primary sortas="b-make">make</primary></indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2> <varlistentry id="make">
<term><command>make</command></term>
<listitem>
<para>Automatically determines which pieces of a package need to
be (re)compiled and then issues the relevant commands</para>
<indexterm zone="ch-system-make make">
<primary sortas="b-make">make</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1> </sect1>