lfs-book/chapter06/gzip.xml

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>

<sect1 id="ch-system-gzip" role="wrap">
  <?dbhtml filename="gzip.html"?>

  <sect1info condition="script">
    <productname>gzip</productname>
    <productnumber>&gzip-version;</productnumber>
    <address>&gzip-url;</address>
  </sect1info>

  <title>Gzip-&gzip-version;</title>

  <indexterm zone="ch-system-gzip">
    <primary sortas="a-Gzip">Gzip</primary>
  </indexterm>

  <sect2 role="package">
    <title/>

    <para>The Gzip package contains programs for compressing and decompressing
    files.</para>

    <segmentedlist>
      <segtitle>&buildtime;</segtitle>
      <segtitle>&diskspace;</segtitle>

      <seglistitem>
        <seg>&gzip-ch6-sbu;</seg>
        <seg>&gzip-ch6-du;</seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

  <sect2 role="installation">
    <title>Installation of Gzip</title>

    <para>The version of the function <quote>futimens</quote> used
    by Gzip is incompatible with the version that current
    Glibc provides, so we'll rename the function:</para>

<screen><userinput remap="pre">sed -i 's/futimens/gl_&amp;/' gzip.c lib/utimens.{c,h}</userinput></screen>

    <para>There is also a bug in the <filename>zdiff</filename> script that
    needs to be fixed:</para>

<screen><userinput remap="pre">sed -i 's/5 -)/5 - >\&amp;3)/' zdiff.in</userinput></screen>

    <para>Prepare Gzip for compilation:</para>

<screen><userinput remap="configure">./configure --prefix=/usr --bindir=/bin</userinput></screen>

    <para>Compile the package:</para>

<screen><userinput remap="make">make</userinput></screen>

    <para>To test the results, issue:</para>

<screen><userinput remap="test">make check</userinput></screen>

    <para>Install the package:</para>

<screen><userinput remap="install">make install</userinput></screen>

    <para>Move some programs that do not need to be on the root filesystem:</para>

<screen><userinput remap="install">mv -v /bin/{gzexe,uncompress,zcmp,zdiff,zegrep} /usr/bin
mv -v /bin/{zfgrep,zforce,zgrep,zless,zmore,znew} /usr/bin</userinput></screen>

  </sect2>

  <sect2 id="contents-gzip" role="content">
    <title>Contents of Gzip</title>

    <segmentedlist>
      <segtitle>Installed programs</segtitle>

      <seglistitem>
        <seg>gunzip, gzexe, gzip, uncompress, zcat, zcmp, zdiff, zegrep, zfgrep,
        zforce, zgrep, zless, zmore, and znew</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="gunzip">
        <term><command>gunzip</command></term>
        <listitem>
          <para>Decompresses gzipped files</para>
          <indexterm zone="ch-system-gzip gunzip">
            <primary sortas="b-gunzip">gunzip</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gzexe">
        <term><command>gzexe</command></term>
        <listitem>
          <para>Creates self-decompressing executable files</para>
          <indexterm zone="ch-system-gzip gzexe">
            <primary sortas="b-gzexe">gzexe</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gzip">
        <term><command>gzip</command></term>
        <listitem>
          <para>Compresses the given files using Lempel-Ziv (LZ77) coding</para>
          <indexterm zone="ch-system-gzip gzip">
            <primary sortas="b-gzip">gzip</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="uncompress">
        <term><command>uncompress</command></term>
        <listitem>
          <para>Decompresses compressed files</para>
          <indexterm zone="ch-system-gzip uncompress">
            <primary sortas="b-uncompress">uncompress</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="zcat">
        <term><command>zcat</command></term>
        <listitem>
          <para>Decompresses the given gzipped files to standard output</para>
          <indexterm zone="ch-system-gzip zcat">
            <primary sortas="b-zcat">zcat</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="zcmp">
        <term><command>zcmp</command></term>
        <listitem>
          <para>Runs <command>cmp</command> on gzipped files</para>
          <indexterm zone="ch-system-gzip zcmp">
            <primary sortas="b-zcmp">zcmp</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="zdiff">
        <term><command>zdiff</command></term>
        <listitem>
          <para>Runs <command>diff</command> on gzipped files</para>
          <indexterm zone="ch-system-gzip zdiff">
            <primary sortas="b-zdiff">zdiff</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="zegrep">
        <term><command>zegrep</command></term>
        <listitem>
          <para>Runs <command>egrep</command> on gzipped files</para>
          <indexterm zone="ch-system-gzip zegrep">
            <primary sortas="b-zegrep">zegrep</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="zfgrep">
        <term><command>zfgrep</command></term>
        <listitem>
          <para>Runs <command>fgrep</command> on gzipped files</para>
          <indexterm zone="ch-system-gzip zfgrep">
            <primary sortas="b-zfgrep">zfgrep</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="zforce">
        <term><command>zforce</command></term>
        <listitem>
          <para>Forces a <filename class="extension">.gz</filename> extension on
          all given files that are gzipped files, so that <command>gzip</command>
          will not compress them again; this can be useful when file names were
          truncated during a file transfer</para>
          <indexterm zone="ch-system-gzip zforce">
            <primary sortas="b-zforce">zforce</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="zgrep">
        <term><command>zgrep</command></term>
        <listitem>
          <para>Runs <command>grep</command> on gzipped files</para>
          <indexterm zone="ch-system-gzip zgrep">
            <primary sortas="b-zgrep">zgrep</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="zless">
        <term><command>zless</command></term>
        <listitem>
          <para>Runs <command>less</command> on gzipped files</para>
          <indexterm zone="ch-system-gzip zless">
            <primary sortas="b-zless">zless</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="zmore">
        <term><command>zmore</command></term>
        <listitem>
          <para>Runs <command>more</command> on gzipped files</para>
          <indexterm zone="ch-system-gzip zmore">
            <primary sortas="b-zmore">zmore</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="znew">
        <term><command>znew</command></term>
        <listitem>
          <para>Re-compresses files from <command>compress</command> format to
          <command>gzip</command> format&mdash;<filename
          class="extension">.Z</filename> to <filename
          class="extension">.gz</filename></para>
          <indexterm zone="ch-system-gzip znew">
            <primary sortas="b-znew">znew</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>