newxml/chapter06/e2fsprogs.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3CR2//EN" "http://www.docbook.org/xml/4.3CR2/docbookx.dtd" [
   3   <!ENTITY % e2fsprogs-entities SYSTEM "../ent/e2fsprogs.ent">
   4   %e2fsprogs-entities;
   5 ]>
   6 <sect1 id="ch06-e2fsprogs">
   7 <title>Installing E2fsprogs-&e2fsprogs-version;</title>
   8 <?dbhtml filename="e2fsprogs.html"?>
   9
  10 <screen>Estimated build time:           0.6 SBU
  11 Estimated required disk space:  48.4 MB</screen>
  12
  13 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../appendixa/e2fsprogs-contents.xml"/>
  14
  15
  16
  17 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../appendixa/e2fsprogs-deps.xml"/>
  18
  19
  20
  21 <sect2>
  22 <title>Installation of E2fsprogs</title>
  23
  24 <para>It is recommended to build E2fsprogs outside of the
  25 source tree:</para>
  26
  27 <screen><userinput>mkdir ../e2fsprogs-build
  28 cd ../e2fsprogs-build</userinput></screen>
  29
  30 <para>Prepare E2fsprogs for compilation:</para>
  31
  32 <screen><userinput>../e2fsprogs-&e2fsprogs-version;/configure --prefix=/usr --with-root-prefix="" \
  33     --enable-elf-shlibs</userinput></screen>
  34
  35 <para>The meaning of the configure options:</para>
  36
  37 <itemizedlist>
  38 <listitem><para><userinput>--with-root-prefix=""</userinput>: Certain
  39 programs (such as the e2fsck program) are considered essential programs.
  40 When, for example, <filename class="directory">/usr</filename> isn't
  41 mounted, these essential programs have to be available. They belong in
  42 directories like <filename class="directory">/lib</filename> and
  43 <filename class="directory">/sbin</filename>. If this option isn't passed
  44 to E2fsprogs's configure, the programs are placed in the
  45 <filename class="directory">/usr</filename> directory, which is not what we
  46 want.</para></listitem>
  47
  48 <listitem><para><userinput>--enable-elf-shlibs</userinput>: This creates
  49 the shared libraries which some programs in this package make use
  50 of.</para></listitem>
  51 </itemizedlist>
  52
  53 <para>Compile the package:</para>
  54
  55 <screen><userinput>make</userinput></screen>
  56
  57 <para>This package has a test suite available which can perform a number of
  58 checks to ensure it built correctly.  Should you choose to run it, the
  59 following command will do so:</para>
  60
  61 <screen><userinput>make check</userinput></screen>
  62
  63 <para>Install most of the package:</para>
  64
  65 <screen><userinput>make install</userinput></screen>
  66
  67 <para>And install also the shared libraries:</para>
  68
  69 <screen><userinput>make install-libs</userinput></screen>
  70
  71 </sect2>
  72
  73
  74 </sect1>