unzip_cli.help

zip压缩

/PASSWORD

/PASSWORD=decryption-password

Specifies a decryption password and prevents UnZip from prompting for
a password in case the specified decryption key was wrong. The supplied
string must be enclosed in double-quotes whenever it contains lowercase
or special characters.
<QUALIFIER>
/PIPE

/PIPE

Extract files to SYS$OUTPUT with no informational messages.
<QUALIFIER>
/QUIET

/QUIET[=SUPER]

Perform operations quietly.  The keyword SUPER can be specified to make
operations even more quiet.
<QUALIFIER>
/RESTORE

/RESTORE
<NEXT>
/NORESTORE

Restore file owner and protection settings.
<QUALIFIER>
/SCREEN

/SCREEN
<NEXT>
/NOSCREEN

Extracts matching files to SYS$OUTPUT (the terminal).
<QUALIFIER>
/TEST

/TEST
<NEXT>
/NOTEST

Test archive files.
<QUALIFIER>
/TEXT

/TEXT[=KEYWORD]
<NEXT>
/NOTEXT (default)

Selects conversion to VMS standard text file format.
The optional keywords recognized are:
<LITERAL>
|  AUTO     Automatically extracts files marked as "text" (rather
|           than "binary") in standard VMS text file format. (default)
|  ALL      Extracts all files in standard VMS text file format.
|  NONE     Same as /NOTEXT.
<LARETIL>

A similar functionality is available for binary files, see qualifier /BINARY.
<QUALIFIER>
/TRAVERSE_DIRS

/TRAVERSE_DIRS
<NEXT>
/NOTRAVERSE_DIRS (default)

Allows to extract archive members into locations outside of the currently
active "extraction root dir".  For security reasons, UnZip normally
removes "parent dir" path components ("../") from the names of extracted
files.  This feature (new for UnZip 5.50) prevents UnZip from accidentally
writing files to "sensitive" areas outside the directory tree below the
specified "extraction root".  By specifying the /TRAVERSE_DIRS option,
this security feature can be switched off. This allows users to extract
(older) archives that made use of "../" to create multiple directory
trees at the level of the current extraction folder.
<QUALIFIER>
/UPDATE

/UPDATE
<NEXT>
/NOUPDATE

Update existing files; create new ones if needed.
<QUALIFIER>
/VERSION

/VERSION
<NEXT>
/NOVERSION (default)

Retain VMS file version numbers.

<TOPIC>
Authors

Info-ZIP; currently maintained by Greg Roelofs.  VMS support maintained
by Igor Mandrichenko, Christian Spieler and Hunter Goatley.  Originally
based on a program by Samuel H. Smith.

VMS on-line help ported from UNZIP.TXT by Hunter Goatley.

<TOPIC>
Exit_Codes

On VMS, UnZip's UNIX style exit values are mapped into proper
VMS status codes:
<LITERAL>
|   1                               (success)  normal exit,
|   (0x7fff0000 + 16*UnZip_errnum)  -W- warnings
|   (0x7fff0002 + 16*UnZip_errnum)  -E- normal errors
|   (0x7fff0004 + 16*UnZip_errnum)  -F- fatal errors
<LARETIL>

