source: chapter05/util-linux.xml@ 9c31d62

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>

<sect1 id="ch-tools-util-linux" role="wrap" revision="systemd">
  <?dbhtml filename="util-linux.html"?>

  <sect1info condition="script">
    <productname>util-linux</productname>
    <productnumber>&util-linux-version;</productnumber>
    <address>&util-linux-url;</address>
  </sect1info>

  <title>Util-linux-&util-linux-version;</title>

  <indexterm zone="ch-tools-util-linux">
    <primary sortas="a-Util-linux">Util-linux</primary>
    <secondary>tools</secondary>
  </indexterm>

  <sect2 role="package">
    <title/>

    <para>The Util-linux package contains miscellaneous utility programs.</para>

    <segmentedlist>
      <segtitle>&buildtime;</segtitle>
      <segtitle>&diskspace;</segtitle>

      <seglistitem>
        <seg>&util-linux-ch5-sbu;</seg>
        <seg>&util-linux-ch5-du;</seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

  <sect2 role="installation">
    <title>Installation of Util-linux</title>

    <para>Prepare Util-linux for compilation:</para>

<screen><userinput remap="configure">./configure --prefix=/tools                \
            --without-python               \
            --disable-makeinstall-chown    \
            --without-systemdsystemunitdir \
            --without-ncurses              \
            PKG_CONFIG=""</userinput></screen>

    <variablelist>
      <title>The meaning of the configure option:</title>

      <varlistentry>
        <term><parameter>--without-python</parameter></term>
        <listitem>
          <para>This switch disables using <application>Python</application>
          if it is installed on the host system.  It avoids trying to build
          unneeded bindings.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>--disable-makeinstall-chown</parameter></term>
        <listitem>
          <para>This switch disables using the <command>chown</command> command
          during installation.  This is not needed when installing into the
          /tools directory and avoids the necessity of installing as
          root.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>--without-ncurses</parameter></term>
        <listitem>
          <para>This switch disables using the ncurses library for
          the build process. This is not needed when installing into the
          /tools directory and avoids problems on some host distros.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><parameter>--without-systemdsystemunitdir</parameter></term>
        <listitem>
          <para>On systems that use systemd, the package tries to install 
          a systemd specific file to a non-existent directory in /tools.
          This switch disables the unnecessary action.</para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><envar>PKG_CONFIG=""</envar></term>
        <listitem>
          <para>Setting this environment variable prevents adding unneeded
          features that may be available on the host. Note that the location
          shown for setting this environment variable is different from other
          LFS sections where variables are set preceding the command.  This
          location is shown to demonstrate an alternative way of setting an
          environment variable when using configure.</para>
        </listitem>
      </varlistentry>
     </variablelist>

    <para>Compile the package:</para>

<screen><userinput remap="make">make</userinput></screen>

    <para>Install the package:</para>

<screen><userinput remap="install">make install</userinput></screen>

  </sect2>

  <sect2 role="content">
    <title/>

    <para>Details on this package are located in
    <xref linkend="contents-utillinux" role="."/></para>

  </sect2>

  <sect2 arch="ml_32,ml_all" role="installation">
    <title>Installation of Util-Linux - 32 bit</title>

    <para>Prepare Util-Linux for compilation:</para>

<screen><userinput remap="configure">make distclean &amp;&amp;
CC="${LFS_TGT}-gcc -m32"           \
./configure                        \
    --prefix=/tools                \
    --libdir=/tools/lib32          \
    --without-python               \
    --disable-makeinstall-chown    \
    --without-systemdsystemunitdir \
    --without-ncurses              \
    --host="${LFS_TGT32}"          \
    PKG_CONFIG=""</userinput></screen>

    <para>Compile the package:</para>

<screen><userinput remap="make">make</userinput></screen>

    <para>To test the results, issue:</para>

<screen><userinput remap="test">make check</userinput></screen>

    <para>Install the package:</para>

<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR_32 install &amp;&amp;
cp -Rv DESTDIR_32/tools/lib32/* /tools/lib32</userinput></screen>

  </sect2>

  <sect2 arch="ml_x32,ml_all" role="installation">
    <title>Installation of Util-Linux - x32 bit</title>

    <para>Repeat for the x32-ABI:</para>

<screen><userinput remap="configure">make distclean &amp;&amp;
CC="${LFS_TGT}-gcc -mx32"          \
./configure                        \
    --prefix=/tools                \
    --libdir=/tools/libx32         \
    --without-python               \
    --disable-makeinstall-chown    \
    --without-systemdsystemunitdir \
    --without-ncurses              \
    --host="${LFS_TGTX32}"         \
    PKG_CONFIG=""</userinput></screen>

<screen><userinput remap="make">make</userinput></screen>

<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR_x32 install &amp;&amp;
cp -Rv DESTDIR_x32/tools/libx32/* /tools/libx32</userinput></screen>

  </sect2>

</sect1>