Remove reference to /dev/shm in fstab description
[linux_from_scratch.git] / chapter06 / gzip.xml
blob7b5a5e20afc3ba1fd41fb65ff4db9c0f58b52b05
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 ]>
8 <sect1 id="ch-system-gzip" role="wrap">
9   <?dbhtml filename="gzip.html"?>
11   <sect1info condition="script">
12     <productname>gzip</productname>
13     <productnumber>&gzip-version;</productnumber>
14     <address>&gzip-url;</address>
15   </sect1info>
17   <title>Gzip-&gzip-version;</title>
19   <indexterm zone="ch-system-gzip">
20     <primary sortas="a-Gzip">Gzip</primary>
21   </indexterm>
23   <sect2 role="package">
24     <title/>
26     <para>The Gzip package contains programs for compressing and decompressing
27     files.</para>
29     <segmentedlist>
30       <segtitle>&buildtime;</segtitle>
31       <segtitle>&diskspace;</segtitle>
33       <seglistitem>
34         <seg>&gzip-ch6-sbu;</seg>
35         <seg>&gzip-ch6-du;</seg>
36       </seglistitem>
37     </segmentedlist>
39   </sect2>
41   <sect2 role="installation">
42     <title>Installation of Gzip</title>
44     <para>Prepare Gzip for compilation:</para>
46 <screen><userinput remap="configure">./configure --prefix=/usr --bindir=/bin</userinput></screen>
48     <para>Compile the package:</para>
50 <screen><userinput remap="make">make</userinput></screen>
52     <para>To test the results, issue:</para>
54 <screen><userinput remap="test">make check</userinput></screen>
56     <para>Install the package:</para>
58 <screen><userinput remap="install">make install</userinput></screen>
60     <para>Move some programs that do not need to be on the root filesystem:</para>
62 <screen><userinput remap="install">mv -v /bin/{gzexe,uncompress,zcmp,zdiff,zegrep} /usr/bin
63 mv -v /bin/{zfgrep,zforce,zgrep,zless,zmore,znew} /usr/bin</userinput></screen>
65   </sect2>
67   <sect2 id="contents-gzip" role="content">
68     <title>Contents of Gzip</title>
70     <segmentedlist>
71       <segtitle>Installed programs</segtitle>
73       <seglistitem>
74         <seg>gunzip, gzexe, gzip, uncompress, zcat, zcmp, zdiff, zegrep, zfgrep,
75         zforce, zgrep, zless, zmore, and znew</seg>
76       </seglistitem>
77     </segmentedlist>
79     <variablelist>
80       <bridgehead renderas="sect3">Short Descriptions</bridgehead>
81       <?dbfo list-presentation="list"?>
82       <?dbhtml list-presentation="table"?>
84       <varlistentry id="gunzip">
85         <term><command>gunzip</command></term>
86         <listitem>
87           <para>Decompresses gzipped files</para>
88           <indexterm zone="ch-system-gzip gunzip">
89             <primary sortas="b-gunzip">gunzip</primary>
90           </indexterm>
91         </listitem>
92       </varlistentry>
94       <varlistentry id="gzexe">
95         <term><command>gzexe</command></term>
96         <listitem>
97           <para>Creates self-decompressing executable files</para>
98           <indexterm zone="ch-system-gzip gzexe">
99             <primary sortas="b-gzexe">gzexe</primary>
100           </indexterm>
101         </listitem>
102       </varlistentry>
104       <varlistentry id="gzip">
105         <term><command>gzip</command></term>
106         <listitem>
107           <para>Compresses the given files using Lempel-Ziv (LZ77) coding</para>
108           <indexterm zone="ch-system-gzip gzip">
109             <primary sortas="b-gzip">gzip</primary>
110           </indexterm>
111         </listitem>
112       </varlistentry>
114       <varlistentry id="uncompress">
115         <term><command>uncompress</command></term>
116         <listitem>
117           <para>Decompresses compressed files</para>
118           <indexterm zone="ch-system-gzip uncompress">
119             <primary sortas="b-uncompress">uncompress</primary>
120           </indexterm>
121         </listitem>
122       </varlistentry>
124       <varlistentry id="zcat">
125         <term><command>zcat</command></term>
126         <listitem>
127           <para>Decompresses the given gzipped files to standard output</para>
128           <indexterm zone="ch-system-gzip zcat">
129             <primary sortas="b-zcat">zcat</primary>
130           </indexterm>
131         </listitem>
132       </varlistentry>
134       <varlistentry id="zcmp">
135         <term><command>zcmp</command></term>
136         <listitem>
137           <para>Runs <command>cmp</command> on gzipped files</para>
138           <indexterm zone="ch-system-gzip zcmp">
139             <primary sortas="b-zcmp">zcmp</primary>
140           </indexterm>
141         </listitem>
142       </varlistentry>
144       <varlistentry id="zdiff">
145         <term><command>zdiff</command></term>
146         <listitem>
147           <para>Runs <command>diff</command> on gzipped files</para>
148           <indexterm zone="ch-system-gzip zdiff">
149             <primary sortas="b-zdiff">zdiff</primary>
150           </indexterm>
151         </listitem>
152       </varlistentry>
154       <varlistentry id="zegrep">
155         <term><command>zegrep</command></term>
156         <listitem>
157           <para>Runs <command>egrep</command> on gzipped files</para>
158           <indexterm zone="ch-system-gzip zegrep">
159             <primary sortas="b-zegrep">zegrep</primary>
160           </indexterm>
161         </listitem>
162       </varlistentry>
164       <varlistentry id="zfgrep">
165         <term><command>zfgrep</command></term>
166         <listitem>
167           <para>Runs <command>fgrep</command> on gzipped files</para>
168           <indexterm zone="ch-system-gzip zfgrep">
169             <primary sortas="b-zfgrep">zfgrep</primary>
170           </indexterm>
171         </listitem>
172       </varlistentry>
174       <varlistentry id="zforce">
175         <term><command>zforce</command></term>
176         <listitem>
177           <para>Forces a <filename class="extension">.gz</filename> extension on
178           all given files that are gzipped files, so that <command>gzip</command>
179           will not compress them again; this can be useful when file names were
180           truncated during a file transfer</para>
181           <indexterm zone="ch-system-gzip zforce">
182             <primary sortas="b-zforce">zforce</primary>
183           </indexterm>
184         </listitem>
185       </varlistentry>
187       <varlistentry id="zgrep">
188         <term><command>zgrep</command></term>
189         <listitem>
190           <para>Runs <command>grep</command> on gzipped files</para>
191           <indexterm zone="ch-system-gzip zgrep">
192             <primary sortas="b-zgrep">zgrep</primary>
193           </indexterm>
194         </listitem>
195       </varlistentry>
197       <varlistentry id="zless">
198         <term><command>zless</command></term>
199         <listitem>
200           <para>Runs <command>less</command> on gzipped files</para>
201           <indexterm zone="ch-system-gzip zless">
202             <primary sortas="b-zless">zless</primary>
203           </indexterm>
204         </listitem>
205       </varlistentry>
207       <varlistentry id="zmore">
208         <term><command>zmore</command></term>
209         <listitem>
210           <para>Runs <command>more</command> on gzipped files</para>
211           <indexterm zone="ch-system-gzip zmore">
212             <primary sortas="b-zmore">zmore</primary>
213           </indexterm>
214         </listitem>
215       </varlistentry>
217       <varlistentry id="znew">
218         <term><command>znew</command></term>
219         <listitem>
220           <para>Re-compresses files from <command>compress</command> format to
221           <command>gzip</command> format&mdash;<filename
222           class="extension">.Z</filename> to <filename
223           class="extension">.gz</filename></para>
224           <indexterm zone="ch-system-gzip znew">
225             <primary sortas="b-znew">znew</primary>
226           </indexterm>
227         </listitem>
228       </varlistentry>
230     </variablelist>
232   </sect2>
234 </sect1>