Added indexing tags to Chapter 5 package instructions

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3346 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Randy McMurchy 2005-01-27 18:24:29 +00:00
parent 852cd813c3
commit dcee0f2f13
3 changed files with 233 additions and 123 deletions

View File

@ -46,7 +46,7 @@ if you accidentally skip enabling the ext3 support in the kernel.</para>
/etc/fstab</filename>, enable the journal for the partition by running the
following command.</para>
<screen><userinput><command>tune2fs -j /dev/hd<replaceable>XX</replaceable></command></userinput></screen>
<screen><userinput role='root'><command>tune2fs -j /dev/hd<replaceable>XX</replaceable></command></userinput></screen>
<para>Remount the concerned partitions, or simply reboot if you have
recompiled the kernel to enable ext3 support.</para>

View File

@ -7,7 +7,7 @@
<!ENTITY reiser-download-http "http://ftp.namesys.com/pub/reiserfsprogs/reiserfsprogs-&reiser-version;.tar.gz">
<!ENTITY reiser-download-ftp "ftp://ftp.namesys.com/pub/reiserfsprogs/reiserfsprogs-&reiser-version;.tar.gz">
<!ENTITY reiser-size "400 KB">
<!ENTITY reiser-buildsize "5.8 MB">
<!ENTITY reiser-buildsize "7.9 MB">
<!ENTITY reiser-time "0.16 SBU">
]>
@ -18,6 +18,9 @@
</sect1info>
<?dbhtml filename="reiserfs.html"?>
<title>ReiserFS-&reiser-version;</title>
<indexterm zone="reiserfs">
<primary sortas="a-ReiserFS">ReiserFS</primary>
</indexterm>
<sect2>
<title>Introduction to <application>ReiserFS</application></title>
@ -47,8 +50,11 @@ url="&reiser-download-ftp;"/></para></listitem>
commands:</para>
<screen><userinput><command>./configure --prefix=/usr --sbindir=/sbin &amp;&amp;
make &amp;&amp;
make install &amp;&amp;
make</command></userinput></screen>
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install &amp;&amp;
ln -sf reiserfsck /sbin/fsck.reiserfs &amp;&amp;
ln -sf mkreiserfs /sbin/mkfs.reiserfs</command></userinput></screen>
@ -59,60 +65,83 @@ ln -sf mkreiserfs /sbin/mkfs.reiserfs</command></userinput></screen>
<para><parameter>--prefix=/usr</parameter>: This ensures that
the manual pages are installed in the correct location while still
installing the programs in <filename class="directory">/sbin</filename> as they should
be.</para>
installing the programs in <filename class="directory">/sbin</filename> as
they should be.</para>
<para><parameter>--sbindir=/sbin</parameter>: This ensures that the
<application>ReiserFS</application>
utilities are installed in <filename class="directory">/sbin</filename> as they should be.</para>
<application>ReiserFS</application> utilities are installed in
<filename class="directory">/sbin</filename> as they should be.</para>
</sect2>
<sect2>
<title>Contents</title>
<para><application>ReiserFS</application> contains <command>debugreiserfs</command>,
<command>mkreiserfs</command>, <command>reiserfsck</command>,
<command>resize_reiserfs</command> and
<command>unpack</command>.</para>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
</sect2>
<seglistitem>
<seg>debugreiserfs, mkreiserfs, reiserfsck, reiserfstune and
resize_reiserfs</seg>
<seg>None</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<sect2><title>Description</title>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<sect3><title>debugreiserfs</title>
<varlistentry id="debugreiserfs">
<term><command>debugreiserfs</command></term>
<listitem><para>can sometimes help to solve problems with
<application>ReiserFS</application> file systems. If it is called without
options, it prints the super block of any reiserfs file system found on the
device.</para>
<indexterm zone="reiserfs debugreiserfs">
<primary sortas="b-debugreiserfs">debugreiserfs</primary>
</indexterm></listitem>
</varlistentry>
<para><command>debugreiserfs</command> can sometimes help to solve problems
with <application>ReiserFS</application> file systems. If it is called without
options, it prints the super block of any reiserfs file system found on the
device.</para></sect3>
<varlistentry id="mkreiserfs">
<term><command>mkreiserfs</command></term>
<listitem><para>creates a <application>ReiserFS</application> file
system.</para>
<indexterm zone="reiserfs mkreiserfs">
<primary sortas="b-mkreiserfs">mkreiserfs</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>mkreiserfs</title>
<para><command>mkreiserfs</command> creates a
<varlistentry id="reiserfsck">
<term><command>reiserfsck</command></term>
<listitem><para>is used to check or repair a
<application>ReiserFS</application> file system.</para>
</sect3>
<indexterm zone="reiserfs reiserfsck">
<primary sortas="b-reiserfsck">reiserfsck</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>reiserfsck</title>
<para><command>reiserfsck</command> checks a
<varlistentry id="reiserfstune">
<term><command>reiserfstune</command></term>
<listitem><para>is used for tuning the <application>ReiserFS</application>
journal. <emphasis>WARNING</emphasis>: Don't use this utility without first
reading the man page thoroughly.</para>
<indexterm zone="reiserfs reiserfstune">
<primary sortas="b-reiserfstune">reiserfstune</primary>
</indexterm></listitem>
</varlistentry>
<varlistentry id="resize_reiserfs">
<term><command>resize_reiserfs</command></term>
<listitem><para>is used to resize an unmounted
<application>ReiserFS</application> file system.</para>
</sect3>
<sect3><title>reiserfstune</title>
<para><command>reiserfstune</command> is used for tuning the
<application>ReiserFS</application> journal.
<emphasis>WARNING</emphasis>: Don't use this utility without first reading the
man page thoroughly.</para></sect3>
<sect3><title>resize_reiserfs</title>
<para><command>resize_reiserfs</command> is used to resize an unmounted
<application>ReiserFS</application> file system.</para></sect3>
<sect3><title>unpack</title>
<para>The <command>unpack</command> utility can be used to dump
<application>ReiserFS</application>
file system information to files for debugging, much like
<command>debugreiserfs</command>.
</para></sect3>
<indexterm zone="reiserfs resize_reiserfs">
<primary sortas="b-resize_reiserfs">resize_reiserfs</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
</sect2>

