view release on metacpan or  search on metacpan

unzip-6.0/man/unzip.1  view on Meta::CPAN

compressed size and compression ratio figures are independent of the entry's
encryption status and show the correct compression performance.  (The complete
size of the encrypted compressed data stream for zipfile entries is reported
by the more verbose \fIzipinfo\fP(1L) reports, see the separate manual.)
When no zipfile is specified (that is, the complete command is simply
``\fCunzip \-v\fR''), a diagnostic screen is printed.  In addition to
the normal header with release date and version, \fIunzip\fP lists the
home Info-ZIP ftp site and where to find a list of other ftp and non-ftp
sites; the target operating system for which it was compiled, as well
as (possibly) the hardware on which it was compiled, the compiler and
version used, and the compilation date; any special compilation options
that might affect the program's operation (see also \fBDECRYPTION\fP below);
and any options stored in environment variables that might do the same
(see \fBENVIRONMENT OPTIONS\fP below).  As a modifier it works in
conjunction with other options (e.g., \fB\-t\fP) to produce more
verbose or debugging output; this is not yet fully implemented
but will be in future releases.
.TP
.B \-z
display only the archive comment.
.PD
.\" =========================================================================
.SH MODIFIERS
.TP
.B \-a
convert text files.  Ordinarily all files are extracted exactly as they
are stored (as ``binary'' files).  The \fB\-a\fP option causes files identified
by \fIzip\fP as text files (those with the `t' label in \fIzipinfo\fP
listings, rather than `b') to be automatically extracted as such, converting
line endings, end-of-file characters and the character set itself as necessary.
(For example, Unix files use line feeds (LFs) for end-of-line (EOL) and
have no end-of-file (EOF) marker; Macintoshes use carriage returns (CRs)
for EOLs; and most PC operating systems use CR+LF for EOLs and control-Z for
EOF.  In addition, IBM mainframes and the Michigan Terminal System use EBCDIC
rather than the more common ASCII character set, and NT supports Unicode.)
Note that \fIzip\fP's identification of text files is by no means perfect; some
``text'' files may actually be binary and vice versa.  \fIunzip\fP therefore
prints ``\fC[text]\fR'' or ``\fC[binary]\fR'' as a visual check for each file
it extracts when using the \fB\-a\fP option.  The \fB\-aa\fP option forces
all files to be extracted as text, regardless of the supposed file type.
On VMS, see also \fB\-S\fP.
.TP
.B \-b
[general] treat all files as binary (no text conversions).  This is a shortcut
for \fB\-\-\-a\fP.
.TP
.B \-b
[Tandem] force the creation files with filecode type 180 ('C') when
extracting Zip entries marked as "text". (On Tandem, \fB\-a\fP is enabled
by default, see above).
.TP
.B \-b
[VMS] auto-convert binary files (see \fB\-a\fP above) to fixed-length,
512-byte record format.  Doubling the option (\fB\-bb\fP) forces all files
to be extracted in this format. When extracting to standard output
(\fB\-c\fP or \fB\-p\fP option in effect), the default conversion of text
record delimiters is disabled for binary (\fB\-b\fP) resp. all (\fB\-bb\fP)
files.
.TP
.B \-B
[when compiled with UNIXBACKUP defined] save a backup copy of each
overwritten file. The backup file is gets the name of the target file with
a tilde and optionally a unique sequence number (up to 5 digits) appended.
The sequence number is applied whenever another file with the original name
plus tilde already exists.  When used together with the "overwrite all"
option \fB\-o\fP, numbered backup files are never created. In this case,
all backup files are named as the original file with an appended tilde,
existing backup files are deleted without notice.
This feature works similarly to the default behavior of \fIemacs\fP(1)
in many locations.
.IP
Example: the old copy of ``\fCfoo\fR'' is renamed to ``\fCfoo~\fR''.
.IP
Warning: Users should be aware that the \fB-B\fP option does not prevent
loss of existing data under all circumstances.  For example, when
\fIunzip\fP is run in overwrite-all mode, an existing ``\fCfoo~\fR'' file
is deleted before \fIunzip\fP attempts to rename ``\fCfoo\fR'' to
``\fCfoo~\fR''.  When this rename attempt fails (because of a file locks,
insufficient privileges, or ...), the extraction of ``\fCfoo~\fR'' gets
cancelled, but the old backup file is already lost.  A similar scenario
takes place when the sequence number range for numbered backup files gets
exhausted (99999, or 65535 for 16-bit systems).  In this case, the backup
file with the maximum sequence number is deleted and replaced by the new
backup version without notice.
.TP
.B \-C
use case-insensitive matching for the selection of archive entries
from the command-line list of extract selection patterns.
\fIunzip\fP's philosophy is ``you get what you ask for'' (this is
also responsible for the \fB\-L\fP/\fB\-U\fP change; see the relevant
options below).  Because some file systems are fully case-sensitive
(notably those under the Unix operating system) and because
both ZIP archives and \fIunzip\fP itself are portable across platforms,
\fIunzip\fP's default behavior is to match both wildcard and literal
filenames case-sensitively.  That is, specifying ``\fCmakefile\fR''
on the command line will \fIonly\fP match ``makefile'' in the archive,
not ``Makefile'' or ``MAKEFILE'' (and similarly for wildcard specifications).
Since this does not correspond to the behavior of many other
operating/file systems (for example, OS/2 HPFS, which preserves
mixed case but is not sensitive to it), the \fB\-C\fP option may be
used to force all filename matches to be case-insensitive.  In the
example above, all three files would then match ``\fCmakefile\fR''
(or ``\fCmake*\fR'', or similar).  The \fB\-C\fP option affects
file specs in both the normal file list and the excluded-file list (xlist).
.IP
Please note that the \fB\-C\fP option does neither affect the search for
the zipfile(s) nor the matching of archive entries to existing files on
the extraction path.  On a case-sensitive file system, \fIunzip\fP will
never try to overwrite a file ``FOO'' when extracting an entry ``foo''!
.TP
.B \-D
skip restoration of timestamps for extracted items.  Normally, \fIunzip\fP
tries to restore all meta-information for extracted items that are supplied
in the Zip archive (and do not require privileges or impose a security risk).
By specifying \fB\-D\fP, \fIunzip\fP is told to suppress restoration of
timestamps for directories explicitly created from Zip archive entries.
This option only applies to ports that support setting timestamps for
directories (currently ATheOS, BeOS, MacOS, OS/2, Unix, VMS, Win32, for other
\fIunzip\fP ports, \fB\-D\fP has no effect).
The duplicated option \fB\-DD\fP forces suppression of timestamp restoration
for all extracted entries (files and directories).  This option results in
setting the timestamps for all extracted entries to the current time.
.IP
On VMS, the default setting for this option is \fB\-D\fP for consistency
with the behaviour of BACKUP: file timestamps are restored, timestamps of
extracted directories are left at the current time.  To enable restoration
of directory timestamps, the negated option \fB\--D\fP should be specified.
On VMS, the option \fB\-D\fP disables timestamp restoration for all extracted
Zip archive items.  (Here, a single \fB\-D\fP on the command line combines
with the default \fB\-D\fP to do what an explicit \fB\-DD\fP does on other
systems.)
.TP
.B \-E
[MacOS only] display contents of MacOS extra field during restore operation.
.TP
.B \-F
[Acorn only] suppress removal of NFS filetype extension from stored filenames.
.TP
.B \-F
[non-Acorn systems supporting long filenames with embedded commas,
and only if compiled with ACORN_FTYPE_NFS defined] translate
filetype information from ACORN RISC OS extra field blocks into a
NFS filetype extension and append it to the names of the extracted files.
(When the stored filename appears to already have an appended NFS filetype