source: chapter05/coreutils.xml@ 9c9d585

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE section [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>
<section xmlns="http://docbook.org/docbook-ng"
         xmlns:xi="http://www.w3.org/2003/XInclude"
         xml: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>

<section role="package"><title/>
<xi:include href="../chapter06/coreutils.xml" xpointer="xpointer(/*[1]/*[3]/*[2])"/>

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

<xi:include href="../chapter06/coreutils.xml" xpointer="xpointer(/*[1]/*[3]/*[2])"/>

</section>

<section 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
DEFAULT_POSIX2_VERSION environment variable to <quote>199209</quote> in the above
command.  If you don't want coreutils to be backwards compatible
with the traditional syntax, then simply omit setting the DEFAULT_POSIX2_VERSION
environment variable.  Realise though, that doing so will mean you'll have
to deal with the consequences yourself: patch the many packages that still use
the old syntax.  We therefore recommend using the instructions exactly as given
above.</para>

<para>Compile the package:</para>

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

<para>(If you want to test the results, then issue:
<userinput>make RUN_EXPENSIVE_TESTS=yes check</userinput>. The
<parameter>RUN_EXPENSIVE_TESTS=yes</parameter> parameter tells the test suite to
run several additional tests that are considered relatively expensive on some
platforms but generally are not a problem on Linux.)</para>

<para>And install the package:</para>

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

</section>

<section role="content"><title/>
<para>The details on this package are found in <xref linkend="contents-coreutils"/>.</para>
</section>

</section>