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" revision="systemd">
   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             --without-ncurses              \
  51             PKG_CONFIG=""</userinput></screen>
  52
  53     <variablelist>
  54       <title>The meaning of the configure option:</title>
  55
  56       <varlistentry>
  57         <term><parameter>--without-python</parameter></term>
  58         <listitem>
  59           <para>This switch disables using <application>Python</application>
  60           if it is installed on the host system.  It avoids trying to build
  61           unneeded bindings.</para>
  62         </listitem>
  63       </varlistentry>
  64
  65       <varlistentry>
  66         <term><parameter>--disable-makeinstall-chown</parameter></term>
  67         <listitem>
  68           <para>This switch disables using the <command>chown</command> command
  69           during installation.  This is not needed when installing into the
  70           /tools directory and avoids the necessity of installing as
  71           root.</para>
  72         </listitem>
  73       </varlistentry>
  74
  75       <varlistentry>
  76         <term><parameter>--without-ncurses</parameter></term>
  77         <listitem>
  78           <para>This switch disables using the ncurses library for
  79           the build process. This is not needed when installing into the
  80           /tools directory and avoids problems on some host distros.</para>
  81         </listitem>
  82       </varlistentry>
  83
  84       <varlistentry>
  85         <term><parameter>--without-systemdsystemunitdir</parameter></term>
  86         <listitem>
  87           <para>On systems that use systemd, the package tries to install
  88           a systemd specific file to a non-existent directory in /tools.
  89           This switch disables the unnecessary action.</para>
  90         </listitem>
  91       </varlistentry>
  92
  93       <varlistentry>
  94         <term><envar>PKG_CONFIG=""</envar></term>
  95         <listitem>
  96           <para>Setting this environment variable prevents adding unneeded
  97           features that may be available on the host. Note that the location
  98           shown for setting this environment variable is different from other
  99           LFS sections where variables are set preceding the command.  This
 100           location is shown to demonstrate an alternative way of setting an
 101           environment variable when using configure.</para>
 102         </listitem>
 103       </varlistentry>
 104      </variablelist>
 105
 106     <para>Compile the package:</para>
 107
 108 <screen><userinput remap="make">make</userinput></screen>
 109
 110     <para>Install the package:</para>
 111
 112 <screen><userinput remap="install">make install</userinput></screen>
 113
 114   </sect2>
 115
 116   <sect2 role="content">
 117     <title/>
 118
 119     <para>Details on this package are located in
 120     <xref linkend="contents-utillinux" role="."/></para>
 121
 122   </sect2>
 123
 124 </sect1>