GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  UNZIP (1)

NAME

unzip - extract files from a ZIP archive

CONTENTS

Synopsis
Description
Environment
Compatibility
See Also
History
Authors

SYNOPSIS

unzip [-aCcfjLlnopqtuv] [-d dir] zipfile

DESCRIPTION

The following options are available:
-a When extracting a text file, convert DOS-style line endings to Unix-style line endings.
-C Match file names case-insensitively.
-c Extract to stdout/screen. When extracting files from the zipfile, they are written to stdout. This is similar to -p , but does not suppress normal output.
-d dir Extract files into the specified directory rather than the current directory.
-f Update existing. Extract only files from the zipfile if a file with the same name already exists on disk and is older than the former. Otherwise, the file is silently skipped.
-j Ignore directories stored in the zipfile; instead, extract all files directly into the extraction directory.
-L Convert the names of the extracted files and directories to lowercase.
-l List, rather than extract, the contents of the zipfile.
-n No overwrite. When extracting a file from the zipfile, if a file with the same name already exists on disk, the file is silently skipped.
-o Overwrite. When extracting a file from the zipfile, if a file with the same name already exists on disk, the existing file is replaced with the file from the zipfile.
-p Extract to stdout. When extracting files from the zipfile, they are written to stdout. The normal output is suppressed as if -q was specified.
-q Quiet: print less information while extracting.
-t Test: do not extract anything, but verify the checksum of every file in the archive.
-u Update. When extracting a file from the zipfile, if a file with the same name already exists on disk, the existing file is replaced with the file from the zipfile if and only if the latter is newer than the former. Otherwise, the file is silently skipped.
-v List verbosely, rather than extract, the contents of the zipfile. This differs from -l by using the long listing. Note that most of the data is currently fake and does not reflect the content of the archive.
-x pattern
  Exclude files matching the pattern pattern.
-Z mode
  Emulate zipinfo(1L) mode. Enabling zipinfo(1L) mode changes the way in which additional arguments are parsed. Currently only zipinfo(1L) mode 1 is supported, which lists the file names one per line.

Note that only one of -n , -o , and -u may be specified. If specified filename is "-", then data is read from stdin.

ENVIRONMENT

If the UNZIP_DEBUG environment variable is defined, the -q command-line option has no effect, and additional debugging information will be printed to stderr.

COMPATIBILITY

The unzip utility aims to be sufficiently compatible with other implementations to serve as a drop-in replacement in the context of the ports(7) system. No attempt has been made to replicate functionality which is not required for that purpose.

For compatibility reasons, command-line options will be recognized if they are listed not only before but also after the name of the zipfile.

Normally, the -a option should only affect files which are marked as text files in the zipfile’s central directory. Since the archive(3) library reads zipfiles sequentially, and does not use the central directory, that information is not available to the unzip utility. Instead, the unzip utility will assume that a file is a text file if no non-ASCII characters are present within the first block of data decompressed for that file. If non-ASCII characters appear in subsequent blocks of data, a warning will be issued.

The unzip utility is only able to process ZIP archives handled by libarchive(3). Depending on the installed version of libarchive, this may or may not include self-extracting archives.

SEE ALSO

libarchive(3)

HISTORY

The unzip utility appeared in
.Fx 8.0 .

AUTHORS

The unzip utility and this manual page were written by
.An Dag-Erling Sm\(/orgrav Aq des@FreeBSD.org . It uses the archive(3) library developed by
.An Tim Kientzle Aq kientzle@FreeBSD.org .
Search for    or go to Top of page |  Section 1 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.