| 1 |
.\" Copyright (c) 1990-2009 Info-ZIP. All rights reserved. |
| 2 |
.\" |
| 3 |
.\" See the accompanying file LICENSE, version 2009-Jan-02 or later |
| 4 |
.\" (the contents of which are also included in unzip.h) for terms of use. |
| 5 |
.\" If, for some reason, all these files are missing, the Info-ZIP license |
| 6 |
.\" also may be found at: ftp://ftp.info-zip.org/pub/infozip/license.html |
| 7 |
.\" |
| 8 |
.\" zipinfo.1 by Greg Roelofs and others. |
| 9 |
.\" |
| 10 |
.\" ========================================================================= |
| 11 |
.\" define .X macro (for long-line ZipInfo output examples; small Courier): |
| 12 |
.de X |
| 13 |
.nf |
| 14 |
.ft CW |
| 15 |
.ie n .ti -5 |
| 16 |
.el \{ .ti +2m |
| 17 |
.ps -1 \} |
| 18 |
\&\\$1 |
| 19 |
.ie n .ti +5 |
| 20 |
.el \{ .ti -2m |
| 21 |
.ps +1 \} |
| 22 |
.ft |
| 23 |
.fi |
| 24 |
.. |
| 25 |
.\" define .EX/.EE (for multiline user-command examples; normal Courier font) |
| 26 |
.de EX |
| 27 |
.in +4n |
| 28 |
.nf |
| 29 |
.ft CW |
| 30 |
.. |
| 31 |
.de EE |
| 32 |
.ft |
| 33 |
.fi |
| 34 |
.in -4n |
| 35 |
.. |
| 36 |
.\" ========================================================================= |
| 37 |
.TH ZIPINFO 1 "20 April 2009 (v3.0)" "Info-ZIP" |
| 38 |
.SH NAME |
| 39 |
zipinfo \- list detailed information about a ZIP archive |
| 40 |
.PD |
| 41 |
.SH SYNOPSIS |
| 42 |
\fBzipinfo\fP [\fB\-12smlvhMtTz\fP] \fIfile\fP[\fI.zip\fP] |
| 43 |
[\fIfile(s)\fP\ .\|.\|.] [\fB\-x\fP\ \fIxfile(s)\fP\ .\|.\|.] |
| 44 |
.PP |
| 45 |
\fBunzip\fP \fB\-Z\fP [\fB\-12smlvhMtTz\fP] \fIfile\fP[\fI.zip\fP] |
| 46 |
[\fIfile(s)\fP\ .\|.\|.] [\fB\-x\fP\ \fIxfile(s)\fP\ .\|.\|.] |
| 47 |
.PD |
| 48 |
.\" ========================================================================= |
| 49 |
.SH DESCRIPTION |
| 50 |
\fIzipinfo\fP lists technical information about files in a ZIP archive, most |
| 51 |
commonly found on MS-DOS systems. Such information includes file access |
| 52 |
permissions, encryption status, type of compression, version and operating |
| 53 |
system or file system of compressing program, and the like. The default |
| 54 |
behavior (with no options) is |
| 55 |
to list single-line entries for each file in the archive, with header and |
| 56 |
trailer lines providing summary information for the entire archive. The |
| 57 |
format is a cross between Unix ``\fCls \-l\fR'' and ``\fCunzip \-v\fR'' |
| 58 |
output. See |
| 59 |
.B "DETAILED DESCRIPTION" |
| 60 |
below. Note that \fIzipinfo\fP is the same program as \fIunzip\fP (under |
| 61 |
Unix, a link to it); on some systems, however, \fIzipinfo\fP support may |
| 62 |
have been omitted when \fIunzip\fP was compiled. |
| 63 |
.PD |
| 64 |
.\" ========================================================================= |
| 65 |
.SH ARGUMENTS |
| 66 |
.TP |
| 67 |
.IR file [ .zip ] |
| 68 |
Path of the ZIP archive(s). If the file specification is a wildcard, |
| 69 |
each matching file is processed in an order determined by the operating |
| 70 |
system (or file system). Only the filename can be a wildcard; the path |
| 71 |
itself cannot. Wildcard expressions are similar to Unix \fIegrep\fP(1) |
| 72 |
(regular) expressions and may contain: |
| 73 |
.RS |
| 74 |
.IP * |
| 75 |
matches a sequence of 0 or more characters |
| 76 |
.IP ? |
| 77 |
matches exactly 1 character |
| 78 |
.IP [.\|.\|.] |
| 79 |
matches any single character found inside the brackets; ranges are specified |
| 80 |
by a beginning character, a hyphen, and an ending character. If an exclamation |
| 81 |
point or a caret (`!' or `^') follows the left bracket, then the range of |
| 82 |
characters within the brackets is complemented (that is, anything \fIexcept\fP |
| 83 |
the characters inside the brackets is considered a match). To specify a |
| 84 |
verbatim left bracket, the three-character sequence ``[[]'' has to be used. |
| 85 |
.RE |
| 86 |
.IP |
| 87 |
(Be sure to quote any character that might otherwise be interpreted or |
| 88 |
modified by the operating system, particularly under Unix and VMS.) If no |
| 89 |
matches are found, the specification is assumed to be a literal filename; |
| 90 |
and if that also fails, the suffix \fC.zip\fR is appended. Note that |
| 91 |
self-extracting ZIP files are supported, as with any other ZIP archive; |
| 92 |
just specify the \fC.exe\fR suffix (if any) explicitly. |
| 93 |
.IP [\fIfile(s)\fP] |
| 94 |
An optional list of archive members to be processed, separated by spaces. |
| 95 |
(VMS versions compiled with VMSCLI defined must delimit files with commas |
| 96 |
instead.) |
| 97 |
Regular expressions (wildcards) may be used to match multiple members; see |
| 98 |
above. Again, be sure to quote expressions that would otherwise be expanded |
| 99 |
or modified by the operating system. |
| 100 |
.IP [\fB\-x\fP\ \fIxfile(s)\fP] |
| 101 |
An optional list of archive members to be excluded from processing. |
| 102 |
.\" ========================================================================= |
| 103 |
.SH OPTIONS |
| 104 |
.TP |
| 105 |
.B \-1 |
| 106 |
list filenames only, one per line. This option excludes all others; headers, |
| 107 |
trailers and zipfile comments are never printed. It is intended for use in |
| 108 |
Unix shell scripts. |
| 109 |
.TP |
| 110 |
.B \-2 |
| 111 |
list filenames only, one per line, but allow headers (\fB\-h\fP), trailers |
| 112 |
(\fB\-t\fP) and zipfile comments (\fB\-z\fP), as well. This option may be |
| 113 |
useful in cases where the stored filenames are particularly long. |
| 114 |
.TP |
| 115 |
.B \-s |
| 116 |
list zipfile info in short Unix ``\fCls \-l\fR'' format. This is the default |
| 117 |
behavior; see below. |
| 118 |
.TP |
| 119 |
.B \-m |
| 120 |
list zipfile info in medium Unix ``\fCls \-l\fR'' format. Identical to the |
| 121 |
\fB\-s\fP output, except that the compression factor, expressed as a |
| 122 |
percentage, is also listed. |
| 123 |
.TP |
| 124 |
.B \-l |
| 125 |
list zipfile info in long Unix ``\fCls \-l\fR'' format. As with \fB\-m\fP |
| 126 |
except that the compressed size (in bytes) is printed instead of the |
| 127 |
compression ratio. |
| 128 |
.TP |
| 129 |
.B \-v |
| 130 |
list zipfile information in verbose, multi-page format. |
| 131 |
.TP |
| 132 |
.B \-h |
| 133 |
list header line. The archive name, actual size (in bytes) and total number |
| 134 |
of files is printed. |
| 135 |
.TP |
| 136 |
.B \-M |
| 137 |
pipe all output through an internal pager similar to the Unix \fImore\fP(1) |
| 138 |
command. At the end of a screenful of output, \fIzipinfo\fP pauses with a |
| 139 |
``\-\-More\-\-'' prompt; the next screenful may be viewed by pressing the |
| 140 |
Enter (Return) key or the space bar. \fIzipinfo\fP can be terminated by |
| 141 |
pressing the ``q'' key and, on some systems, the Enter/Return key. Unlike |
| 142 |
Unix \fImore\fP(1), there is no forward-searching or editing capability. |
| 143 |
Also, \fIzipinfo\fP doesn't notice if long lines wrap at the edge of the |
| 144 |
screen, effectively resulting in the printing of two or more lines and the |
| 145 |
likelihood that some text will scroll off the top of the screen before being |
| 146 |
viewed. On some systems the number of available lines on the screen is not |
| 147 |
detected, in which case \fIzipinfo\fP assumes the height is 24 lines. |
| 148 |
.TP |
| 149 |
.B \-t |
| 150 |
list totals for files listed or for all files. The number of files listed, |
| 151 |
their uncompressed and compressed total sizes , and their overall compression |
| 152 |
factor is printed; or, if only the totals line is being printed, the values |
| 153 |
for the entire archive are given. The compressed total size does not include |
| 154 |
the 12 additional header bytes of each encrypted entry. Note that the total |
| 155 |
compressed (data) size will never match the actual zipfile size, since the |
| 156 |
latter includes all of the internal zipfile headers in addition to the |
| 157 |
compressed data. |
| 158 |
.TP |
| 159 |
.B \-T |
| 160 |
print the file dates and times in a sortable decimal format (yymmdd.hhmmss). |
| 161 |
The default date format is a more standard, human-readable version with |
| 162 |
abbreviated month names (see examples below). |
| 163 |
.TP |
| 164 |
.B \-U |
| 165 |
[UNICODE_SUPPORT only] modify or disable UTF-8 handling. |
| 166 |
When UNICODE_SUPPORT is available, the option \fB\-U\fP forces \fIunzip\fP |
| 167 |
to escape all non-ASCII characters from UTF-8 coded filenames as ``#Uxxxx''. |
| 168 |
This option is mainly provided for debugging purpose when the fairly new |
| 169 |
UTF-8 support is suspected to mangle up extracted filenames. |
| 170 |
.IP |
| 171 |
The option \fB\-UU\fP allows to entirely disable the recognition of UTF-8 |
| 172 |
encoded filenames. The handling of filename codings within \fIunzip\fP falls |
| 173 |
back to the behaviour of previous versions. |
| 174 |
.TP |
| 175 |
.B \-z |
| 176 |
include the archive comment (if any) in the listing. |
| 177 |
.PD |
| 178 |
.\" ========================================================================= |
| 179 |
.SH "DETAILED DESCRIPTION" |
| 180 |
.I zipinfo |
| 181 |
has a number of modes, and its behavior can be rather difficult to fathom |
| 182 |
if one isn't familiar with Unix \fIls\fP(1) (or even if one is). The default |
| 183 |
behavior is to list files in the following format: |
| 184 |
.PP |
| 185 |
.X "-rw-rws--- 1.9 unx 2802 t- defX 11-Aug-91 13:48 perms.2660" |
| 186 |
.PP |
| 187 |
The last three fields are the modification date and time of |
| 188 |
the file, and its name. The case of the filename is respected; thus |
| 189 |
files that come from MS-DOS PKZIP are always capitalized. If the file |
| 190 |
was zipped with a stored directory name, that is also displayed as part |
| 191 |
of the filename. |
| 192 |
.PP |
| 193 |
The second and third fields indicate that the file was zipped under |
| 194 |
Unix with version 1.9 of \fIzip\fP. Since it comes from Unix, the file |
| 195 |
permissions at the beginning of the line are printed in Unix format. |
| 196 |
The uncompressed file-size (2802 in this example) is the fourth field. |
| 197 |
.PP |
| 198 |
The fifth field consists of two characters, either of which may take |
| 199 |
on several values. The first character may be either `t' or `b', indicating |
| 200 |
that \fIzip\fP believes the file to be text or binary, respectively; |
| 201 |
but if the file is encrypted, \fIzipinfo\fP |
| 202 |
notes this fact by capitalizing the character (`T' or `B'). The second |
| 203 |
character may also take on four values, depending on whether there is |
| 204 |
an extended local header and/or an ``extra field'' associated with the |
| 205 |
file (fully explained in PKWare's APPNOTE.TXT, but basically analogous to |
| 206 |
pragmas in ANSI C--i.e., they provide a standard way to include non-standard |
| 207 |
information in the archive). If neither exists, the character |
| 208 |
will be a hyphen (`\-'); if there is an extended local header but no extra |
| 209 |
field, `l'; if the reverse, `x'; and if both exist, `X'. Thus the |
| 210 |
file in this example is (probably) a text file, is not encrypted, and |
| 211 |
has neither an extra field nor an extended local header associated with it. |
| 212 |
The example below, on the other hand, is an encrypted binary file with an |
| 213 |
extra field: |
| 214 |
.PP |
| 215 |
.X "RWD,R,R 0.9 vms 168 Bx shrk 9-Aug-91 19:15 perms.0644" |
| 216 |
.PP |
| 217 |
Extra fields are used for various purposes (see discussion of the \fB\-v\fP |
| 218 |
option below) including the storage of VMS file attributes, which is |
| 219 |
presumably the case here. Note that the file attributes are listed in |
| 220 |
VMS format. Some other possibilities for the host operating system (which |
| 221 |
is actually a misnomer--host file system is more correct) include |
| 222 |
OS/2 or NT with High Performance File System (HPFS), MS-DOS, OS/2 or NT |
| 223 |
with File Allocation Table (FAT) file system, and Macintosh. These are |
| 224 |
denoted as follows: |
| 225 |
.PP |
| 226 |
.X "-rw-a-- 1.0 hpf 5358 Tl i4:3 4-Dec-91 11:33 longfilename.hpfs" |
| 227 |
.X "-r--ahs 1.1 fat 4096 b- i4:2 14-Jul-91 12:58 EA DATA. SF" |
| 228 |
.X "--w------- 1.0 mac 17357 bx i8:2 4-May-92 04:02 unzip.macr" |
| 229 |
.PP |
| 230 |
File attributes in the first two cases are indicated in a Unix-like format, |
| 231 |
where the seven subfields indicate whether the file: (1) is a directory, |
| 232 |
(2) is readable (always true), (3) is writable, (4) is executable (guessed |
| 233 |
on the basis of the extension--\fI.exe\fP, \fI.com\fP, \fI.bat\fP, \fI.cmd\fP |
| 234 |
and \fI.btm\fP files are assumed to be so), (5) has its archive bit set, |
| 235 |
(6) is hidden, and (7) is a system file. Interpretation of Macintosh file |
| 236 |
attributes is unreliable because some Macintosh archivers don't store any |
| 237 |
attributes in the archive. |
| 238 |
.PP |
| 239 |
Finally, the sixth field indicates |
| 240 |
the compression method and possible sub-method used. There are six methods |
| 241 |
known at present: storing (no compression), reducing, shrinking, imploding, |
| 242 |
tokenizing (never publicly released), and deflating. In addition, there are |
| 243 |
four levels of reducing (1 through 4); four types of imploding (4K or 8K |
| 244 |
sliding dictionary, and 2 or 3 Shannon-Fano trees); and four levels of |
| 245 |
deflating (superfast, fast, normal, maximum compression). \fIzipinfo\fP |
| 246 |
represents these methods and their sub-methods as follows: \fIstor\fP; |
| 247 |
\fIre:1\fP, \fIre:2\fP, etc.; \fIshrk\fP; \fIi4:2\fP, \fIi8:3\fP, etc.; |
| 248 |
\fItokn\fP; and \fIdefS\fP, \fIdefF\fP, \fIdefN\fP, and \fIdefX\fP. |
| 249 |
.PP |
| 250 |
The medium and long listings are almost identical to the short format except |
| 251 |
that they add information on the file's compression. The medium format lists |
| 252 |
the file's compression factor as a percentage indicating the amount of space |
| 253 |
that has been ``removed'': |
| 254 |
.PP |
| 255 |
.X "-rw-rws--- 1.5 unx 2802 t- 81% defX 11-Aug-91 13:48 perms.2660" |
| 256 |
.PP |
| 257 |
In this example, the file has been compressed by more than a factor of |
| 258 |
five; the compressed data are only 19% of the original size. The long |
| 259 |
format gives the compressed file's size in bytes, instead: |
| 260 |
.PP |
| 261 |
.X "-rw-rws--- 1.5 unx 2802 t- 538 defX 11-Aug-91 13:48 perms.2660" |
| 262 |
.PP |
| 263 |
In contrast to the \fIunzip\fP listings, the compressed size figures in |
| 264 |
this listing format denote the complete size of compressed data, including |
| 265 |
the 12 extra header bytes in case of encrypted entries. |
| 266 |
.PP |
| 267 |
Adding the \fB\-T\fP option changes the file date and time to decimal |
| 268 |
format: |
| 269 |
.PP |
| 270 |
.X "-rw-rws--- 1.5 unx 2802 t- 538 defX 910811.134804 perms.2660" |
| 271 |
.PP |
| 272 |
Note that because of limitations in the MS-DOS format used to store file |
| 273 |
times, the seconds field is always rounded to the nearest even second. |
| 274 |
For Unix files this is expected to change in the next major releases of |
| 275 |
\fIzip\fP(1) and \fIunzip\fP. |
| 276 |
.PP |
| 277 |
In addition to individual file information, a default zipfile listing |
| 278 |
also includes header and trailer lines: |
| 279 |
.PP |
| 280 |
.X "Archive: OS2.zip 5453 bytes 5 files" |
| 281 |
.X ",,rw, 1.0 hpf 730 b- i4:3 26-Jun-92 23:40 Contents" |
| 282 |
.X ",,rw, 1.0 hpf 3710 b- i4:3 26-Jun-92 23:33 makefile.os2" |
| 283 |
.X ",,rw, 1.0 hpf 8753 b- i8:3 26-Jun-92 15:29 os2unzip.c" |
| 284 |
.X ",,rw, 1.0 hpf 98 b- stor 21-Aug-91 15:34 unzip.def" |
| 285 |
.X ",,rw, 1.0 hpf 95 b- stor 21-Aug-91 17:51 zipinfo.def" |
| 286 |
.X "5 files, 13386 bytes uncompressed, 4951 bytes compressed: 63.0%" |
| 287 |
.PP |
| 288 |
The header line gives the name of the archive, its total size, and the |
| 289 |
total number of files; the trailer gives the number of files listed, |
| 290 |
their total uncompressed size, and their total compressed size (not |
| 291 |
including any of \fIzip\fP's internal overhead). If, however, one or |
| 292 |
more \fIfile(s)\fP are provided, the header and trailer lines are |
| 293 |
not listed. This behavior is also similar to that of Unix's ``\fCls \-l\fR''; |
| 294 |
it may be overridden by specifying the \fB\-h\fP and \fB\-t\fP options |
| 295 |
explicitly. |
| 296 |
In such a case the listing format must also be specified explicitly, |
| 297 |
since \fB\-h\fP or \fB\-t\fP (or both) in the absence of other options implies |
| 298 |
that ONLY the header or trailer line (or both) is listed. See the |
| 299 |
\fBEXAMPLES\fP section below for a semi-intelligible translation of this |
| 300 |
nonsense. |
| 301 |
.PP |
| 302 |
The verbose listing is mostly self-explanatory. It also lists file |
| 303 |
comments and the zipfile comment, if any, and the type and number of bytes |
| 304 |
in any stored extra fields. Currently known types of extra fields include |
| 305 |
PKWARE's authentication (``AV'') info; OS/2 extended attributes; VMS |
| 306 |
filesystem info, both PKWARE and Info-ZIP versions; Macintosh resource |
| 307 |
forks; Acorn/Archimedes SparkFS info; and so on. (Note |
| 308 |
that in the case of OS/2 extended attributes--perhaps the most common |
| 309 |
use of zipfile extra fields--the size of the stored EAs as reported by |
| 310 |
\fIzipinfo\fP may not match the number given by OS/2's \fIdir\fP command: |
| 311 |
OS/2 always reports the number of bytes required in 16-bit format, whereas |
| 312 |
\fIzipinfo\fP always reports the 32-bit storage.) |
| 313 |
.PP |
| 314 |
Again, the compressed size figures of the individual entries include the |
| 315 |
12 extra header bytes for encrypted entries. In contrast, the archive total |
| 316 |
compressed size and the average compression ratio shown in the summary |
| 317 |
bottom line are calculated \fBwithout\fP the extra 12 header bytes of |
| 318 |
encrypted entries. |
| 319 |
.PD |
| 320 |
.\" ========================================================================= |
| 321 |
.SH "ENVIRONMENT OPTIONS" |
| 322 |
Modifying \fIzipinfo\fP's default behavior via options placed in |
| 323 |
an environment variable can be a bit complicated to explain, due to |
| 324 |
\fIzipinfo\fP's attempts to handle various defaults in an intuitive, |
| 325 |
yet Unix-like, manner. (Try not to laugh.) Nevertheless, there is some |
| 326 |
underlying logic. In brief, |
| 327 |
there are three ``priority levels'' of options: the default options; |
| 328 |
environment options, which can override or add to the defaults; and |
| 329 |
explicit options given by the user, which can override or add to |
| 330 |
either of the above. |
| 331 |
.PP |
| 332 |
The default listing format, as noted above, corresponds roughly |
| 333 |
to the "\fCzipinfo \-hst\fR" command (except when individual zipfile members |
| 334 |
are specified). |
| 335 |
A user who prefers the long-listing format (\fB\-l\fP) can make use of the |
| 336 |
\fIzipinfo\fP's environment variable to change this default: |
| 337 |
.TP |
| 338 |
Unix Bourne shell: |
| 339 |
\f(CW\&ZIPINFO=\-l; export ZIPINFO\fP |
| 340 |
.TP |
| 341 |
Unix C shell: |
| 342 |
\f(CW\&setenv ZIPINFO \-l\fP |
| 343 |
.TP |
| 344 |
OS/2 or MS-DOS: |
| 345 |
\f(CW\&set ZIPINFO=\-l\fP |
| 346 |
.TP |
| 347 |
VMS (quotes for \fIlowercase\fP): |
| 348 |
\f(CW\&define ZIPINFO_OPTS "\-l"\fP |
| 349 |
.EE |
| 350 |
.PP |
| 351 |
If, in addition, the user dislikes the trailer line, \fIzipinfo\fP's |
| 352 |
concept of ``negative options'' may be used to override the default |
| 353 |
inclusion of the line. This is accomplished by preceding the undesired |
| 354 |
option with one or more minuses: e.g., ``\fC\-l\-t\fR'' or ``\fC\-\-tl\fR'', |
| 355 |
in this example. The first hyphen is the regular switch character, but the |
| 356 |
one before the `t' is a minus sign. The dual use of hyphens may seem a |
| 357 |
little awkward, but it's reasonably intuitive nonetheless: simply ignore |
| 358 |
the first hyphen and go from there. It is also consistent with the behavior |
| 359 |
of the Unix command \fInice\fP(1). |
| 360 |
.PP |
| 361 |
As suggested above, the default variable names are ZIPINFO_OPTS for VMS |
| 362 |
(where the symbol used to install \fIzipinfo\fP as a foreign command |
| 363 |
would otherwise be confused with the environment variable), and ZIPINFO |
| 364 |
for all other operating systems. For compatibility with \fIzip\fP(1), |
| 365 |
ZIPINFOOPT is also accepted (don't ask). If both ZIPINFO and ZIPINFOOPT |
| 366 |
are defined, however, ZIPINFO takes precedence. \fIunzip\fP's diagnostic |
| 367 |
option (\fB\-v\fP with no zipfile name) can be used to check the values |
| 368 |
of all four possible \fIunzip\fP and \fIzipinfo\fP environment variables. |
| 369 |
.PD |
| 370 |
.\" ========================================================================= |
| 371 |
.SH EXAMPLES |
| 372 |
To get a basic, short-format listing of the complete contents of a ZIP |
| 373 |
archive \fIstorage.zip\fP, with both header and totals lines, use only |
| 374 |
the archive name as an argument to zipinfo: |
| 375 |
.PP |
| 376 |
.EX |
| 377 |
zipinfo storage |
| 378 |
.EE |
| 379 |
.PP |
| 380 |
To produce a basic, long-format listing (not verbose), including header and |
| 381 |
totals lines, use \fB\-l\fP: |
| 382 |
.PP |
| 383 |
.EX |
| 384 |
zipinfo \-l storage |
| 385 |
.EE |
| 386 |
.PP |
| 387 |
To list the complete contents of the archive without header and totals |
| 388 |
lines, either negate the \fB\-h\fP and \fB\-t\fP options or else specify the |
| 389 |
contents explicitly: |
| 390 |
.PP |
| 391 |
.EX |
| 392 |
zipinfo \-\-h\-t storage |
| 393 |
zipinfo storage \e* |
| 394 |
.EE |
| 395 |
.PP |
| 396 |
(where the backslash is required only if the shell would otherwise expand |
| 397 |
the `*' wildcard, as in Unix when globbing is turned on--double quotes around |
| 398 |
the asterisk would have worked as well). To turn off the totals line by |
| 399 |
default, use the environment variable (C shell is assumed here): |
| 400 |
.PP |
| 401 |
.EX |
| 402 |
setenv ZIPINFO \-\-t |
| 403 |
zipinfo storage |
| 404 |
.EE |
| 405 |
.PP |
| 406 |
To get the full, short-format listing of the first example again, given |
| 407 |
that the environment variable is set as in the previous example, it is |
| 408 |
necessary to specify the \fB\-s\fP option explicitly, since the \fB\-t\fP |
| 409 |
option by itself implies that ONLY the footer line is to be printed: |
| 410 |
.PP |
| 411 |
.EX |
| 412 |
setenv ZIPINFO \-\-t |
| 413 |
zipinfo \-t storage \fR[only totals line]\fP |
| 414 |
zipinfo \-st storage \fR[full listing]\fP |
| 415 |
.EE |
| 416 |
.PP |
| 417 |
The \fB\-s\fP option, like \fB\-m\fP and \fB\-l\fP, includes headers and |
| 418 |
footers by default, unless otherwise specified. Since the environment |
| 419 |
variable specified no footers and that has a higher precedence than the |
| 420 |
default behavior of \fB\-s\fP, an explicit \fB\-t\fP option was necessary |
| 421 |
to produce the full listing. Nothing was indicated about the header, |
| 422 |
however, so the \fB\-s\fP option was sufficient. Note that both the |
| 423 |
\fB\-h\fP and \fB\-t\fP options, when used by themselves or with |
| 424 |
each other, override any default listing of member files; only the header |
| 425 |
and/or footer are printed. This behavior is useful when \fIzipinfo\fP is |
| 426 |
used with a wildcard zipfile specification; the contents of all zipfiles |
| 427 |
are then summarized with a single command. |
| 428 |
.PP |
| 429 |
To list information on a single file within the archive, in medium format, |
| 430 |
specify the filename explicitly: |
| 431 |
.PP |
| 432 |
.EX |
| 433 |
zipinfo \-m storage unshrink.c |
| 434 |
.EE |
| 435 |
.PP |
| 436 |
The specification of any member file, as in this example, will override |
| 437 |
the default header and totals lines; only the single line of information |
| 438 |
about the requested file will be printed. This is intuitively what one |
| 439 |
would expect when requesting information about a single file. For multiple |
| 440 |
files, it is often useful to know the total compressed and uncompressed |
| 441 |
size; in such cases \fB\-t\fP may be specified explicitly: |
| 442 |
.PP |
| 443 |
.EX |
| 444 |
zipinfo \-mt storage "*.[ch]" Mak\e* |
| 445 |
.EE |
| 446 |
.PP |
| 447 |
To get maximal information about the ZIP archive, use the verbose |
| 448 |
option. It is usually wise to pipe the output into a filter such as |
| 449 |
Unix \fImore\fP(1) if the operating system allows it: |
| 450 |
.PP |
| 451 |
.EX |
| 452 |
zipinfo \-v storage | more |
| 453 |
.EE |
| 454 |
.PP |
| 455 |
Finally, to see the most recently modified files in the archive, use |
| 456 |
the \fB\-T\fP option in conjunction with an external sorting utility |
| 457 |
such as Unix \fIsort\fP(1) (and \fIsed\fP(1) as well, in this example): |
| 458 |
.PP |
| 459 |
.EX |
| 460 |
zipinfo \-T storage | sort -nr -k 7 | sed 15q |
| 461 |
.EE |
| 462 |
.PP |
| 463 |
The \fB\-nr\fP option to \fIsort\fP(1) tells it to sort numerically |
| 464 |
in reverse order rather than in textual order, and the \fB\-k\ 7\fP option |
| 465 |
tells it to sort on the seventh field. This |
| 466 |
assumes the default short-listing format; if \fB\-m\fP or \fB\-l\fP is |
| 467 |
used, the proper \fIsort\fP(1) option would be \fB\-k\ 8\fP. |
| 468 |
Older versions of \fIsort\fP(1) do not support the \fB\-k\fP option, |
| 469 |
but you can use the traditional \fB\+\fP option instead, e.g., |
| 470 |
\fB\+6\fP instead of \fB\-k\ 7\fP. The \fIsed\fP(1) |
| 471 |
command filters out all but the first 15 lines of the listing. Future |
| 472 |
releases of \fIzipinfo\fP may incorporate date/time and filename sorting |
| 473 |
as built-in options. |
| 474 |
.PD |
| 475 |
.\" ========================================================================= |
| 476 |
.SH TIPS |
| 477 |
The author finds it convenient to define an alias \fIii\fP for \fIzipinfo\fP |
| 478 |
on systems that allow aliases (or, on other systems, copy/rename the |
| 479 |
executable, create a link or create a command file with the name \fIii\fP). |
| 480 |
The \fIii\fP usage parallels the common \fIll\fP alias for long listings in |
| 481 |
Unix, and the similarity between the outputs of the two commands was |
| 482 |
intentional. |
| 483 |
.PD |
| 484 |
.\" ========================================================================= |
| 485 |
.SH BUGS |
| 486 |
As with \fIunzip\fP, \fIzipinfo\fP's \fB\-M\fP (``more'') option is overly |
| 487 |
simplistic in its handling of screen output; as noted above, it fails to detect |
| 488 |
the wrapping of long lines and may thereby cause lines at the top of the screen |
| 489 |
to be scrolled off before being read. \fIzipinfo\fP should detect and treat |
| 490 |
each occurrence of line-wrap as one additional line printed. This requires |
| 491 |
knowledge of the screen's width as well as its height. In addition, |
| 492 |
\fIzipinfo\fP should detect the true screen geometry on all systems. |
| 493 |
.PP |
| 494 |
\fIzipinfo\fP's listing-format behavior is unnecessarily complex and should |
| 495 |
be simplified. (This is not to say that it will be.) |
| 496 |
.PP |
| 497 |
.\" ========================================================================= |
| 498 |
.SH "SEE ALSO" |
| 499 |
\fIls\fP(1), \fIfunzip\fP(1), \fIunzip\fP(1), \fIunzipsfx\fP(1), |
| 500 |
\fIzip\fP(1), \fIzipcloak\fP(1), \fIzipnote\fP(1), \fIzipsplit\fP(1) |
| 501 |
.PD |
| 502 |
.\" ========================================================================= |
| 503 |
.SH URL |
| 504 |
The Info-ZIP home page is currently at |
| 505 |
.EX |
| 506 |
\fChttp://www.info-zip.org/pub/infozip/\fR |
| 507 |
.EE |
| 508 |
or |
| 509 |
.EX |
| 510 |
\fCftp://ftp.info-zip.org/pub/infozip/\fR . |
| 511 |
.EE |
| 512 |
.PD |
| 513 |
.\" ========================================================================= |
| 514 |
.SH AUTHOR |
| 515 |
Greg ``Cave Newt'' Roelofs. ZipInfo contains pattern-matching code |
| 516 |
by Mark Adler and fixes/improvements by many others. Please refer to the |
| 517 |
CONTRIBS file in the UnZip source distribution for a more complete list. |