source: chapter08/bzip2.xml@ 32f47b1

ml-11.0 multilib
Last change on this file since 32f47b1 was 32f47b1, checked in by Thomas Trepl (Moody) <thomas@…>, 14 months ago

Merge branch 'trunk' into multilib

  • Property mode set to 100644
File size: 10.2 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 library:</para>
88<screen><userinput remap="install">cp -av libbz2.so.* /usr/lib
89ln -sv libbz2.so.&bzip2-version; /usr/lib/libbz2.so</userinput></screen>
90
91 <para>Install the shared <command>bzip2</command> binary into the
92 <filename class="directory">/usr/bin</filename> directory, and replace
93 two copies of <command>bzip2</command> with symlinks:</para>
94
95<screen><userinput remap="install">cp -v bzip2-shared /usr/bin/bzip2
96for i in /usr/bin/{bzcat,bunzip2}; do
97 ln -sfv bzip2 $i
98done</userinput></screen>
99
100 <para>Remove an useless static library:</para>
101
102<screen><userinput remap="install">rm -fv /usr/lib/libbz2.a</userinput></screen>
103
104 </sect2>
105
106 <!-- - - - - - - - - - -->
107 <!-- Multilib - 32bit -->
108 <!-- - - - - - - - - - -->
109
110 <sect2 arch="ml_32,ml_all" role="installation">
111 <title>Installation of Bzip2 - 32bit</title>
112
113 <para>Clean previous build:</para>
114
115<screen><userinput remap="pre">make clean</userinput></screen>
116
117 <para>Compile the package:</para>
118
119<screen><userinput remap="make">sed -e "s/^CC=.*/CC=gcc -m32/" -i Makefile{,-libbz2_so}
120make -f Makefile-libbz2_so
121make libbz2.a</userinput></screen>
122
123 <para>Install the package:</para>
124
125<screen><userinput remap="install">install -Dm755 libbz2.so.1.0.8 /usr/lib32/libbz2.so.1.0.8
126ln -sf libbz2.so.1.0.8 /usr/lib32/libbz2.so
127ln -sf libbz2.so.1.0.8 /usr/lib32/libbz2.so.1
128ln -sf libbz2.so.1.0.8 /usr/lib32/libbz2.so.1.0
129install -Dm644 libbz2.a /usr/lib32/libbz2.a</userinput></screen>
130
131 </sect2><!-- m32 -->
132
133 <!-- - - - - - - - - - -->
134 <!-- Multilib - x32bit -->
135 <!-- - - - - - - - - - -->
136
137 <sect2 arch="ml_x32,ml_all" role="installation">
138 <title>Installation of Bzip2 - x32bit</title>
139
140 <para>Clean previous build:</para>
141
142<screen><userinput remap="pre">make clean</userinput></screen>
143
144 <para>Compile the package:</para>
145
146<screen><userinput remap="make">sed -e "s/^CC=.*/CC=gcc -mx32/" -i Makefile{,-libbz2_so}
147make -f Makefile-libbz2_so
148make libbz2.a</userinput></screen>
149
150 <para>Install the package:</para>
151
152<screen><userinput remap="install">install -Dm755 libbz2.so.1.0.8 /usr/libx32/libbz2.so.1.0.8
153ln -sf libbz2.so.1.0.8 /usr/libx32/libbz2.so
154ln -sf libbz2.so.1.0.8 /usr/libx32/libbz2.so.1
155ln -sf libbz2.so.1.0.8 /usr/libx32/libbz2.so.1.0
156install -Dm644 libbz2.a /usr/libx32/libbz2.a</userinput></screen>
157
158 </sect2><!-- mx32 -->
159
160 <sect2 id="contents-bzip2" role="content">
161 <title>Contents of Bzip2</title>
162
163 <segmentedlist>
164 <segtitle>Installed programs</segtitle>
165 <segtitle>Installed libraries</segtitle>
166 <segtitle>Installed directory</segtitle>
167
168 <seglistitem>
169 <seg>bunzip2 (link to bzip2), bzcat (link to bzip2), bzcmp (link to
170 bzdiff), bzdiff, bzegrep (link to bzgrep), bzfgrep (link to bzgrep),
171 bzgrep, bzip2, bzip2recover, bzless (link to bzmore), and bzmore</seg>
172 <seg>libbz2.so</seg>
173 <seg>/usr/share/doc/bzip2-&bzip2-version;</seg>
174 </seglistitem>
175 </segmentedlist>
176
177 <variablelist>
178 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
179 <?dbfo list-presentation="list"?>
180 <?dbhtml list-presentation="table"?>
181
182 <varlistentry id="bunzip2">
183 <term><command>bunzip2</command></term>
184 <listitem>
185 <para>Decompresses bzipped files</para>
186 <indexterm zone="ch-system-bzip2 bunzip2">
187 <primary sortas="b-bunzip2">bunzip2</primary>
188 </indexterm>
189 </listitem>
190 </varlistentry>
191
192 <varlistentry id="bzcat">
193 <term><command>bzcat</command></term>
194 <listitem>
195 <para>Decompresses to standard output</para>
196 <indexterm zone="ch-system-bzip2 bzcat">
197 <primary sortas="b-bzcat">bzcat</primary>
198 </indexterm>
199 </listitem>
200 </varlistentry>
201
202 <varlistentry id="bzcmp">
203 <term><command>bzcmp</command></term>
204 <listitem>
205 <para>Runs <command>cmp</command> on bzipped files</para>
206 <indexterm zone="ch-system-bzip2 bzcmp">
207 <primary sortas="b-bzcmp">bzcmp</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <varlistentry id="bzdiff">
213 <term><command>bzdiff</command></term>
214 <listitem>
215 <para>Runs <command>diff</command> on bzipped files</para>
216 <indexterm zone="ch-system-bzip2 bzdiff">
217 <primary sortas="b-bzdiff">bzdiff</primary>
218 </indexterm>
219 </listitem>
220 </varlistentry>
221
222 <varlistentry id="bzegrep">
223 <term><command>bzegrep</command></term>
224 <listitem>
225 <para>Runs <command>egrep</command> on bzipped files</para>
226 <indexterm zone="ch-system-bzip2 bzegrep">
227 <primary sortas="b-bzegrep">bzegrep</primary>
228 </indexterm>
229 </listitem>
230 </varlistentry>
231
232 <varlistentry id="bzfgrep">
233 <term><command>bzfgrep</command></term>
234 <listitem>
235 <para>Runs <command>fgrep</command> on bzipped files</para>
236 <indexterm zone="ch-system-bzip2 bzfgrep">
237 <primary sortas="b-bzfgrep">bzfgrep</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 <varlistentry id="bzgrep">
243 <term><command>bzgrep</command></term>
244 <listitem>
245 <para>Runs <command>grep</command> on bzipped files</para>
246 <indexterm zone="ch-system-bzip2 bzgrep">
247 <primary sortas="b-bzgrep">bzgrep</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251
252 <varlistentry id="bzip2">
253 <term><command>bzip2</command></term>
254 <listitem>
255 <para>Compresses files using the Burrows-Wheeler block sorting text
256 compression algorithm with Huffman coding; the compression rate is
257 better than that achieved by more conventional compressors using
258 <quote>Lempel-Ziv</quote> algorithms, like <command>gzip</command></para>
259 <indexterm zone="ch-system-bzip2 bzip2">
260 <primary sortas="b-bzip2">bzip2</primary>
261 </indexterm>
262 </listitem>
263 </varlistentry>
264
265 <varlistentry id="bzip2recover">
266 <term><command>bzip2recover</command></term>
267 <listitem>
268 <para>Tries to recover data from damaged bzipped files</para>
269 <indexterm zone="ch-system-bzip2 bzip2recover">
270 <primary sortas="b-bzip2recover">bzip2recover</primary>
271 </indexterm>
272 </listitem>
273 </varlistentry>
274
275 <varlistentry id="bzless">
276 <term><command>bzless</command></term>
277 <listitem>
278 <para>Runs <command>less</command> on bzipped files</para>
279 <indexterm zone="ch-system-bzip2 bzless">
280 <primary sortas="b-bzless">bzless</primary>
281 </indexterm>
282 </listitem>
283 </varlistentry>
284
285 <varlistentry id="bzmore">
286 <term><command>bzmore</command></term>
287 <listitem>
288 <para>Runs <command>more</command> on bzipped files</para>
289 <indexterm zone="ch-system-bzip2 bzmore">
290 <primary sortas="b-bzmore">bzmore</primary>
291 </indexterm>
292 </listitem>
293 </varlistentry>
294
295 <varlistentry id="libbz2">
296 <term><filename class="libraryfile">libbz2</filename></term>
297 <listitem>
298 <para>The library implementing lossless, block-sorting data
299 compression, using the Burrows-Wheeler algorithm</para>
300 <indexterm zone="ch-system-bzip2 libbz2">
301 <primary sortas="c-libbz2">libbz2</primary>
302 </indexterm>
303 </listitem>
304 </varlistentry>
305
306 </variablelist>
307
308 </sect2>
309
310</sect1>
Note: See TracBrowser for help on using the repository browser.