* Fixed problem when BASEDIR paths were given without a trailing '/'.
[linux_from_scratch.git] / newxml / chapter05 / coreutils.xml
blob78833341f00e7cd9dc12df3fc08c5e15c60ae0db
1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
3   <!ENTITY % general-entities SYSTEM "../general.ent">
4   %general-entities;
5 ]>
6 <sect1 id="ch-tools-coreutils">
7 <title>Coreutils-&coreutils-version;</title>
8 <?dbhtml filename="coreutils.html"?>
10 <indexterm zone="ch-tools-coreutils">
11 <primary sortas="a-Coreutils">Coreutils</primary>
12 <secondary>tools</secondary></indexterm>
14 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/coreutils.xml" xpointer="xpointer(/sect1/para[1])"/>
16 <screen>&buildtime; 0.9 SBU
17 &diskspace; 69 MB</screen>
19 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../chapter06/coreutils.xml" xpointer="xpointer(/sect1/para[2])"/>
22 <sect2>
23 <title>Installation of Coreutils</title>
25 <para>Prepare Coreutils for compilation:</para>
27 <screen><userinput>DEFAULT_POSIX2_VERSION=199209 ./configure --prefix=/tools</userinput></screen>
29 <para>This package has an issue when compiled against versions of glibc
30 later than 2.3.2.  Some of the Coreutils utilities (such as
31 (<command>head</command>, <command>tail</command> and <command>sort</command>)
32 will reject their traditional syntax, a syntax that has been in use for
33 approximately 30 years. This old syntax is so pervasive that compatibility
34 should be preserved until the many places where it is used can be
35 updated.  Backwards compatibility is achieved by setting the
36 DEFAULT_POSIX2_VERSION environment variable to &quot;199209&quot; in the above
37 command.  If you don&apos;t want coreutils to be backwards compatible
38 with the traditional syntax, then simply omit setting the DEFAULT_POSIX2_VERSION
39 environment variable.  Realise though, that doing so will mean you&apos;ll have
40 to deal with the consequences yourself: patch the many packages that still use
41 the old syntax.  We therefore recommend using the instructions exactly as given
42 above.</para>
44 <para>Compile the package:</para>
46 <screen><userinput>make</userinput></screen>
48 <para>(If you insist on testing the results, then issue:
49 <userinput>make RUN_EXPENSIVE_TESTS=yes check</userinput>. The
50 <emphasis>RUN_EXPENSIVE_TESTS=yes</emphasis> parameter tells the test suite to
51 run several additional tests that are considered relatively expensive on some
52 platforms but generally are not a problem on Linux.)</para>
54 <para>And install the package:</para>
56 <screen><userinput>make install</userinput></screen>
58 </sect2>
60 <sect2><title> </title><para> </para>
61 <para>The details on this package are found in <xref linkend="contents-coreutils"/>.</para>
62 <para> </para></sect2>
64 </sect1>