source: chapter07/util-linux.xml@ 9282602

multilib
Last change on this file since 9282602 was 9282602, checked in by Thomas Trepl (Moody) <thomas@…>, 20 months ago

Adopt change instructions to m32/mx32
  • Property mode set to 100644
File size: 6.9 KB
RevLine 
[6dfcfecc]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-tmp-sbu;</seg>
35 <seg>&util-linux-tmp-du;</seg>
36 </seglistitem>
37 </segmentedlist>
38
39 </sect2>
40
41 <sect2 role="installation">
42 <title>Installation of Util-linux</title>
43
[a5c2803]44 <para>The FHS recommends using the <filename
45 class="directory">/var/lib/hwclock</filename> directory instead of the
46 usual <filename class="directory">/etc</filename> directory as the
47 location for the <filename>adjtime</filename> file. Create this directory
48 with:</para>
[6dfcfecc]49
50<screen><userinput remap="pre">mkdir -pv /var/lib/hwclock</userinput></screen>
51
52 <para>Prepare Util-linux for compilation:</para>
53
54<screen><userinput remap="configure">./configure ADJTIME_PATH=/var/lib/hwclock/adjtime \
[d7a9421]55 --libdir=/usr/lib \
[6dfcfecc]56 --docdir=/usr/share/doc/util-linux-&util-linux-version; \
57 --disable-chfn-chsh \
58 --disable-login \
59 --disable-nologin \
60 --disable-su \
61 --disable-setpriv \
62 --disable-runuser \
63 --disable-pylibmount \
64 --disable-static \
[edd83dc]65 --without-python \
66 runstatedir=/run</userinput></screen>
[6dfcfecc]67
68 <variablelist>
69 <title>The meaning of the configure options:</title>
70
71 <varlistentry>
72 <term><parameter>ADJTIME_PATH=/var/lib/hwclock/adjtime</parameter></term>
73 <listitem>
74 <para>This sets the location of the file recording information about
[bcb20b4]75 the hardware clock in accordance to the FHS. This is not strictly
[6dfcfecc]76 needed for this temporary tool, but it prevents creating a file
77 at another location, which would not be overwritten or removed
78 when building the final util-linux package.</para>
79 </listitem>
80 </varlistentry>
81
[d7a9421]82 <varlistentry>
83 <term><parameter>--libdir=/usr/lib</parameter></term>
84 <listitem>
85 <para>This switch ensures the
86 <filename class="extension">.so</filename> symlinks targeting
87 the shared library file in the same directory
88 (<filename class="directory">/usr/lib</filename>) directly.</para>
89 </listitem>
90 </varlistentry>
91
[6dfcfecc]92 <varlistentry>
93 <term><parameter>--disable-*</parameter></term>
94 <listitem>
95 <para>These switches prevent warnings about building components
96 that require packages not in LFS or not installed yet.</para>
97 </listitem>
98 </varlistentry>
99
100 <varlistentry>
101 <term><parameter>--without-python</parameter></term>
102 <listitem>
103 <para>This switch disables using <application>Python</application>.
104 It avoids trying to build unneeded bindings.</para>
105 </listitem>
106 </varlistentry>
107
[edd83dc]108 <varlistentry>
109 <term><parameter>runstatedir=/run</parameter></term>
110 <listitem>
111 <para>This switch sets the location of the socket used by
112 <command>uuidd</command> and
113 <filename class="libraryfile">libuuid</filename> correctly.</para>
114 </listitem>
115 </varlistentry>
116
[6dfcfecc]117 </variablelist>
118
119 <para>Compile the package:</para>
120
121<screen><userinput remap="make">make</userinput></screen>
122
123 <para>Install the package:</para>
124
125<screen><userinput remap="install">make install</userinput></screen>
126
127 </sect2>
128
129 <!-- - - - - - - - - - -->
130 <!-- Multilib - 32bit -->
131 <!-- - - - - - - - - - -->
132
133 <sect2 arch="ml_32,ml_all" role="installation">
134 <title>Installation of Util-linux - 32-bit</title>
135
136 <para>Clean previous build:</para>
137
138<screen><userinput remap="pre">make distclean</userinput></screen>
139
140 <para>Prepare Util-linux for compilation:</para>
141
142<screen><userinput remap="configure">CC="gcc -m32" \
143./configure ADJTIME_PATH=/var/lib/hwclock/adjtime \
[9282602]144 --libdir=/usr/lib32 \
145 --host=i686-pc-linux-gnu \
[6dfcfecc]146 --docdir=/usr/share/doc/util-linux-&util-linux-version; \
147 --disable-chfn-chsh \
148 --disable-login \
149 --disable-nologin \
150 --disable-su \
151 --disable-setpriv \
152 --disable-runuser \
153 --disable-pylibmount \
154 --disable-static \
155 --without-python \
[9282602]156 runstatedir=/run</userinput></screen>
[6dfcfecc]157
158 <para>Compile the package:</para>
159
160<screen><userinput remap="make">make</userinput></screen>
161
162 <para>Install the package:</para>
163
164<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
[0ebda11]165cp -Rv DESTDIR/usr/lib32/* /usr/lib32
[6dfcfecc]166rm -rf DESTDIR</userinput></screen>
167
168 </sect2><!-- m32 -->
169
170 <!-- - - - - - - - - - -->
171 <!-- Multilib - x32bit -->
172 <!-- - - - - - - - - - -->
173
174 <sect2 arch="ml_x32,ml_all" role="installation">
175 <title>Installation of Util-linux - x32-bit</title>
176
177 <para>Clean previous build:</para>
178
179<screen><userinput remap="pre">make distclean</userinput></screen>
180
181 <para>Prepare Util-linux for compilation:</para>
182
183<screen><userinput remap="configure">CC="gcc -mx32" \
184./configure ADJTIME_PATH=/var/lib/hwclock/adjtime \
[9282602]185 --libdir=/usr/libx32 \
186 --host=x86_64-pc-linux-gnux32 \
[6dfcfecc]187 --docdir=/usr/share/doc/util-linux-&util-linux-version; \
188 --disable-chfn-chsh \
189 --disable-login \
190 --disable-nologin \
191 --disable-su \
192 --disable-setpriv \
193 --disable-runuser \
194 --disable-pylibmount \
195 --disable-static \
196 --without-python \
[9282602]197 runstatedir=/run</userinput></screen>
[6dfcfecc]198
199 <para>Compile the package:</para>
200
201<screen><userinput remap="make">make</userinput></screen>
202
203 <para>Install the package:</para>
204
205<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
[0ebda11]206cp -Rv DESTDIR/usr/libx32/* /usr/libx32
[6dfcfecc]207rm -rf DESTDIR</userinput></screen>
208
209 </sect2><!-- mx32 -->
210
211 <sect2 role="content">
212 <title/>
213
214 <para>Details on this package are located in <xref linkend="contents-utillinux" role="."/></para>
215
216 </sect2>
217
218</sect1>
Note: See TracBrowser for help on using the repository browser.