source: BOOK/final-system/common/bzip2.xml@ f6c354f

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since f6c354f was 3f8be484, checked in by Jim Gifford <clfs@…>, 19 years ago

r627@server (orig r625): jim | 2005-10-31 12:59:34 -0800
Import of Cross-LFS Book

  • Property mode set to 100644
File size: 8.4 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 <!ENTITY % patches-entities SYSTEM "../../patches.ent">
6 %general-entities;
7 %patches-entities;
8]>
9
10<sect1 id="ch-system-bzip2" role="wrap">
11 <?dbhtml filename="bzip2.html"?>
12
13 <title>Bzip2-&bzip2-version;</title>
14
15 <indexterm zone="ch-system-bzip2">
16 <primary sortas="a-Bzip2">Bzip2</primary>
17 </indexterm>
18
19 <sect2 role="package">
20 <title/>
21
22 <para>The Bzip2 package contains programs for compressing and
23 decompressing files. Compressing text files with <command>bzip2</command>
24 yields a much better compression percentage than with the traditional
25 <command>gzip</command>.</para>
26
27 <segmentedlist>
28 <segtitle>&buildtime;</segtitle>
29 <segtitle>&diskspace;</segtitle>
30
31 <seglistitem>
32 <seg>Not checked yet</seg>
33 <seg>Not checked yet</seg>
34 </seglistitem>
35 </segmentedlist>
36
37 <segmentedlist>
38 <segtitle>&dependencies;</segtitle>
39
40 <seglistitem>
41 <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, and Make</seg>
42 </seglistitem>
43 </segmentedlist>
44
45 </sect2>
46
47 <sect2 role="installation">
48 <title>Installation of Bzip2</title>
49
50 <para os="j">Apply a patch to install the documentation for this
51 package:</para>
52
53<screen os="k"><userinput>patch -Np1 -i ../&bzip2-docs-patch;</userinput></screen>
54
55 <para os="l">The <command>bzgrep</command> command does not escape '|' and
56 '&amp;' in filenames passed to it. This allows arbitrary commands to be
57 executed with the privileges of the user running <command>bzgrep</command>.
58 Apply the following patch to address this:</para>
59
60<screen os="m"><userinput>patch -Np1 -i ../&bzip2-bzgrep-patch;</userinput></screen>
61
62 <para os="a">The Bzip2 package does not contain a <command>configure</command>
63 script. Compile it with:</para>
64
65<screen><userinput>make -f Makefile-libbz2_so
66make clean</userinput></screen>
67
68 <para os="b">The <parameter>-f</parameter> flag will cause Bzip2 to be built
69 using a different <filename>Makefile</filename> file, in this case the
70 <filename>Makefile-libbz2_so</filename> file, which creates a dynamic
71 <filename class="libraryfile">libbz2.so</filename> library and links the
72 Bzip2 utilities against it.</para>
73
74 <para os="c">Compile the package:</para>
75
76<screen><userinput>make</userinput></screen>
77
78 <para os="d">To test the results, issue:
79 <userinput>make test</userinput>.</para>
80
81 <para os="e">If reinstalling Bzip2, perform
82 <userinput>rm -f /usr/bin/bz*</userinput> first, otherwise the
83 following <command>make install</command> will fail.</para>
84
85 <para os="f">Install the programs:</para>
86
87<screen os="g"><userinput>make install</userinput></screen>
88
89 <para os="h">Install the shared <command>bzip2</command> binary into the
90 <filename class="directory">/bin</filename> directory, make
91 some necessary symbolic links, and clean up:</para>
92
93<screen os="i"><userinput>cp bzip2-shared /bin/bzip2
94cp -a libbz2.so* /lib
95ln -s ../../lib/libbz2.so.1.0 /usr/lib/libbz2.so
96rm /usr/bin/{bunzip2,bzcat,bzip2}
97ln -s bzip2 /bin/bunzip2
98ln -s bzip2 /bin/bzcat</userinput></screen>
99
100 </sect2>
101
102 <sect2 id="contents-bzip2" role="content">
103 <title>Contents of Bzip2</title>
104
105 <segmentedlist>
106 <segtitle>Installed programs</segtitle>
107 <segtitle>Installed libraries</segtitle>
108
109 <seglistitem>
110 <seg>bunzip2 (link to bzip2), bzcat (link to bzip2), bzcmp, bzdiff,
111 bzegrep, bzfgrep, bzgrep, bzip2, bzip2recover, bzless, and bzmore</seg>
112 <seg>libbz2.a, libbz2.so (link to libbz2.so.1.0), libbz2.so.1.0 (link to
113 libbz2.so.&bzip2-version;), and libbz2.so.&bzip2-version;</seg>
114 </seglistitem>
115 </segmentedlist>
116
117 <variablelist>
118 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
119 <?dbfo list-presentation="list"?>
120 <?dbhtml list-presentation="table"?>
121
122 <varlistentry id="bunzip2">
123 <term><command>bunzip2</command></term>
124 <listitem>
125 <para>Decompresses bzipped files</para>
126 <indexterm zone="ch-system-bzip2 bunzip2">
127 <primary sortas="b-bunzip2">bunzip2</primary>
128 </indexterm>
129 </listitem>
130 </varlistentry>
131
132 <varlistentry id="bzcat">
133 <term><command>bzcat</command></term>
134 <listitem>
135 <para>Decompresses to standard output</para>
136 <indexterm zone="ch-system-bzip2 bzcat">
137 <primary sortas="b-bzcat">bzcat</primary>
138 </indexterm>
139 </listitem>
140 </varlistentry>
141
142 <varlistentry id="bzcmp">
143 <term><command>bzcmp</command></term>
144 <listitem>
145 <para>Runs <command>cmp</command> on bzipped files</para>
146 <indexterm zone="ch-system-bzip2 bzcmp">
147 <primary sortas="b-bzcmp">bzcmp</primary>
148 </indexterm>
149 </listitem>
150 </varlistentry>
151
152 <varlistentry id="bzdiff">
153 <term><command>bzdiff</command></term>
154 <listitem>
155 <para>Runs <command>diff</command> on bzipped files</para>
156 <indexterm zone="ch-system-bzip2 bzdiff">
157 <primary sortas="b-bzdiff">bzdiff</primary>
158 </indexterm>
159 </listitem>
160 </varlistentry>
161
162 <varlistentry id="bzgrep">
163 <term><command>bzgrep</command></term>
164 <listitem>
165 <para>Runs <command>grep</command> on bzipped files</para>
166 <indexterm zone="ch-system-bzip2 bzgrep">
167 <primary sortas="b-bzgrep">bzgrep</primary>
168 </indexterm>
169 </listitem>
170 </varlistentry>
171
172 <varlistentry id="bzegrep">
173 <term><command>bzegrep</command></term>
174 <listitem>
175 <para>Runs <command>egrep</command> on bzipped files</para>
176 <indexterm zone="ch-system-bzip2 bzegrep">
177 <primary sortas="b-bzegrep">bzegrep</primary>
178 </indexterm>
179 </listitem>
180 </varlistentry>
181
182 <varlistentry id="bzfgrep">
183 <term><command>bzfgrep</command></term>
184 <listitem>
185 <para>Runs <command>fgrep</command> on bzipped files</para>
186 <indexterm zone="ch-system-bzip2 bzfgrep">
187 <primary sortas="b-bzfgrep">bzfgrep</primary>
188 </indexterm>
189 </listitem>
190 </varlistentry>
191
192 <varlistentry id="bzip2">
193 <term><command>bzip2</command></term>
194 <listitem>
195 <para>Compresses files using the Burrows-Wheeler block sorting text
196 compression algorithm with Huffman coding; the compression rate is
197 better than that achieved by more conventional compressors using
198 <quote>Lempel-Ziv</quote> algorithms, like <command>gzip</command></para>
199 <indexterm zone="ch-system-bzip2 bzip2">
200 <primary sortas="b-bzip2">bzip2</primary>
201 </indexterm>
202 </listitem>
203 </varlistentry>
204
205 <varlistentry id="bzip2recover">
206 <term><command>bzip2recover</command></term>
207 <listitem>
208 <para>Tries to recover data from damaged bzipped files</para>
209 <indexterm zone="ch-system-bzip2 bzip2recover">
210 <primary sortas="b-bzip2recover">bzip2recover</primary>
211 </indexterm>
212 </listitem>
213 </varlistentry>
214
215 <varlistentry id="bzless">
216 <term><command>bzless</command></term>
217 <listitem>
218 <para>Runs <command>less</command> on bzipped files</para>
219 <indexterm zone="ch-system-bzip2 bzless">
220 <primary sortas="b-bzless">bzless</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="bzmore">
226 <term><command>bzmore</command></term>
227 <listitem>
228 <para>Runs <command>more</command> on bzipped files</para>
229 <indexterm zone="ch-system-bzip2 bzmore">
230 <primary sortas="b-bzmore">bzmore</primary>
231 </indexterm>
232 </listitem>
233 </varlistentry>
234
235 <varlistentry id="libbz2">
236 <term><filename class="libraryfile">libbz2*</filename></term>
237 <listitem>
238 <para>The library implementing lossless, block-sorting data
239 compression, using the Burrows-Wheeler algorithm</para>
240 <indexterm zone="ch-system-bzip2 libbz2">
241 <primary sortas="c-libbz2*">libbz2*</primary>
242 </indexterm>
243 </listitem>
244 </varlistentry>
245
246 </variablelist>
247
248 </sect2>
249
250</sect1>
Note: See TracBrowser for help on using the repository browser.