zip_cli.help

给出了 zip 压缩算法的完整实现过程。

/MOVE

Move the specified files into the Zip archive.
Entries which have been added (or freshened) to the zip file get removed from
the file system. If a directory is empty afterwards, it is also removed.
<QUALIFIER>
/MUST_MATCH

/MUST_MATCH

Input files must exist (and wildcards must match existing files).  By
default, missing files and unmatched wildcards generate a warning when
Zip finishes work on the files which do exist.  With /MUST_MATCH, Zip
exits immediately with an error status if an input file is not found, or
if an input file wildcard is not matched.
<QUALIFIER>
/PKZIP

/PKZIP
/NOPKZIP (default)

Create PKZIP compatible archive entries.
The file names are truncated and converted to upper case to match the
MSDOS 8+3 file name syntax. Only the MSDOS compatible attributes are stored;
the file owner's write permission is mapped to the "readonly" attribute.
The archive entry is marked as being made under MSDOS regardless of the true
host system of Zip.
<QUALIFIER>
/QUIET

/QUIET

Perform operations quietly.
<QUALIFIER>
/RECURSE

/RECURSE[=KEYWORD]
/NORECURSE (default)

Directs Zip to recurse into subdirectories.
The optional keywords recognized are:
<LITERAL>
|  PATH      take patterns as full path specifiers (-r) (default)
|  FILENAMES start from current dir;
|            only use filename part of file patterns (-R)
<LARETIL>
The new FILENAMES optional keyword modifies the recursion algorithm to
be (almost) compatible to PKZIP's behaviour on subdirectory recursion.

On VMS, this behaviour can be alternatively archived by using
the "subdirectory recursing wildcard" [...] in the "include files" parameter
list.
<QUALIFIER>
/SINCE

/SINCE=(VMS time specification)

Only handle files that are newer than the specified date and time.
The specified time is compared with the files' RMS creation time.
<QUALIFIER>
/STORETYPES

/STORETYPES=(.ext1,.ext2,... )

For files with the specified extensions, Zip does not try to compress the
data but stores them verbatim.  This speeds up operation on files that
have already been compressed and where a second compression step usually
does not gain much space.
The default list of extensions where compression is suppressed is
(.Z,.zip,.zoo,.arc,.arj).

But note: when maximum level of compression is requested (/LEVEL=9), the
STORETYPES heuristic is not used. In this case, Zip tries to compress ALL
files.
<QUALIFIER>
/TEMP_PATH

/TEMP_PATH=dirspec

Specifies an alternate directory where Zip creates its temporary files.
When this qualifier is not given, Zip attempts to write to the current
working directory.
<QUALIFIER>
/TEST

/TEST

Test archive integrity.
<QUALIFIER>
/TRANSLATE_EOL

/TRANSLATE_EOL[=KEYWORD]

Selects conversion of the end-of-line markers in text files.
The optional keywords recognized are:
<LITERAL>
|  LF        convert LF -> CRLF (UNIX to DOS) (default)
|  CRLF      convert CRLF -> LF, strip trailing CTRL-Z's (DOS to UNIX)
<LARETIL>

This option should only be used with text files. The second option CRLF
is only useful when a DOS text file has been transfered to a VMS disk
in stream (or stream_lf) format.
<QUALIFIER>
/UNSFX

/UNSFX

Strip any prepended data from the Zip archive, for example a self-extracting
executable stub.
<QUALIFIER>
/UPDATE

/UPDATE

Freshen existing archive entries; create new ones if needed.
<QUALIFIER>
/VERBOSE

/VERBOSE[=NORMAL|MORE|DEBUG]

Switch on verbose messages. This includes diagnostics on discovered
oddities in the zipfile's structure, and a progress indicator during
compression operation.  /VERBOSE with no value is equivalent to /VERBOSE
= NORMAL.  MORE adds more messages, and DEBUG adds still more messages.

When this qualifier is the only command line argument given, it has a special
meaning. In this case a screen of diagnostic information about the program
version is displayed. This display includes the Zip version number and
release date, and it shows some information to determine when and how
the executable was built and set up. This includes info on the used compiler's
name and version, the date of the build (if available), and some optional
compile time feature flags. Additionally, the contents of the environment
variables (=logical names on VMS) that are read by Zip for runtime
configuration are shown.
This information is especially valuable when reporting problems or bugs.

<QUALIFIER>
/VMS

/VMS[=ALL]

Store VMS file attributes in Zip archive.

When the optional keyword ALL is specified, all allocated blocks in a
file are stored in the Zip archive, including data beyond the
End-of-File (EOF) marker.

/VMS provides good fidelity for well-formed files (no data past EOF)
when unpacked on a VMS system.  Also, some types of file (notably
Stream_LF text files) will be unpacked as expected on a non-VMS system.

