source: clfs-sysroot/BOOK/final-system/common/bzip2.xml @ 12e6567

Last change on this file since 12e6567 was 12e6567, checked in by Joe Ciccone <jciccone@…>, 15 years ago

Added a sysroot wrapper.
Updated the build variables section of the book, each package uses its own.

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