Ignore:
Timestamp:
02/03/2006 06:23:22 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Children:
fa994c9
Parents:
b4cd3c5
Message:

Ported r7294 to r7325 from trunk to alphabetical branch.

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/branches/alphabetical/BOOK@7333 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

File:
1 edited

Legend:

Unmodified
Added
Removed

  • chapter06/bzip2.xml

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