source: chapter07/util-linux.xml@ ce45f8d

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

Adopt instruction changes

  • Property mode set to 100644
File size: 7.0 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 --host=i686-pc-linux-gnu \
145 --libdir=/usr/lib32 \
146 --runstatedir=/run \
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 --disable-liblastlog2 \
157 --without-python \
158 ADJTIME_PATH=/var/lib/hwclock/adjtime</userinput></screen>
159
160 <para>Compile the package:</para>
161
162<screen><userinput remap="make">make</userinput></screen>
163
164 <para>Install the package:</para>
165
166<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
167cp -Rv DESTDIR/usr/lib32/* /usr/lib32
168rm -rf DESTDIR</userinput></screen>
169
170 </sect2><!-- m32 -->
171
172 <!-- - - - - - - - - - -->
173 <!-- Multilib - x32bit -->
174 <!-- - - - - - - - - - -->
175
176 <sect2 arch="ml_x32,ml_all" role="installation">
177 <title>Installation of Util-linux - x32-bit</title>
178
179 <para>Clean previous build:</para>
180
181<screen><userinput remap="pre">make distclean</userinput></screen>
182
183 <para>Prepare Util-linux for compilation:</para>
184
185<screen><userinput remap="configure">CC="gcc -mx32" \
186./configure --host=x86_64-pc-linux-gnux32 \
187 --libdir=/usr/libx32 \
188 --runstatedir=/run \
189 --docdir=/usr/share/doc/util-linux-&util-linux-version; \
190 --disable-chfn-chsh \
191 --disable-login \
192 --disable-nologin \
193 --disable-su \
194 --disable-setpriv \
195 --disable-runuser \
196 --disable-pylibmount \
197 --disable-static \
198 --disable-liblastlog2 \
199 --without-python \
200 ADJTIME_PATH=/var/lib/hwclock/adjtime</userinput></screen>
201
202 <para>Compile the package:</para>
203
204<screen><userinput remap="make">make</userinput></screen>
205
206 <para>Install the package:</para>
207
208<screen><userinput remap="install">make DESTDIR=$PWD/DESTDIR install
209cp -Rv DESTDIR/usr/libx32/* /usr/libx32
210rm -rf DESTDIR</userinput></screen>
211
212 </sect2><!-- mx32 -->
213
214 <sect2 role="content">
215 <title/>
216
217 <para>Details on this package are located in <xref linkend="contents-utillinux" role="."/></para>
218
219 </sect2>
220
221</sect1>
Note: See TracBrowser for help on using the repository browser.