source: chapter07/util-linux.xml@ 59e0a47

multilib
Last change on this file since 59e0a47 was 59e0a47, checked in by Thomas Trepl <thomas@…>, 2 months ago

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