Text updates to cross2 branch Chapter 6
[linux_from_scratch.git] / chapter06 / coreutils.xml
blob3ae765e85e4d327a4a0e947dac7093256b1d49f1
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 ]>
8 <sect1 id="ch-tools-coreutils" role="wrap">
9   <?dbhtml filename="coreutils.html"?>
11   <sect1info condition="script">
12     <productname>coreutils</productname>
13     <productnumber>&coreutils-version;</productnumber>
14     <address>&coreutils-url;</address>
15   </sect1info>
17   <title>Coreutils-&coreutils-version;</title>
19   <indexterm zone="ch-tools-coreutils">
20     <primary sortas="a-Coreutils">Coreutils</primary>
21     <secondary>tools</secondary>
22   </indexterm>
24   <sect2 role="package">
25     <title/>
27     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
28     href="../chapter08/coreutils.xml"
29     xpointer="xpointer(/sect1/sect2[1]/para[1])"/>
31     <segmentedlist>
32       <segtitle>&buildtime;</segtitle>
33       <segtitle>&diskspace;</segtitle>
35       <seglistitem>
36         <seg>&coreutils-ch5-sbu;</seg>
37         <seg>&coreutils-ch5-du;</seg>
38       </seglistitem>
39     </segmentedlist>
41   </sect2>
43   <sect2 role="installation">
44     <title>Installation of Coreutils</title>
46     <para>Prepare Coreutils for compilation:</para>
48 <screen><userinput remap="configure">./configure --prefix=/usr                     \
49             --host=$LFS_TGT                   \
50             --build=$(build-aux/config.guess) \
51             --enable-install-program=hostname \
52             --enable-no-install-program=kill,uptime</userinput></screen>
54     <variablelist>
55       <title>The meaning of the configure options:</title>
57       <varlistentry>
58         <term><envar>--enable-install-program=hostname</envar></term>
59         <listitem>
60           <para>This enables the <command>hostname</command> binary to be built
61           and installed &ndash; it is disabled by default but is required by the
62           Perl test suite.</para>
63         </listitem>
64       </varlistentry>
65     </variablelist>
67     <para>Compile the package:</para>
69 <screen><userinput remap="make">make</userinput></screen>
71     <para>Install the package:</para>
73 <screen><userinput remap="install">make DESTDIR=$LFS install</userinput></screen>
74 <!--
75     <para>The above command refuses to install <filename>su</filename>
76     because the program cannot be installed setuid root as a non-privileged
77     user. By manually installing it, we can use it for running tests in the
78     final system as a non-privileged user. Install it with:</para>
80 <screen><userinput remap="install">cp -v src/su /tools/bin</userinput></screen>
81 -->
82     <para>Move programs to their final expected locations. Although this is
83     not necessary in this temporary environment, we must do so because some
84     programs harcode executable locations:</para>
86 <screen><userinput remap="install">mv -v $LFS/usr/bin/{cat,chgrp,chmod,chown,cp,date,dd,df,echo} $LFS/bin
87 mv -v $LFS/usr/bin/{false,ln,ls,mkdir,mknod,mv,pwd,rm}        $LFS/bin
88 mv -v $LFS/usr/bin/{rmdir,stty,sync,true,uname}               $LFS/bin
89 mv -v $LFS/usr/bin/{head,nice,sleep,touch}                    $LFS/bin
90 mv -v $LFS/usr/bin/chroot                                     $LFS/usr/sbin
91 mkdir -pv $LFS/usr/share/man/man8
92 mv -v $LFS/usr/share/man/man1/chroot.1                        $LFS/usr/share/man/man8/chroot.8
93 sed -i 's/"1"/"8"/'                                           $LFS/usr/share/man/man8/chroot.8</userinput></screen>
95   </sect2>
97   <sect2 role="content">
98     <title/>
100     <para>Details on this package are located in
101     <xref linkend="contents-coreutils" role="."/></para>
103   </sect2>
105 </sect1>