source: final-system/common/bzip2.xml@ db63ccc

Last change on this file since db63ccc was eac7362, checked in by Jim Gifford <clfs@…>, 19 years ago

r668@server (orig r666): manuel | 2005-11-08 15:25:13 -0800
Removing SBUs and DUs. Chapter final-system, round 6.

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