source: clfs-sysroot/BOOK/final-system/common/gzip.xml @ 124ebe0

Last change on this file since 124ebe0 was 124ebe0, checked in by Jim Gifford <clfs@…>, 15 years ago

r3843@server (orig r1733): jciccone | 2006-06-06 12:54:26 -0700
Fixed a few typos.

  • Property mode set to 100644
File size: 8.1 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  %general-entities;
6]>
7
8<sect1 id="ch-system-gzip" role="wrap">
9  <?dbhtml filename="gzip.html"?>
10
11  <title>Gzip-&gzip-version;</title>
12
13  <indexterm zone="ch-system-gzip">
14    <primary sortas="a-Gzip">Gzip</primary>
15  </indexterm>
16
17  <sect2 role="package">
18    <title/>
19
20    <para>The Gzip package contains programs for compressing and decompressing
21    files.</para>
22
23  </sect2>
24
25  <sect2 role="installation">
26    <title>Installation of Gzip</title>
27
28    <para os="p1">The following patch fixes two security vulnerabilities in Gzip.
29    First, a path traversal bug when using the <option>-N</option> option
30    (CAN-2005-1228) Second, a race condition in the file permission restore
31    code (CAN-2005-0998)</para>
32
33<screen os="p2"><userinput>patch -Np1 -i ../&gzip-security_fix-patch;</userinput></screen>
34
35    <para os="a">Prepare Gzip for compilation:</para>
36
37<screen os="b"><userinput>./configure --prefix=/usr --host=${LFS_TARGET}</userinput></screen>
38
39    <para os="c">The <command>gzexe</command> script has the location of the
40    <command>gzip</command> binary hard-wired into it. Because the
41    location of the binary is changed later, the following command ensures
42    that the new location gets placed into the script:</para>
43
44<screen os="d"><userinput>cp gzexe.in{,.orig}
45sed 's@"BINDIR"@/bin@g' gzexe.in.orig &gt; gzexe.in</userinput></screen>
46
47    <para os="e">Compile the package:</para>
48
49<screen os="f"><userinput>make</userinput></screen>
50
51    <para os="g">Install the package:</para>
52
53<screen os="h"><userinput>make DESTDIR=${LFS} install</userinput></screen>
54
55    <para os="i">Move the <command>gzip</command> program to the <filename
56    class="directory">/bin</filename> directory and create some commonly
57    used symlinks to it:</para>
58
59<screen os="j"><userinput>mv -v ${LFS}/usr/bin/gzip ${LFS}/bin
60rm -v ${LFS}/usr/bin/{gunzip,zcat}
61ln -sv gzip ${LFS}/bin/gunzip
62ln -sv gzip ${LFS}/bin/zcat
63ln -sv gzip ${LFS}/bin/compress
64ln -sv gunzip ${LFS}/bin/uncompress</userinput></screen>
65
66  </sect2>
67
68  <sect2 id="contents-gzip" role="content">
69    <title>Contents of Gzip</title>
70
71    <segmentedlist>
72      <segtitle>Installed programs</segtitle>
73
74      <seglistitem>
75        <seg>compress (link to gzip), gunzip (link to gzip), gzexe, gzip,
76        uncompress (link to gunzip), zcat (link to gzip), zcmp, zdiff,
77        zegrep, zfgrep, zforce, zgrep, zless, zmore, and znew</seg>
78      </seglistitem>
79    </segmentedlist>
80
81    <variablelist>
82      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
83      <?dbfo list-presentation="list"?>
84      <?dbhtml list-presentation="table"?>
85
86      <varlistentry id="compress">
87        <term><command>compress</command></term>
88        <listitem>
89          <para>Compresses and decompresses files</para>
90          <indexterm zone="ch-system-gzip compress">
91            <primary sortas="b-compress">compress</primary>
92          </indexterm>
93        </listitem>
94      </varlistentry>
95
96      <varlistentry id="gunzip">
97        <term><command>gunzip</command></term>
98        <listitem>
99          <para>Decompresses gzipped files</para>
100          <indexterm zone="ch-system-gzip gunzip">
101            <primary sortas="b-gunzip">gunzip</primary>
102          </indexterm>
103        </listitem>
104      </varlistentry>
105
106      <varlistentry id="gzexe">
107        <term><command>gzexe</command></term>
108        <listitem>
109          <para>Creates self-decompressing executable files</para>
110          <indexterm zone="ch-system-gzip gzexe">
111            <primary sortas="b-gzexe">gzexe</primary>
112          </indexterm>
113        </listitem>
114      </varlistentry>
115
116      <varlistentry id="gzip">
117        <term><command>gzip</command></term>
118        <listitem>
119          <para>Compresses the given files using Lempel-Ziv (LZ77) coding</para>
120          <indexterm zone="ch-system-gzip gzip">
121            <primary sortas="b-gzip">gzip</primary>
122          </indexterm>
123        </listitem>
124      </varlistentry>
125
126      <varlistentry id="uncompress">
127        <term><command>uncompress</command></term>
128        <listitem>
129          <para>Decompresses compressed files</para>
130          <indexterm zone="ch-system-gzip uncompress">
131            <primary sortas="b-uncompress">uncompress</primary>
132          </indexterm>
133        </listitem>
134      </varlistentry>
135
136      <varlistentry id="zcat">
137        <term><command>zcat</command></term>
138        <listitem>
139          <para>Decompresses the given gzipped files to standard output</para>
140          <indexterm zone="ch-system-gzip zcat">
141            <primary sortas="b-zcat">zcat</primary>
142          </indexterm>
143        </listitem>
144      </varlistentry>
145
146      <varlistentry id="zcmp">
147        <term><command>zcmp</command></term>
148        <listitem>
149          <para>Runs <command>cmp</command> on gzipped files</para>
150          <indexterm zone="ch-system-gzip zcmp">
151            <primary sortas="b-zcmp">zcmp</primary>
152          </indexterm>
153        </listitem>
154      </varlistentry>
155
156      <varlistentry id="zdiff">
157        <term><command>zdiff</command></term>
158        <listitem>
159          <para>Runs <command>diff</command> on gzipped files</para>
160          <indexterm zone="ch-system-gzip zdiff">
161            <primary sortas="b-zdiff">zdiff</primary>
162          </indexterm>
163        </listitem>
164      </varlistentry>
165
166      <varlistentry id="zegrep">
167        <term><command>zegrep</command></term>
168        <listitem>
169          <para>Runs <command>egrep</command> on gzipped files</para>
170          <indexterm zone="ch-system-gzip zegrep">
171            <primary sortas="b-zegrep">zegrep</primary>
172          </indexterm>
173        </listitem>
174      </varlistentry>
175
176      <varlistentry id="zfgrep">
177        <term><command>zfgrep</command></term>
178        <listitem>
179          <para>Runs <command>fgrep</command> on gzipped files</para>
180          <indexterm zone="ch-system-gzip zfgrep">
181            <primary sortas="b-zfgrep">zfgrep</primary>
182          </indexterm>
183        </listitem>
184      </varlistentry>
185
186      <varlistentry id="zforce">
187        <term><command>zforce</command></term>
188        <listitem>
189          <para>Forces a <filename class="extension">.gz</filename> extension on
190          all given files that are gzipped files, so that <command>gzip</command>
191          will not compress them again; this can be useful when file names were
192          truncated during a file transfer</para>
193          <indexterm zone="ch-system-gzip zforce">
194            <primary sortas="b-zforce">zforce</primary>
195          </indexterm>
196        </listitem>
197      </varlistentry>
198
199      <varlistentry id="zgrep">
200        <term><command>zgrep</command></term>
201        <listitem>
202          <para>Runs <command>grep</command> on gzipped files</para>
203          <indexterm zone="ch-system-gzip zgrep">
204            <primary sortas="b-zgrep">zgrep</primary>
205          </indexterm>
206        </listitem>
207      </varlistentry>
208
209      <varlistentry id="zless">
210        <term><command>zless</command></term>
211        <listitem>
212          <para>Runs <command>less</command> on gzipped files</para>
213          <indexterm zone="ch-system-gzip zless">
214            <primary sortas="b-zless">zless</primary>
215          </indexterm>
216        </listitem>
217      </varlistentry>
218
219      <varlistentry id="zmore">
220        <term><command>zmore</command></term>
221        <listitem>
222          <para>Runs <command>more</command> on gzipped files</para>
223          <indexterm zone="ch-system-gzip zmore">
224            <primary sortas="b-zmore">zmore</primary>
225          </indexterm>
226        </listitem>
227      </varlistentry>
228
229      <varlistentry id="znew">
230        <term><command>znew</command></term>
231        <listitem>
232          <para>Re-compresses files from <command>compress</command> format to
233          <command>gzip</command> format&mdash;<filename
234          class="extension">.Z</filename> to <filename
235          class="extension">.gz</filename></para>
236          <indexterm zone="ch-system-gzip znew">
237            <primary sortas="b-znew">znew</primary>
238          </indexterm>
239        </listitem>
240      </varlistentry>
241
242    </variablelist>
243
244  </sect2>
245
246</sect1>
Note: See TracBrowser for help on using the repository browser.