source: chapter08/bzip2.xml@ a5c2803

ml-11.0 multilib
Last change on this file since a5c2803 was a5c2803, checked in by Xℹ Ruoyao <xry111@…>, 3 years ago

Merge changes from trunk to multilib

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/branches/multilib@12130 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
  • Property mode set to 100644
File size: 10.1 KB
Line 
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-system-bzip2" role="wrap">
9 <?dbhtml filename="bzip2.html"?>
10
11 <sect1info condition="script">
12 <productname>bzip2</productname>
13 <productnumber>&bzip2-version;</productnumber>
14 <address>&bzip2-url;</address>
15 </sect1info>
16
17 <title>Bzip2-&bzip2-version;</title>
18
19 <indexterm zone="ch-system-bzip2">
20 <primary sortas="a-Bzip2">Bzip2</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The Bzip2 package contains programs for compressing and decompressing
27 files. Compressing text files with <command>bzip2</command> yields a much
28 better compression percentage than with the traditional
29 <command>gzip</command>.</para>
30
31 <segmentedlist>
32 <segtitle>&buildtime;</segtitle>
33 <segtitle>&diskspace;</segtitle>
34
35 <seglistitem>
36 <seg>&bzip2-fin-sbu;</seg>
37 <seg>&bzip2-fin-du;</seg>
38 </seglistitem>
39 </segmentedlist>
40
41 </sect2>
42
43 <sect2 role="installation">
44 <title>Installation of Bzip2</title>
45
46 <para>Apply a patch that will install the documentation for this package:</para>
47
48<screen><userinput remap="pre">patch -Np1 -i ../&bzip2-docs-patch;</userinput></screen>
49
50 <para>The following command ensures installation of symbolic links are relative:</para>
51
52<screen><userinput remap="pre">sed -i 's@\(ln -s -f \)$(PREFIX)/bin/@\1@' Makefile</userinput></screen>
53
54 <para>Ensure the man pages are installed into the correct location:</para>
55
56<screen><userinput remap="pre">sed -i "s@(PREFIX)/man@(PREFIX)/share/man@g" Makefile</userinput></screen>
57
58 <para>Prepare Bzip2 for compilation with:</para>
59
60<screen><userinput remap="make">make -f Makefile-libbz2_so
61make clean</userinput></screen>
62
63 <variablelist>
64 <title>The meaning of the make parameter:</title>
65
66 <varlistentry>
67 <term><parameter>-f Makefile-libbz2_so</parameter></term>
68 <listitem>
69 <para>This will cause Bzip2 to be built using a different
70 <filename>Makefile</filename> file, in this case the
71 <filename>Makefile-libbz2_so</filename> file, which creates a dynamic
72 <filename class="libraryfile">libbz2.so</filename> library and links
73 the Bzip2 utilities against it.</para>
74 </listitem>
75 </varlistentry>
76
77 </variablelist>
78
79 <para>Compile and test the package:</para>
80
81<screen><userinput remap="make">make</userinput></screen>
82
83 <para>Install the programs:</para>
84
85<screen><userinput remap="install">make PREFIX=/usr install</userinput></screen>
86
87 <para>Install the shared <command>bzip2</command> binary into the
88 <filename class="directory">/bin</filename> directory, make
89 some necessary symbolic links, and clean up:</para>
90
91<screen><userinput remap="install">cp -v bzip2-shared /bin/bzip2
92cp -av libbz2.so* /lib
93ln -sv ../../lib/libbz2.so.1.0 /usr/lib/libbz2.so
94rm -v /usr/bin/{bunzip2,bzcat,bzip2}
95ln -sv bzip2 /bin/bunzip2
96ln -sv bzip2 /bin/bzcat</userinput></screen>
97
98 <para>Remove an useless static library:</para>
99
100<screen><userinput remap="install">rm -fv /usr/lib/libbz2.a</userinput></screen>
101
102 </sect2>
103
104 <!-- - - - - - - - - - -->
105 <!-- Multilib - 32bit -->
106 <!-- - - - - - - - - - -->
107
108 <sect2 arch="ml_32,ml_all" role="installation">
109 <title>Installation of Bzip2 - 32bit</title>
110
111 <para>Clean previous build:</para>
112
113<screen><userinput remap="pre">make clean</userinput></screen>
114
115 <para>Compile the package:</para>
116
117<screen><userinput remap="make">sed -e "s/^CC=.*/CC=gcc -m32/" -i Makefile{,-libbz2_so}
118make -f Makefile-libbz2_so
119make libbz2.a</userinput></screen>
120
121 <para>Install the package:</para>
122
123<screen><userinput remap="install">install -Dm755 libbz2.so.1.0.8 &usr-lib-m32;/libbz2.so.1.0.8
124ln -sf libbz2.so.1.0.8 &usr-lib-m32;/libbz2.so
125ln -sf libbz2.so.1.0.8 &usr-lib-m32;/libbz2.so.1
126ln -sf libbz2.so.1.0.8 &usr-lib-m32;/libbz2.so.1.0
127install -Dm644 libbz2.a &usr-lib-m32;/libbz2.a</userinput></screen>
128
129 </sect2><!-- m32 -->
130
131 <!-- - - - - - - - - - -->
132 <!-- Multilib - x32bit -->
133 <!-- - - - - - - - - - -->
134
135 <sect2 arch="ml_x32,ml_all" role="installation">
136 <title>Installation of Bzip2 - x32bit</title>
137
138 <para>Clean previous build:</para>
139
140<screen><userinput remap="pre">make clean</userinput></screen>
141
142 <para>Compile the package:</para>
143
144<screen><userinput remap="make">sed -e "s/^CC=.*/CC=gcc -mx32/" -i Makefile{,-libbz2_so}
145make -f Makefile-libbz2_so
146make libbz2.a</userinput></screen>
147
148 <para>Install the package:</para>
149
150<screen><userinput remap="install">install -Dm755 libbz2.so.1.0.8 &usr-lib-mx32;/libbz2.so.1.0.8
151ln -sf libbz2.so.1.0.8 &usr-lib-mx32;/libbz2.so
152ln -sf libbz2.so.1.0.8 &usr-lib-mx32;/libbz2.so.1
153ln -sf libbz2.so.1.0.8 &usr-lib-mx32;/libbz2.so.1.0
154install -Dm644 libbz2.a &usr-lib-mx32;/libbz2.a</userinput></screen>
155
156 </sect2><!-- mx32 -->
157
158 <sect2 id="contents-bzip2" role="content">
159 <title>Contents of Bzip2</title>
160
161 <segmentedlist>
162 <segtitle>Installed programs</segtitle>
163 <segtitle>Installed libraries</segtitle>
164 <segtitle>Installed directory</segtitle>
165
166 <seglistitem>
167 <seg>bunzip2 (link to bzip2), bzcat (link to bzip2), bzcmp (link to
168 bzdiff), bzdiff, bzegrep (link to bzgrep), bzfgrep (link to bzgrep),
169 bzgrep, bzip2, bzip2recover, bzless (link to bzmore), and bzmore</seg>
170 <seg>libbz2.so</seg>
171 <seg>/usr/share/doc/bzip2-&bzip2-version;</seg>
172 </seglistitem>
173 </segmentedlist>
174
175 <variablelist>
176 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
177 <?dbfo list-presentation="list"?>
178 <?dbhtml list-presentation="table"?>
179
180 <varlistentry id="bunzip2">
181 <term><command>bunzip2</command></term>
182 <listitem>
183 <para>Decompresses bzipped files</para>
184 <indexterm zone="ch-system-bzip2 bunzip2">
185 <primary sortas="b-bunzip2">bunzip2</primary>
186 </indexterm>
187 </listitem>
188 </varlistentry>
189
190 <varlistentry id="bzcat">
191 <term><command>bzcat</command></term>
192 <listitem>
193 <para>Decompresses to standard output</para>
194 <indexterm zone="ch-system-bzip2 bzcat">
195 <primary sortas="b-bzcat">bzcat</primary>
196 </indexterm>
197 </listitem>
198 </varlistentry>
199
200 <varlistentry id="bzcmp">
201 <term><command>bzcmp</command></term>
202 <listitem>
203 <para>Runs <command>cmp</command> on bzipped files</para>
204 <indexterm zone="ch-system-bzip2 bzcmp">
205 <primary sortas="b-bzcmp">bzcmp</primary>
206 </indexterm>
207 </listitem>
208 </varlistentry>
209
210 <varlistentry id="bzdiff">
211 <term><command>bzdiff</command></term>
212 <listitem>
213 <para>Runs <command>diff</command> on bzipped files</para>
214 <indexterm zone="ch-system-bzip2 bzdiff">
215 <primary sortas="b-bzdiff">bzdiff</primary>
216 </indexterm>
217 </listitem>
218 </varlistentry>
219
220 <varlistentry id="bzegrep">
221 <term><command>bzegrep</command></term>
222 <listitem>
223 <para>Runs <command>egrep</command> on bzipped files</para>
224 <indexterm zone="ch-system-bzip2 bzegrep">
225 <primary sortas="b-bzegrep">bzegrep</primary>
226 </indexterm>
227 </listitem>
228 </varlistentry>
229
230 <varlistentry id="bzfgrep">
231 <term><command>bzfgrep</command></term>
232 <listitem>
233 <para>Runs <command>fgrep</command> on bzipped files</para>
234 <indexterm zone="ch-system-bzip2 bzfgrep">
235 <primary sortas="b-bzfgrep">bzfgrep</primary>
236 </indexterm>
237 </listitem>
238 </varlistentry>
239
240 <varlistentry id="bzgrep">
241 <term><command>bzgrep</command></term>
242 <listitem>
243 <para>Runs <command>grep</command> on bzipped files</para>
244 <indexterm zone="ch-system-bzip2 bzgrep">
245 <primary sortas="b-bzgrep">bzgrep</primary>
246 </indexterm>
247 </listitem>
248 </varlistentry>
249
250 <varlistentry id="bzip2">
251 <term><command>bzip2</command></term>
252 <listitem>
253 <para>Compresses files using the Burrows-Wheeler block sorting text
254 compression algorithm with Huffman coding; the compression rate is
255 better than that achieved by more conventional compressors using
256 <quote>Lempel-Ziv</quote> algorithms, like <command>gzip</command></para>
257 <indexterm zone="ch-system-bzip2 bzip2">
258 <primary sortas="b-bzip2">bzip2</primary>
259 </indexterm>
260 </listitem>
261 </varlistentry>
262
263 <varlistentry id="bzip2recover">
264 <term><command>bzip2recover</command></term>
265 <listitem>
266 <para>Tries to recover data from damaged bzipped files</para>
267 <indexterm zone="ch-system-bzip2 bzip2recover">
268 <primary sortas="b-bzip2recover">bzip2recover</primary>
269 </indexterm>
270 </listitem>
271 </varlistentry>
272
273 <varlistentry id="bzless">
274 <term><command>bzless</command></term>
275 <listitem>
276 <para>Runs <command>less</command> on bzipped files</para>
277 <indexterm zone="ch-system-bzip2 bzless">
278 <primary sortas="b-bzless">bzless</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 <varlistentry id="bzmore">
284 <term><command>bzmore</command></term>
285 <listitem>
286 <para>Runs <command>more</command> on bzipped files</para>
287 <indexterm zone="ch-system-bzip2 bzmore">
288 <primary sortas="b-bzmore">bzmore</primary>
289 </indexterm>
290 </listitem>
291 </varlistentry>
292
293 <varlistentry id="libbz2">
294 <term><filename class="libraryfile">libbz2</filename></term>
295 <listitem>
296 <para>The library implementing lossless, block-sorting data
297 compression, using the Burrows-Wheeler algorithm</para>
298 <indexterm zone="ch-system-bzip2 libbz2">
299 <primary sortas="c-libbz2">libbz2</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 </variablelist>
305
306 </sect2>
307
308</sect1>
Note: See TracBrowser for help on using the repository browser.