Added a few comments here and there
[linux_from_scratch.git] / BOOK / chapter06 / e2fsprogs.xml
blobd55d51ae74cbc40b2deb7bd6ac66aef5ed835533
1 <sect1 id="ch-system-e2fsprogs" xreflabel="E2fsprogs">
2 <title>Installing E2fsprogs-&e2fsprogs-version;</title>
3 <?dbhtml filename="e2fsprogs.html" dir="chapter06"?>
5 <para>The E2fsprogs package contains the utilities for handling the ext2
6 file system. It also supports the ext3 journaling file system.</para>
8 <screen>&buildtime; &e2fsprogs-time;
9 &diskspace; &e2fsprogs-compsize;</screen>
11 &aa-e2fsprogs-down;
12 &aa-e2fsprogs-dep;
14 <sect2><title>&nbsp;</title><para>&nbsp;</para></sect2>
16 <sect2>
17 <title>Installation of E2fsprogs</title>
19 <para>It is recommended to build E2fsprogs outside of the
20 source tree:</para>
22 <screen><userinput>mkdir ../e2fsprogs-build
23 cd ../e2fsprogs-build</userinput></screen>
25 <para>Prepare E2fsprogs for compilation:</para>
27 <screen><userinput>../&e2fsprogs-dir;/configure --prefix=/usr --with-root-prefix="" \
28 &nbsp;&nbsp;&nbsp;&nbsp;--enable-elf-shlibs</userinput></screen>
30 <para>The meaning of the configure options:</para>
32 <itemizedlist>
33 <listitem><para><userinput>--with-root-prefix=""</userinput>: Certain
34 programs (such as the e2fsck program) are considered essential programs.
35 When, for example, <filename class="directory">/usr</filename> isn't
36 mounted, these essential programs have to be available. They belong in
37 directories like <filename class="directory">/lib</filename> and
38 <filename class="directory">/sbin</filename>. If this option isn't passed
39 to E2fsprogs's configure, the programs are placed in the
40 <filename class="directory">/usr</filename> directory, which is not what we
41 want.</para></listitem>
43 <listitem><para><userinput>--enable-elf-shlibs</userinput>: This creates
44 the shared libraries which some programs in this package make use
45 of.</para></listitem>
46 </itemizedlist>
48 <para>Compile the package:</para>
50 <screen><userinput>make</userinput></screen>
52 <para>This package has a test suite available which can perform a number of
53 checks to ensure it built correctly.  Should you choose to run it, the 
54 following command will do so:</para>
56 <screen><userinput>make check</userinput></screen>
58 <para>Install most of the package:</para>
60 <screen><userinput>make install</userinput></screen>
62 <para>And install also the shared libraries:</para>
64 <screen><userinput>make install-libs</userinput></screen>
66 </sect2>
69 &aa-e2fsprogs-shortdesc;
70 &aa-e2fsprogs-desc;
72 </sect1>