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