source: general/sysutils/unzip.xml@ c1ed818

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

<!ENTITY unzip-download-http "http://www.mirrorservice.org/sites/ftp.info-zip.org/pub/infozip/src/unzip551.tar.gz">
<!ENTITY unzip-download-ftp "ftp://ftp.info-zip.org/pub/infozip/src/unzip551.tar.gz">
<!ENTITY unzip-size "1.1 MB">
<!ENTITY unzip-buildsize "6.5 MB">
<!ENTITY unzip-time "0.11 SBU">
]>

<sect1 id="unzip" xreflabel="UnZip-&unzip-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="unzip.html"?>
<title>UnZip-&unzip-version;</title>

<sect2>
<title>Introduction to <application>UnZip</application></title>

<para>The <application>UnZip</application> package contains 
<filename>ZIP</filename> extraction utilities. These are useful for extracting 
files from <filename>ZIP</filename> archives. <filename>ZIP</filename> archives 
are created with <application>PKZIP</application> or 
<application>Info-ZIP</application> utilities primarily in a 
<acronym>DOS</acronym> environment.
</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
url="&unzip-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink
url="&unzip-download-ftp;"/></para></listitem>
<listitem><para>Download size: &unzip-size;</para></listitem>
<listitem><para>Estimated Disk space required:
&unzip-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&unzip-time;</para></listitem></itemizedlist>
</sect3>

<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch: <ulink 
url="&patch-root;/unzip-&unzip-version;-fix_Makefile-1.patch"/></para>
</listitem>
<listitem><para>Required Patch: <ulink
url="&patch-root;/unzip-&unzip-version;-fix_libz-1.patch"/></para>
</listitem>
<listitem><para>Recommended Patch: <ulink
url="&patch-root;/unzip-&unzip-version;-dont_make_noise-1.patch"/></para>
</listitem></itemizedlist>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>UnZip</application></title>

<para>Install <application>UnZip</application> by running the following
commands:</para>

<screen><userinput><command>patch -Np1 -i ../unzip-&unzip-version;-fix_Makefile-1.patch &amp;&amp;
patch -Np1 -i ../unzip-&unzip-version;-fix_libz-1.patch &amp;&amp;
patch -Np1 -i ../unzip-&unzip-version;-dont_make_noise-1.patch &amp;&amp;
cp unix/Makefile . &amp;&amp;
make prefix=/usr LOCAL_UNZIP=-DUSE_UNSHRINK linux &amp;&amp;
make prefix=/usr LOCAL_UNZIP=-DUSE_UNSHRINK linux_shlibz &amp;&amp;
make prefix=/usr LOCAL_UNZIP=-DUSE_UNSHRINK install &amp;&amp;
cp -d libunzip.so* /usr/lib</command></userinput></screen>

</sect2>

<sect2>
<title>Command explanations</title>

<para><command>make prefix=/usr LOCAL_UNZIP=-DUSE_UNSHRINK linux</command>:
This command overrides the <varname>prefix</varname> variable that is
set to <filename class="directory">/usr/local</filename> in the
<filename>Makefile</filename>, sets the <envar>LOCAL_UNZIP</envar>
environment variable to instruct <application>UnZip</application> to use
the shrinking algorithm based on the <acronym>LZW</acronym> compression
algorithm, and builds the executables for a Linux system.
The alternatives to 'linux' can be seen with a
<command>make list</command> command.</para>

<para><command>make ... linux_shlibz</command>: Build shared
<filename>libunzip</filename> and link <application>UnZip</application> against 
it and <application>zlib</application>.</para>

</sect2>

<sect2>
<title>Contents</title>

<para>The <application>UnZip</application> package contains 
<command>unzip</command>, <command>funzip</command>, <command>unzipfsx</command>,
<command>zipgrep</command>, <command>zipinfo</command> and the 
<filename class="libraryfile">libunzip</filename> library.</para>

</sect2>

<sect2><title>Description</title>

<sect3><title>unzip</title>
<para><command>unzip</command> lists, tests or extracts files from a
<filename>ZIP</filename> archive.</para></sect3>

<sect3><title>funzip</title>
<para><command>funzip</command> allows the output of <command>unzip</command>
commands to be redirected.</para></sect3>

<sect3><title>unzipfsx</title>
<para><command>unzipfsx</command> is the self-extracting stub that can be
prepended to a <filename>ZIP</filename> archive.  Files in this format allow
the recipient to decompress the archive without installing
<application>UnZip</application>.</para></sect3>

<sect3><title>zipgrep</title>
<para><command>zipgrep</command> is a grep for <filename>ZIP</filename>
archives.</para></sect3>

<sect3><title>zipinfo</title>
<para><command>zipinfo</command> produces technical information about the files 
in a <filename>ZIP</filename> archive, including file access permissions,
encryption status, type of compression, etc.</para></sect3>

</sect2>

</sect1>