View File

@ -5,10 +5,10 @@
%general-entities;
<!ENTITY xfsprogs-download-http "http://mirrors.sunsite.dk/xfs/download/cmd_tars/xfsprogs-&xfsprogs-version;.src.tar.gz">
<!ENTITY xfsprogs-download-ftp "ftp://oss.sgi.com/projects/xfs/download/cmd_tars/xfsprogs-&xfsprogs-version;.src.tar.gz">
<!ENTITY xfsprogs-size "833 KB">
<!ENTITY xfsprogs-buildsize "19 MB">
<!ENTITY xfsprogs-time "0.69 SBU">
<!ENTITY xfsprogs-download-ftp "ftp://oss.sgi.com/projects/xfs/download/cmd_tars/xfsprogs-&xfsprogs-version;.src.tar.gz">
<!ENTITY xfsprogs-size "833 KB">
<!ENTITY xfsprogs-buildsize "25.2 MB">
<!ENTITY xfsprogs-time "0.59 SBU">
]>
<sect1 id="xfs" xreflabel="XFS-&xfsprogs-version;">
@ -18,9 +18,13 @@
</sect1info>
<?dbhtml filename="xfsfs.html"?>
<title>XFS-&xfsprogs-version;</title>
<indexterm zone="xfs">
<primary sortas="a-XFS">XFS</primary>
</indexterm>
<sect2>
<title>Introduction to <application><acronym>XFS</acronym></application></title>
<title>Introduction to
<application><acronym>XFS</acronym></application></title>
<para>The <application>XFS</application> package contains administration
and debugging tools for the <acronym>XFS</acronym> file system.</para>
@ -40,7 +44,6 @@ url="&xfsprogs-download-ftp;"/></para></listitem>
</sect2>
<sect2>
<title>Installation of <application>XFS</application></title>
@ -48,105 +51,183 @@ url="&xfsprogs-download-ftp;"/></para></listitem>
commands:</para>
<screen><userinput><command>sed -i 's/autoconf//' Makefile &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
make</command></userinput></screen>
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
</sect2>
<sect2>
<title>Contents</title>
<para><application>XFS</application> contains
<command>fsck.xfs</command>,
<command>mkfs.xfs</command>,
<command>xfs_admin</command>,
<command>xfs_bmap</command>,
<command>xfs_check</command>,
<command>xfs_copy</command>,
<command>xfs_db</command>,
<command>xfs_freeze</command>,
<command>xfs_growfs</command>,
<command>xfs_info</command>,
<command>xfs_io</command>,
<command>xfs_logprint</command>,
<command>xfs_mkfile</command>,
<command>xfs_ncheck</command>,
<command>xfs_repair</command> and
<command>xfs_rtcp</command>.
</para>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
</sect2>
<seglistitem>
<seg>fsck.xfs, mkfs.xfs, xfs_admin, xfs_bmap, xfs_check, xfs_copy, xfs_db,
xfs_freeze, xfs_growfs, xfs_info, xfs_io, xfs_logprint, xfs_mkfile,
xfs_ncheck, xfs_repair and xfs_rtcp</seg>
<seg>libhandle.so</seg>
<seg>/usr/share/doc/xfsprogs</seg>
</seglistitem>
</segmentedlist>
<sect2><title>Description</title>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<sect3><title>fsck.xfs</title>
<para><command>fsck.xfs</command> simply exits with a zero status, since
<acronym>XFS</acronym> partitions are checked at mount time.</para></sect3>
<varlistentry id="fsck.xfs">
<term><command>fsck.xfs</command></term>
<listitem><para>simply exits with a zero status, since <acronym>XFS</acronym>
partitions are checked at mount time.</para>
<indexterm zone="xfs fsck.xfs">
<primary sortas="b-fsck.xfs">fsck.xfs</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>mkfs.xfs</title>
<para><command>mkfs.xfs</command> constructs an <acronym>XFS</acronym>
file system.</para></sect3>
<varlistentry id="mkfs.xfs">
<term><command>mkfs.xfs</command></term>
<listitem><para>constructs an <acronym>XFS</acronym> file system.</para>
<indexterm zone="xfs mkfs.xfs">
<primary sortas="b-mkfs.xfs">mkfs.xfs</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>xfs_admin</title>
<para><command>xfs_admin</command> changes the parameters of an <acronym>XFS
</acronym> file system.</para></sect3>
<varlistentry id="xfs_admin">
<term><command>xfs_admin</command></term>
<listitem><para>changes the parameters of an <acronym>XFS</acronym> file
system.</para>
<indexterm zone="xfs xfs_admin">
<primary sortas="b-xfs_admin">xfs_admin</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>xfs_bmap</title>
<para><command>xfs_bmap</command> prints block mapping for an <acronym>XFS
</acronym> file.</para></sect3>
<varlistentry id="xfs_bmap">
<term><command>xfs_bmap</command></term>
<listitem><para>prints block mapping for an <acronym>XFS</acronym> file.</para>
<indexterm zone="xfs xfs_bmap">
<primary sortas="b-xfs_bmap">xfs_bmap</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>xfs_check</title>
<para><command>xfs_check</command> checks <acronym>XFS</acronym> file system
consistency.</para>
</sect3>
<varlistentry id="xfs_check">
<term><command>xfs_check</command></term>
<listitem><para>checks <acronym>XFS</acronym> file system consistency.</para>
<indexterm zone="xfs xfs_check">
<primary sortas="b-xfs_check">xfs_check</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>xfs_copy</title>
<para><command>xfs_copy</command> copies the contents of an
<acronym>XFS</acronym> file system to one or more targets in
parallel.</para></sect3>
<varlistentry id="xfs_copy">
<term><command>xfs_copy</command></term>
<listitem><para>copies the contents of an <acronym>XFS</acronym> file system
to one or more targets in parallel.</para>
<indexterm zone="xfs xfs_copy">
<primary sortas="b-xfs_copy">xfs_copy</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>xfs_db</title>
<para><command>xfs_db</command> is used to debug an <acronym>XFS</acronym>
file system.</para></sect3>
<varlistentry id="xfs_db">
<term><command>xfs_db</command></term>
<listitem><para>is used to debug an <acronym>XFS</acronym> file system.</para>
<indexterm zone="xfs xfs_db">
<primary sortas="b-xfs_db">xfs_db</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>xfs_freeze</title>
<para><command>xfs_freeze</command> suspends access to an
<acronym>XFS</acronym> file system.</para></sect3>
<varlistentry id="xfs_freeze">
<term><command>xfs_freeze</command></term>
<listitem><para>suspends access to an <acronym>XFS</acronym> file
system.</para>
<indexterm zone="xfs xfs_freeze">
<primary sortas="b-xfs_freeze">xfs_freeze</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>xfs_growfs</title>
<para><command>xfs_growfs</command> expands an <acronym>XFS</acronym> file system.
</para></sect3>
<varlistentry id="xfs_growfs">
<term><command>xfs_growfs</command></term>
<listitem><para>expands an <acronym>XFS</acronym> file system.</para>
<indexterm zone="xfs xfs_growfs">
<primary sortas="b-xfs_growfs">xfs_growfs</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>xfs_info</title>
<para><command>xfs_info</command> is equivalent to invoking
<command>xfs_growfs</command>, but specifying that no change to the file
system is to be made.</para></sect3>
<varlistentry id="xfs_info">
<term><command>xfs_info</command></term>
<listitem><para>is equivalent to invoking <command>xfs_growfs</command>, but
specifying that no change to the file system is to be made.</para>
<indexterm zone="xfs xfs_info">
<primary sortas="b-xfs_info">xfs_info</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>xfs_io</title>
<para><command>xfs_io</command> is a debugging tool like
<command>xfs_db</command>, but is aimed at examining the regular
file I/O path rather than the raw <acronym>XFS</acronym> volume
itself.</para></sect3>
<varlistentry id="xfs_io">
<term><command>xfs_io</command></term>
<listitem><para>is a debugging tool like <command>xfs_db</command>, but is
aimed at examining the regular file I/O path rather than the raw
<acronym>XFS</acronym> volume itself.</para>
<indexterm zone="xfs xfs_io">
<primary sortas="b-xfs_io">xfs_io</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>xfs_logprint</title>
<para><command>xfs_logprint</command> prints the log of an <acronym>XFS
</acronym> file system.</para></sect3>
<varlistentry id="xfs_logprint">
<term><command>xfs_logprint</command></term>
<listitem><para>prints the log of an <acronym>XFS</acronym> file system.</para>
<indexterm zone="xfs xfs_logprint">
<primary sortas="b-xfs_logprint">xfs_logprint</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>xfs_mkfile</title>
<para><command>xfs_mkfile</command> creates an <acronym>XFS</acronym> file,
padded with zeroes by default.</para></sect3>
<varlistentry id="xfs_mkfile">
<term><command>xfs_mkfile</command></term>
<listitem><para>creates an <acronym>XFS</acronym> file, padded with zeroes by
default.</para>
<indexterm zone="xfs xfs_mkfile">
<primary sortas="b-xfs_mkfile">xfs_mkfile</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>xfs_ncheck</title>
<para><command>xfs_ncheck</command> generates pathnames from inode numbers for
an <acronym>XFS</acronym> file system.</para></sect3>
<varlistentry id="xfs_ncheck">
<term><command>xfs_ncheck</command></term>
<listitem><para>generates pathnames from inode numbers for an
<acronym>XFS</acronym> file system.</para>
<indexterm zone="xfs xfs_ncheck">
<primary sortas="b-xfs_ncheck">xfs_ncheck</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>xfs_repair</title>
<para><command>xfs_repair</command> repairs corrupt or damaged <acronym>XFS
</acronym>file systems.</para></sect3>
<varlistentry id="xfs_repair">
<term><command>xfs_repair</command></term>
<listitem><para>repairs corrupt or damaged <acronym>XFS</acronym>file
systems.</para>
<indexterm zone="xfs xfs_repair">
<primary sortas="b-xfs_repair">xfs_repair</primary>
</indexterm></listitem>
</varlistentry>
<sect3><title>xfs_rtcp</title>
<para><command>xfs_rtcp</command> copies a file to the real-time
partition on an <acronym>XFS</acronym> file system.</para></sect3>
<varlistentry id="xfs_rtcp">
<term><command>xfs_rtcp</command></term>
<listitem><para>copies a file to the real-time partition on an
<acronym>XFS</acronym> file system.</para>
<indexterm zone="xfs xfs_rtcp">
<primary sortas="b-xfs_rtcp">xfs_rtcp</primary>
</indexterm></listitem>
</varlistentry>
<varlistentry id="libhandle">
<term><filename class='libraryfile'>libhandle.so</filename></term>
<listitem><para>contains functions to map filesystem handles to a
corresponding open file descriptor for that filesystem.</para>
<indexterm zone="xfs libhandle">
<primary sortas="c-libhandle">libhandle.so</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
</sect2>