![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to unzip.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [MW Coherent from dump] / coherent / b / bin / unzip|
Return to unzip.1 CVS log | Up to [MW Coherent from dump] / coherent / b / bin / unzip |
1.1 root 1: .TH UNZIP 1 "22 Aug 92 (v5.0)"
2: .SH NAME
3: unzip \- list/test/extract from a ZIP archive file
4: .SH SYNOPSIS
5: \fBunzip\fP [ \-\fBcflptuvxz\fP[\fBajnoqUV\fP] ] \fIfile\fP[\fI.zip\fP] [\fIfilespec\fP\ ...]
6: .SH ARGUMENTS
7: .IP \fIfile\fP[\fI.zip\fP] \w'[\fIfilespec\fP]'u+2m
8: Path of the ZIP archive. The suffix
9: ``\fI.zip\fP'' is applied if the \fIfile\fP specified does not exist.
10: Note that self-extracting ZIP files are supported; just specify the
11: ``\fI.exe\fP'' suffix yourself.
12: .IP [\fIfilespec\fP]
13: An optional list of archive members to be processed.
14: Expressions may be used to match multiple members; be sure to quote
15: expressions that contain characters interpreted by the operating
16: system. See DESCRIPTION (below) for more details.
17: .SH OPTIONS
18: .PD 0
19: .IP \-c \w'\-c'u+2m
20: extract files to stdout/screen (``CRT'')
21: .IP \-f
22: freshen existing files (replace if newer); create none
23: .IP \-l
24: list archive files (short format)
25: .IP \-p
26: extract files to pipe; no informational messages
27: .IP \-t
28: test archive files
29: .IP \-u
30: update existing files; create new ones if needed
31: .IP \-v
32: list archive files (verbose format)
33: .IP \-x
34: extract files in archive (default)
35: .IP \-z
36: display only the archive comment
37: .PD
38: .SH MODIFIERS
39: .PD 0
40: .IP \-a \w'\-a'u+2m
41: convert to MS-DOS textfile format (CR LF), Mac format (CR), Unix/VMS
42: format (LF), OR from ASCII to EBCDIC, depending on your system (only
43: use for TEXT files!)
44: .IP \-j
45: junk paths (don't recreate archive's directory structure)
46: .IP \-n
47: never overwrite existing files; don't prompt
48: .IP \-o
49: OK to overwrite files without prompting
50: .IP \-q
51: perform operations quietly (\-qq \(rh even quieter)
52: .IP \-s
53: [OS/2, MS-DOS] allow spaces in filenames (e.g., ``EA\ DATA.\ SF'')
54: .IP \-U
55: leave filenames uppercase if created under MS-DOS, VMS, etc.
56: .IP \-V
57: retain (VMS) file version numbers
58: .IP \-X
59: [VMS] restore owner/protection info (may require privileges)
60: .PD
61: .SH DESCRIPTION
62: .I UnZip
63: will list, test, or extract from a ZIP archive, commonly found on MSDOS
64: systems.
65: Archive member extraction is implied by the absence of the \-c, \-p,
66: \-t, \-l, \-v or \-z options. All archive members are processed unless a
67: .I filespec
68: is provided to specify a subset of the archive members. The
69: .I filespec
70: is similar to an egrep expression, and may contain:
71: .sp 1
72: .ta \w'[...]'u+2m
73: * matches a sequence of 0 or more characters
74: .br
75: ? matches exactly 1 character
76: .br
77: \\nnn matches the character having octal code nnn
78: .PD 0
79: .IP [...] \w'[...]'u+2m
80: matches any single character found inside the brackets; ranges
81: are specified by a beginning character, a hyphen, and an ending
82: character. If an exclamation point or a carat (`!' or `^') follows
83: the left bracket, then the range of characters matched is complemented
84: with respect to the ASCII character set (that is, anything except the
85: characters inside the brackets is considered a match).
86: .PD
87: .SH ENVIRONMENT OPTIONS
88: \fIUnZip\fP's default behavior may be modified via options placed in
89: an environment variable. This can be done with any option, but it
90: is probably most useful with the
91: \-q, \-o, or \-n modifiers: in order to make \fIUnZip\fP quieter by
92: default, or to make it always overwrite or never overwrite files as it
93: extracts them. For example, to
94: make \fIUnZip\fP act as quietly as possible, only reporting errors, one would
95: use one of the following commands:
96: .ta \w'tabset'u +\w'UNZIP=-qq; export UNZIP'u+4m
97: .PP
98: .IP "\tsetenv UNZIP -qq\tUnix C shell"
99: .br
100: .IP "\tUNZIP=-qq; export UNZIP\tUnix Bourne shell"
101: .PP
102: .IP "\tset UNZIP=-qq\tOS/2 or MS-DOS"
103: .PP
104: .IP "\tdefine UNZIP_OPTS ""-qq""\tVMS (quotes for LOWERCASE)"
105: .PP
106: Environment options are, in effect, considered to be just like any other
107: command-line options, except that they are effectively the first options
108: on the command line. To override
109: an environment option, one may use the ``minus operator'' to remove it. For
110: instance, to override one of the quiet-flags in the example above, use the
111: command
112: .PP
113: .IP "\t\fIunzip\fP \-\-q[other options] zipfile"
114: .PP
115: The first hyphen is the normal
116: switch character, and the second is a minus sign, acting on the q option.
117: Thus the effect here is to cancel a single quantum of quietness. To cancel
118: both quiet flags, two (or more) minuses may be used:
119: .PP
120: .IP "\t\fIunzip\fP \-x\-\-q zipfile"
121: .PP
122: or
123: .PP
124: .IP "\t\fIunzip\fP \-\-\-qx zipfile"
125: .PP
126: (the two are equivalent). This may seem awkward
127: or confusing, but it is reasonably intuitive: just ignore the first
128: hyphen and go from there. It is also consistent with the behavior of Unix
129: nice(1).
130: .PD
131: .SH EXAMPLES
132: To use \fIUnZip\fP to extract all members of the archive letters.zip,
133: creating any directories as necessary:
134: .PP
135: .IP "\t\fIunzip\fP letters"
136: .PP
137: To extract all members of letters.zip to the current directory:
138: .PP
139: .IP "\t\fIunzip\fP -j letters"
140: .PP
141: To test letters.zip, printing only a summary message indicating
142: whether the archive is OK or not:
143: .PP
144: .IP "\t\fIunzip\fP -tq letters"
145: .PP
146: To extract to standard output all members of letters.zip whose names end
147: in ``.tex'', converting to the local end-of-line convention and piping the
148: output into more(1):
149: .PP
150: .IP "\t\fIunzip\fP \-ca letters \e*.tex | more"
151: .PP
152: (The backslash before the asterisk is only required if the shell expands
153: wildcards, as in Unix; double quotes could have been used instead, as in
154: the source example below.)\ \ To extract the binary file paper1.dvi to
155: standard output and pipe it to a printing program:
156: .PP
157: .IP "\t\fIunzip\fP \-p articles paper1.dvi | dvips"
158: .PP
159: To extract all FORTRAN and C source files--*.f, *.c, *.h, Makefile (the
160: double quotes are necessary only in Unix and only if globbing is turned on):
161: .PP
162: .IP "\t\fIunzip\fP source.zip ""*.[fch]"" Makefile"
163: .PP
164: To extract only newer versions of the files already in the current directory,
165: without querying (NOTE: be careful of unzipping in one timezone a zipfile
166: created in another--ZIP archives contain no timezone information, and a
167: ``newer'' file from an eastern timezone may, in fact, be older):
168: .PP
169: .IP "\t\fIunzip\fP \-fo sources"
170: .PP
171: To extract newer versions of the files already in the current directory and
172: to create any files not already there (same caveat as previous example):
173: .PP
174: .IP "\t\fIunzip\fP \-uo sources"
175: .PP
176: .PP
177: In the last five examples, assume that UNZIP or UNZIP_OPTS is set to -q.
178: To do a singly quiet listing:
179: .PP
180: .IP "\t\fIunzip\fP \-\fIl\fP \fIfile\fP"
181: .PP
182: To do a doubly quiet listing:
183: .PP
184: .IP "\t\fIunzip\fP \-\fIql\fP \fIfile\fP"
185: .PP
186: To do a standard listing:
187: .PP
188: .IP "\t\fIunzip\fP \-\-\fIql\fP \fIfile\fP"
189: .PP
190: or
191: .PP
192: .IP "\t\fIunzip\fP \-\fIl\fP\-\fIq\fP \fIfile\fP"
193: .PP
194: or
195: .PP
196: .IP "\t\fIunzip\fP \-\fIl\fP\-\-\fIq\fP \fIfile\fP"
197: .PP
198: (extra minuses don't hurt).
199: .PD
200: .SH TIPS
201: The current maintainer, being a lazy sort, finds it very useful to define
202: an alias ``tt'' for ``unzip -tq''. One may then simply type ``tt zipfile''
203: to test the archive, something which one ought make a habit of doing.
204: With luck \fIUnZip\fP will report ``No errors detected in zipfile.zip,''
205: after which one may breathe a sigh of relief.
206: .PD
207: .SH SEE ALSO
208: funzip(1), zip(1), zipcloak(1), zipinfo(1), zipnote(1), zipsplit(1)
209: .PD
210: .SH AUTHORS
211: Samuel H. Smith, Carl Mascott, David P. Kirschbaum, Greg R. Roelofs, Mark
212: Adler, Kai Uwe Rommel, Igor Mandrichenko, Johnny Lee, Jean-loup Gailly; Glenn
213: Andrews, Joel Aycock, Allan Bjorklund, James Birdsall, Wim Bonner, John Cowan,
214: Frank da Cruz, Bill Davidsen, Arjan de Vet, James Dugal, Jim Dumser, Mark
215: Edwards, David Feinleib, Mike Freeman, Hunter Goatley, Robert Heath, Dave
216: Heiland, Larry Jones, Kjetil J(o)rgenson, Bob Kemp, J. Kercheval, Alvin Koh,
217: Bo Kullmar, Johnny Lee, Warner Losh, Fulvio Marino, Gene McManus, Joe Meadows,
218: Mike O'Carroll, Humberto Ortiz-Zuazaga, Piet W. Plomp, Antonio Querubin Jr.,
219: Steve Salisbury, Georg Sassen, Jon Saxton, Hugh Schmidt, Martin Schulz, Charles
220: Scripter, Chris Seaman, Richard Seay, Alex Sergejew, Cliff Stanford, Onno van
221: der Linden, Jim Van Zandt, Antoine Verheijen, Paul Wells.
222: .PD
223: .SH VERSIONS
224: .ta \w'vx.x\ \ 'u +\w'fall 1989\ \ 'u
225: .PD 0
226: .IP "v1.2\t15 Mar 89" \w'\t\t'u
227: Samuel H. Smith
228: .IP "v2.0\t\ 9 Sep 89"
229: Samuel H. Smith
230: .IP "v2.x\tfall 1989"
231: many Usenet contributors
232: .IP "v3.0\t\ 1 May 90"
233: Info-ZIP (DPK, consolidator)
234: .IP "v3.1\t15 Aug 90"
235: Info-ZIP (DPK, consolidator)
236: .IP "v4.0\t\ 1 Dec 90"
237: Info-ZIP (GRR, maintainer)
238: .IP "v4.1\t12 May 91"
239: Info-ZIP
240: .IP "v4.2\t20 Mar 92"
241: Info-ZIP (zip-bugs subgroup; GRR, maint.)
242: .IP "v5.0\t21 Aug 92"
243: Info-ZIP (zip-bugs subgroup; GRR, maint.)
244: .PD
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.