The UnZip error level (or exit code) approximates the exit
codes defined by PKWARE and takes on the following values:
<LITERAL>
|  VMS       UnZip    Type of error
|  severity  errcode
|    -         0      normal; no errors or warnings detected.
|
|    W         1      one or more warning errors were encountered,
|                     but processing completed  successfully  any-
|                     way.   This  includes  zipfiles where one or
|                     more files was skipped  due  to  unsupported
|                     compression  method  or  encryption  with an
|                     unknown password.
|
|    E         2      a generic error in the  zipfile  format  was
|                     detected.   Processing  may  have  completed
|                     successfully anyway;  some  broken  zipfiles
|                     created by other archivers have simple work-
|                     arounds.
|
|    F         3      a severe error in  the  zipfile  format  was
|                     detected.   Processing probably failed imme-
|                     diately.
|
|    F         4      unzip was unable to allocate memory for  one
|                     or  more  buffers during program initializa-
|                     tion.
|
|    F         5      unzip  was  unable  to  allocate  memory  or
|                     unable  to  obtain a tty to read the decryp-
|                     tion password(s).
|
|    F         6      unzip was unable to allocate  memory  during
|                     decompression to disk.
|
|    F         7      unzip  was  unable to allocate memory during
|                     in-memory decompression.
|
|    F         8      [currently not used]
|
|    E         9      the specified zipfiles were not found.
|
|    E         10     invalid options were specified on  the  com-
|                     mand line.
|
|    E         11     no matching files were found.
|
|    F         50     the disk is (or was) full during extraction.
|
|    F         51     the end of the ZIP archive  was  encountered
|                     prematurely.
|
|    E         80     the user aborted unzip prematurely with con-
|                     trol-C (or similar)
|
|    E         81     no files were found due to unsupported  com-
|                     pression  methods or unsupported decryption.
|                     (If even one additional file is successfully
|                     processed, however, the exit status is 1.)
|
|    E         82     no  files  were  found due to bad decryption
|                     password(s).  This is also the  exit  status
|                     if  no files were found due to a combination
|                     of unsupported  compression  and  bad  pass-
|                     words.   As in the previous case, however, a
|                     single successful file  will  result  in  an
|                     exit status of 1 instead.)
<LARETIL>

In addition, there is a compilation option to expand upon this behavior:
An executable compiled with the option RETURN_CODES defined displays
a human-readable explanation of what the error status means.

<TOPIC>
UNIX_Options

The default action of UnZip is to extract all zipfile entries.  The following
options and modifiers can be provided:

<LITERAL>
|  -Z   ZipInfo mode
|  -c   extract files to SYS$OUTPUT (terminal)
|  -f   freshen existing files (replace if newer); create none
|  -h   show brief help screen and exit quietly
|  -l   list archive files (short format)
|  -p   extract files to SYS$OUTPUT; no informational messages
|  -t   test archive files
|  -u   update existing files; create new ones if needed
|  -v   list archive files (verbose format)
|  -z   display only the archive comment
|
|MODIFIERS
|  -a   auto-extract only text files in standard VMS text file format
|  -aa  extract all files as text
|  -b   auto-extract only binary files in VMS fixed 512 bytes records
|  -bb  extract all files as binary VMS fixed 512 byte record files
|  -j   junk paths (don't recreate archive's directory structure)
|  -n   never overwrite existing files; don't prompt
|  -o   OK to overwrite files without prompting
|  -q   perform operations quietly (-qq => even quieter)
|  -C   match filenames case-insensitively
|  -L   convert filenames to lowercase if created on MSDOS, VMS, etc.
|  -P<pwd>  supply decryption password on the command line (insecure!)
|  -M   page output through built-in "more" function
|  -V   retain (VMS) file version numbers
|  -X   restore owner/protection info (may require privileges)
|  -:   allow "../" path components that traverse across extract dir root
<LARETIL>

Note that uppercase options such as -C, -L, -M, -P, -V, -X and -Z must
be specified in quotes.  For example:

<LITERAL>
|  $ unzip "-VX" -a zipfile
<LARETIL>

<TOPIC>
UNZIP_OPTS_Default

UnZip allows to modify its default behaviour by specifying (UNIX style)
option defaults via the UNZIP_OPTS logical name.
For example, the following will cause UnZip to match filenames without regard
to case, restore owner/protection information and perform all operations at
quiet-level 1 by default:

<LITERAL>
|  $ define UNZIP_OPTS "-qCX"
<LARETIL>

Note that the quotation marks here are required to preserve lowercase options
(opposite of the command-line behavior). To negate a default option on the
command line, add one or more minus  signs before the option letter, in
addition to the leading switch character `-':

<LITERAL>
|  $ unzip --ql zipfile
<LARETIL>

or

<LITERAL>
|  $ unzip -l-q zipfile
<LARETIL>

At present it is not possible to decrement an option below zero--that is,
more than a few minuses have no effect.

UNZIP_OPTS may be defined as a symbol rather than a logical, but if both
are defined, the logical is used.