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

clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since 0a7edfb was 653cf49, checked in by Chris Staub <chris@…>, 15 years ago

Updates to program descriptions for Bzip2 and Findutils

  • Property mode set to 100644
File size: 7.5 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 <title>Bzip2-&bzip2-version;</title>
12
13 <indexterm zone="ch-system-bzip2">
14 <primary sortas="a-Bzip2">Bzip2</primary>
15 </indexterm>
16
17 <sect2 role="package">
18 <title/>
19
20 <para>The Bzip2 package contains programs for compressing and
21 decompressing files. Compressing text files with <command>bzip2</command>
22 yields a much better compression percentage than with the traditional
23 <command>gzip</command>.</para>
24
25 </sect2>
26
27 <sect2 role="installation">
28 <title>Installation of Bzip2</title>
29
30 <para os="s1">By default Bzip2 creates some symlinks that use absolute
31 pathnames. The following sed will cause them to be created with relative
32 paths instead:</para>
33
34<screen os="s2"><userinput>sed -i -e 's:ln -s -f $(PREFIX)/bin/:ln -s :' Makefile</userinput></screen>
35
36 <para os="a">The Bzip2 package does not contain a <command>configure</command>
37 script. Compile it with:</para>
38
39<screen os="b"><userinput>make -f Makefile-libbz2_so
40make clean</userinput></screen>
41
42 <para os="c">The <parameter>-f</parameter> flag will cause Bzip2 to be built
43 using a different <filename>Makefile</filename> file, in this case the
44 <filename>Makefile-libbz2_so</filename> file, which creates a dynamic
45 <filename class="libraryfile">libbz2.so</filename> library and links the
46 Bzip2 utilities against it.</para>
47
48 <para os="d">Recompile the package using a non-shared library and test it:</para>
49
50<screen os="e"><userinput>make</userinput></screen>
51
52 <para os="g">Install the programs:</para>
53
54<screen os="h"><userinput>make PREFIX=/usr install</userinput></screen>
55
56 <para os="i">Install the shared <command>bzip2</command> binary into the
57 <filename class="directory">/bin</filename> directory, make
58 some necessary symbolic links, and clean up:</para>
59
60<screen os="j"><userinput>cp -v bzip2-shared /bin/bzip2
61cp -av libbz2.so* /lib
62ln -sv ../../lib/libbz2.so.1.0 /usr/lib/libbz2.so
63rm -v /usr/bin/{bunzip2,bzcat,bzip2}
64ln -sv bzip2 /bin/bunzip2
65ln -sv bzip2 /bin/bzcat</userinput></screen>
66
67 </sect2>
68
69 <sect2 id="contents-bzip2" role="content">
70 <title>Contents of Bzip2</title>
71
72 <segmentedlist>
73 <segtitle>Installed programs</segtitle>
74 <segtitle>Installed libraries</segtitle>
75
76 <seglistitem>
77 <seg>bunzip2 (link to bzip2), bzcat (link to bzip2), bzcmp (link to
78 bzdiff), bzdiff, bzegrep (link to bzgrep), bzfgrep (link to bzgrep),
79 bzgrep, bzip2, bzip2recover, bzless (link to bzmore), and bzmore</seg>
80 <seg>libbz2.a, libbz2.so (link to libbz2.so.1.0), libbz2.so.1.0 (link to
81 libbz2.so.&bzip2-version;), and libbz2.so.&bzip2-version;</seg>
82 </seglistitem>
83 </segmentedlist>
84
85 <variablelist>
86 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
87 <?dbfo list-presentation="list"?>
88 <?dbhtml list-presentation="table"?>
89
90 <varlistentry id="bunzip2">
91 <term><command>bunzip2</command></term>
92 <listitem>
93 <para>Decompresses bzipped files</para>
94 <indexterm zone="ch-system-bzip2 bunzip2">
95 <primary sortas="b-bunzip2">bunzip2</primary>
96 </indexterm>
97 </listitem>
98 </varlistentry>
99
100 <varlistentry id="bzcat">
101 <term><command>bzcat</command></term>
102 <listitem>
103 <para>Decompresses to standard output</para>
104 <indexterm zone="ch-system-bzip2 bzcat">
105 <primary sortas="b-bzcat">bzcat</primary>
106 </indexterm>
107 </listitem>
108 </varlistentry>
109
110 <varlistentry id="bzcmp">
111 <term><command>bzcmp</command></term>
112 <listitem>
113 <para>Runs <command>cmp</command> on bzipped files</para>
114 <indexterm zone="ch-system-bzip2 bzcmp">
115 <primary sortas="b-bzcmp">bzcmp</primary>
116 </indexterm>
117 </listitem>
118 </varlistentry>
119
120 <varlistentry id="bzdiff">
121 <term><command>bzdiff</command></term>
122 <listitem>
123 <para>Runs <command>diff</command> on bzipped files</para>
124 <indexterm zone="ch-system-bzip2 bzdiff">
125 <primary sortas="b-bzdiff">bzdiff</primary>
126 </indexterm>
127 </listitem>
128 </varlistentry>
129
130 <varlistentry id="bzegrep">
131 <term><command>bzegrep</command></term>
132 <listitem>
133 <para>Runs <command>egrep</command> on bzipped files</para>
134 <indexterm zone="ch-system-bzip2 bzegrep">
135 <primary sortas="b-bzegrep">bzegrep</primary>
136 </indexterm>
137 </listitem>
138 </varlistentry>
139
140 <varlistentry id="bzfgrep">
141 <term><command>bzfgrep</command></term>
142 <listitem>
143 <para>Runs <command>fgrep</command> on bzipped files</para>
144 <indexterm zone="ch-system-bzip2 bzfgrep">
145 <primary sortas="b-bzfgrep">bzfgrep</primary>
146 </indexterm>
147 </listitem>
148 </varlistentry>
149
150 <varlistentry id="bzgrep">
151 <term><command>bzgrep</command></term>
152 <listitem>
153 <para>Runs <command>grep</command> on bzipped files</para>
154 <indexterm zone="ch-system-bzip2 bzgrep">
155 <primary sortas="b-bzgrep">bzgrep</primary>
156 </indexterm>
157 </listitem>
158 </varlistentry>
159
160 <varlistentry id="bzip2">
161 <term><command>bzip2</command></term>
162 <listitem>
163 <para>Compresses files using the Burrows-Wheeler block sorting text
164 compression algorithm with Huffman coding; the compression rate is
165 better than that achieved by more conventional compressors using
166 <quote>Lempel-Ziv</quote> algorithms, like <command>gzip</command></para>
167 <indexterm zone="ch-system-bzip2 bzip2">
168 <primary sortas="b-bzip2">bzip2</primary>
169 </indexterm>
170 </listitem>
171 </varlistentry>
172
173 <varlistentry id="bzip2recover">
174 <term><command>bzip2recover</command></term>
175 <listitem>
176 <para>Tries to recover data from damaged bzipped files</para>
177 <indexterm zone="ch-system-bzip2 bzip2recover">
178 <primary sortas="b-bzip2recover">bzip2recover</primary>
179 </indexterm>
180 </listitem>
181 </varlistentry>
182
183 <varlistentry id="bzless">
184 <term><command>bzless</command></term>
185 <listitem>
186 <para>Runs <command>less</command> on bzipped files</para>
187 <indexterm zone="ch-system-bzip2 bzless">
188 <primary sortas="b-bzless">bzless</primary>
189 </indexterm>
190 </listitem>
191 </varlistentry>
192
193 <varlistentry id="bzmore">
194 <term><command>bzmore</command></term>
195 <listitem>
196 <para>Runs <command>more</command> on bzipped files</para>
197 <indexterm zone="ch-system-bzip2 bzmore">
198 <primary sortas="b-bzmore">bzmore</primary>
199 </indexterm>
200 </listitem>
201 </varlistentry>
202
203 <varlistentry id="libbz2">
204 <term><filename class="libraryfile">libbz2*</filename></term>
205 <listitem>
206 <para>The library implementing lossless, block-sorting data
207 compression, using the Burrows-Wheeler algorithm</para>
208 <indexterm zone="ch-system-bzip2 libbz2">
209 <primary sortas="c-libbz2*">libbz2*</primary>
210 </indexterm>
211 </listitem>
212 </varlistentry>
213
214 </variablelist>
215
216 </sect2>
217
218</sect1>
Note: See TracBrowser for help on using the repository browser.