r6389 - in trunk/BOOK: . introduction/welcome postlfs/filesystems

alexander at linuxfromscratch.org alexander at linuxfromscratch.org
Sun Jan 14 04:24:50 PST 2007


Author: alexander
Date: 2007-01-14 05:24:50 -0700 (Sun, 14 Jan 2007)
New Revision: 6389

Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/postlfs/filesystems/reiser.xml
   trunk/BOOK/postlfs/filesystems/xfs.xml
Log:
Upgraded xfsprogs, thus fixing a 404 error. Added two lack-of-testsuite notes.


Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2007-01-14 03:53:29 UTC (rev 6388)
+++ trunk/BOOK/general.ent	2007-01-14 12:24:50 UTC (rev 6389)
@@ -68,7 +68,7 @@
 
 <!-- Chapter 5 -->
 <!ENTITY reiser-version               "3.6.19">
-<!ENTITY xfsprogs-version             "2.7.11">
+<!ENTITY xfsprogs-version             "2.8.18">
 
 <!-- Chapter 6 -->
 <!ENTITY vim-version                  "7.0">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2007-01-14 03:53:29 UTC (rev 6388)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2007-01-14 12:24:50 UTC (rev 6389)
@@ -42,6 +42,16 @@
 -->
 
     <listitem>
+      <para>January 14th, 2007</para>
+      <itemizedlist>
+        <listitem>
+          <para>[alexander] - Updated to xfsprogs-2.8.18, added notes about
+	  the lack of testsuites to xfsprogs and reiserfsprogs.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
+    <listitem>
       <para>January 13th, 2007</para>
       <itemizedlist>
         <listitem>

Modified: trunk/BOOK/postlfs/filesystems/reiser.xml
===================================================================
--- trunk/BOOK/postlfs/filesystems/reiser.xml	2007-01-14 03:53:29 UTC (rev 6388)
+++ trunk/BOOK/postlfs/filesystems/reiser.xml	2007-01-14 12:24:50 UTC (rev 6389)
@@ -4,18 +4,6 @@
   <!ENTITY % general-entities SYSTEM "../../general.ent">
   %general-entities;
 
-    <!-- Inserted as a reminder to do this. The mention of a test suite
-         is usually right before the root user installation commands. Please
-         delete these 12 (including one blank) lines after you are done.-->
-
-    <!-- Use one of the two mentions below about a test suite,
-         delete the line that is not applicable. Of course, if the
-         test suite uses syntax other than "make check", revise the
-         line to reflect the actual syntax to run the test suite -->
-
-    <!-- <para>This package does not come with a test suite.</para> -->
-    <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
-
   <!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-md5sum "b42cf15f6651c3ceff5cb84996c0d539">
@@ -80,6 +68,8 @@
 <screen><userinput>./configure --prefix=/usr --sbindir=/sbin &&
 make</userinput></screen>
 
+    <para>This package does not come with a test suite.</para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install &&

Modified: trunk/BOOK/postlfs/filesystems/xfs.xml
===================================================================
--- trunk/BOOK/postlfs/filesystems/xfs.xml	2007-01-14 03:53:29 UTC (rev 6388)
+++ trunk/BOOK/postlfs/filesystems/xfs.xml	2007-01-14 12:24:50 UTC (rev 6389)
@@ -4,24 +4,12 @@
   <!ENTITY % general-entities SYSTEM "../../general.ent">
   %general-entities;
 
-    <!-- Inserted as a reminder to do this. The mention of a test suite
-         is usually right before the root user installation commands. Please
-         delete these 12 (including one blank) lines after you are done.-->
-
-    <!-- Use one of the two mentions below about a test suite,
-         delete the line that is not applicable. Of course, if the
-         test suite uses syntax other than "make check", revise the
-         line to reflect the actual syntax to run the test suite -->
-
-    <!-- <para>This package does not come with a test suite.</para> -->
-    <!-- <para>To test the results, issue: <command>make check</command>.</para> -->
-
-  <!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-md5sum        "d4a78fced98c0f3f32627a473e8e0a59">
-  <!ENTITY xfsprogs-size          "878 KB">
-  <!ENTITY xfsprogs-buildsize     "17.3 MB">
-  <!ENTITY xfsprogs-time          "0.78 SBU">
+  <!ENTITY xfsprogs-download-http "http://mirrors.sunsite.dk/xfs/download/cmd_tars/xfsprogs_&xfsprogs-version;-1.tar.gz">
+  <!ENTITY xfsprogs-download-ftp  "ftp://oss.sgi.com/projects/xfs/download/cmd_tars/xfsprogs_&xfsprogs-version;-1.tar.gz">
+  <!ENTITY xfsprogs-md5sum        "6ce9e198cc79ebec6f6fb1f34ffa7709">
+  <!ENTITY xfsprogs-size          "956 KB">
+  <!ENTITY xfsprogs-buildsize     "17.9 MB">
+  <!ENTITY xfsprogs-time          "0.57 SBU">
 ]>
 
 <sect1 id="xfs" xreflabel="XFS-&xfsprogs-version;">
