gzip.xml 6.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213
  1. <?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" [
  3. <!ENTITY % general-entities SYSTEM "../general.ent">
  4. %general-entities;
  5. ]>
  6. <sect1 id="ch-system-gzip" role="wrap">
  7. <title>Gzip-&gzip-version;</title>
  8. <?dbhtml filename="gzip.html"?>
  9. <indexterm zone="ch-system-gzip"><primary sortas="a-Gzip">Gzip</primary></indexterm>
  10. <sect2 role="package"><title/>
  11. <para>The Gzip package contains programs for compressing and decompressing
  12. files.</para>
  13. <segmentedlist>
  14. <segtitle>&buildtime;</segtitle>
  15. <segtitle>&diskspace;</segtitle>
  16. <seglistitem><seg>0.1 SBU</seg><seg>2.2 MB</seg></seglistitem>
  17. </segmentedlist>
  18. <segmentedlist>
  19. <segtitle>&dependencies;</segtitle>
  20. <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
  21. GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
  22. </segmentedlist>
  23. </sect2>
  24. <sect2 role="installation">
  25. <title>Installation of Gzip</title>
  26. <para>Gzip has 2 known security vulnerabilities. The following patch
  27. addresses both of them:</para>
  28. <screen><userinput>patch -Np1 -i ../&gzip-security_fix-patch;</userinput></screen>
  29. <para>Prepare Gzip for compilation:</para>
  30. <screen><userinput>./configure --prefix=/usr</userinput></screen>
  31. <para>The <command>gzexe</command> script has the location of the
  32. <command>gzip</command> binary hard-wired into it. Because the
  33. location of the binary is changed later, the following command ensures
  34. that the new location gets placed into the script:</para>
  35. <screen><userinput>sed -i 's@"BINDIR"@/bin@g' gzexe.in</userinput></screen>
  36. <para>Compile the package:</para>
  37. <screen><userinput>make</userinput></screen>
  38. <para>This package does not come with a test suite.</para>
  39. <para>Install the package:</para>
  40. <screen><userinput>make install</userinput></screen>
  41. <para>Move the <command>gzip</command> program to the <filename
  42. class="directory">/bin</filename> directory and create some commonly used
  43. symlinks to it:</para>
  44. <screen><userinput>mv -v /usr/bin/gzip /bin
  45. rm -v /usr/bin/{gunzip,zcat}
  46. ln -sv gzip /bin/gunzip
  47. ln -sv gzip /bin/zcat
  48. ln -sv gzip /bin/compress
  49. ln -sv gunzip /bin/uncompress</userinput></screen>
  50. </sect2>
  51. <sect2 id="contents-gzip" role="content"><title>Contents of Gzip</title>
  52. <segmentedlist>
  53. <segtitle>Installed programs</segtitle>
  54. <seglistitem><seg>compress (link to gzip), gunzip (link to gzip), gzexe,
  55. gzip, uncompress (link to gunzip), zcat (link to gzip), zcmp, zdiff,
  56. zegrep, zfgrep, zforce, zgrep, zless, zmore, and znew</seg></seglistitem>
  57. </segmentedlist>
  58. <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
  59. <?dbfo list-presentation="list"?>
  60. <?dbhtml list-presentation="table"?>
  61. <varlistentry id="compress">
  62. <term><command>compress</command></term>
  63. <listitem>
  64. <para>Compresses and decompresses files</para>
  65. <indexterm zone="ch-system-gzip compress"><primary sortas="b-compress">compress</primary></indexterm>
  66. </listitem>
  67. </varlistentry>
  68. <varlistentry id="gunzip">
  69. <term><command>gunzip</command></term>
  70. <listitem>
  71. <para>Decompresses gzipped files</para>
  72. <indexterm zone="ch-system-gzip gunzip"><primary sortas="b-gunzip">gunzip</primary></indexterm>
  73. </listitem>
  74. </varlistentry>
  75. <varlistentry id="gzexe">
  76. <term><command>gzexe</command></term>
  77. <listitem>
  78. <para>Creates self-decompressing executable files</para>
  79. <indexterm zone="ch-system-gzip gzexe"><primary sortas="b-gzexe">gzexe</primary></indexterm>
  80. </listitem>
  81. </varlistentry>
  82. <varlistentry id="gzip">
  83. <term><command>gzip</command></term>
  84. <listitem>
  85. <para>Compresses the given files using Lempel-Ziv (LZ77) coding</para>
  86. <indexterm zone="ch-system-gzip gzip"><primary sortas="b-gzip">gzip</primary></indexterm>
  87. </listitem>
  88. </varlistentry>
  89. <varlistentry id="uncompress">
  90. <term><command>uncompress</command></term>
  91. <listitem>
  92. <para>Decompresses compressed files</para>
  93. <indexterm zone="ch-system-gzip uncompress"><primary sortas="b-uncompress">uncompress</primary></indexterm>
  94. </listitem>
  95. </varlistentry>
  96. <varlistentry id="zcat">
  97. <term><command>zcat</command></term>
  98. <listitem>
  99. <para>Decompresses the given gzipped files to standard output</para>
  100. <indexterm zone="ch-system-gzip zcat"><primary sortas="b-zcat">zcat</primary></indexterm>
  101. </listitem>
  102. </varlistentry>
  103. <varlistentry id="zcmp">
  104. <term><command>zcmp</command></term>
  105. <listitem>
  106. <para>Runs <command>cmp</command> on gzipped files</para>
  107. <indexterm zone="ch-system-gzip zcmp"><primary sortas="b-zcmp">zcmp</primary></indexterm>
  108. </listitem>
  109. </varlistentry>
  110. <varlistentry id="zdiff">
  111. <term><command>zdiff</command></term>
  112. <listitem>
  113. <para>Runs <command>diff</command> on gzipped files</para>
  114. <indexterm zone="ch-system-gzip zdiff"><primary sortas="b-zdiff">zdiff</primary></indexterm>
  115. </listitem>
  116. </varlistentry>
  117. <varlistentry id="zegrep">
  118. <term><command>zegrep</command></term>
  119. <listitem>
  120. <para>Runs <command>egrep</command> on gzipped files</para>
  121. <indexterm zone="ch-system-gzip zegrep"><primary sortas="b-zegrep">zegrep</primary></indexterm>
  122. </listitem>
  123. </varlistentry>
  124. <varlistentry id="zfgrep">
  125. <term><command>zfgrep</command></term>
  126. <listitem>
  127. <para>Runs <command>fgrep</command> on gzipped files</para>
  128. <indexterm zone="ch-system-gzip zfgrep"><primary sortas="b-zfgrep">zfgrep</primary></indexterm>
  129. </listitem>
  130. </varlistentry>
  131. <varlistentry id="zforce">
  132. <term><command>zforce</command></term>
  133. <listitem>
  134. <para>Forces a <filename class="extension">.gz</filename> extension on all given files
  135. that are gzipped files, so that <command>gzip</command> will not compress them again; this can be
  136. useful when file names were truncated during a file transfer</para>
  137. <indexterm zone="ch-system-gzip zforce"><primary sortas="b-zforce">zforce</primary></indexterm>
  138. </listitem>
  139. </varlistentry>
  140. <varlistentry id="zgrep">
  141. <term><command>zgrep</command></term>
  142. <listitem>
  143. <para>Runs <command>grep</command> on gzipped files</para>
  144. <indexterm zone="ch-system-gzip zgrep"><primary sortas="b-zgrep">zgrep</primary></indexterm>
  145. </listitem>
  146. </varlistentry>
  147. <varlistentry id="zless">
  148. <term><command>zless</command></term>
  149. <listitem>
  150. <para>Runs <command>less</command> on gzipped files</para>
  151. <indexterm zone="ch-system-gzip zless"><primary sortas="b-zless">zless</primary></indexterm>
  152. </listitem>
  153. </varlistentry>
  154. <varlistentry id="zmore">
  155. <term><command>zmore</command></term>
  156. <listitem>
  157. <para>Runs <command>more</command> on gzipped files</para>
  158. <indexterm zone="ch-system-gzip zmore"><primary sortas="b-zmore">zmore</primary></indexterm>
  159. </listitem>
  160. </varlistentry>
  161. <varlistentry id="znew">
  162. <term><command>znew</command></term>
  163. <listitem>
  164. <para>Re-compresses files from <command>compress</command> format to
  165. <command>gzip</command> format&mdash;<filename class="extension">.Z</filename>
  166. to <filename class="extension">.gz</filename></para>
  167. <indexterm zone="ch-system-gzip znew"><primary sortas="b-znew">znew</primary></indexterm>
  168. </listitem>
  169. </varlistentry>
  170. </variablelist>
  171. </sect2>
  172. </sect1>