view release on metacpan or  search on metacpan

unzip-6.0/vms/unzip_cli.help  view on Meta::CPAN

/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 Christian Spieler.  VMS support maintained
by Igor Mandrichenko, Steven M. Schweda, 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_Status

On VMS, UnZip's UNIX-style exit values are mapped into VMS-style status
codes with facility code 1954 = %x7A2, and with the inhibit-message
(%x10000000) and facility-specific (%x00008000) bits set:
<LITERAL>
|   %x17A28001                        normal exit
|   %x17A28000 + 16*UnZip_error_code  warnings
|   %x17A28002 + 16*UnZip_error_code  normal errors
|   %x17A28004 + 16*UnZip_error_code  fatal errors
<LARETIL>

Note that multiplying the UNIX-style UnZip error code by 16 places it
conveniently in the hexadecimal representation of the VMS exit code,
"__" in %x17A28__s, where "s" is the severity code.  For example, a
missing archive might cause UnZip error code 9, which would be
transformed into the VMS exit status %X17A28092.

The UnZip VMS exit codes include severity values which approximate those
defined by PKWARE, as shown in the following table:
<LITERAL>
|    VMS     UnZip err
|  severity    code     Error description
| ----------+---------+----------------------------------------------
|  Success       0      Normal.  No errors or warnings detected.
|  Warning       1      One or more warnings  were  encountered, but
|                       processing  completed  successfully  anyway.
|                       This  includes  archives  where  one or more
|                       (but not all)  files were skipped because of
|                       unsupported compress or encrypt methods,  or
|                       bad passwords.
|  Error         2      Error in the archive format.  Processing may
|                       have completed  successfully  anyway.   Some
|                       defects in archives (made by other programs)
|                       can be repaired transparently.
|  Fatal         3      Severe error in the archive format. Process-
|                       ing probably failed immediately.
|  Fatal         4      Memory allocation failed in program initial-
|                       ization.
|  Fatal         5      Memory  allocation  failed  in password pro-
|                       cessing.
|  Fatal         6      Memory allocation failed while decompressing
|                       to disk.
|  Fatal         7      Memory allocation failed while decompressing
|                       in memory.
|  Fatal         8      Memory  allocation  failed    (reserved  for
|                       future use).
|  Error         9      Specified archive files were not found.
|  Error        10      Invalid command-line options or parameters.
|  Error        11      No files matched selection criteria.
|  Fatal        50      Disk full.
|  Fatal        51      Unexpected  end-of-file  while  reading  the
|                       archive.
|  Error        80      User interrupt (Ctrl/C).
|  Error        81      No files were processed,  because  of unsup-
|                       ported compress or encrypt methods.
|  Error        82      No  files  were  processed,  because  of bad
|                       password(s).
|  Fatal        83      Large-file archive could not be processed by
|                       this small-file program.
<LARETIL>

<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
|  -T   set zipfile timestamps to that of each archive's newest entry
|  -u   update existing files; create new ones if needed
|  -v   list archive files (verbose format)
|  -z   display only the archive comment
|
|MODIFIERS
|  -a   extract text files in standard VMS text file format
|  -aa  extract all files as text
|  -b   auto-extract only binary files in fixed 512-byte record format
|  -bb  extract all files as binary in fixed 512-byte record format
|  -j   junk paths (don't recreate archive's directory structure)
|  -n   never overwrite or make a new version of an existing file
|  -o   always make a new version (-oo: overwrite orig) existing file
|  -q   perform operations quietly (-qq => even quieter)
|  -C   match filenames case-insensitively
|  -D   do not restore any timestamps (--D restore them even for dirs)
|  -L   convert filenames to lowercase if created under DOS, VMS, etc.
|  -M   feed screen output through built-in "more" pager
|  -P<password> supply decryption password on the cmd line (insecure!)