@@ -78,15 +66,19 @@
     commands:</para>
 
 <screen><userinput>sed -i '/autoconf/d' Makefile &&
-make DEBUG=-DNDEBUG</userinput></screen>
+make DEBUG=-DNDEBUG INSTALL_USER=root INSTALL_GROUP=root \
+    LOCAL_CONFIGURE_OPTIONS="--enable-readline=yes"</userinput></screen>
 
+    <para>This package does not come with a test suite.</para>
+
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make install &&
+make install-dev &&
+install -v -m755 -D libhandle/libhandle.la /usr/lib/libhandle.la &&
 chmod -v 755 /lib/libhandle.so* &&
-install -v -m755 -D libhandle/libhandle.la /usr/lib/libhandle.la &&
-install -v -m644 libhandle/.libs/libhandle.a /usr/lib &&
-ln -sv ../../lib/libhandle.so.1 /usr/lib/libhandle.so</userinput></screen>
+rm -f /lib/libhandle.{a,la,so} &&
+ln -svf ../../lib/libhandle.so.1 /usr/lib/libhandle.so</userinput></screen>
 
   </sect2>
 
@@ -100,18 +92,32 @@
     <para><command>make DEBUG=-DNDEBUG</command>: The <application>XFS
     </application> build will fail using the default -DDEBUG flags.</para>
 
+    <para><parameter>INSTALL_USER=root INSTALL_GROUP=root</parameter>: This
+    sets the owner and group of the installed files.</para>
+    <!-- relevant only if building as non-root -->
+    
+    <para><parameter>LOCAL_CONFIGURE_OPTIONS="..."</parameter>: This passes
+    extra configuration options to the <filename>configure</filename> script.
+    The example <parameter>--enable-readline=yes</parameter> parameter
+    enables linking the XFS programs with the
+    <filename class="libraryfile">libreadline.so</filename> library, in order
+    to allow editing interactive commands.</para>
+    
     <para><parameter>OPTIMIZER="..."</parameter>: Adding this parameter to
-    the <command>make</command> command overrides the default optimization
-    settings.</para>
+    the end of the <command>make</command> command overrides the
+    default optimization settings.</para>
 
-    <para><command>install -v ...</command>: These commands install the
-    static library and libtool archive for <filename>libhandle</filename>
-    since <command>make install</command> only installs the shared
-    library.</para>
+    <para><command>make install-dev</command>: This command installs
+    static XFS libraries, their headers and the corresponding documentation.
+    Currently, <ulink url="ftp://oss.sgi.com/projects/xfs/">DMAPI</ulink>
+    and <ulink url="ftp://oss.sgi.com/projects/xfs/">xfsdump</ulink> are
+    the only packages that use the installed libraries.</para>
+    <!-- checked with the Debian package database as of 2007-01-14 -->
+    
+    <para><command>install -v ...</command> and the three following commands
+    fix the installation of <filename class="libraryfile">libhandle</filename>
+    libraries.</para>
 
-    <para><command>ln -sv ...</command>: This command installs a symlink
-    that is missed by the <command>make install</command> command.</para>
-
   </sect2>
 
   <sect2 role="content">
@@ -119,14 +125,14 @@
 
     <segmentedlist>
       <segtitle>Installed Programs</segtitle>
-      <segtitle>Installed Library</segtitle>
+      <segtitle>Installed Libraries</segtitle>
       <segtitle>Installed Directory</segtitle>
 
       <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,a}</seg>
+        xfs_mkfile, xfs_ncheck, xfs_quota, xfs_repair, and xfs_rtcp</seg>
+        <seg>libdisk.a, libhandle.{so,a}, libxcmd.a, libxfs.a, and libxlog.a </seg>
         <seg>/usr/share/doc/xfsprogs</seg>
       </seglistitem>
     </segmentedlist>
@@ -317,13 +323,16 @@
       <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>
+          <para>contains XFS-specific functions that provide a way to perform
+	  certain filesystem  operations without using a file descriptor to
+	  access filesystem objects.</para>
           <indexterm zone="xfs libhandle">
             <primary sortas="c-libhandle">libhandle.so</primary>
           </indexterm>
         </listitem>
       </varlistentry>
+      
+      <!-- FIXME: other libraries are undocumented -->
 
     </variablelist>
 




More information about the blfs-book mailing list