chapter05/util-linux.xml

   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 ]>
   7
   8 <sect1 id="ch-tools-util-linux" role="wrap">
   9   <?dbhtml filename="util-linux.html"?>
  10
  11   <sect1info condition="script">
  12     <productname>util-linux</productname>
  13     <productnumber>&util-linux-version;</productnumber>
  14     <address>&util-linux-url;</address>
  15   </sect1info>
  16
  17   <title>Util-linux-&util-linux-version;</title>
  18
  19   <indexterm zone="ch-tools-util-linux">
  20     <primary sortas="a-Util-linux">Util-linux</primary>
  21     <secondary>tools</secondary>
  22   </indexterm>
  23
  24   <sect2 role="package">
  25     <title/>
  26
  27     <para>The Util-linux package contains miscellaneous utility programs.</para>
  28
  29     <segmentedlist>
  30       <segtitle>&buildtime;</segtitle>
  31       <segtitle>&diskspace;</segtitle>
  32
  33       <seglistitem>
  34         <seg>&util-linux-ch5-sbu;</seg>
  35         <seg>&util-linux-ch5-du;</seg>
  36       </seglistitem>
  37     </segmentedlist>
  38
  39   </sect2>
  40
  41   <sect2 role="installation">
  42     <title>Installation of Util-linux</title>
  43
  44     <para>Prepare Util-linux for compilation:</para>
  45
  46 <screen><userinput remap="configure">./configure --prefix=/tools                \
  47             --without-python               \
  48             --disable-makeinstall-chown    \
  49             --without-systemdsystemunitdir \
  50             PKG_CONFIG=""</userinput></screen>
  51
  52     <variablelist>
  53       <title>The meaning of the configure option:</title>
  54
  55       <varlistentry>
  56         <term><parameter>--without-python</parameter></term>
  57         <listitem>
  58           <para>This switch disables using <application>Python</application>
  59           if it is installed on the host system.  It avoids trying to build
  60           unneeded bindings.</para>
  61         </listitem>
  62       </varlistentry>
  63
  64       <varlistentry>
  65         <term><parameter>--disable-makeinstall-chown</parameter></term>
  66         <listitem>
  67           <para>This switch disables using the <command>chown</command> command
  68           during installation.  This is not needed when installing into the
  69           /tools directory and avoids the necessity of installing as
  70           root.</para>
  71         </listitem>
  72       </varlistentry>
  73
  74       <varlistentry>
  75         <term><parameter>--without-systemdsystemunitdir</parameter></term>
  76         <listitem>
  77           <para>On systems that use systemd, the package tries to install
  78           a systemd specific file to a non-existent directory in /tools.
  79           This switch disables the unnecessary action.</para>
  80         </listitem>
  81       </varlistentry>
  82
  83       <varlistentry>
  84         <term><envar>PKG_CONFIG=""</envar></term>
  85         <listitem>
  86           <para>Setting this envronment variable prevents adding unneeded
  87           features that may be available on the host. Note that the location
  88           shown for setting this environment variable is different from other
  89           LFS sections where variables are set preceding the command.  This
  90           location is shown to demonstrate an alternative way of setting an
  91           environment variable when using configure.</para>
  92         </listitem>
  93       </varlistentry>
  94      </variablelist>
  95
  96     <para>Compile the package:</para>
  97
  98 <screen><userinput remap="make">make</userinput></screen>
  99
 100     <para>Install the package:</para>
 101
 102 <screen><userinput remap="install">make install</userinput></screen>
 103
 104   </sect2>
 105
 106 </sect1>