source: chapter05/coreutils.xml@ 0b5096ca

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>
<sect1 id="ch-tools-coreutils" role="wrap">
<title>Coreutils-&coreutils-version;</title>
<?dbhtml filename="coreutils.html"?>

<indexterm zone="ch-tools-coreutils">
<primary sortas="a-Coreutils">Coreutils</primary>
<secondary>tools</secondary></indexterm>

<sect2 role="package"><title/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/coreutils.xml" xpointer="xpointer(/sect1/sect2[1]/para[1])"/>

<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.9 SBU</seg><seg>69 MB</seg></seglistitem>
</segmentedlist>

<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/coreutils.xml" xpointer="xpointer(/sect1/sect2[1]/segmentedlist[2])"/>

</sect2>

<sect2 role="installation">
<title>Installation of Coreutils</title>

<para>Prepare Coreutils for compilation:</para>

<screen><userinput>DEFAULT_POSIX2_VERSION=199209 ./configure --prefix=/tools</userinput></screen>

<para>This package has an issue when compiled against versions of
Glibc later than 2.3.2. Some of the Coreutils utilities (such as
<command>head</command>, <command>tail</command>, and
<command>sort</command>) will reject their traditional syntax, a
syntax that has been in use for approximately 30 years. This old
syntax is so pervasive that compatibility should be preserved until
the many places where it is used can be updated. Backwards
compatibility is achieved by setting the
<envar>DEFAULT_POSIX2_VERSION</envar> environment variable to
<quote>199209</quote> in the above command. If you do not want
Coreutils to be backwards compatible with the traditional syntax, then
omit setting the <envar>DEFAULT_POSIX2_VERSION</envar>
environment variable. It is important to remember that doing so will
have consequences, including the need to patch the many packages that
still use the old syntax. Therefore, it is recommended that the
instructions be followed exactly as given above.</para>

<para>Compile the package:</para>

<screen><userinput>make</userinput></screen>

<para>To test the results, issue: <userinput>make
RUN_EXPENSIVE_TESTS=yes check</userinput>.  The
<parameter condition="html">RUN_EXPENSIVE_TESTS=yes</parameter>
<parameter condition="pdf">RUN_EXPENSIVE_ TESTS=yes</parameter> 
parameter tells the test suite to run several additional tests that are considered
relatively expensive (in terms of CPU power and memory usage) on some
platforms, but generally are not a problem on Linux.</para>

<para>Install the package:</para>

<screen><userinput>make install</userinput></screen>

</sect2>

<sect2 role="content"><title/>
<para>Details on this package are located in <xref
linkend="contents-coreutils" role="."/></para>
</sect2>

</sect1>