From 6bc7a8acdc17ad8c6ec6a41c39257d732c34ca2b Mon Sep 17 00:00:00 2001 From: DarkWyrm Date: Sat, 21 Sep 2002 16:51:13 +0000 Subject: [PATCH] Oops. Accidentally checked in man pages git-svn-id: file:///srv/svn/repos/haiku/trunk/current@1105 a95241bf-73f2-0310-859d-f6bbb57e9c96 --- src/apps/bin/unzip/man/Contents | 14 - src/apps/bin/unzip/man/funzip.1 | 127 ----- src/apps/bin/unzip/man/unzip.1 | 865 ------------------------------ src/apps/bin/unzip/man/unzipsfx.1 | 336 ------------ src/apps/bin/unzip/man/zipgrep.1 | 89 --- src/apps/bin/unzip/man/zipinfo.1 | 488 ----------------- 6 files changed, 1919 deletions(-) delete mode 100644 src/apps/bin/unzip/man/Contents delete mode 100644 src/apps/bin/unzip/man/funzip.1 delete mode 100644 src/apps/bin/unzip/man/unzip.1 delete mode 100644 src/apps/bin/unzip/man/unzipsfx.1 delete mode 100644 src/apps/bin/unzip/man/zipgrep.1 delete mode 100644 src/apps/bin/unzip/man/zipinfo.1 diff --git a/src/apps/bin/unzip/man/Contents b/src/apps/bin/unzip/man/Contents deleted file mode 100644 index 10368691f0..0000000000 --- a/src/apps/bin/unzip/man/Contents +++ /dev/null @@ -1,14 +0,0 @@ -Contents of the "man" subdirectory for UnZip 5.41 and later: - - Contents this file - funzip.1 fUnZip manual page, nroff format - unzip.1 UnZip manual page, nroff format - unzipsfx.1 UnZipSFX manual page, nroff format - zipgrep.1 ZipGrep manual page, nroff format - zipinfo.1 ZipInfo manual page, nroff format - -This subdirectory contains the master source files for the UnZip user -documentation. Although these documents are Unix man-page sources, they -are of general interest and therefore stored separately. -Some non-Unix systems may supply a man-page reader where they could be -used; and they are the sources for the generic ASCII text document files. diff --git a/src/apps/bin/unzip/man/funzip.1 b/src/apps/bin/unzip/man/funzip.1 deleted file mode 100644 index 589c567dab..0000000000 --- a/src/apps/bin/unzip/man/funzip.1 +++ /dev/null @@ -1,127 +0,0 @@ -.\" Copyright (c) 1990-2002 Info-ZIP. All rights reserved. -.\" -.\" See the accompanying file LICENSE, version 2000-Apr-09 or later -.\" (the contents of which are also included in unzip.h) for terms of use. -.\" If, for some reason, all these files are missing, the Info-ZIP license -.\" also may be found at: ftp://ftp.info-zip.org/pub/infozip/license.html -.\" -.\" funzip.1 by Greg Roelofs and others. -.\" -.\" ========================================================================= -.\" define .EX/.EE (for multiline user-command examples; normal Courier font) -.de EX -.in +4n -.nf -.ft CW -.. -.de EE -.ft R -.fi -.in -4n -.. -.\" ========================================================================= -.TH FUNZIP 1L "17 February 2002 (v3.94)" "Info-ZIP" -.SH NAME -funzip \- filter for extracting from a ZIP archive in a pipe -.PD -.SH SYNOPSIS -\fBfunzip\fP [\fB\-password\fP] [\fIinput[.zip|.gz]\fP] -.\" ========================================================================= -.SH ARGUMENTS -.IP [\fI\-password\fP] -Optional password to be used if ZIP archive is encrypted. Decryption -may not be supported at some sites. See DESCRIPTION for more details. -.IP [\fIinput[.zip|.gz]\fP] -Optional input archive file specification. See DESCRIPTION for details. -.PD -.\" ========================================================================= -.SH DESCRIPTION -.I funzip -without a file argument acts as a filter; that is, it assumes that a -ZIP archive (or a \fIgzip\fP'd(1) file) is being piped into -standard input, and it extracts the first member from the archive to stdout. -When stdin comes from a tty device, -.I funzip -assumes that this cannot be a stream of (binary) compressed data and -shows a short help text, instead. -If there is a file argument, then input is read from the specified file -instead of from stdin. -.PP -A password for encrypted zip files can be specified -on the command line (preceding the file name, if any) by prefixing the -password with a dash. Note that this constitutes a security risk on many -systems; currently running processes are often visible via simple commands -(e.g., \fIps\fP(1) under Unix), and command-line histories can be read. -If the first entry of the zip file is encrypted and -no password is specified on the command line, then the user is prompted for -a password and the password is not echoed on the console. -.PP -Given the limitation on single-member extraction, \fIfunzip\fP is most -useful in conjunction with a secondary archiver program such as \fItar\fP(1). -The following section includes an example illustrating this usage in the -case of disk backups to tape. -.PD -.\" ========================================================================= -.SH EXAMPLES -To use \fIfunzip\fP to extract the first member file of the archive test.zip -and to pipe it into \fImore\fP(1): -.PP -.EX -funzip test.zip | more -.EE -.PP -To use \fIfunzip\fP to test the first member file of test.zip (any errors -will be reported on standard error): -.PP -.EX -funzip test.zip > /dev/null -.EE -.PP -To use \fIzip\fP and \fIfunzip\fP in place of \fIcompress\fP(1) and -\fIzcat\fP(1) (or \fIgzip\fP(1L) and \fIgzcat\fP(1L)) for tape backups: -.PP -.EX -tar cf \- . | zip \-7 | dd of=/dev/nrst0 obs=8k -dd if=/dev/nrst0 ibs=8k | funzip | tar xf \- -.EE -.PP -(where, for example, nrst0 is a SCSI tape drive). -.PD -.\" ========================================================================= -.SH BUGS -When piping an encrypted file into \fImore\fP and allowing \fIfunzip\fP -to prompt for password, the terminal may sometimes be reset to a non-echo -mode. This is apparently due to a race condition between the two programs; -\fIfunzip\fP changes the terminal mode to non-echo before \fImore\fP reads -its state, and \fImore\fP then ``restores'' the terminal to this mode before -exiting. To recover, run \fIfunzip\fP on the same file but redirect to -/dev/null rather than piping into more; after prompting again for the -password, \fIfunzip\fP will reset the terminal properly. -.PP -There is presently no way to extract any member but the first from a ZIP -archive. This would be useful in the case where a ZIP archive is included -within another archive. In the case where the first member is a directory, -\fIfunzip\fP simply creates the directory and exits. -.PP -The functionality of \fIfunzip\fP should be incorporated into \fIunzip\fP -itself (future release). -.PD -.\" ========================================================================= -.SH "SEE ALSO" -\fIgzip\fP(1L), \fIunzip\fP(1L), \fIunzipsfx\fP(1L), \fIzip\fP(1L), -\fIzipcloak\fP(1L), \fIzipinfo\fP(1L), \fIzipnote\fP(1L), \fIzipsplit\fP(1L) -.PD -.\" ========================================================================= -.SH URL -The Info-ZIP home page is currently at -.EX -\fChttp://www.info-zip.org/pub/infozip/\fR -.EE -or -.EX -\fCftp://ftp.info-zip.org/pub/infozip/\fR . -.EE -.PD -.\" ========================================================================= -.SH AUTHOR -Mark Adler (Info-ZIP) diff --git a/src/apps/bin/unzip/man/unzip.1 b/src/apps/bin/unzip/man/unzip.1 deleted file mode 100644 index 9d53915da0..0000000000 --- a/src/apps/bin/unzip/man/unzip.1 +++ /dev/null @@ -1,865 +0,0 @@ -.\" Copyright (c) 1990-2002 Info-ZIP. All rights reserved. -.\" -.\" See the accompanying file LICENSE, version 2000-Apr-09 or later -.\" (the contents of which are also included in unzip.h) for terms of use. -.\" If, for some reason, all these files are missing, the Info-ZIP license -.\" also may be found at: ftp://ftp.info-zip.org/pub/infozip/license.html -.\" -.\" unzip.1 by Greg Roelofs, Fulvio Marino, Jim van Zandt and others. -.\" -.\" ========================================================================= -.\" define .EX/.EE (for multiline user-command examples; normal Courier font) -.de EX -.in +4n -.nf -.ft CW -.. -.de EE -.ft R -.fi -.in -4n -.. -.\" ========================================================================= -.TH UNZIP 1L "17 February 2002 (v5.5)" "Info-ZIP" -.SH NAME -unzip \- list, test and extract compressed files in a ZIP archive -.PD -.SH SYNOPSIS -\fBunzip\fP [\fB\-Z\fP] [\fB\-cflptuvz\fP[\fBabjnoqsCLMVX$/:\fP]] -\fIfile\fP[\fI.zip\fP] [\fIfile(s)\fP\ .\|.\|.] -[\fB\-x\fP\ \fIxfile(s)\fP\ .\|.\|.] [\fB\-d\fP\ \fIexdir\fP] -.PD -.\" ========================================================================= -.SH DESCRIPTION -\fIunzip\fP will list, test, or extract files from a ZIP archive, commonly -found on MS-DOS systems. The default behavior (with no options) is to extract -into the current directory (and subdirectories below it) all files from the -specified ZIP archive. A companion program, \fIzip\fP(1L), creates ZIP -archives; both programs are compatible with archives created by PKWARE's -\fIPKZIP\fP and \fIPKUNZIP\fP for MS-DOS, but in many cases the program -options or default behaviors differ. -.PD -.\" ========================================================================= -.SH ARGUMENTS -.TP -.IR file [ .zip ] -Path of the ZIP archive(s). If the file specification is a wildcard, -each matching file is processed in an order determined by the operating -system (or file system). Only the filename can be a wildcard; the path -itself cannot. Wildcard expressions are similar to those supported in -commonly used Unix shells (\fIsh\fP, \fIksh\fP, \fIcsh\fP) and may contain: -.RS -.IP * -matches a sequence of 0 or more characters -.IP ? -matches exactly 1 character -.IP [.\|.\|.] -matches any single character found inside the brackets; ranges are specified -by a beginning character, a hyphen, and an ending character. If an exclamation -point or a caret (`!' or `^') follows the left bracket, then the range of -characters within the brackets is complemented (that is, anything \fIexcept\fP -the characters inside the brackets is considered a match). -.RE -.IP -(Be sure to quote any character that might otherwise be interpreted or -modified by the operating system, particularly under Unix and VMS.) If no -matches are found, the specification is assumed to be a literal filename; -and if that also fails, the suffix \fC.zip\fR is appended. Note that -self-extracting ZIP files are supported, as with any other ZIP archive; -just specify the \fC.exe\fR suffix (if any) explicitly. -.IP [\fIfile(s)\fP] -An optional list of archive members to be processed, separated by spaces. -(VMS versions compiled with VMSCLI defined must delimit files with commas -instead. See \fB\-v\fP in \fBOPTIONS\fP below.) -Regular expressions (wildcards) may be used to match multiple members; see -above. Again, be sure to quote expressions that would otherwise be expanded -or modified by the operating system. -.IP [\fB\-x\fP\ \fIxfile(s)\fP] -An optional list of archive members to be excluded from processing. -Since wildcard characters match directory separators (`/'), this option -may be used to exclude any files that are in subdirectories. For -example, ``\fCunzip foo *.[ch] -x */*\fR'' would extract all C source files -in the main directory, but none in any subdirectories. Without the \fB\-x\fP -option, all C source files in all directories within the zipfile would be -extracted. -.IP [\fB\-d\fP\ \fIexdir\fP] -An optional directory to which to extract files. By default, all files -and subdirectories are recreated in the current directory; the \fB\-d\fP -option allows extraction in an arbitrary directory (always assuming one -has permission to write to the directory). This option need not appear -at the end of the command line; it is also accepted before the zipfile -specification (with the normal options), immediately after the zipfile -specification, or between the \fIfile(s)\fP and the \fB\-x\fP option. -The option and directory may be concatenated without any white space -between them, but note that this may cause normal shell behavior to be -suppressed. In particular, ``\fC\-d\ ~\fR'' (tilde) is expanded by Unix -C shells into the name of the user's home directory, but ``\fC\-d~\fR'' -is treated as a literal subdirectory ``\fB~\fP'' of the current directory. -.\" ========================================================================= -.SH OPTIONS -Note that, in order to support obsolescent hardware, \fIunzip\fP's usage -screen is limited to 22 or 23 lines and should therefore be considered -only a reminder of the basic \fIunzip\fP syntax rather than an exhaustive -list of all possible flags. The exhaustive list follows: -.TP -.B \-Z -\fIzipinfo\fP(1L) mode. If the first option on the command line is \fB\-Z\fP, -the remaining options are taken to be \fIzipinfo\fP(1L) options. See the -appropriate manual page for a description of these options. -.TP -.B \-A -[OS/2, Unix DLL] print extended help for the DLL's programming interface (API). -.TP -.B \-c -extract files to stdout/screen (``CRT''). This option is similar to the -\fB\-p\fP option except that the name of each file is printed as it is -extracted, the \fB\-a\fP option is allowed, and ASCII-EBCDIC conversion -is automatically performed if appropriate. This option is not listed in -the \fIunzip\fP usage screen. -.TP -.B \-f -freshen existing files, i.e., extract only those files that -already exist on disk and that are newer than the disk copies. By -default \fIunzip\fP queries before overwriting, but the \fB\-o\fP option -may be used to suppress the queries. Note that under many operating systems, -the TZ (timezone) environment variable must be set correctly in order for -\fB\-f\fP and \fB\-u\fP to work properly (under Unix the variable is usually -set automatically). The reasons for this are somewhat subtle but -have to do with the differences between DOS-format file times (always local -time) and Unix-format times (always in GMT/UTC) and the necessity to compare -the two. A typical TZ value is ``PST8PDT'' (US Pacific time with automatic -adjustment for Daylight Savings Time or ``summer time''). -.TP -.B \-l -list archive files (short format). The names, uncompressed file sizes and -modification dates and times of the specified files are printed, along -with totals for all files specified. If UnZip was compiled with OS2_EAS -defined, the \fB\-l\fP option also lists columns for the sizes of stored -OS/2 extended attributes (EAs) and OS/2 access control lists (ACLs). In -addition, the zipfile comment and individual file comments (if any) are -displayed. If a file was archived from a single-case file system (for -example, the old MS-DOS FAT file system) and the \fB\-L\fP option was given, -the filename is converted to lowercase and is prefixed with a caret (^). -.TP -.B \-p -extract files to pipe (stdout). Nothing but the file data is sent to -stdout, and the files are always extracted in binary format, just as they -are stored (no conversions). -.TP -.B \-t -test archive files. This option extracts each specified file in memory -and compares the CRC (cyclic redundancy check, an enhanced checksum) of -the expanded file with the original file's stored CRC value. -.TP -.B \-T -[most OSes] set the timestamp on the archive(s) to that of the newest file -in each one. This corresponds to \fIzip\fP's \fB\-go\fP option except that -it can be used on wildcard zipfiles (e.g., ``\fCunzip \-T \e*.zip\fR'') and -is much faster. -.TP -.B \-u -update existing files and create new ones if needed. This option performs -the same function as the \fB\-f\fP option, extracting (with query) files -that are newer than those with the same name on disk, and in addition it -extracts those files that do not already exist on disk. See \fB\-f\fP -above for information on setting the timezone properly. -.TP -.B \-v -be verbose or print diagnostic version info. This option has evolved and -now behaves as both an option and a modifier. As an option it has two -purposes: when a zipfile is specified with no other options, \fB\-v\fP lists -archive files verbosely, adding to the basic \fB\-l\fP info the compression -method, compressed size, compression ratio and 32-bit CRC. When no zipfile -is specified (that is, the complete command is simply ``\fCunzip \-v\fR''), a -diagnostic screen is printed. In addition to the normal header with release -date and version, \fIunzip\fP lists the home Info-ZIP ftp site and where to -find a list of other ftp and non-ftp sites; the target operating system for -which it was compiled, as well as (possibly) the hardware on which it was -compiled, the compiler and version used, and the compilation date; any special -compilation options that might affect the program's operation (see also -\fBDECRYPTION\fP below); and any options stored in environment variables -that might do the same (see \fBENVIRONMENT OPTIONS\fP below). As a -modifier it works in conjunction with other options (e.g., \fB\-t\fP) to -produce more verbose or debugging output; this is not yet fully implemented -but will be in future releases. -.TP -.B \-z -display only the archive comment. -.PD -.\" ========================================================================= -.SH MODIFIERS -.TP -.B \-a -convert text files. Ordinarily all files are extracted exactly as they -are stored (as ``binary'' files). The \fB\-a\fP option causes files identified -by \fIzip\fP as text files (those with the `t' label in \fIzipinfo\fP -listings, rather than `b') to be automatically extracted as such, converting -line endings, end-of-file characters and the character set itself as necessary. -(For example, Unix files use line feeds (LFs) for end-of-line (EOL) and -have no end-of-file (EOF) marker; Macintoshes use carriage returns (CRs) -for EOLs; and most PC operating systems use CR+LF for EOLs and control-Z for -EOF. In addition, IBM mainframes and the Michigan Terminal System use EBCDIC -rather than the more common ASCII character set, and NT supports Unicode.) -Note that \fIzip\fP's identification of text files is by no means perfect; some -``text'' files may actually be binary and vice versa. \fIunzip\fP therefore -prints ``\fC[text]\fR'' or ``\fC[binary]\fR'' as a visual check for each file -it extracts when using the \fB\-a\fP option. The \fB\-aa\fP option forces -all files to be extracted as text, regardless of the supposed file type. -.TP -.B \-b -[general] treat all files as binary (no text conversions). This is a shortcut -for \fB\-\-\-a\fP. -.TP -.B \-b -[Tandem] force the creation files with filecode type 180 ('C') when -extracting Zip entries marked as "text". (On Tandem, \fB\-a\fP is enabled -by default, see above). -.TP -.B \-b -[VMS] auto-convert binary files (see \fB\-a\fP above) to fixed-length, -512-byte record format. Doubling the option (\fB\-bb\fP) forces all files -to be extracted in this format. When extracting to standard output -(\fB\-c\fP or \fB\-p\fP option in effect), the default conversion of text -record delimiters is disabled for binary (\fB\-b\fP) resp. all (\fB\-bb\fP) -files. -.TP -.B \-B -[Unix only, and only if compiled with UNIXBACKUP defined] save a backup copy -of each overwritten file with a tilde appended (e.g., the old copy of -``\fCfoo\fR'' is renamed to ``\fCfoo~\fR''). This is similar to the default -behavior of \fIemacs\fP(1) in many locations. -.TP -.B \-C -match filenames case-insensitively. \fIunzip\fP's philosophy is ``you get -what you ask for'' (this is also responsible for the \fB\-L\fP/\fB\-U\fP -change; see the relevant options below). Because some file systems are fully -case-sensitive (notably those under the Unix operating system) and because -both ZIP archives and \fIunzip\fP itself are portable across platforms, -\fIunzip\fP's default behavior is to match both wildcard and literal filenames -case-sensitively. That is, specifying ``\fCmakefile\fR'' on the command line -will \fIonly\fP match ``makefile'' in the archive, not ``Makefile'' or -``MAKEFILE'' (and similarly for wildcard specifications). Since this does -not correspond to the behavior of many other operating/file systems (for -example, OS/2 HPFS, which preserves mixed case but is not sensitive to it), -the \fB\-C\fP option may be used to force all filename matches to be -case-insensitive. In the example above, all three files would then match -``\fCmakefile\fR'' (or ``\fCmake*\fR'', or similar). The \fB\-C\fP option -affects files in both the normal file list and the excluded-file list (xlist). -.TP -.B \-E -[MacOS only] display contents of MacOS extra field during restore operation. -.TP -.B \-F -[Acorn only] suppress removal of NFS filetype extension from stored filenames. -.TP -.B \-F -[non-Acorn systems supporting long filenames with embedded commas, -and only if compiled with ACORN_FTYPE_NFS defined] translate -filetype information from ACORN RISC OS extra field blocks into a -NFS filetype extension and append it to the names of the extracted files. -(When the stored filename appears to already have an appended NFS filetype -extension, it is replaced by the info from the extra field.) -.TP -.B \-i -[MacOS only] ignore filenames stored in MacOS extra fields. Instead, the -most compatible filename stored in the generic part of the entry's header -is used. -.TP -.B \-j -junk paths. The archive's directory structure is not recreated; all files -are deposited in the extraction directory (by default, the current one). -.TP -.B \-J -[BeOS only] junk file attributes. The file's BeOS file attributes are not -restored, just the file's data. -.TP -.B \-J -[MacOS only] ignore MacOS extra fields. All Macintosh specific info -is skipped. Data-fork and resource-fork are restored as separate files. -.TP -.B \-L -convert to lowercase any filename originating on an uppercase-only operating -system or file system. (This was \fIunzip\fP's default behavior in releases -prior to 5.11; the new default behavior is identical to the old behavior with -the \fB\-U\fP option, which is now obsolete and will be removed in a future -release.) Depending on the archiver, files archived under single-case -file systems (VMS, old MS-DOS FAT, etc.) may be stored as all-uppercase names; -this can be ugly or inconvenient when extracting to a case-preserving -file system such as OS/2 HPFS or a case-sensitive one such as under -Unix. By default \fIunzip\fP lists and extracts such filenames exactly as -they're stored (excepting truncation, conversion of unsupported characters, -etc.); this option causes the names of all files from certain systems to be -converted to lowercase. The \fB\-LL\fP option forces conversion of every -filename to lowercase, regardless of the originating file system. -.TP -.B \-M -pipe all output through an internal pager similar to the Unix \fImore\fP(1) -command. At the end of a screenful of output, \fIunzip\fP pauses with a -``\-\-More\-\-'' prompt; the next screenful may be viewed by pressing the -Enter (Return) key or the space bar. \fIunzip\fP can be terminated by -pressing the ``q'' key and, on some systems, the Enter/Return key. Unlike -Unix \fImore\fP(1), there is no forward-searching or editing capability. -Also, \fIunzip\fP doesn't notice if long lines wrap at the edge of the screen, -effectively resulting in the printing of two or more lines and the likelihood -that some text will scroll off the top of the screen before being viewed. -On some systems the number of available lines on the screen is not detected, -in which case \fIunzip\fP assumes the height is 24 lines. -.TP -.B \-n -never overwrite existing files. If a file already exists, skip the extraction -of that file without prompting. By default \fIunzip\fP queries before -extracting any file that already exists; the user may choose to overwrite -only the current file, overwrite all files, skip extraction of the current -file, skip extraction of all existing files, or rename the current file. -.TP -.B \-N -[Amiga] extract file comments as Amiga filenotes. File comments are created -with the \-c option of \fIzip\fP(1L), or with the \-N option of the Amiga port -of \fIzip\fP(1L), which stores filenotes as comments. -.TP -.B \-o -overwrite existing files without prompting. This is a dangerous option, so -use it with care. (It is often used with \fB\-f\fP, however, and is the only -way to overwrite directory EAs under OS/2.) -.IP \fB\-P\fP\ \fIpassword\fP -use \fIpassword\fP to decrypt encrypted zipfile entries (if any). \fBTHIS IS -INSECURE!\fP Many multi-user operating systems provide ways for any user to -see the current command line of any other user; even on stand-alone systems -there is always the threat of over-the-shoulder peeking. Storing the plaintext -password as part of a command line in an automated script is even worse. -Whenever possible, use the non-echoing, interactive prompt to enter passwords. -(And where security is truly important, use strong encryption such as Pretty -Good Privacy instead of the relatively weak encryption provided by standard -zipfile utilities.) -.TP -.B \-q -perform operations quietly (\fB\-qq\fP = even quieter). Ordinarily \fIunzip\fP -prints the names of the files it's extracting or testing, the extraction -methods, any file or zipfile comments that may be stored in the archive, -and possibly a summary when finished with each archive. The \fB\-q\fP[\fBq\fP] -options suppress the printing of some or all of these messages. -.TP -.B \-s -[OS/2, NT, MS-DOS] convert spaces in filenames to underscores. Since all PC -operating systems allow spaces in filenames, \fIunzip\fP by default extracts -filenames with spaces intact (e.g., ``\fCEA\ DATA.\ SF\fR''). This can be -awkward, however, since MS-DOS in particular does not gracefully support -spaces in filenames. Conversion of spaces to underscores can eliminate the -awkwardness in some cases. -.TP -.B \-U -(obsolete; to be removed in a future release) leave filenames uppercase if -created under MS-DOS, VMS, etc. See \fB\-L\fP above. -.TP -.B \-V -retain (VMS) file version numbers. VMS files can be stored with a version -number, in the format \fCfile.ext;##\fR. By default the ``\fC;##\fR'' version -numbers are stripped, but this option allows them to be retained. (On -file systems that limit filenames to particularly short lengths, the version -numbers may be truncated or stripped regardless of this option.) -.TP -.B \-X -[VMS, Unix, OS/2, NT] restore owner/protection info (UICs) under VMS, or user -and group info (UID/GID) under Unix, or access control lists (ACLs) under -certain network-enabled versions of OS/2 (Warp Server with IBM LAN -Server/Requester 3.0 to 5.0; Warp Connect with IBM Peer 1.0), or security ACLs -under Windows NT. In most cases this will require special system privileges, -and doubling the option (\fB\-XX\fP) under NT instructs \fIunzip\fP to use -privileges for extraction; but under Unix, for example, a user who belongs to -several groups can restore files owned by any of those groups, as long as the -user IDs match his or her own. Note that ordinary file attributes are always -restored--this option applies only to optional, extra ownership info available -on some operating systems. [NT's access control lists do not appear to be -especially compatible with OS/2's, so no attempt is made at cross-platform -portability of access privileges. It is not clear under what conditions this -would ever be useful anyway.] -.TP -.B \-$ -.\" Amiga support possible eventually, but not yet -[MS-DOS, OS/2, NT] restore the volume label if the extraction medium is -removable (e.g., a diskette). Doubling the option (\fB\-$$\fP) allows fixed -media (hard disks) to be labelled as well. By default, volume labels are -ignored. -.IP \fB\-/\fP\ \fIextensions\fP -[Acorn only] overrides the extension list supplied by Unzip$Ext environment -variable. During extraction, filename extensions that match one of the items -in this extension list are swapped in front of the base name of the extracted -file. -.TP -.B \-: -[all but Acorn, VM/CMS, MVS, Tandem] allows to extract archive members into -locations outside of the current `` extraction root folder''. For security -reasons, \fIunzip\fP normally removes ``parent dir'' path components -(``../'') from the names of extracted file. This safety feature (new for -version 5.50) prevents \fIunzip\fP from accidentally writing files to -``sensitive'' areas outside the active extraction folder tree head. The -\fB\-:\fP option lets \fIunzip\fP switch back to its previous, more liberal -behaviour, to allow exact extraction of (older) archives that used ``../'' -components to create multiple directory trees at the level of the current -extraction folder. -.PD -.\" ========================================================================= -.SH "ENVIRONMENT OPTIONS" -\fIunzip\fP's default behavior may be modified via options placed in -an environment variable. This can be done with any option, but it -is probably most useful with the \fB\-a\fP, \fB\-L\fP, \fB\-C\fP, \fB\-q\fP, -\fB\-o\fP, or \fB\-n\fP modifiers: make \fIunzip\fP auto-convert text -files by default, make it convert filenames from uppercase systems to -lowercase, make it match names case-insensitively, make it quieter, -or make it always overwrite or never overwrite files as it extracts -them. For example, to make \fIunzip\fP act as quietly as possible, only -reporting errors, one would use one of the following commands: -.TP - Unix Bourne shell: -UNZIP=\-qq; export UNZIP -.TP - Unix C shell: -setenv UNZIP \-qq -.TP - OS/2 or MS-DOS: -set UNZIP=\-qq -.TP - VMS (quotes for \fIlowercase\fP): -define UNZIP_OPTS ""\-qq"" -.PP -Environment options are, in effect, considered to be just like any other -command-line options, except that they are effectively the first options -on the command line. To override an environment option, one may use the -``minus operator'' to remove it. For instance, to override one of the -quiet-flags in the example above, use the command -.PP -.EX -unzip \-\-q[\fIother options\fP] zipfile -.EE -.PP -The first hyphen is the normal -switch character, and the second is a minus sign, acting on the q option. -Thus the effect here is to cancel one quantum of quietness. To cancel -both quiet flags, two (or more) minuses may be used: -.PP -.EX -unzip \-t\-\-q zipfile -unzip \-\-\-qt zipfile -.EE -.PP -(the two are equivalent). This may seem awkward -or confusing, but it is reasonably intuitive: just ignore the first -hyphen and go from there. It is also consistent with the behavior of -Unix \fInice\fP(1). -.PP -As suggested by the examples above, the default variable names are UNZIP_OPTS -for VMS (where the symbol used to install \fIunzip\fP as a foreign command -would otherwise be confused with the environment variable), and UNZIP -for all other operating systems. For compatibility with \fIzip\fP(1L), -UNZIPOPT is also accepted (don't ask). If both UNZIP and UNZIPOPT -are defined, however, UNZIP takes precedence. \fIunzip\fP's diagnostic -option (\fB\-v\fP with no zipfile name) can be used to check the values -of all four possible \fIunzip\fP and \fIzipinfo\fP environment variables. -.PP -The timezone variable (TZ) should be set according to the local timezone -in order for the \fB\-f\fP and \fB\-u\fP to operate correctly. See the -description of \fB\-f\fP above for details. This variable may also be -necessary in order for timestamps on extracted files to be set correctly. -Under Windows 95/NT \fIunzip\fP should know the correct timezone even if -TZ is unset, assuming the timezone is correctly set in the Control Panel. -.PD -.\" ========================================================================= -.SH DECRYPTION -Encrypted archives are fully supported by Info-ZIP software, but due to -United States export restrictions, de-/encryption support might be disabled -in your compiled binary. However, since spring 2000, US export restrictions -have been liberated, and our source archives do now include full crypt code. -In case you need binary distributions with crypt support enabled, see the -file ``WHERE'' in any Info-ZIP source or binary distribution for locations -both inside and outside the US. -.PP -Some compiled versions of \fIunzip\fP may not support decryption. -To check a version for crypt support, either attempt to test or extract -an encrypted archive, or else check \fIunzip\fP's diagnostic -screen (see the \fB\-v\fP option above) for ``\fC[decryption]\fR'' as one -of the special compilation options. -.PP -As noted above, the \fB\-P\fP option may be used to supply a password on -the command line, but at a cost in security. The preferred decryption -method is simply to extract normally; if a zipfile member is encrypted, -\fIunzip\fP will prompt for the password without echoing what is typed. -\fIunzip\fP continues to use the same password as long as it appears to be -valid, by testing a 12-byte header on each file. The correct password will -always check out against the header, but there is a 1-in-256 chance that an -incorrect password will as well. (This is a security feature of the PKWARE -zipfile format; it helps prevent brute-force attacks that might otherwise -gain a large speed advantage by testing only the header.) In the case that -an incorrect password is given but it passes the header test anyway, either -an incorrect CRC will be generated for the extracted data or else \fIunzip\fP -will fail during the extraction because the ``decrypted'' bytes do not -constitute a valid compressed data stream. -.PP -If the first password fails the header check on some file, \fIunzip\fP will -prompt for another password, and so on until all files are extracted. If -a password is not known, entering a null password (that is, just a carriage -return or ``Enter'') is taken as a signal to skip all further prompting. -Only unencrypted files in the archive(s) will thereafter be extracted. (In -fact, that's not quite true; older versions of \fIzip\fP(1L) and -\fIzipcloak\fP(1L) allowed null passwords, so \fIunzip\fP checks each encrypted -file to see if the null password works. This may result in ``false positives'' -and extraction errors, as noted above.) -.PP -Archives encrypted with 8-bit passwords (for example, passwords with accented -European characters) may not be portable across systems and/or other -archivers. This problem stems from the use of multiple encoding methods for -such characters, including Latin-1 (ISO 8859-1) and OEM code page 850. DOS -\fIPKZIP\fP 2.04g uses the OEM code page; Windows \fIPKZIP\fP 2.50 uses -Latin-1 (and is therefore incompatible with DOS \fIPKZIP\fP); Info-ZIP uses -the OEM code page on DOS, OS/2 and Win3.x ports but Latin-1 everywhere -else; and Nico Mak's \fIWinZip\fP 6.x does not allow 8-bit passwords at all. -\fIUnZip\fP 5.3 (or newer) attempts to use the default character set first -(e.g., Latin-1), followed by the alternate one (e.g., OEM code page) to test -passwords. On EBCDIC systems, if both of these fail, EBCDIC encoding will -be tested as a last resort. (EBCDIC is not tested on non-EBCDIC systems, -because there are no known archivers that encrypt using EBCDIC encoding.) -ISO character encodings other than Latin-1 are not supported. -.PD -.\" ========================================================================= -.SH EXAMPLES -To use \fIunzip\fP to extract all members of the archive \fIletters.zip\fP -into the current directory and subdirectories below it, creating any -subdirectories as necessary: -.PP -.EX -unzip letters -.EE -.PP -To extract all members of \fIletters.zip\fP into the current directory only: -.PP -.EX -unzip -j letters -.EE -.PP -To test \fIletters.zip\fP, printing only a summary message indicating -whether the archive is OK or not: -.PP -.EX -unzip -tq letters -.EE -.PP -To test \fIall\fP zipfiles in the current directory, printing only the -summaries: -.PP -.EX -unzip -tq \e*.zip -.EE -.PP -(The backslash before the asterisk is only required if the shell expands -wildcards, as in Unix; double quotes could have been used instead, as in -the source examples below.)\ \ To extract to standard output all members of -\fIletters.zip\fP whose names end in \fI.tex\fP, auto-converting to the -local end-of-line convention and piping the output into \fImore\fP(1): -.PP -.EX -unzip \-ca letters \e*.tex | more -.EE -.PP -To extract the binary file \fIpaper1.dvi\fP to standard output and pipe it -to a printing program: -.PP -.EX -unzip \-p articles paper1.dvi | dvips -.EE -.PP -To extract all FORTRAN and C source files--*.f, *.c, *.h, and Makefile--into -the /tmp directory: -.PP -.EX -unzip source.zip "*.[fch]" Makefile -d /tmp -.EE -.PP -(the double quotes are necessary only in Unix and only if globbing is turned -on). To extract all FORTRAN and C source files, regardless of case (e.g., -both *.c and *.C, and any makefile, Makefile, MAKEFILE or similar): -.PP -.EX -unzip \-C source.zip "*.[fch]" makefile -d /tmp -.EE -.PP -To extract any such files but convert any uppercase MS-DOS or VMS names to -lowercase and convert the line-endings of all of the files to the local -standard (without respect to any files that might be marked ``binary''): -.PP -.EX -unzip \-aaCL source.zip "*.[fch]" makefile -d /tmp -.EE -.PP -To extract only newer versions of the files already in the current -directory, without querying (NOTE: be careful of unzipping in one timezone a -zipfile created in another--ZIP archives other than those created by Zip 2.1 -or later contain no timezone information, and a ``newer'' file from an eastern -timezone may, in fact, be older): -.PP -.EX -unzip \-fo sources -.EE -.PP -To extract newer versions of the files already in the current directory and -to create any files not already there (same caveat as previous example): -.PP -.EX -unzip \-uo sources -.EE -.PP -To display a diagnostic screen showing which \fIunzip\fP and \fIzipinfo\fP -options are stored in environment variables, whether decryption support was -compiled in, the compiler with which \fIunzip\fP was compiled, etc.: -.PP -.EX -unzip \-v -.EE -.PP -In the last five examples, assume that UNZIP or UNZIP_OPTS is set to -q. -To do a singly quiet listing: -.PP -.EX -unzip \-l file.zip -.EE -.PP -To do a doubly quiet listing: -.PP -.EX -unzip \-ql file.zip -.EE -.PP -(Note that the ``\fC.zip\fR'' is generally not necessary.) To do a standard -listing: -.PP -.EX -unzip \-\-ql file.zip -.EE -or -.EX -unzip \-l\-q file.zip -.EE -or -.EX -unzip \-l\-\-q file.zip -.EE -\fR(Extra minuses in options don't hurt.) -.PD -.\" ========================================================================= -.SH TIPS -The current maintainer, being a lazy sort, finds it very useful to define -a pair of aliases: \fCtt\fR for ``\fCunzip \-tq\fR'' and \fCii\fR for -``\fCunzip \-Z\fR'' (or ``\fCzipinfo\fR''). One may then simply type -``\fCtt zipfile\fR'' to test an archive, something that is worth making a -habit of doing. With luck \fIunzip\fP will report ``\fCNo errors detected -in compressed data of zipfile.zip\fR,'' after which one may breathe a sigh -of relief. -.PP -The maintainer also finds it useful to set the UNZIP environment variable -to ``\fC\-aL\fR'' and is tempted to add ``\fC\-C\fR'' as well. His ZIPINFO -variable is set to ``\fC\-z\fR''. -.PD -.\" ========================================================================= -.SH DIAGNOSTICS -The exit status (or error level) approximates the exit codes defined by PKWARE -and takes on the following values, except under VMS: -.RS -.IP 0 -normal; no errors or warnings detected. -.IP 1 -one or more warning errors were encountered, but processing completed -successfully anyway. This includes zipfiles where one or more files -was skipped due to unsupported compression method or encryption with an -unknown password. -.IP 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. -.IP 3 -a severe error in the zipfile format was detected. Processing probably -failed immediately. -.IP 4 -\fIunzip\fP was unable to allocate memory for one or more buffers during -program initialization. -.IP 5 -\fIunzip\fP was unable to allocate memory or unable to obtain a tty to read -the decryption password(s). -.IP 6 -\fIunzip\fP was unable to allocate memory during decompression to disk. -.IP 7 -\fIunzip\fP was unable to allocate memory during in-memory decompression. -.IP 8 -[currently not used] -.IP 9 -the specified zipfiles were not found. -.IP 10 -invalid options were specified on the command line. -.IP 11 -no matching files were found. -.IP 50 -the disk is (or was) full during extraction. -.IP 51 -the end of the ZIP archive was encountered prematurely. -.IP 80 -the user aborted \fIunzip\fP prematurely with control-C (or similar) -.IP 81 -testing or extraction of one or more files failed due to unsupported -compression methods or unsupported decryption. -.IP 82 -no files were found due to bad decryption password(s). (If even one file is -successfully processed, however, the exit status is 1.) -.RE -.PP -VMS interprets standard Unix (or PC) return values as other, scarier-looking -things, so \fIunzip\fP instead maps them into VMS-style status codes. The -current mapping is as follows: 1 (success) for normal exit, 0x7fff0001 -for warning errors, and (0x7fff000? + 16*normal_unzip_exit_status) for all -other errors, where the `?' is 2 (error) for \fIunzip\fP values 2, 9-11 and -80-82, and 4 (fatal error) for the remaining ones (3-8, 50, 51). In addition, -there is a compilation option to expand upon this behavior: defining -RETURN_CODES results in a human-readable explanation of what the error -status means. -.PD -.\" ========================================================================= -.SH BUGS -Multi-part archives are not yet supported, except in conjunction with -\fIzip\fP. (All parts must be concatenated together in order, and then -``\fCzip \-F\fR'' must be performed on the concatenated archive in order -to ``fix'' it.) This will definitely be corrected in the next major release. -.PP -Archives read from standard input are not yet supported, except with -\fIfunzip\fP (and then only the first member of the archive can be extracted). -.PP -Archives encrypted with 8-bit passwords (e.g., passwords with accented -European characters) may not be portable across systems and/or other -archivers. See the discussion in \fBDECRYPTION\fP above. -.PP -\fIunzip\fP's \fB\-M\fP (``more'') option is overly simplistic in its handling -of screen output; as noted above, it fails to detect the wrapping of long lines -and may thereby cause lines at the top of the screen to be scrolled off before -being read. \fIunzip\fP should detect and treat each occurrence of line-wrap -as one additional line printed. This requires knowledge of the screen's width -as well as its height. In addition, \fIunzip\fP should detect the true screen -geometry on all systems. -.PP -Dates, times and permissions of stored directories are not restored except -under Unix. -.PP -[MS-DOS] When extracting or testing files from an archive on a defective -floppy diskette, if the ``Fail'' option is chosen from DOS's ``Abort, Retry, -Fail?'' message, older versions of \fIunzip\fP may hang the system, requiring -a reboot. This problem appears to be fixed, but control-C (or control-Break) -can still be used to terminate \fIunzip\fP. -.PP -Under DEC Ultrix, \fIunzip\fP would sometimes fail on long zipfiles (bad CRC, -not always reproducible). This was apparently due either to a hardware bug -(cache memory) or an operating system bug (improper handling of page faults?). -Since Ultrix has been abandoned in favor of Digital Unix (OSF/1), this may not -be an issue anymore. -.PP -[Unix] Unix special files such as FIFO buffers (named pipes), block devices -and character devices are not restored even if they are somehow represented -in the zipfile, nor are hard-linked files relinked. Basically the only file -types restored by \fIunzip\fP are regular files, directories and symbolic -(soft) links. -.PP -[OS/2] Extended attributes for existing directories are only updated if the -\fB\-o\fP (``overwrite all'') option is given. This is a limitation of the -operating system; because directories only have a creation time associated -with them, \fIunzip\fP has no way to determine whether the stored attributes -are newer or older than those on disk. In practice this may mean a two-pass -approach is required: first unpack the archive normally (with or without -freshening/updating existing files), then overwrite just the directory entries -(e.g., ``\fCunzip -o foo */\fR''). -.PP -[VMS] When extracting to another directory, only the \fI[.foo]\fP syntax is -accepted for the \fB\-d\fP option; the simple Unix \fIfoo\fP syntax is -silently ignored (as is the less common VMS \fIfoo.dir\fP syntax). -.PP -[VMS] When the file being extracted already exists, \fIunzip\fP's query only -allows skipping, overwriting or renaming; there should additionally be a -choice for creating a new version of the file. In fact, the ``overwrite'' -choice does create a new version; the old version is not overwritten or -deleted. -.PD -.\" ========================================================================= -.SH "SEE ALSO" -\fIfunzip\fP(1L), \fIzip\fP(1L), \fIzipcloak\fP(1L), \fIzipgrep\fP(1L), -\fIzipinfo\fP(1L), \fIzipnote\fP(1L), \fIzipsplit\fP(1L) -.PD -.\" ========================================================================= -.SH URL -The Info-ZIP home page is currently at -.EX -\fChttp://www.info-zip.org/pub/infozip/\fR -.EE -or -.EX -\fCftp://ftp.info-zip.org/pub/infozip/\fR . -.EE -.PD -.\" ========================================================================= -.SH AUTHORS -The primary Info-ZIP authors (current semi-active members of the Zip-Bugs -workgroup) are: Greg ``Cave Newt'' Roelofs (UnZip); Onno van der Linden (Zip); -Jean-loup Gailly (compression); Mark Adler (decompression, fUnZip); Christian -Spieler (UnZip maintance coordination, VMS, MS-DOS, Windows 95, NT, -shared code, general Zip and UnZip integration and optimization); -Mike White (Windows GUI, Windows DLLs); Kai Uwe Rommel (OS/2); -Paul Kienitz (Amiga, Windows 95); Chris Herborth (BeOS, QNX, Atari); -Jonathan Hudson (SMS/QDOS); Sergio Monesi (Acorn RISC OS); Harald -Denker (Atari, MVS); John Bush (Solaris, Amiga); Hunter Goatley (VMS); Steve -Salisbury (Windows 95, NT); Steve Miller (Windows CE GUI), Johnny Lee (MS-DOS, -Windows 95, NT); and Dave Smith (Tandem NSK). -The author of the original unzip code upon which Info-ZIP's was based -is Samuel H. Smith; Carl Mascott did the first Unix port; and David P. -Kirschbaum organized and led Info-ZIP in its early days with Keith Petersen -hosting the original mailing list at WSMR-SimTel20. The full list of -contributors to UnZip has grown quite large; please refer to the CONTRIBS -file in the UnZip source distribution for a relatively complete version. -.PD -.\" ========================================================================= -.SH VERSIONS -.ta \w'vx.xxnn'u +\w'fall 1989'u+3n -.PD 0 -.IP "v1.2\t15 Mar 89" \w'\t\t'u -Samuel H. Smith -.IP "v2.0\t\ 9 Sep 89" -Samuel H. Smith -.IP "v2.x\tfall 1989" -many Usenet contributors -.IP "v3.0\t\ 1 May 90" -Info-ZIP (DPK, consolidator) -.IP "v3.1\t15 Aug 90" -Info-ZIP (DPK, consolidator) -.IP "v4.0\t\ 1 Dec 90" -Info-ZIP (GRR, maintainer) -.IP "v4.1\t12 May 91" -Info-ZIP -.IP "v4.2\t20 Mar 92" -Info-ZIP (Zip-Bugs subgroup, GRR) -.IP "v5.0\t21 Aug 92" -Info-ZIP (Zip-Bugs subgroup, GRR) -.IP "v5.01\t15 Jan 93" -Info-ZIP (Zip-Bugs subgroup, GRR) -.IP "v5.1\t\ 7 Feb 94" -Info-ZIP (Zip-Bugs subgroup, GRR) -.IP "v5.11\t\ 2 Aug 94" -Info-ZIP (Zip-Bugs subgroup, GRR) -.IP "v5.12\t28 Aug 94" -Info-ZIP (Zip-Bugs subgroup, GRR) -.IP "v5.2\t30 Apr 96" -Info-ZIP (Zip-Bugs subgroup, GRR) -.IP "v5.3\t22 Apr 97" -Info-ZIP (Zip-Bugs subgroup, GRR) -.IP "v5.31\t31 May 97" -Info-ZIP (Zip-Bugs subgroup, GRR) -.IP "v5.32\t\ 3 Nov 97" -Info-ZIP (Zip-Bugs subgroup, GRR) -.IP "v5.4\t28 Nov 98" -Info-ZIP (Zip-Bugs subgroup, SPC) -.IP "v5.41\t16 Apr 00" -Info-ZIP (Zip-Bugs subgroup, SPC) -.IP "v5.42\t14 Jan 01" -Info-ZIP (Zip-Bugs subgroup, SPC) -.IP "v5.5\t17 Feb 02" -Info-ZIP (Zip-Bugs subgroup, SPC) -.PD diff --git a/src/apps/bin/unzip/man/unzipsfx.1 b/src/apps/bin/unzip/man/unzipsfx.1 deleted file mode 100644 index 6970a1cf33..0000000000 --- a/src/apps/bin/unzip/man/unzipsfx.1 +++ /dev/null @@ -1,336 +0,0 @@ -.\" Copyright (c) 1990-2002 Info-ZIP. All rights reserved. -.\" -.\" See the accompanying file LICENSE, version 2000-Apr-09 or later -.\" (the contents of which are also included in unzip.h) for terms of use. -.\" If, for some reason, all these files are missing, the Info-ZIP license -.\" also may be found at: ftp://ftp.info-zip.org/pub/infozip/license.html -.\" -.\" unzipsfx.1 by Greg Roelofs -.\" -.\" ========================================================================= -.\" define .EX/.EE (for multiline user-command examples; normal Courier font) -.de EX -.in +4n -.nf -.ft CW -.. -.de EE -.ft R -.fi -.in -4n -.. -.\" ========================================================================= -.TH UNZIPSFX 1L "17 February 2002 (v5.5)" "Info-ZIP" -.SH NAME -unzipsfx \- self-extracting stub for prepending to ZIP archives -.PD -.SH SYNOPSIS -\fB\fP [\fB\-cfptuz\fP[\fBajnoqsCLV$\fP]] -[\fIfile(s)\fP\ .\|.\|. [\fB\-x\fP\ \fIxfile(s)\fP\ .\|.\|.]] -.PD -.\" ========================================================================= -.SH DESCRIPTION -\fIunzipsfx\fP is a modified version of \fIunzip\fP(1L) designed to be -prepended to existing ZIP archives in order to form self-extracting archives. -Instead of taking its first non-flag argument to be the zipfile(s) to be -extracted, \fIunzipsfx\fP seeks itself under the name by which it was invoked -and tests or extracts the contents of the appended archive. Because the -executable stub adds bulk to the archive (the whole purpose of which is to -be as small as possible), a number of the less-vital capabilities in regular -\fIunzip\fP have been removed. Among these are the usage (or help) screen, -the listing and diagnostic functions (\fB\-l\fP and \fB\-v\fP), the ability -to decompress older compression formats (the ``reduce,'' ``shrink'' and -``implode'' methods). The ability to extract to a directory other than -the current one can be selected as a compile-time option, which is now enabled -by default since UnZipSFX version 5.5. Similary, decryption is supported as -a compile-time option but should be avoided unless the attached archive -contains encrypted files. Starting with release 5.5, another compile-time -option adds a simple ``run command after extraction'' feature. This feature -is currently incompatible with the ``extract to different directory'' -feature and remains disabled by default. -.PP -\fBNote that -self-extracting archives made with\fP \fIunzipsfx\fP \fBare no more (or less) -portable across different operating systems than is -the\fP \fIunzip\fP \fBexecutable itself.\fP In general a self-extracting -archive made on -a particular Unix system, for example, will only self-extract under the same -flavor of Unix. Regular \fIunzip\fP may still be used to extract the -embedded archive as with any normal zipfile, although it will generate -a harmless warning about extra bytes at the beginning of the zipfile. -\fIDespite this\fP, however, the self-extracting archive is technically -\fInot\fP a valid ZIP archive, and PKUNZIP may be unable to test or extract -it. This limitation is due to the simplistic manner in which the archive -is created; the internal directory structure is not updated to reflect the -extra bytes prepended to the original zipfile. -.PD -.\" ========================================================================= -.SH ARGUMENTS -.IP [\fIfile(s)\fP] -An optional list of archive members to be processed. -Regular expressions (wildcards) similar to those in Unix \fIegrep\fP(1) -may be used to match multiple members. These wildcards may contain: -.RS -.IP * -matches a sequence of 0 or more characters -.IP ? -matches exactly 1 character -.IP [.\|.\|.] -matches any single character found inside the brackets; ranges are specified -by a beginning character, a hyphen, and an ending character. If an exclamation -point or a caret (`!' or `^') follows the left bracket, then the range of -characters within the brackets is complemented (that is, anything \fIexcept\fP -the characters inside the brackets is considered a match). -.RE -.IP -(Be sure to quote any character that might otherwise be interpreted or -modified by the operating system, particularly under Unix and VMS.) -.IP [\fB\-x\fP\ \fIxfile(s)\fP] -An optional list of archive members to be excluded from processing. -Since wildcard characters match directory separators (`/'), this option -may be used to exclude any files that are in subdirectories. For -example, ``\fCfoosfx *.[ch] -x */*\fR'' would extract all C source files -in the main directory, but none in any subdirectories. Without the \fB\-x\fP -option, all C source files in all directories within the zipfile would be -extracted. -.PP -If \fIunzipsfx\fP is compiled with SFX_EXDIR defined, the following option -is also enabled: -.IP [\fB\-d\fP\ \fIexdir\fP] -An optional directory to which to extract files. By default, all files -and subdirectories are recreated in the current directory; the \fB\-d\fP -option allows extraction in an arbitrary directory (always assuming one -has permission to write to the directory). The option and directory may -be concatenated without any white space between them, but note that this -may cause normal shell behavior to be suppressed. In particular, -``\fC\-d\ ~\fR'' (tilde) is expanded by Unix C shells into the name -of the user's home directory, but ``\fC\-d~\fR'' is treated as a -literal subdirectory ``\fB~\fP'' of the current directory. -.PD -.\" ========================================================================= -.SH OPTIONS -\fIunzipsfx\fP supports the following \fIunzip\fP(1L) options: \fB\-c\fP -and \fB\-p\fP (extract to standard output/screen), \fB\-f\fP and \fB\-u\fP -(freshen and update existing files upon extraction), \fB\-t\fP (test -archive) and \fB\-z\fP (print archive comment). All normal listing options -(\fB\-l\fP, \fB\-v\fP and \fB\-Z\fP) have been removed, but the testing -option (\fB\-t\fP) may be used as a ``poor man's'' listing. Alternatively, -those creating self-extracting archives may wish to include a short listing -in the zipfile comment. -.PP -See \fIunzip\fP(1L) for a more complete description of these options. -.PD -.\" ========================================================================= -.SH MODIFIERS -\fIunzipsfx\fP currently supports all \fIunzip\fP(1L) modifiers: \fB\-a\fP -(convert text files), \fB\-n\fP (never overwrite), \fB\-o\fP (overwrite -without prompting), \fB\-q\fP (operate quietly), \fB\-C\fP (match names -case-insensitively), \fB\-L\fP (convert uppercase-OS names to lowercase), -\fB\-j\fP (junk paths) and \fB\-V\fP (retain version numbers); plus the -following operating-system specific options: \fB\-X\fP (restore VMS -owner/protection info), \fB\-s\fP (convert spaces in filenames to underscores -[DOS, OS/2, NT]) and \fB\-$\fP (restore volume label [DOS, OS/2, NT, Amiga]). -.PP -(Support for regular ASCII text-conversion may be removed in future versions, -since it is simple enough for the archive's creator to ensure that text -files have the appropriate format for the local OS. EBCDIC conversion will -of course continue to be supported since the zipfile format implies ASCII -storage of text files.) -.PP -See \fIunzip\fP(1L) for a more complete description of these modifiers. -.PD -.\" ========================================================================= -.SH "ENVIRONMENT OPTIONS" -\fIunzipsfx\fP uses the same environment variables as \fIunzip\fP(1L) does, -although this is likely to be an issue only for the person creating and -testing the self-extracting archive. See \fIunzip\fP(1L) for details. -.PD -.\" ========================================================================= -.SH DECRYPTION -Decryption is supported exactly as in \fIunzip\fP(1L); that is, interactively -with a non-echoing prompt for the password(s). See \fIunzip\fP(1L) for -details. Once again, note that if the archive has no encrypted files there -is no reason to use a version of \fIunzipsfx\fP with decryption support; -that only adds to the size of the archive. -.PD -.\" ========================================================================= -.SH AUTORUN COMMAND -When \fIunzipsfx\fP was compiled with CHEAP_SFX_AUTORUN defined, a simple -``command autorun'' feature is supported. You may enter a command into the -Zip archive comment, using the following format: -.PP -.EX -$AUTORUN$>[command line string] -.EE -.PP -When \fIunzipsfx\P recognizes the ``$AUTORUN$>'' token at the beginning -of the Zip archive comment, the remainder of the first line of the comment -(until the first newline character) is passed as a shell command to the -operating system using the C rtl ``system'' function. Before executing -the command, \fIunzipsfx\P displays the command on the console and prompts -the user for confirmation. When the user has switched off prompting by -specifying the \fB-q\fP option, autorun commands are never executed. -.PP -In case the archive comment contains additonal lines of text, the remainder -of the archive comment following the first line is displayed normally, unless -quiet operation was requested by supplying a \fB-q\fP option. -.PD -.\" ========================================================================= -.SH EXAMPLES -To create a self-extracting archive \fIletters\fP from a regular zipfile -\fIletters.zip\fP and change the new archive's permissions to be -world-executable under Unix: -.PP -.EX -cat unzipsfx letters.zip > letters -chmod 755 letters -zip -A letters -.EE -.PP -To create the same archive under MS-DOS, OS/2 or NT (note the use of the -\fB/b\fP [binary] option to the \fIcopy\fP command): -.PP -.EX -copy /b unzipsfx.exe+letters.zip letters.exe -zip -A letters.exe -.EE -.PP -Under VMS: -.PP -.EX -copy unzipsfx.exe,letters.zip letters.exe -letters == "$currentdisk:[currentdir]letters.exe" -zip -A letters.exe -.EE -.PP -(The VMS \fIappend\fP command may also be used. The second command installs -the new program as a ``foreign command'' capable of taking arguments. The -third line assumes that Zip is already installed as a foreign command.) -Under AmigaDOS: -.PP -.EX -MakeSFX letters letters.zip UnZipSFX -.EE -.PP -(MakeSFX is included with the UnZip source distribution and with Amiga -binary distributions. ``\fCzip -A\fR'' doesn't work on Amiga self-extracting -archives.) -To test (or list) the newly created self-extracting archive: -.PP -.EX -letters \-t -.EE -.PP -To test \fIletters\fP quietly, printing only a summary message indicating -whether the archive is OK or not: -.PP -.EX -letters \-tqq -.EE -.PP -To extract the complete contents into the current directory, recreating all -files and subdirectories as necessary: -.PP -.EX -letters -.EE -.PP -To extract all \fC*.txt\fR files (in Unix quote the `*'): -.PP -.EX -letters *.txt -.EE -.PP -To extract everything \fIexcept\fP the \fC*.txt\fR files: -.PP -.EX -letters -x *.txt -.EE -.PP -To extract only the README file to standard output (the screen): -.PP -.EX -letters -c README -.EE -.PP -To print only the zipfile comment: -.PP -.EX -letters \-z -.EE -.PD -.\" ========================================================================= -.SH LIMITATIONS -The principle and fundamental limitation of \fIunzipsfx\fP is that it is -not portable across architectures or operating systems, and therefore -neither are the resulting archives. For some architectures there is -limited portability, however (e.g., between some flavors of Intel-based Unix). -.PP -Another problem with the current implementation is that any archive -with ``junk'' prepended to the beginning technically is no longer a zipfile -(unless \fIzip\fP(1) is used to adjust the zipfile offsets appropriately, -as noted above). \fIunzip\fP(1) takes note of the prepended bytes -and ignores them since some file-transfer protocols, notably MacBinary, are -also known to prepend junk. But PKWARE's archiver suite may not be able to -deal with the modified archive unless its offsets have been adjusted. -.PP -\fIunzipsfx\fP has no knowledge of the user's PATH, so in general an archive -must either be in the current directory when it is invoked, or else a full -or relative path must be given. If a user attempts to extract the archive -from a directory in the PATH other than the current one, \fIunzipsfx\fP will -print a warning to the effect, ``can't find myself.'' This is always true -under Unix and may be true in some cases under MS-DOS, depending on the -compiler used (Microsoft C fully qualifies the program name, but other -compilers may not). Under OS/2 and NT there are operating-system calls -available that provide the full path name, so the archive may be invoked -from anywhere in the user's path. The situation is not known for AmigaDOS, -Atari TOS, MacOS, etc. -.PP -As noted above, a number of the normal \fIunzip\fP(1L) functions have -been removed in order to make \fIunzipsfx\fP smaller: usage and diagnostic -info, listing functions and extraction to other directories. Also, only -stored and deflated files are supported. The latter limitation is mainly -relevant to those who create SFX archives, however. -.PP -VMS users must know how to set up self-extracting archives as foreign -commands in order to use any of \fIunzipsfx\fP's options. This is not -necessary for simple extraction, but the command to do so then becomes, -e.g., ``\fCrun letters\fR'' (to continue the examples given above). -.PP -\fIunzipsfx\fP on the Amiga requires the use of a special program, MakeSFX, -in order to create working self-extracting archives; simple concatenation -does not work. (For technically oriented users, the attached archive is -defined as a ``debug hunk.'') There may be compatibility problems between -the ROM levels of older Amigas and newer ones. -.PP -All current bugs in \fIunzip\fP(1L) exist in \fIunzipsfx\fP as well. -.PD -.\" ========================================================================= -.SH DIAGNOSTICS -\fIunzipsfx\fP's exit status (error level) is identical to that of -\fIunzip\fP(1L); see the corresponding man page. -.PD -.\" ========================================================================= -.SH "SEE ALSO" -\fIfunzip\fP(1L), \fIunzip\fP(1L), \fIzip\fP(1L), \fIzipcloak\fP(1L), -\fIzipgrep\fP(1L), \fIzipinfo\fP(1L), \fIzipnote\fP(1L), \fIzipsplit\fP(1L) -.PD -.PD -.\" ========================================================================= -.SH URL -The Info-ZIP home page is currently at -.EX -\fChttp://www.info-zip.org/pub/infozip/\fR -.EE -or -.EX -\fCftp://ftp.info-zip.org/pub/infozip/\fR . -.EE -.PD -.\" ========================================================================= -.SH AUTHORS -Greg Roelofs was responsible for the basic modifications to UnZip necessary -to create UnZipSFX. See \fIunzip\fP(1L) for the current list of Zip-Bugs -authors, or the file CONTRIBS in the UnZip source distribution for the -full list of Info-ZIP contributors. -.PD diff --git a/src/apps/bin/unzip/man/zipgrep.1 b/src/apps/bin/unzip/man/zipgrep.1 deleted file mode 100644 index 4122aef52a..0000000000 --- a/src/apps/bin/unzip/man/zipgrep.1 +++ /dev/null @@ -1,89 +0,0 @@ -.\" Copyright (c) 1990-2002 Info-ZIP. All rights reserved. -.\" -.\" See the accompanying file LICENSE, version 2000-Apr-09 or later -.\" (the contents of which are also included in unzip.h) for terms of use. -.\" If, for some reason, all these files are missing, the Info-ZIP license -.\" also may be found at: ftp://ftp.info-zip.org/pub/infozip/license.html -.\" -.\" zipgrep.1 by Greg Roelofs. -.\" -.\" ========================================================================= -.TH ZIPGREP 1L "17 February 2002" "Info-ZIP" -.SH NAME -zipgrep \- search files in a ZIP archive for lines matching a pattern -.PD -.SH SYNOPSIS -\fBzipgrep\fP [\fBegrep_options\fP] \fIpattern\fP -\fIfile\fP[\fI.zip\fP] [\fIfile(s)\fP\ .\|.\|.] -[\fB\-x\fP\ \fIxfile(s)\fP\ .\|.\|.] -.PD -.\" ========================================================================= -.SH DESCRIPTION -\fIzipgrep\fP will search files within a ZIP archive for lines matching -the given string or pattern. \fIzipgrep\fP is a shell script and requires -\fIegrep\fP(1) and \fIunzip\fP(1L) to function. Its output is identical to -that of \fIegrep\fP(1). -.PD -.\" ========================================================================= -.SH ARGUMENTS -.TP -.IP \fIpattern\fP -The pattern to be located within a ZIP archive. Any string or regular -expression accepted by \fIegrep\fP(1) may be used. -.IR file [ .zip ] -Path of the ZIP archive. (Wildcard expressions for the ZIP archive name are -not supported.) If the literal filename is not found, the suffix \fC.zip\fR -is appended. Note that self-extracting ZIP files are supported, as with any -other ZIP archive; just specify the \fC.exe\fR suffix (if any) explicitly. -.IP [\fIfile(s)\fP] -An optional list of archive members to be processed, separated by spaces. -If no member files are specified, all members of the ZIP archive are searched. -Regular expressions (wildcards) may be used to match multiple members: -.RS -.IP * -matches a sequence of 0 or more characters -.IP ? -matches exactly 1 character -.IP [.\|.\|.] -matches any single character found inside the brackets; ranges are specified -by a beginning character, a hyphen, and an ending character. If an exclamation -point or a caret (`!' or `^') follows the left bracket, then the range of -characters within the brackets is complemented (that is, anything \fIexcept\fP -the characters inside the brackets is considered a match). -.RE -.IP -(Be sure to quote any character that might otherwise be interpreted or -modified by the operating system.) -.IP [\fB\-x\fP\ \fIxfile(s)\fP] -An optional list of archive members to be excluded from processing. -Since wildcard characters match directory separators (`/'), this option -may be used to exclude any files that are in subdirectories. For -example, ``\fCzipgrep grumpy foo *.[ch] -x */*\fR'' would search for the -string ``grumpy'' in all C source files in the main directory of the ``foo'' -archive, but none in any subdirectories. Without the \fB\-x\fP -option, all C source files in all directories within the zipfile would be -searched. -.\" ========================================================================= -.SH OPTIONS -All options prior to the ZIP archive filename are passed to \fIegrep\fP(1). -.PD -.\" ========================================================================= -.SH "SEE ALSO" -\fIegrep\fP(1), \fIunzip\fP(1L), \fIzip\fP(1L), \fIfunzip\fP(1L), -\fIzipcloak\fP(1L), \fIzipinfo\fP(1L), \fIzipnote\fP(1L), \fIzipsplit\fP(1L) -.PD -.\" ========================================================================= -.SH URL -The Info-ZIP home page is currently at -.EX -\fChttp://www.info-zip.org/pub/infozip/\fR -.EE -or -.EX -\fCftp://ftp.info-zip.org/pub/infozip/\fR . -.EE -.PD -.\" ========================================================================= -.SH AUTHORS -\fIzipgrep\fP was written by Jean-loup Gailly. -.PD diff --git a/src/apps/bin/unzip/man/zipinfo.1 b/src/apps/bin/unzip/man/zipinfo.1 deleted file mode 100644 index eca6307fe1..0000000000 --- a/src/apps/bin/unzip/man/zipinfo.1 +++ /dev/null @@ -1,488 +0,0 @@ -.\" Copyright (c) 1990-2002 Info-ZIP. All rights reserved. -.\" -.\" See the accompanying file LICENSE, version 2000-Apr-09 or later -.\" (the contents of which are also included in unzip.h) for terms of use. -.\" If, for some reason, all these files are missing, the Info-ZIP license -.\" also may be found at: ftp://ftp.info-zip.org/pub/infozip/license.html -.\" -.\" zipinfo.1 by Greg Roelofs and others. -.\" -.\" ========================================================================= -.\" define .X macro (for long-line ZipInfo output examples; small Courier): -.de X -.nf -.ft CW -.ie n .ti -5 -.el \{ .ti +2m -.ps -1 \} -\&\\$1 -.ie n .ti +5 -.el \{ .ti -2m -.ps +1 \} -.ft -.fi -.. -.\" define .EX/.EE (for multiline user-command examples; normal Courier font) -.de EX -.in +4n -.nf -.ft CW -.. -.de EE -.ft -.fi -.in -4n -.. -.\" ========================================================================= -.TH ZIPINFO 1L "17 February 2002 (v2.4)" "Info-ZIP" -.SH NAME -zipinfo \- list detailed information about a ZIP archive -.PD -.SH SYNOPSIS -\fBzipinfo\fP [\fB\-12smlvhMtTz\fP] \fIfile\fP[\fI.zip\fP] -[\fIfile(s)\fP\ .\|.\|.] [\fB\-x\fP\ \fIxfile(s)\fP\ .\|.\|.] -.PP -\fBunzip\fP \fB\-Z\fP [\fB\-12smlvhMtTz\fP] \fIfile\fP[\fI.zip\fP] -[\fIfile(s)\fP\ .\|.\|.] [\fB\-x\fP\ \fIxfile(s)\fP\ .\|.\|.] -.PD -.\" ========================================================================= -.SH DESCRIPTION -\fIzipinfo\fP lists technical information about files in a ZIP archive, most -commonly found on MS-DOS systems. Such information includes file access -permissions, encryption status, type of compression, version and operating -system or file system of compressing program, and the like. The default -behavior (with no options) is -to list single-line entries for each file in the archive, with header and -trailer lines providing summary information for the entire archive. The -format is a cross between Unix ``\fCls \-l\fR'' and ``\fCunzip \-v\fR'' -output. See -.B "DETAILED DESCRIPTION" -below. Note that \fIzipinfo\fP is the same program as \fIunzip\fP (under -Unix, a link to it); on some systems, however, \fIzipinfo\fP support may -have been omitted when \fIunzip\fP was compiled. -.PD -.\" ========================================================================= -.SH ARGUMENTS -.TP -.IR file [ .zip ] -Path of the ZIP archive(s). If the file specification is a wildcard, -each matching file is processed in an order determined by the operating -system (or file system). Only the filename can be a wildcard; the path -itself cannot. Wildcard expressions are similar to Unix \fIegrep\fP(1) -(regular) expressions and may contain: -.RS -.IP * -matches a sequence of 0 or more characters -.IP ? -matches exactly 1 character -.IP [.\|.\|.] -matches any single character found inside the brackets; ranges are specified -by a beginning character, a hyphen, and an ending character. If an exclamation -point or a caret (`!' or `^') follows the left bracket, then the range of -characters within the brackets is complemented (that is, anything \fIexcept\fP -the characters inside the brackets is considered a match). -.RE -.IP -(Be sure to quote any character that might otherwise be interpreted or -modified by the operating system, particularly under Unix and VMS.) If no -matches are found, the specification is assumed to be a literal filename; -and if that also fails, the suffix \fC.zip\fR is appended. Note that -self-extracting ZIP files are supported; just specify the \fC.exe\fR suffix -(if any) explicitly. -.IP [\fIfile(s)\fP] -An optional list of archive members to be processed. -Regular expressions (wildcards) may be used to match multiple members; see -above. Again, be sure to quote expressions that would otherwise be expanded -or modified by the operating system. -.IP [\fB\-x\fP\ \fIxfile(s)\fP] -An optional list of archive members to be excluded from processing. -.\" ========================================================================= -.SH OPTIONS -.TP -.B \-1 -list filenames only, one per line. This option excludes all others; headers, -trailers and zipfile comments are never printed. It is intended for use in -Unix shell scripts. -.TP -.B \-2 -list filenames only, one per line, but allow headers (\fB\-h\fP), trailers -(\fB\-t\fP) and zipfile comments (\fB\-z\fP), as well. This option may be -useful in cases where the stored filenames are particularly long. -.TP -.B \-s -list zipfile info in short Unix ``\fCls \-l\fR'' format. This is the default -behavior; see below. -.TP -.B \-m -list zipfile info in medium Unix ``\fCls \-l\fR'' format. Identical to the -\fB\-s\fP output, except that the compression factor, expressed as a -percentage, is also listed. -.TP -.B \-l -list zipfile info in long Unix ``\fCls \-l\fR'' format. As with \fB\-m\fP -except that the compressed size (in bytes) is printed instead of the -compression ratio. -.TP -.B \-v -list zipfile information in verbose, multi-page format. -.TP -.B \-h -list header line. The archive name, actual size (in bytes) and total number -of files is printed. -.TP -.B \-M -pipe all output through an internal pager similar to the Unix \fImore\fP(1) -command. At the end of a screenful of output, \fIzipinfo\fP pauses with a -``\-\-More\-\-'' prompt; the next screenful may be viewed by pressing the -Enter (Return) key or the space bar. \fIzipinfo\fP can be terminated by -pressing the ``q'' key and, on some systems, the Enter/Return key. Unlike -Unix \fImore\fP(1), there is no forward-searching or editing capability. -Also, \fIzipinfo\fP doesn't notice if long lines wrap at the edge of the -screen, effectively resulting in the printing of two or more lines and the -likelihood that some text will scroll off the top of the screen before being -viewed. On some systems the number of available lines on the screen is not -detected, in which case \fIzipinfo\fP assumes the height is 24 lines. -.TP -.B \-t -list totals for files listed or for all files. The number of files listed, -their uncompressed and compressed total sizes, and their overall compression -factor is printed; or, if only the totals line is being printed, the values -for the entire archive are given. Note that the total compressed (data) -size will never match the actual zipfile size, since the latter includes all -of the internal zipfile headers in addition to the compressed data. -.TP -.B \-T -print the file dates and times in a sortable decimal format (yymmdd.hhmmss). -The default date format is a more standard, human-readable version with -abbreviated month names (see examples below). -.TP -.B \-z -include the archive comment (if any) in the listing. -.PD -.\" ========================================================================= -.SH "DETAILED DESCRIPTION" -.I zipinfo -has a number of modes, and its behavior can be rather difficult to fathom -if one isn't familiar with Unix \fIls\fP(1) (or even if one is). The default -behavior is to list files in the following format: -.PP -.X "-rw-rws--- 1.9 unx 2802 t- defX 11-Aug-91 13:48 perms.2660" -.PP -The last three fields are the modification date and time of -the file, and its name. The case of the filename is respected; thus -files that come from MS-DOS PKZIP are always capitalized. If the file -was zipped with a stored directory name, that is also displayed as part -of the filename. -.PP -The second and third fields indicate that the file was zipped under -Unix with version 1.9 of \fIzip\fP. Since it comes from Unix, the file -permissions at the beginning of the line are printed in Unix format. -The uncompressed file-size (2802 in this example) is the fourth field. -.PP -The fifth field consists of two characters, either of which may take -on several values. The first character may be either `t' or `b', indicating -that \fIzip\fP believes the file to be text or binary, respectively; -but if the file is encrypted, \fIzipinfo\fP -notes this fact by capitalizing the character (`T' or `B'). The second -character may also take on four values, depending on whether there is -an extended local header and/or an ``extra field'' associated with the -file (fully explained in PKWare's APPNOTE.TXT, but basically analogous to -pragmas in ANSI C--i.e., they provide a standard way to include non-standard -information in the archive). If neither exists, the character -will be a hyphen (`\-'); if there is an extended local header but no extra -field, `l'; if the reverse, `x'; and if both exist, `X'. Thus the -file in this example is (probably) a text file, is not encrypted, and -has neither an extra field nor an extended local header associated with it. -The example below, on the other hand, is an encrypted binary file with an -extra field: -.PP -.X "RWD,R,R 0.9 vms 168 Bx shrk 9-Aug-91 19:15 perms.0644" -.PP -Extra fields are used for various purposes (see discussion of the \fB\-v\fP -option below) including the storage of VMS file attributes, which is -presumably the case here. Note that the file attributes are listed in -VMS format. Some other possibilities for the host operating system (which -is actually a misnomer--host file system is more correct) include -OS/2 or NT with High Performance File System (HPFS), MS-DOS, OS/2 or NT -with File Allocation Table (FAT) file system, and Macintosh. These are -denoted as follows: -.PP -.X "-rw-a-- 1.0 hpf 5358 Tl i4:3 4-Dec-91 11:33 longfilename.hpfs" -.X "-r--ahs 1.1 fat 4096 b- i4:2 14-Jul-91 12:58 EA DATA. SF" -.X "--w------- 1.0 mac 17357 bx i8:2 4-May-92 04:02 unzip.macr" -.PP -File attributes in the first two cases are indicated in a Unix-like format, -where the seven subfields indicate whether the file: (1) is a directory, -(2) is readable (always true), (3) is writable, (4) is executable (guessed -on the basis of the extension--\fI.exe\fP, \fI.com\fP, \fI.bat\fP, \fI.cmd\fP -and \fI.btm\fP files are assumed to be so), (5) has its archive bit set, -(6) is hidden, and (7) is a system file. Interpretation of Macintosh file -attributes is unreliable because some Macintosh archivers don't store any -attributes in the archive. -.PP -Finally, the sixth field indicates -the compression method and possible sub-method used. There are six methods -known at present: storing (no compression), reducing, shrinking, imploding, -tokenizing (never publicly released), and deflating. In addition, there are -four levels of reducing (1 through 4); four types of imploding (4K or 8K -sliding dictionary, and 2 or 3 Shannon-Fano trees); and four levels of -deflating (superfast, fast, normal, maximum compression). \fIzipinfo\fP -represents these methods and their sub-methods as follows: \fIstor\fP; -\fIre:1\fP, \fIre:2\fP, etc.; \fIshrk\fP; \fIi4:2\fP, \fIi8:3\fP, etc.; -\fItokn\fP; and \fIdefS\fP, \fIdefF\fP, \fIdefN\fP, and \fIdefX\fP. -.PP -The medium and long listings are almost identical to the short format except -that they add information on the file's compression. The medium format lists -the file's compression factor as a percentage indicating the amount of space -that has been ``removed'': -.PP -.X "-rw-rws--- 1.5 unx 2802 t- 81% defX 11-Aug-91 13:48 perms.2660" -.PP -In this example, the file has been compressed by more than a factor of -five; the compressed data are only 19% of the original size. The long -format gives the compressed file's size in bytes, instead: -.PP -.X "-rw-rws--- 1.5 unx 2802 t- 538 defX 11-Aug-91 13:48 perms.2660" -.PP -Adding the \fB\-T\fP option changes the file date and time to decimal -format: -.PP -.X "-rw-rws--- 1.5 unx 2802 t- 538 defX 910811.134804 perms.2660" -.PP -Note that because of limitations in the MS-DOS format used to store file -times, the seconds field is always rounded to the nearest even second. -For Unix files this is expected to change in the next major releases of -\fIzip\fP(1L) and \fIunzip\fP. -.PP -In addition to individual file information, a default zipfile listing -also includes header and trailer lines: -.PP -.X "Archive: OS2.zip 5453 bytes 5 files" -.X ",,rw, 1.0 hpf 730 b- i4:3 26-Jun-92 23:40 Contents" -.X ",,rw, 1.0 hpf 3710 b- i4:3 26-Jun-92 23:33 makefile.os2" -.X ",,rw, 1.0 hpf 8753 b- i8:3 26-Jun-92 15:29 os2unzip.c" -.X ",,rw, 1.0 hpf 98 b- stor 21-Aug-91 15:34 unzip.def" -.X ",,rw, 1.0 hpf 95 b- stor 21-Aug-91 17:51 zipinfo.def" -.X "5 files, 13386 bytes uncompressed, 4951 bytes compressed: 63.0%" -.PP -The header line gives the name of the archive, its total size, and the -total number of files; the trailer gives the number of files listed, -their total uncompressed size, and their total compressed size (not -including any of \fIzip\fP's internal overhead). If, however, one or -more \fIfile(s)\fP are provided, the header and trailer lines are -not listed. This behavior is also similar to that of Unix's ``\fCls \-l\fR''; -it may be overridden by specifying the \fB\-h\fP and \fB\-t\fP options -explicitly. -In such a case the listing format must also be specified explicitly, -since \fB\-h\fP or \fB\-t\fP (or both) in the absence of other options implies -that ONLY the header or trailer line (or both) is listed. See the -\fBEXAMPLES\fP section below for a semi-intelligible translation of this -nonsense. -.PP -The verbose listing is mostly self-explanatory. It also lists file -comments and the zipfile comment, if any, and the type and number of bytes -in any stored extra fields. Currently known types of extra fields include -PKWARE's authentication (``AV'') info; OS/2 extended attributes; VMS -filesystem info, both PKWARE and Info-ZIP versions; Macintosh resource -forks; Acorn/Archimedes SparkFS info; and so on. (Note -that in the case of OS/2 extended attributes--perhaps the most common -use of zipfile extra fields--the size of the stored EAs as reported by -\fIzipinfo\fP may not match the number given by OS/2's \fIdir\fP command: -OS/2 always reports the number of bytes required in 16-bit format, whereas -\fIzipinfo\fP always reports the 32-bit storage.) -.PD -.\" ========================================================================= -.SH "ENVIRONMENT OPTIONS" -Modifying \fIzipinfo\fP's default behavior via options placed in -an environment variable can be a bit complicated to explain, due to -\fIzipinfo\fP's attempts to handle various defaults in an intuitive, -yet Unix-like, manner. (Try not to laugh.) Nevertheless, there is some -underlying logic. In brief, -there are three ``priority levels'' of options: the default options; -environment options, which can override or add to the defaults; and -explicit options given by the user, which can override or add to -either of the above. -.PP -The default listing format, as noted above, corresponds roughly -to the "\fCzipinfo \-hst\fR" command (except when individual zipfile members -are specified). -A user who prefers the long-listing format (\fB\-l\fP) can make use of the -\fIzipinfo\fP's environment variable to change this default: -.TP -Unix Bourne shell: -\f(CW\&ZIPINFO=\-l; export ZIPINFO\fP -.TP -Unix C shell: -\f(CW\&setenv ZIPINFO \-l\fP -.TP -OS/2 or MS-DOS: -\f(CW\&set ZIPINFO=\-l\fP -.TP -VMS (quotes for \fIlowercase\fP): -\f(CW\&define ZIPINFO_OPTS "\-l"\fP -.EE -.PP -If, in addition, the user dislikes the trailer line, \fIzipinfo\fP's -concept of ``negative options'' may be used to override the default -inclusion of the line. This is accomplished by preceding the undesired -option with one or more minuses: e.g., ``\fC\-l\-t\fR'' or ``\fC\-\-tl\fR'', -in this example. The first hyphen is the regular switch character, but the -one before the `t' is a minus sign. The dual use of hyphens may seem a -little awkward, but it's reasonably intuitive nonetheless: simply ignore -the first hyphen and go from there. It is also consistent with the behavior -of the Unix command \fInice\fP(1). -.PP -As suggested above, the default variable names are ZIPINFO_OPTS for VMS -(where the symbol used to install \fIzipinfo\fP as a foreign command -would otherwise be confused with the environment variable), and ZIPINFO -for all other operating systems. For compatibility with \fIzip\fP(1L), -ZIPINFOOPT is also accepted (don't ask). If both ZIPINFO and ZIPINFOOPT -are defined, however, ZIPINFO takes precedence. \fIunzip\fP's diagnostic -option (\fB\-v\fP with no zipfile name) can be used to check the values -of all four possible \fIunzip\fP and \fIzipinfo\fP environment variables. -.PD -.\" ========================================================================= -.SH EXAMPLES -To get a basic, short-format listing of the complete contents of a ZIP -archive \fIstorage.zip\fP, with both header and totals lines, use only -the archive name as an argument to zipinfo: -.PP -.EX -zipinfo storage -.EE -.PP -To produce a basic, long-format listing (not verbose), including header and -totals lines, use \fB\-l\fP: -.PP -.EX -zipinfo \-l storage -.EE -.PP -To list the complete contents of the archive without header and totals -lines, either negate the \fB\-h\fP and \fB\-t\fP options or else specify the -contents explicitly: -.PP -.EX -zipinfo \-\-h\-t storage -zipinfo storage \e* -.EE -.PP -(where the backslash is required only if the shell would otherwise expand -the `*' wildcard, as in Unix when globbing is turned on--double quotes around -the asterisk would have worked as well). To turn off the totals line by -default, use the environment variable (C shell is assumed here): -.PP -.EX -setenv ZIPINFO \-\-t -zipinfo storage -.EE -.PP -To get the full, short-format listing of the first example again, given -that the environment variable is set as in the previous example, it is -necessary to specify the \fB\-s\fP option explicitly, since the \fB\-t\fP -option by itself implies that ONLY the footer line is to be printed: -.PP -.EX -setenv ZIPINFO \-\-t -zipinfo \-t storage \fR[only totals line]\fP -zipinfo \-st storage \fR[full listing]\fP -.EE -.PP -The \fB\-s\fP option, like \fB\-m\fP and \fB\-l\fP, includes headers and -footers by default, unless otherwise specified. Since the environment -variable specified no footers and that has a higher precedence than the -default behavior of \fB\-s\fP, an explicit \fB\-t\fP option was necessary -to produce the full listing. Nothing was indicated about the header, -however, so the \fB\-s\fP option was sufficient. Note that both the -\fB\-h\fP and \fB\-t\fP options, when used by themselves or with -each other, override any default listing of member files; only the header -and/or footer are printed. This behavior is useful when \fIzipinfo\fP is -used with a wildcard zipfile specification; the contents of all zipfiles -are then summarized with a single command. -.PP -To list information on a single file within the archive, in medium format, -specify the filename explicitly: -.PP -.EX -zipinfo \-m storage unshrink.c -.EE -.PP -The specification of any member file, as in this example, will override -the default header and totals lines; only the single line of information -about the requested file will be printed. This is intuitively what one -would expect when requesting information about a single file. For multiple -files, it is often useful to know the total compressed and uncompressed -size; in such cases \fB\-t\fP may be specified explicitly: -.PP -.EX -zipinfo \-mt storage "*.[ch]" Mak\e* -.EE -.PP -To get maximal information about the ZIP archive, use the verbose -option. It is usually wise to pipe the output into a filter such as -Unix \fImore\fP(1) if the operating system allows it: -.PP -.EX -zipinfo \-v storage | more -.EE -.PP -Finally, to see the most recently modified files in the archive, use -the \fB\-T\fP option in conjunction with an external sorting utility -such as Unix \fIsort\fP(1) (and \fItail\fP(1) as well, in this example): -.PP -.EX -zipinfo \-T storage | sort -n +6 | tail -15 -.EE -.PP -The \fB\-n\fP option to \fIsort\fP(1) tells it to sort numerically -rather than in ASCII order, and the \fB\+6\fP option tells it to sort -on the sixth field after the first one (i.e., the seventh field). This -assumes the default short-listing format; if \fB\-m\fP or \fB\-l\fP is -used, the proper \fIsort\fP(1) option would be \fB\+7\fP. The \fItail\fP(1) -command filters out all but the last 15 lines of the listing. Future -releases of \fIzipinfo\fP may incorporate date/time and filename sorting -as built-in options. -.PD -.\" ========================================================================= -.SH TIPS -The author finds it convenient to define an alias \fIii\fP for \fIzipinfo\fP -on systems that allow aliases (or, on other systems, copy/rename the -executable, create a link or create a command file with the name \fIii\fP). -The \fIii\fP usage parallels the common \fIll\fP alias for long listings in -Unix, and the similarity between the outputs of the two commands was -intentional. -.PD -.\" ========================================================================= -.SH BUGS -As with \fIunzip\fP, \fIzipinfo\fP's \fB\-M\fP (``more'') option is overly -simplistic in its handling of screen output; as noted above, it fails to detect -the wrapping of long lines and may thereby cause lines at the top of the screen -to be scrolled off before being read. \fIzipinfo\fP should detect and treat -each occurrence of line-wrap as one additional line printed. This requires -knowledge of the screen's width as well as its height. In addition, -\fIzipinfo\fP should detect the true screen geometry on all systems. -.PP -\fIzipinfo\fP's listing-format behavior is unnecessarily complex and should -be simplified. (This is not to say that it will be.) -.PP -.\" ========================================================================= -.SH "SEE ALSO" -\fIls\fP(1), \fIfunzip\fP(1L), \fIunzip\fP(1L), \fIunzipsfx\fP(1L), -\fIzip\fP(1L), \fIzipcloak\fP(1L), \fIzipnote\fP(1L), \fIzipsplit\fP(1L) -.PD -.\" ========================================================================= -.SH URL -The Info-ZIP home page is currently at -.EX -\fChttp://www.info-zip.org/pub/infozip/\fR -.EE -or -.EX -\fCftp://ftp.info-zip.org/pub/infozip/\fR . -.EE -.PD -.\" ========================================================================= -.SH AUTHOR -Greg ``Cave Newt'' Roelofs. ZipInfo contains pattern-matching code -by Mark Adler and fixes/improvements by many others. Please refer to the -CONTRIBS file in the UnZip source distribution for a more complete list.