view release on metacpan or  search on metacpan

unzip-6.0/vms/unzip_def.rnh  view on Meta::CPAN

for Zip entries marked as non-text, only. To force "binary piping" mode
even for Zip file entries marked as text, the "-bb" option should be used.
(Please note that a later "-a" cancels any -b option, see below.)
.sk
The output conversion options -b and -a may be combined to perform
binary conversions on binary files and text conversion on text files.
But note: For compatibility with implementation on other systems, -b cancels
any -a option; to get the intended result, -a must be specified AFTER -b.
And, in combination, "text" recognition takes precedence; this means
that -bba (-bb -a) has the same effect as -ba (-b -a), and -aa overrides
binary conversion for ALL files.
.sk
The conversion option -S is only effective when used together with
-a or -aa. When specified, "text" files are written in Stream-LF record
format instead of the VMS default of Variable-Length record format.
(When no conversion options are specified, all non-VMS entries are always
written as Stream-LF files.)
.sk
Please note that using the "-P<password>" option is higly insecure, the
plaintext password may be seen by others. For this reason (and because of
lack of space), the "-P<password>" option is not advertised on UnZip's
online help screen.
.!------------------------------------------------------------------------------
.indent -4
2 Exit_Status
.br
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:
.sk
.literal
   %x17A28001                        normal exit
   %x17A28000 + 16*UnZip_error_code  warnings
   %x17A28002 + 16*UnZip_error_code  normal errors
   %x17A28004 + 16*UnZip_error_code  fatal errors
.end literal
.sk
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.
.sk
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.
.end literal
.!------------------------------------------------------------------------------
.indent -4
2 Logical_Names
.br
UnZip allows to modify its default behaviour by specifying option defaults
via the UNZIP_OPTS logical name.
For example, the following will cause UnZip to restore owner/protection
information and perform all operations at quiet-level 1 by default:
.sk;.literal
    define UNZIP_OPTS "-qX"
.end literal;.sk
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
`-':
.sk;.literal
    unzip --ql zipfile
.end literal
or
.literal
    unzip -l-q zipfile
.end literal;.sk
At present it is not possible to decrement an option below zero--that is,
more than a few minuses have no effect.
.sk
UNZIP_OPTS may be defined as a symbol rather than a logical name, but if
both are defined, the logical name takes precedence.
.!-----------------------------------------------------------------------------
.indent -4
2 Authors
.br
Info-ZIP; currently maintained by Christian Spieler.  VMS support maintained
by Christian Spieler and Hunter Goatley.  Originally based on a program