[673b0d8] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
[b06ca36] | 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
---|
[673b0d8] | 4 | <!ENTITY % general-entities SYSTEM "../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 | ]>
|
---|
[09fb7a09] | 7 |
|
---|
[9652249] | 8 | <sect1 id="ch-tools-coreutils" role="wrap">
|
---|
[09fb7a09] | 9 | <?dbhtml filename="coreutils.html"?>
|
---|
| 10 |
|
---|
[e747759] | 11 | <sect1info condition="script">
|
---|
| 12 | <productname>coreutils</productname>
|
---|
| 13 | <productnumber>&coreutils-version;</productnumber>
|
---|
| 14 | <address>&coreutils-url;</address>
|
---|
| 15 | </sect1info>
|
---|
| 16 |
|
---|
[09fb7a09] | 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/>
|
---|
[bc82645e] | 26 |
|
---|
[09fb7a09] | 27 | <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
|
---|
| 28 | href="../chapter06/coreutils.xml"
|
---|
| 29 | xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
|
---|
[81fd230] | 30 |
|
---|
[09fb7a09] | 31 | <segmentedlist>
|
---|
| 32 | <segtitle>&buildtime;</segtitle>
|
---|
| 33 | <segtitle>&diskspace;</segtitle>
|
---|
[5888299] | 34 |
|
---|
[09fb7a09] | 35 | <seglistitem>
|
---|
[e4a5635] | 36 | <seg>&coreutils-ch5-sbu;</seg>
|
---|
| 37 | <seg>&coreutils-ch5-du;</seg>
|
---|
[09fb7a09] | 38 | </seglistitem>
|
---|
| 39 | </segmentedlist>
|
---|
[673b0d8] | 40 |
|
---|
[09fb7a09] | 41 | </sect2>
|
---|
[73aedd1d] | 42 |
|
---|
[09fb7a09] | 43 | <sect2 role="installation">
|
---|
| 44 | <title>Installation of Coreutils</title>
|
---|
[73aedd1d] | 45 |
|
---|
[f3c13ba] | 46 | <para>There's an internal issue with Coreutils which makes some of the
|
---|
| 47 | programs behave abnormally if you build using an older kernel. Apply a
|
---|
| 48 | patch to fix the issue:</para>
|
---|
[a5933e2] | 49 |
|
---|
| 50 | <screen><userinput remap="pre">patch -Np1 -i ../&coreutils-old-kernel-patch;</userinput></screen>
|
---|
| 51 |
|
---|
[615a565] | 52 | <para>Prepare Coreutils for compilation:</para>
|
---|
[2a7ac34] | 53 |
|
---|
[615a565] | 54 | <screen><userinput remap="configure">./configure --prefix=/tools --enable-install-program=hostname</userinput></screen>
|
---|
[2a7ac34] | 55 |
|
---|
[615a565] | 56 | <variablelist>
|
---|
| 57 | <title>The meaning of the configure options:</title>
|
---|
[673b0d8] | 58 |
|
---|
[615a565] | 59 | <varlistentry>
|
---|
| 60 | <term><envar>--enable-install-program=hostname</envar></term>
|
---|
| 61 | <listitem>
|
---|
| 62 | <para>This enables the <command>hostname</command> binary to be built
|
---|
| 63 | and installed – it is disabled by default but is required by the
|
---|
| 64 | Perl test suite.</para>
|
---|
| 65 | </listitem>
|
---|
| 66 | </varlistentry>
|
---|
| 67 | </variablelist>
|
---|
[81fd230] | 68 |
|
---|
[09fb7a09] | 69 | <para>Compile the package:</para>
|
---|
[73aedd1d] | 70 |
|
---|
[0445a3d] | 71 | <screen><userinput remap="make">make</userinput></screen>
|
---|
[73aedd1d] | 72 |
|
---|
[0445a3d] | 73 | <para>To test the results, issue:</para>
|
---|
| 74 |
|
---|
| 75 | <screen><userinput remap="test">make RUN_EXPENSIVE_TESTS=yes check</userinput></screen>
|
---|
| 76 |
|
---|
| 77 | <para>The <parameter>RUN_EXPENSIVE_TESTS=yes</parameter> parameter tells the
|
---|
[09fb7a09] | 78 | test suite to run several additional tests that are considered
|
---|
| 79 | relatively expensive (in terms of CPU power and memory usage) on some
|
---|
| 80 | platforms, but generally are not a problem on Linux.</para>
|
---|
[73aedd1d] | 81 |
|
---|
[09fb7a09] | 82 | <para>Install the package:</para>
|
---|
[73aedd1d] | 83 |
|
---|
[0445a3d] | 84 | <screen><userinput remap="install">make install</userinput></screen>
|
---|
[73aedd1d] | 85 |
|
---|
[f4c628c] | 86 | <para>The above command refuses to install <filename>su</filename>
|
---|
[182d5d3] | 87 | because the program cannot be installed setuid root as a non-privileged
|
---|
| 88 | user. By manually installing it with a different name, we can use it for
|
---|
| 89 | running tests in the final system as a non-privileged user and we keep a
|
---|
| 90 | possibly useful <command>su</command> from our host first in our PATH.
|
---|
| 91 | Install it with:</para>
|
---|
[f4c628c] | 92 |
|
---|
[0445a3d] | 93 | <screen><userinput remap="install">cp -v src/su /tools/bin/su-tools</userinput></screen>
|
---|
[f4c628c] | 94 |
|
---|
[09fb7a09] | 95 | </sect2>
|
---|
[bc82645e] | 96 |
|
---|
[09fb7a09] | 97 | <sect2 role="content">
|
---|
| 98 | <title/>
|
---|
[81fd230] | 99 |
|
---|
[09fb7a09] | 100 | <para>Details on this package are located in
|
---|
| 101 | <xref linkend="contents-coreutils" role="."/></para>
|
---|
| 102 |
|
---|
| 103 | </sect2>
|
---|
[81fd230] | 104 |
|
---|
[09fb7a09] | 105 | </sect1>
|
---|