NAME

     bsdunzip — extract files from a ZIP archive

SYNOPSIS

     bsdunzip [-aCcfjLlnopqtuvy] [{ -O | -I } encoding] [-d dir] [-x pattern] [-P password]
              zipfile [member ...]

DESCRIPTION

     The following options are available:

     -a          When extracting a text file, convert DOS-style line endings to Unix-style line
                 endings.

     -C          Match file names case-insensitively.

     -c          Extract to stdout/screen.  When extracting files from the zipfile, they are
                 written to stdout.  This is similar to -p, but does not suppress normal output.

     -d dir      Extract files into the specified directory rather than the current directory.

     -f          Update existing.  Extract only files from the zipfile if a file with the same
                 name already exists on disk and is older than the former.  Otherwise, the file
                 is silently skipped.

     -I encoding

     -O encoding
                 Convert filenames from the specified encoding.

     -j          Ignore directories stored in the zipfile; instead, extract all files directly
                 into the extraction directory.

     -L          Convert the names of the extracted files and directories to lowercase.

     -l          List, rather than extract, the contents of the zipfile.

     -n          No overwrite.  When extracting a file from the zipfile, if a file with the same
                 name already exists on disk, the file is silently skipped.

     -o          Overwrite.  When extracting a file from the zipfile, if a file with the same
                 name already exists on disk, the existing file is replaced with the file from
                 the zipfile.

     -p          Extract to stdout.  When extracting files from the zipfile, they are written to
                 stdout.  The normal output is suppressed as if -q was specified.

     -P password
                 Extract encrypted files using a password.  Putting a password on the command
                 line using this option can be insecure.

     -q          Quiet: print less information while extracting.

     -t          Test: do not extract anything, but verify the checksum of every file in the
                 archive.

     -u          Update.  When extracting a file from the zipfile, if a file with the same name
                 already exists on disk, the existing file is replaced with the file from the
                 zipfile if and only if the latter is newer than the former.  Otherwise, the file
                 is silently skipped.

     -v          List verbosely, rather than extract, the contents of the zipfile.  This differs
                 from -l by using the long listing.  Note that most of the data is currently fake
                 and does not reflect the content of the archive.

     -x pattern  Exclude files matching the pattern pattern.

     -y          Print four digit years in listings instead of two.

     -Z mode     Emulate zipinfo(1L) mode.  Enabling zipinfo(1L) mode changes the way in which
                 additional arguments are parsed.  Currently only zipinfo(1L) mode 1 is
                 supported, which lists the file names one per line.

     [member ...]
                 Optional list of members to extract from the zipfile.  Can include patterns,
                 e.g., 'memberdir/*' will extract all files and dirs below memberdir.

     Note that only one of -n, -o, and -u may be specified.  If specified filename is "-", then
     data is read from stdin.

ENVIRONMENT

     If the UNZIP_DEBUG environment variable is defined, the -q command-line option has no
     effect, and additional debugging information will be printed to stderr.

COMPATIBILITY

     The bsdunzip utility aims to be sufficiently compatible with other implementations to serve
     as a drop-in replacement in the context of the ports(7) system.  No attempt has been made to
     replicate functionality which is not required for that purpose.

     For compatibility reasons, command-line options will be recognized if they are listed not
     only before but also after the name of the zipfile.

     Normally, the -a option should only affect files which are marked as text files in the
     zipfile's central directory.  Since the archive(3) library does not provide access to that
     information, it is not available to the bsdunzip utility.  Instead, the bsdunzip utility
     will assume that a file is a text file if no non-ASCII characters are present within the
     first block of data decompressed for that file.  If non-ASCII characters appear in
     subsequent blocks of data, a warning will be issued.

     The bsdunzip utility is only able to process ZIP archives handled by libarchive(3).
     Depending on the installed version of libarchive(3), this may or may not include self-
     extracting or ZIPX archives.

SEE ALSO

     libarchive(3)

HISTORY

     The bsdunzip utility appeared in FreeBSD 8.0.

AUTHORS

     The bsdunzip utility and this manual page were written by Dag-Erling Smørgrav
     <des@FreeBSD.org>.  It uses the archive(3) library developed by
     Tim Kientzle <kientzle@FreeBSD.org>.

CAVEATS

     The bsdunzip utility performs two scans of the command-line for arguments before and after
     the archive name, so as to maintain compatibility with Info-ZIP unzip.  As a result, the
     POSIX ‘--’ double-dash string used to separate options from arguments will need to be
     repeated.  For example, to extract a "-a.jpg" from "-b.zip" with overwrite, one would need
     to invoke
           bsdunzip -o -- -a.jpg -- -b.zip