chapter05/coreutils.xml

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
   4   <!ENTITY % general-entities SYSTEM "../general.ent">
   5   %general-entities;
   6 ]>
   7
   8 <sect1 id="ch-tools-coreutils" role="wrap">
   9   <?dbhtml filename="coreutils.html"?>
  10
  11   <sect1info condition="script">
  12     <productname>coreutils</productname>
  13     <productnumber>&coreutils-version;</productnumber>
  14     <address>&coreutils-url;</address>
  15   </sect1info>
  16
  17   <title>Coreutils-&coreutils-version;</title>
  18
  19   <indexterm zone="ch-tools-coreutils">
  20     <primary sortas="a-Coreutils">Coreutils</primary>
  21     <secondary>tools</secondary>
  22   </indexterm>
  23
  24   <sect2 role="package">
  25     <title/>
  26
  27     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
  28     href="../chapter06/coreutils.xml"
  29     xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
  30
  31     <segmentedlist>
  32       <segtitle>&buildtime;</segtitle>
  33       <segtitle>&diskspace;</segtitle>
  34
  35       <seglistitem>
  36         <seg>&coreutils-ch5-sbu;</seg>
  37         <seg>&coreutils-ch5-du;</seg>
  38       </seglistitem>
  39     </segmentedlist>
  40
  41   </sect2>
  42
  43   <sect2 role="installation">
  44     <title>Installation of Coreutils</title>
  45
  46     <para>Prepare Coreutils for compilation:</para>
  47
  48 <screen><userinput remap="configure">./configure --prefix=/tools --enable-install-program=hostname</userinput></screen>
  49
  50     <variablelist>
  51       <title>The meaning of the configure options:</title>
  52
  53       <varlistentry>
  54         <term><envar>--enable-install-program=hostname</envar></term>
  55         <listitem>
  56           <para>This enables the <command>hostname</command> binary to be built
  57           and installed &ndash; it is disabled by default but is required by the
  58           Perl test suite.</para>
  59         </listitem>
  60       </varlistentry>
  61     </variablelist>
  62
  63     <para>Compile the package:</para>
  64
  65 <screen><userinput remap="make">make</userinput></screen>
  66
  67     <para>Compilation is now complete. As discussed earlier, running the test
  68     suite is not mandatory for the temporary tools here in this chapter. To run
  69     the Coreutils test suite anyway, issue the following command:</para>
  70
  71 <screen><userinput remap="test">make RUN_EXPENSIVE_TESTS=yes check</userinput></screen>
  72
  73     <para>The <parameter>RUN_EXPENSIVE_TESTS=yes</parameter> parameter tells the
  74     test suite to run several additional tests that are considered
  75     relatively expensive (in terms of CPU power and memory usage) on some
  76     platforms, but generally are not a problem on Linux.</para>
  77
  78     <para>Install the package:</para>
  79
  80 <screen><userinput remap="install">make install</userinput></screen>
  81
  82     <para>The above command refuses to install <filename>su</filename>
  83     because the program cannot be installed setuid root as a non-privileged
  84     user. By manually installing it with a different name, we can use it for
  85     running tests in the final system as a non-privileged user and we keep a
  86     possibly useful <command>su</command> from our host first in our PATH.
  87     Install it with:</para>
  88
  89 <screen><userinput remap="install">cp -v src/su /tools/bin/su-tools</userinput></screen>
  90
  91   </sect2>
  92
  93   <sect2 role="content">
  94     <title/>
  95
  96     <para>Details on this package are located in
  97     <xref linkend="contents-coreutils" role="."/></para>
  98
  99   </sect2>
 100
 101 </sect1>