.\"  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 NAMEzipinfo \- 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, mostcommonly found on MS-DOS systems.  Such information includes file accesspermissions, encryption status, type of compression, version and operatingsystem or file system of compressing program, and the like.  The defaultbehavior (with no options) isto list single-line entries for each file in the archive, with header andtrailer lines providing summary information for the entire archive.  Theformat 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 (underUnix, a link to it); on some systems, however, \fIzipinfo\fP support mayhave 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 operatingsystem (or file system).  Only the filename can be a wildcard; the pathitself 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 specifiedby a beginning character, a hyphen, and an ending character.  If an exclamationpoint or a caret (`!' or `^') follows the left bracket, then the range ofcharacters within the brackets is complemented (that is, anything \fIexcept\fPthe characters inside the brackets is considered a match)..RE.IP(Be sure to quote any character that might otherwise be interpreted ormodified by the operating system, particularly under Unix and VMS.)  If nomatches are found, the specification is assumed to be a literal filename;and if that also fails, the suffix \fC.zip\fR is appended.  Note thatself-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; seeabove.  Again, be sure to quote expressions that would otherwise be expandedor 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 \-1list filenames only, one per line.  This option excludes all others; headers,trailers and zipfile comments are never printed.  It is intended for use inUnix shell scripts..TP.B \-2list 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 beuseful in cases where the stored filenames are particularly long..TP.B \-slist zipfile info in short Unix ``\fCls \-l\fR'' format.  This is the defaultbehavior; see below..TP.B \-mlist zipfile info in medium Unix ``\fCls \-l\fR'' format.  Identical to the\fB\-s\fP output, except that the compression factor, expressed as apercentage, is also listed..TP.B \-llist zipfile info in long Unix ``\fCls \-l\fR'' format.  As with \fB\-m\fPexcept that the compressed size (in bytes) is printed instead of thecompression ratio..TP.B \-vlist zipfile information in verbose, multi-page format..TP.B \-hlist header line.  The archive name, actual size (in bytes) and total numberof files is printed..TP.B \-Mpipe 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 theEnter (Return) key or the space bar.  \fIzipinfo\fP can be terminated bypressing the ``q'' key and, on some systems, the Enter/Return key.  UnlikeUnix \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 thescreen, effectively resulting in the printing of two or more lines and thelikelihood that some text will scroll off the top of the screen before beingviewed.  On some systems the number of available lines on the screen is notdetected, in which case \fIzipinfo\fP assumes the height is 24 lines..TP.B \-tlist totals for files listed or for all files.  The number of files listed,their uncompressed and compressed total sizes, and their overall compressionfactor is printed; or, if only the totals line is being printed, the valuesfor the entire archive are given.  Note that the total compressed (data)size will never match the actual zipfile size, since the latter includes allof the internal zipfile headers in addition to the compressed data..TP.B \-Tprint the file dates and times in a sortable decimal format (yymmdd.hhmmss).The default date format is a more standard, human-readable version withabbreviated month names (see examples below)..TP.B \-zinclude the archive comment (if any) in the listing..PD.\" =========================================================================.SH "DETAILED DESCRIPTION".I zipinfohas a number of modes, and its behavior can be rather difficult to fathomif one isn't familiar with Unix \fIls\fP(1) (or even if one is).  The defaultbehavior 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".PPThe last three fields are the modification date and time ofthe file, and its name.  The case of the filename is respected; thusfiles that come from MS-DOS PKZIP are always capitalized.  If the filewas zipped with a stored directory name, that is also displayed as partof the filename..PPThe second and third fields indicate that the file was zipped underUnix with version 1.9 of \fIzip\fP.  Since it comes from Unix, the filepermissions at the beginning of the line are printed in Unix format.The uncompressed file-size (2802 in this example) is the fourth field..PPThe fifth field consists of two characters, either of which may takeon several values.  The first character may be either `t' or `b', indicatingthat \fIzip\fP believes the file to be text or binary, respectively;but if the file is encrypted, \fIzipinfo\fPnotes this fact by capitalizing the character (`T' or `B').  The secondcharacter may also take on four values, depending on whether there isan extended local header and/or an ``extra field'' associated with thefile (fully explained in PKWare's APPNOTE.TXT, but basically analogous topragmas in ANSI C--i.e., they provide a standard way to include non-standardinformation in the archive).  If neither exists, the characterwill be a hyphen (`\-'); if there is an extended local header but no extrafield, `l'; if the reverse, `x'; and if both exist, `X'.  Thus thefile in this example is (probably) a text file, is not encrypted, andhas 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 anextra field:.PP.X "RWD,R,R     0.9 vms     168 Bx shrk  9-Aug-91 19:15 perms.0644".PPExtra fields are used for various purposes (see discussion of the \fB\-v\fPoption below) including the storage of VMS file attributes, which ispresumably the case here.  Note that the file attributes are listed inVMS format.  Some other possibilities for the host operating system (whichis actually a misnomer--host file system is more correct) includeOS/2 or NT with High Performance File System (HPFS), MS-DOS, OS/2 or NTwith File Allocation Table (FAT) file system, and Macintosh.  These aredenoted 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".PPFile 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 (guessedon the basis of the extension--\fI.exe\fP, \fI.com\fP, \fI.bat\fP, \fI.cmd\fPand \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 fileattributes is unreliable because some Macintosh archivers don't store anyattributes in the archive..PPFinally, the sixth field indicatesthe compression method and possible sub-method used.  There are six methodsknown at present:  storing (no compression), reducing, shrinking, imploding,tokenizing (never publicly released), and deflating.  In addition, there arefour levels of reducing (1 through 4); four types of imploding (4K or 8Ksliding dictionary, and 2 or 3 Shannon-Fano trees); and four levels ofdeflating (superfast, fast, normal, maximum compression).  \fIzipinfo\fPrepresents 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..PPThe medium and long listings are almost identical to the short format exceptthat they add information on the file's compression.  The medium format liststhe file's compression factor as a percentage indicating the amount of spacethat has been ``removed'':.PP.X "-rw-rws---  1.5 unx    2802 t- 81% defX 11-Aug-91 13:48 perms.2660".PPIn this example, the file has been compressed by more than a factor offive; the compressed data are only 19% of the original size.  The longformat 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"