/VMS=ALL provides good fidelity, even for files with data past EOF, when
unpacked on a VMS system.  However, the data from beyond the EOF marker
will typically cause a file to appear corrupted when unpacked on a
non-VMS system.
<TOPIC>
Authors

Info-ZIP; currently maintained by Onno van der Linden.  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 Zip's MANUAL by Christian Spieler, using
Hunter Goatley's work for UnZip.

<TOPIC>
Exit_Codes

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

The Zip error level (or exit code) approximates the exit
codes defined by PKWARE and takes on the following values:
<LITERAL>
|  VMS       Zip      Type of error
|  severity  errcode
|    -         0      normal; no errors or warnings detected.
|    F         2      unexpected end of zip file.
|    E         3      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         4      zip was unable to allocate memory for one or
|                     more  buffers during program initialization.
|    F         5      a severe error in  the  zipfile  format  was
|                     detected.   Processing probably failed imme-
|                     diately.
|    E         6      entry too large to be split with zipsplit
|    E         7      invalid comment format
|    F         8      zip -T failed, or out of memory
|    E         9      the user aborted zip prematurely  with  con-
|                     trol-C (or similar)
|    F         10     zip  encountered an error while using a temp
|                     file
|    F         11     read or seek error
|    W         12     zip has nothing to do
|    E         13     missing or empty zip file
|    F         14     error writing to a file
|    F         15     zip was unable to create a file for writing
|    E         16     bad command line parameters
|    E         18     zip could not open a specified file to read
<LARETIL>

<TOPIC>
Logical_Names

Zip scans its process environment for the logical name ZIP_OPTS, which
can be used to specify a string of default options to modify Zip's
behaviour. For the syntax, see help topic UNIX_Options.
With the exception of "-i" and "-x", all recognized UNIX style options
can be used within the ZIP_OPTS equivalence string.

For example, the following will cause Zip to skip directories, include
VMS attribute information perform all operations at quiet-level 1 by default:

<LITERAL>
|  $ define ZIP_OPTS "-qDV"
<LARETIL>

Note that the quotation marks here are required to preserve lowercase options
(opposite of the command-line behavior).

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

The alternative logical name ZIPOPT (more UNIX-like naming convention)
is recognized as well. If both ZIPOPT and ZIP_OPTS are present (and do
not equate to whitespace only), the content of ZIPOPT takes precedence
and ZIP_OPTS is ignored.

<TOPIC>
UNIX_Options

The default action of Zip is to add or replace zipfile entries from list, which
can include the special name -@ to read names from SYS$INPUT.  The following
list of options was taken from the on-line help generated when Zip is run
with the -h command-line option:

<LITERAL>
|  -A   adjust self-extracting exe
|  -b   use "path" for temp files
|  -c   add one-line comments
|  -d   delete entries in zipfile
|  -D   do not add directory entries
|  -e   encrypt
|  -f   freshen: only changed files
|  -F   fix zipfile (-FF try harder)
|  -g   allow growing existing zipfile (unless updating or deleting)
|  -h   show this help
|  -i   include only names matching the following patterns
|  -i@  include only names matching the patterns listed in "file"
|  -j   junk (don't record) directory names
|  -J   junk (remove) prepended (SFX) stub
|  -k   simulate PKZIP made zipfile
|  -l   translate end-of-lines (LF -> CRLF)
|  -ll  translate end-of-lines (CRLF -> LF)
|  -L   show software license
|  -m   move into zipfile (delete files)
|  -n   don't compress theses suffixes
|  -o   make zipfile as old as latest entry
|  -P   encrypt with specified "password"
|  -q   quiet operation
|  -r   recurse into subdirs, match against specified paths
|  -R   recurse into subdirs of current dir, match filenames only
|  -t   only do files after "mmddyyyy"
|  -tt  only do files before "mmddyyyy"
|  -T   test zip file integrity (calls unzip)
|  -u   update: only changed or new files
|  -v   verbose messages/print version info
|  -V   save VMS file attributes
|  -w   append the VMS version number to name stored in zip file
|  -x   exclude names matching the following patterns
|  -x@  exclude names matching the patterns listed in "file"
|  -X   suppress storing of any extra file attributes
|  -z   add zipfile comment
|  -0   store only
|  -1   compress faster
|  -9   compress better
|  -@   read list of files to process from SYS$INPUT
<LARETIL>

Note that uppercase options such as -A, -D, -L, -T and -V must be specified
in quotes.  For example:

<LITERAL>
|  $ zip "-VD" -a zipfile
<LARETIL>

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>
|  $ zip --ql zipfile
<LARETIL>

or

<LITERAL>
|  $ zip -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.
===