BSDUNZIP(1)		    General Commands Manual		   BSDUNZIP(1)

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

Debian				 June 27, 2023				Debian