.TH unzip "" "" "Command"
.PC "Un-zip a zipped archive"
\fBunzip \fIarchive \fB[\-cfpux \fIfile ...\^\fB] [\-ltvz] [\-anojqUV]\fR
.PP
.HS
.SH Options
.IC "\fB\-c [\fIfile ...\^\fB]\fR"
Extract files, write them to the standard output
.IC "\fB\-f [\fIfile ...\^\fB]\fR"
Update existing files from the archive; do not create new files
.IC \fB\-l\fR
List the contents of the archive, short format
.IC "\fB\-p [\fIfile ... \fB| \fIcommand\^\fB]\fR"
Extract to pipe, no messages
.IC \fB\-t\fR
Test archive integrity
.IC "\fB\-u [\fIfile ...\^\fB]\fR\fR"
Update files, create if necessary
.IC \fB\-v\fR
List files (verbose format)
.IC "\fB\-x [\fIfile ...\^\fB]\fR"
Extract files (default)
.IC \fB\-z\fR
Display archive's comment
.SH Modifiers
.IC \fB\-a\fR
Convert text from \*(MD format to \*(UU format
.IC \fB\-j\fR
Ignore (``junk'') paths; do not make directories
.IC \fB\-n\fR
Never overwrite existing files
.IC \fB\-o\fR
Overwrite files without prompting
.IC \fB\-q\fR
Quiet mode
.IC \fB\-qq\fR
Quieter mode      
.IC \fB\-U\fR
Do not convert file names to lower-case letters
.HE
The command
.B unzip
extracts files from a zipped archive.
It recognizes the following command-line options:
.IP "\fB\-c [\fIfile ...\^\fB]\fR"
Extract
.IR file ,
but write them to the standard output instead of to disk.
.IP "\fB\-f [\fIfile ...\^\fB]\fR"
``Freshen'' files:
Extract
.I file
from
.I archive
and write it to disk, but
do so only if the file in the archive is newer than the file on disk.
Do not create new files.
.IP \fB\-l\fR
List the contents of the archive, short format.
.IP "\fB\-p [\fIfile ...\fB| \fIcommand\^\fB]\fR\fR"
Extract each
.I file
and pipe it to
.IR command .
.IP \fB\-t\fR
Test the integrity of
.IR archive .
.IP "\fB\-u [\fIfile ...\^\fB]\fR\fR"
Update each
.I file
within the archive.
Create the file if necessary.
.IP \fB\-v\fR
List files, verbose format.
.IP "\fB\-x [\fIfile ...\^\fB]\fR"
Extract each
.I file
from default.
If no
.I file
argument is given, extract all files.
This is the default.
.IP \fB\-z\fR
Display archive's comments, if any.
.PP
The following modify the behavior of the options:
.IP \fB\-a\fR
Convert text from \*(MD format to \*(UU format.
.IP \fB\-j\fR
Ignore (``junk'') paths; do not make directories.
.IP \fB\-n\fR
Never overwrite existing files.
.IP \fB\-o\fR
Overwrite files without prompting.
.IP \fB\-q\fR
Quiet mode.
.IP \fB\-qq\fR
Quieter mode.
.IP \fB\-U\fR
Do not convert file names to lower-case letters.
.PP
The following example extracts file
.B ReadMe
from archive
.BR data1 :
.DM
	unzip data1 ReadMe
.DE
.PP
The next example extracts all files from archive
.B foo.zip
and pipes them to the pager
.BR more :
.DM
	unzip -p foo | more
.DE
.PP
The final example ``freshens'' files on disk from the contents of
.BR foo.zip .
Files are overwritten without prompting:
.DM
	unzip -fo foo
.DE
.SH Notes
.Xr "commands," commands
.Xr "compress," compress
.Xr "gunzip," gunzip
.Xr "gzip," gzip
.Xr "uncompress," uncompres
.Xr "zip" zip
.SH Notes
Do not confuse this command with
.BR gunzip .
Archives made by
.B gzip
may not be extractable by
.BR unzip .
