620 lines
21 KiB
Plaintext
620 lines
21 KiB
Plaintext
.!
|
||
.! File: UNZIP_CLI.HELP
|
||
.!
|
||
.! Author: Hunter Goatley
|
||
.!
|
||
.! Date: 12 Jul 94 (orig. UNZIP.RNH, 23 Oct 91)
|
||
.!
|
||
.! Description:
|
||
.!
|
||
.! TPU-processable source file to produce VMS on-line help for
|
||
.! portable UnZip. Adapted from UNZIP.RNH, originally based on
|
||
.! UNZIP.MAN (now UNZIP.TXT).
|
||
.!
|
||
.! To build:
|
||
.! $ EDIT /TPU/NOSECTION/NODISPLAY/COMMAND=CVTHELP.TPU UNZIP_CLI.HELP
|
||
.! $ RUNOFF /OUT=UNZIP.HLP UNZIP_CLI.RNH
|
||
.! $ LIBR /HELP/INSERT libr UNZIP
|
||
.!
|
||
.! Modification history:
|
||
.!
|
||
.! 02-001 Hunter Goatley 12-JUL-1994 16:59
|
||
.! Genesis.
|
||
.! 02-002 Cave Newt 14-JUL-1994 11:36
|
||
.! Fixed /*TEXT options and added/removed various options.
|
||
.! 02-003 Cave Newt 28-JUL-1994 08:54
|
||
.! Removed semicolons from comments and moved /ZIPINFO.
|
||
.! 02-004 Christian Spieler 06-OCT-1995 02:02
|
||
.! Changed to conform to revised .CLD definition.
|
||
.! 02-005 Christian Spieler 06-FEB-1996 02:20
|
||
.! Added description of /HELP qualifier.
|
||
.! 02-006 Christian Spieler 12-MAY-1996 00:50
|
||
.! Some clarifications/cleanups.
|
||
.! 02-007 Christian Spieler 04-MAR-1997 22:25
|
||
.! Added /[NO]CASE_INSENSITIVE to ZipInfo mode;
|
||
.! documented the new /PASSWORD="decryption_key" option.
|
||
.! 02-007 Christian Spieler 22-JUL-1997 22:37
|
||
.! Formatting changes (prevent line wraps);
|
||
.! added "Exit_Codes" subtopic (no version number change).
|
||
.! 02-007 Christian Spieler 28-APR-2000 03:22
|
||
.! Changed references to plaintext UnZip documentation file
|
||
.! into UNZIP.TXT (no version number change).
|
||
.! 02-007 Hunter Goatley 07-Feb-2001 15:43
|
||
.! Reformatted qualifier item headers to show negated form of
|
||
.! option qualifier on separate line (no version number change).
|
||
.! 02-008 Christian Spieler 18-Apr-2001 22:29
|
||
.! Added description for extended functionality of -b option.
|
||
.! 02-009 Christian Spieler 10-Dec-2001 13:37
|
||
.! Added description for new /TRAVERSE_DIRS option.
|
||
.! 02-010 Steven Schweda 28-Jan-2005 16:16:36
|
||
.! Added /TIMESTAMP (-T) qualifier.
|
||
.! 02-010 Christian Spieler 29-Jan-2005 01:50
|
||
.! Completed description of -T qualifier (also for UNIX style).
|
||
.! 02-011 Steven Schweda 14-FEB-2005 20:04
|
||
.! Added /DOT_VERSION (-Y) and /ODS2 (-2) qualifiers.
|
||
.! 02-012 Steven Schweda 07-JUL-2006 01:30
|
||
.! Added /TEXT = STMLF (-s) qualifier.
|
||
.! 02-012 Christian Spieler 04-Mar-2007 14:39
|
||
.! Changed -s qualifier into -S;
|
||
.! updated documentation of UnZip's exit codes.
|
||
.! 03-002 S. Schweda, C. Spieler 09-Jan-2008 03:35
|
||
.! Added documentation of extended /RESTORE=(...) qualifier.
|
||
.! 03-003 S. Schweda, C. Spieler 13-Sep-2008 20:00
|
||
.! Added /EXISTING qualifier.
|
||
.!
|
||
<INIT>
|
||
<MAIN>
|
||
UNZIP
|
||
|
||
UnZip is used to extract files compressed and packaged by Zip (see HELP ZIP
|
||
for information on ZIP).
|
||
|
||
For a brief help on Zip and Unzip, run each without specifying any
|
||
parameters on the command line (or apply the /HELP qualifier).
|
||
To get a brief help sceen about the alternate UNIX style command interface,
|
||
run each with the -h option applied.
|
||
|
||
UNZIP will list, test, or extract from a ZIP archive. ZIP archives are commonly
|
||
found on MS-DOS systems; a VMS version of ZIP can also be found here.
|
||
|
||
Archive member extraction is implied by the absence of the /SCREEN (-c),
|
||
/PIPE (-p), /TEST (-t), /TIMESTAMP (-T), /LIST (-l, -v) or /COMMENT (-z)
|
||
qualifiers (options).
|
||
All archive members are processed unless a filespec is provided to
|
||
specify a subset of the archive members.
|
||
<FORMAT>
|
||
UNZIP zipfile [file[,...]] [/qualifiers]
|
||
|
||
.!
|
||
<TOPIC>
|
||
Parameters
|
||
|
||
<PARAMETER>
|
||
zipfile
|
||
|
||
<PTEXT>
|
||
File specification for the ZIP archive(s) with optional wildcards. UnZip will
|
||
perform actions specified for every zipfile matching the specification.
|
||
The default file specification is SYS$DISK:[].ZIP.
|
||
|
||
Note that self-extracting ZIP files are supported; just specify the .EXE
|
||
suffix yourself.
|
||
<TXETP>
|
||
|
||
<PARAMETER>
|
||
file
|
||
|
||
<PTEXT>
|
||
An optional comma-separated list of archive members to be processed;
|
||
if no list is given, all archive members are processed. Expressions
|
||
may be used to match multiple members. Expressions should be enclosed
|
||
in double-quotes to prevent interpretation by DCL. Multiple filenames
|
||
should be separated by blanks. Each file specification is similar to
|
||
a Unix egrep expression and may contain:
|
||
|
||
<LITERAL>
|
||
|* matches a sequence of 0 or more characters
|
||
|? matches exactly 1 character
|
||
|[...] matches any single character found inside the brackets;
|
||
| ranges are specified by a beginning character, a hyphen,
|
||
| and an ending character. If a '!' or '^' immediately
|
||
| follows the left bracket, then any character not in the
|
||
| given range is matched.
|
||
| Hint: To specify a verbatim left bracket '[', the
|
||
| three-character sequence "[[]" has to be used.
|
||
<LARETIL>
|
||
<TXETP>
|
||
|
||
<QUALIFIERS>
|
||
<QUALIFIER>
|
||
/ZIPINFO
|
||
|
||
/ZIPINFO
|
||
|
||
Displays information about the Zip archive and the files contained therein.
|
||
This function used to be provided by a separate ZipInfo program.
|
||
|
||
The following qualifiers may be specified with /ZIPINFO:
|
||
|
||
<LITERAL>
|
||
| /SHORT Short UNIX "ls -l" format (default)
|
||
| /MEDIUM Medium UNIX "ls -l" format
|
||
| /LONG Long UNIX "ls -l" format
|
||
| /VERBOSE Verbose, multi-page format
|
||
| /ONE_LINE Filenames only, one per line
|
||
| /HEADER Print header lines
|
||
| /TOTALS Print totals for files
|
||
| /TIMES Print file times in sortable decimal format
|
||
| /[NO]CASE_INSENSITIVE Match filenames case-insensitively
|
||
| /[NO]PAGE Page screen output through built-in "more"
|
||
<LARETIL>
|
||
<QUALIFIER>
|
||
/BINARY
|
||
|
||
/BINARY[=KEYWORD]
|
||
<NEXT>
|
||
/NOBINARY (default)
|
||
|
||
Selects conversion to VMS "standard" binary file format for
|
||
extracted files, which is "fixed length 512 byte records,
|
||
no record attributes". When extracting to SYS$OUTPUT (/SCREEN
|
||
or /PIPE qualifier), this qualifier deactivates the default
|
||
"text data" conversion, instead.
|
||
The optional keywords recognized are:
|
||
<LITERAL>
|
||
| AUTO Automatically extracts files marked as "binary" (rather
|
||
| than "text") in standard VMS binary file format. (default)
|
||
| ALL Extracts all files in standard VMS binary file format.
|
||
| NONE Same as /NOBINARY.
|
||
<LARETIL>
|
||
|
||
Note that a combination of /BINARY[=AUTO] and /TEXT[=AUTO] is allowed.
|
||
(see /TEXT qualifier)
|
||
<QUALIFIER>
|
||
/BRIEF
|
||
|
||
/BRIEF (default)
|
||
|
||
When used with /LIST, specifies that a brief listing of the archive's
|
||
contents is to be displayed. A brief listing shows the length, date,
|
||
time, and file name for the files in the archive.
|
||
<QUALIFIER>
|
||
/CASE_INSENSITIVE
|
||
|
||
/CASE_INSENSITIVE
|
||
<NEXT>
|
||
/NOCASE_INSENSITIVE (default)
|
||
|
||
Match filenames case-insensitively. (Good default option under VMS.)
|
||
<QUALIFIER>
|
||
/COMMENT
|
||
|
||
/COMMENT
|
||
<NEXT>
|
||
/NOCOMMENT
|
||
|
||
Display the archive comment.
|
||
<QUALIFIER>
|
||
/DIRECTORY
|
||
|
||
/DIRECTORY=directory-spec
|
||
|
||
Specifies the output directory where all the extracted files are to be
|
||
placed.
|
||
<QUALIFIER>
|
||
/DOT_VERSION
|
||
|
||
/DOT_VERSION
|
||
<NEXT>
|
||
/NODOT_VERSION (default)
|
||
|
||
Causes UnZip to treat archived file name endings of ".nnn" (where "nnn"
|
||
is a decimal number) as if they were VMS version numbers (";nnn"). (The
|
||
default is to treat them as file types.) Example: "a.b.3" -> "a.b;3".
|
||
<QUALIFIER>
|
||
/EXCLUDE
|
||
|
||
/EXCLUDE=(file[,...])
|
||
|
||
A comma-separated list of files to exclude when extracting files.
|
||
If multiple files are specified, the list should be included in
|
||
parentheses.
|
||
<QUALIFIER>
|
||
/EXISTING
|
||
|
||
/EXISTING = keyword
|
||
|
||
Valid keywords (exactly one must be specified) are:
|
||
<LITERAL>
|
||
| NEW_VERSION Create a new version of an existing file.
|
||
| OVERWRITE Overwrite the same version of an existing file.
|
||
| (But only if the archive member name includes a
|
||
| version number.)
|
||
| NOEXTRACT Do not extract. An existing file is not affected.
|
||
<LARETIL>
|
||
|
||
When UnZip would extract an archive member, but the destination file
|
||
already exists, UnZip will, by default, ask the user what to do.
|
||
/EXISTING lets the user specify on the command line what to do in this
|
||
situation, eliminating the interactive question(s).
|
||
|
||
NOEXTRACT will always stop UnZip from extracting an archive member if
|
||
the destination file already exists.
|
||
|
||
If an archive member name does not include a VMS version number, or if
|
||
UnZip is run with /NOVERSION (the default, causing it to ignore version
|
||
numbers), then either NEW_VERSION or OVERWRITE will cause UnZip to
|
||
create a new version of the existing file.
|
||
|
||
If an archive member name does include a VMS version number, and if
|
||
UnZip is run with /VERSION, then NEW_VERSION will cause UnZip to create
|
||
a new version of the existing file, and OVERWRITE will cause UnZip to
|
||
overwrite the existing file which has the version specified by the
|
||
archive member name.
|
||
<QUALIFIER>
|
||
/FRESHEN
|
||
|
||
/FRESHEN
|
||
<NEXT>
|
||
/NOFRESHEN
|
||
|
||
Freshen existing files; replace if newer. Does not cause any new files to
|
||
be created.
|
||
<QUALIFIER>
|
||
/FULL
|
||
|
||
/FULL
|
||
|
||
When used with /LIST, specifies that a full listing of the archive's
|
||
contents is to be displayed. A full listing shows the length,
|
||
compression method, compressed size, compression ratio, date,
|
||
time, CRC value, and file name for the files in the archive.
|
||
<QUALIFIER>
|
||
/HELP
|
||
|
||
/HELP
|
||
|
||
Displays a one-page brief help screen and exits quietly.
|
||
<QUALIFIER>
|
||
/JUNK
|
||
|
||
/JUNK
|
||
<NEXT>
|
||
/NOJUNK (default)
|
||
|
||
Junk the stored paths (don't recreated the archive's directory
|
||
structure.
|
||
<QUALIFIER>
|
||
/LIST
|
||
|
||
/LIST
|
||
|
||
List the contents of the archive. /BRIEF and /FULL can be used to
|
||
specify the amount of information displayed. The default is /BRIEF.
|
||
<QUALIFIER>
|
||
/LOWERCASE
|
||
|
||
/LOWERCASE
|
||
<NEXT>
|
||
/NOLOWERCASE (default)
|
||
|
||
Convert filenames from all-uppercase operating systems to lowercase. This
|
||
option has no effect under VMS.
|
||
<QUALIFIER>
|
||
/ODS2
|
||
|
||
/ODS2
|
||
<NEXT>
|
||
/NOODS2 (default)
|
||
|
||
Causes UnZip to convert archived file names to ODS2-compatible file
|
||
names (substituting "_" for any invalid characters), regardless of the
|
||
type of the destination file system.
|
||
|
||
The default is to use ODS5-compatible file names when the destination
|
||
file system is ODS5, and to convert the names to ODS2-compatible names
|
||
when the destination file system is ODS2.
|
||
|
||
Beginning in UnZip 6.0, ODS2-compatible names are explicitly set to
|
||
upper case.
|
||
<QUALIFIER>
|
||
/OVERWRITE
|
||
|
||
/OVERWRITE
|
||
<NEXT>
|
||
/NOOVERWRITE
|
||
|
||
See /EXISTING.
|
||
|
||
/OVERWRITE is equivalent to /EXISTING = NEW_VERSION.
|
||
<NEXT>
|
||
/NOOVERWRITE is equivalent to /EXISTING = NOEXTRACT.
|
||
<QUALIFIER>
|
||
/PAGE
|
||
|
||
/PAGE
|
||
<NEXT>
|
||
/NOPAGE
|
||
|
||
Feed all screen output through the built-in "more" pager.
|
||
<QUALIFIER>
|
||
/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[=(KEYWORD, ...)]
|
||
|
||
Selects restoration options for some meta-data.
|
||
The optional keywords recognized are:
|
||
<LITERAL>
|
||
| OWNER_PROT Restore file owner and ACL protection settings.
|
||
| NOOWNER_PROT Do not restore file owner and ACL protection settings.
|
||
| NODATE Do not restore any timestamps.
|
||
| DATE=ALL Restore timestamps for all extracted entries, files
|
||
| and directories.
|
||
| DATE=FILES Restore timestamps for extracted files. (default)
|
||
<LARETIL>
|
||
|
||
By default, VMS UnZip restores the original date-time attributes for files,
|
||
but not for directories. This agrees with the behavior of VMS BACKUP
|
||
(and UnZip versions before 5.52 where the capability to restore directory
|
||
timestamps was added).
|
||
|
||
For compatibility with UnZip versions before 6.0 (5.53), the following
|
||
obsolete short forms are still accepted:
|
||
<LITERAL>
|
||
| Obsolete form: Modern form:
|
||
| /RESTORE /RESTORE = OWNER_PROT
|
||
| /NORESTORE /RESTORE = NOOWNER_PROT
|
||
<LARETIL>
|
||
<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.
|
||
| STMLF Use Stream_LF record format for text files (instead of the
|
||
| default variable-length record format).
|
||
<LARETIL>
|
||
|
||
A similar functionality is available for binary files, see qualifier /BINARY.
|
||
<QUALIFIER>
|
||
/TIMESTAMP
|
||
|
||
/TIMESTAMP
|
||
|
||
Sets the timestamp of an archive to that of its newest file. This qualifier
|
||
corresponds to zip's /APPEND/LATEST (-go) option, but can be applied to
|
||
wildcard zipfile specifications (e.g. "*.zip") and is much faster.
|
||
<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 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!)
|
||
| -S use Stream_LF record format to extract text files (with -a[a])
|
||
| -V retain (VMS) file version numbers
|
||
| -X restore owner/ACL protection info (may require privileges)
|
||
| -Y treat ".nnn" suffix as version number ("a.b.3" -> "a.b;3")
|
||
| -: allow "../" path components to traverse across top extract dir
|
||
| -2 force creation of ODS2-compatible file names
|
||
<LARETIL>
|
||
|
||
Note that uppercase options such as -C, -D, -L, -M, -P, -S, -T, -V, -X, -Y,
|
||
and -Z must be specified in quotes (unless SET PROC/PARSE=EXTEND is set).
|
||
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.
|