2 .\" Copyright (c) 2007-2008 Dag-Erling Smørgrav
3 .\" All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in the
12 .\" documentation and/or other materials provided with the distribution.
14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 .Nd extract files from a ZIP archive
41 The following options are available:
44 When extracting a text file, convert DOS-style line endings to
45 Unix-style line endings.
47 Match file names case-insensitively.
49 Extract to stdout/screen.
50 When extracting files from the zipfile, they are written to stdout.
53 but doesn't suppress normal output.
55 Extract files into the specified directory rather than the current
59 Extract only files from the zipfile if a file with the same name
60 already exists on disk and is older than the former.
61 Otherwise, the file is silently skipped.
63 Ignore directories stored in the zipfile; instead, extract all files
64 directly into the extraction directory.
66 Convert the names of the extracted files and directories to lowercase.
68 List, rather than extract, the contents of the zipfile.
71 When extracting a file from the zipfile, if a file with the same name
72 already exists on disk, the file is silently skipped.
75 When extracting a file from the zipfile, if a file with the same name
76 already exists on disk, the existing file is replaced with the file
80 When extracting files from the zipfile, they are written to stdout.
81 The normal output is suppressed as if
85 Quiet: print less information while extracting.
87 Test: do not extract anything, but verify the checksum of every file
91 When extracting a file from the zipfile, if a file with the same name
92 already exists on disk, the existing file is replaced with the file
93 from the zipfile if and only if the latter is newer than the former.
94 Otherwise, the file is silently skipped.
96 List verbosely, rather than extract, the contents of the zipfile.
99 by using the long listing.
100 Note that most of the data is currently fake and does not reflect the
101 content of the archive.
103 Exclude files matching the pattern
111 mode changes the way in which additional arguments are parsed.
114 mode 1 is supported, which lists the file names one per line.
117 Note that only one of
123 If specified filename is
125 then data is read from
130 environment variable is defined, the
132 command-line option has no effect, and additional debugging
133 information will be printed to
138 utility aims to be sufficiently compatible with other implementations
139 to serve as a drop-in replacement in the context of the
142 No attempt has been made to replicate functionality which is not
143 required for that purpose.
145 For compatibility reasons, command-line options will be recognized if
146 they are listed not only before but also after the name of the
151 option should only affect files which are marked as text files in the
152 zipfile's central directory.
155 library reads zipfiles sequentially, and does not use the central
156 directory, that information is not available to the
161 utility will assume that a file is a text file if no non-ASCII
162 characters are present within the first block of data decompressed for
164 If non-ASCII characters appear in subsequent blocks of data, a warning
169 utility is only able to process ZIP archives handled by
171 Depending on the installed version of
173 this may or may not include self-extracting archives.
184 utility and this manual page were written by
185 .An Dag-Erling Sm\(/orgrav Aq des@FreeBSD.org .
189 .An Tim Kientzle Aq kientzle@FreeBSD.org .