r3346 - trunk/BOOK/postlfs/filesystems

randy at linuxfromscratch.org randy at linuxfromscratch.org
Thu Jan 27 10:24:30 PST 2005


Author: randy
Date: 2005-01-27 11:24:29 -0700 (Thu, 27 Jan 2005)
New Revision: 3346

Modified:
   trunk/BOOK/postlfs/filesystems/ext3.xml
   trunk/BOOK/postlfs/filesystems/reiser.xml
   trunk/BOOK/postlfs/filesystems/xfs.xml
Log:
Added indexing tags to Chapter 5 package instructions

Modified: trunk/BOOK/postlfs/filesystems/ext3.xml
===================================================================
--- trunk/BOOK/postlfs/filesystems/ext3.xml	2005-01-27 15:36:13 UTC (rev 3345)
+++ trunk/BOOK/postlfs/filesystems/ext3.xml	2005-01-27 18:24:29 UTC (rev 3346)
@@ -46,7 +46,7 @@
 /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>

Modified: trunk/BOOK/postlfs/filesystems/reiser.xml
===================================================================
--- trunk/BOOK/postlfs/filesystems/reiser.xml	2005-01-27 15:36:13 UTC (rev 3345)
+++ trunk/BOOK/postlfs/filesystems/reiser.xml	2005-01-27 18:24:29 UTC (rev 3346)
@@ -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 @@
 commands:</para>
 
 <screen><userinput><command>./configure --prefix=/usr --sbindir=/sbin &&
-make &&
-make install &&
+make</command></userinput></screen>
+
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>make install &&
 ln -sf reiserfsck /sbin/fsck.reiserfs &&
 ln -sf mkreiserfs /sbin/mkfs.reiserfs</command></userinput></screen>
 
@@ -59,61 +65,84 @@
 
 <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>
+<indexterm zone="reiserfs resize_reiserfs">
+<primary sortas="b-resize_reiserfs">resize_reiserfs</primary>
+</indexterm></listitem>
+</varlistentry>
+</variablelist>
 
-<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>
-
 </sect2>
 
 </sect1>

Modified: trunk/BOOK/postlfs/filesystems/xfs.xml
===================================================================
--- trunk/BOOK/postlfs/filesystems/xfs.xml	2005-01-27 15:36:13 UTC (rev 3345)
+++ trunk/BOOK/postlfs/filesystems/xfs.xml	2005-01-27 18:24:29 UTC (rev 3346)
@@ -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 @@
 
 </sect2>
 
-
 <sect2>
 <title>Installation of <application>XFS</application></title>
 
@@ -48,106 +51,184 @@
 commands:</para>
 
 <screen><userinput><command>sed -i 's/autoconf//' Makefile &&
-make &&
-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>
 
 </sect1>




More information about the blfs-book mailing list