224 lines
4.2 KiB
Plaintext
224 lines
4.2 KiB
Plaintext
.TH GZIP 1
|
|
.SH NAME
|
|
gzip, gunzip, bzip2, bunzip2, compress, uncompress, zip, unzip \- compress and expand data
|
|
.SH SYNOPSIS
|
|
.B gzip
|
|
.RB [ -cvnD [ 1-9 ]]
|
|
.RI [ file
|
|
.BR ... ]
|
|
.PP
|
|
.B gunzip
|
|
.RB [ -ctTvD ]
|
|
.RI [ file
|
|
.BR ... ]
|
|
.PP
|
|
.B bzip2
|
|
.RB [ -cvnD [ 1-9 ]]
|
|
.RI [ file
|
|
.BR ... ]
|
|
.PP
|
|
.B bunzip2
|
|
.RB [ -cvD ]
|
|
.RI [ file
|
|
.BR ... ]
|
|
.PP
|
|
.B compress
|
|
[
|
|
.B -cv
|
|
] [
|
|
.I file
|
|
.B ...
|
|
]
|
|
.PP
|
|
.B uncompress
|
|
[
|
|
.B -cv
|
|
] [
|
|
.I file
|
|
.B ...
|
|
]
|
|
.PP
|
|
.B zip
|
|
.RB [ -avD [ 1-9 ]]
|
|
.RB [ -f
|
|
.IR zipfile ]
|
|
.I file
|
|
.RB [ ... ]
|
|
.PP
|
|
.B unzip
|
|
.RB [ -cistTvD ]
|
|
.RB [ -f
|
|
.IR zipfile ]
|
|
.RI [ file
|
|
.BR ... ]
|
|
.SH DESCRIPTION
|
|
.PP
|
|
.I Gzip
|
|
encodes files with a hybrid Lempel-Ziv 1977 and Huffman compression algorithm
|
|
known as
|
|
.BR deflate .
|
|
Most of the time, the resulting file is smaller,
|
|
and will never be much bigger.
|
|
Output files are named by taking the last path element of each file argument
|
|
and appending
|
|
.BR .gz ;
|
|
if the resulting name ends with
|
|
.BR .tar.gz ,
|
|
it is converted to
|
|
.B .tgz
|
|
instead.
|
|
.I Gunzip
|
|
reverses the process.
|
|
Its output files are named by taking the last path element of each file argument,
|
|
converting
|
|
.B .tgz
|
|
to
|
|
.BR .tar.gz ,
|
|
and stripping any
|
|
.BR .gz ;
|
|
the resulting name must be different from the original name.
|
|
.PP
|
|
.I Bzip2
|
|
and
|
|
.I bunzip2
|
|
are similar in interface to
|
|
.I gzip
|
|
and
|
|
.IR gunzip ,
|
|
but use a modified Burrows-Wheeler block sorting
|
|
compression algorithm.
|
|
The default suffix for output files is
|
|
.BR .bz2 ,
|
|
with
|
|
.B .tar.bz2
|
|
becoming
|
|
.BR .tbz .
|
|
.I Bunzip2
|
|
recognizes the extension
|
|
.B .tbz2
|
|
as a synonym for
|
|
.BR .tbz .
|
|
.PP
|
|
.I Compress
|
|
and
|
|
.I uncompress
|
|
are similar in interface to
|
|
.I gzip
|
|
and
|
|
.IR gunzip ,
|
|
but use the Lempel-Ziv-Welch compression algorithm.
|
|
The default suffix for output files is
|
|
.BR .Z .
|
|
.I Compress
|
|
is one of the oldest widespread Unix compression programs.
|
|
.PP
|
|
.I Zip
|
|
encodes the named files and places the results into the archive
|
|
.IR zipfile ,
|
|
or the standard output if no file is given.
|
|
.I Unzip
|
|
extracts files from an archive created by
|
|
.IR zip .
|
|
If no files are named as arguments, all of files in the archive are extracted.
|
|
A directory's name implies all recursively contained files and subdirectories.
|
|
.I Zip
|
|
is the
|
|
.I "de facto"
|
|
standard for compression on Microsoft operating systems.
|
|
.PP
|
|
None of these programs removes the original files.
|
|
If the process fails, the faulty output files are removed.
|
|
.PP
|
|
The options are:
|
|
.TP 0.6i
|
|
.B -a
|
|
Automaticialy creates directories as needed, needed for zip files
|
|
created by broken implementations which omit directories.
|
|
.TP
|
|
.B -c
|
|
Write to standard output rather than creating an output file.
|
|
.TP
|
|
.B -i
|
|
Convert all archive file names to lower case.
|
|
.TP
|
|
.B -s
|
|
Streaming mode. Looks at the file data adjacent to each compressed file
|
|
rather than seeking in the central file directory.
|
|
This is the mode used by
|
|
.I unzip
|
|
if no
|
|
.I zipfile
|
|
is specified.
|
|
If
|
|
.B -s
|
|
is given,
|
|
.B -T
|
|
is ignored.
|
|
.TP
|
|
.B -t
|
|
List matching files in the archive rather than extracting them.
|
|
.TP
|
|
.B -T
|
|
Set the output time to that specified in the archive.
|
|
.TP
|
|
.BR -1 " .. " -9
|
|
Sets the compression level.
|
|
.B -1
|
|
is tuned for speed,
|
|
.B -9
|
|
for minimal output size.
|
|
The best compromise is
|
|
.BR -6 ,
|
|
the default.
|
|
.TP
|
|
.B -v
|
|
Produce more descriptive output.
|
|
With
|
|
.BR -t ,
|
|
adds the uncompressed size in bytes and the modification time to the output.
|
|
Without
|
|
.BR -t ,
|
|
prints the names of files on standard error as they are compressed or decompressed.
|
|
.TP
|
|
.B -n
|
|
The
|
|
.I gzip
|
|
and
|
|
.I bzip2
|
|
file formats include a modification timestamp which is by default set
|
|
to the modification time of the files being compressed or the current
|
|
time when the source file is read from standard input.
|
|
The
|
|
.B -n
|
|
flag overrides this behaviour and puts a timestamp of zero instead,
|
|
making the compressed output deterministic.
|
|
.TP
|
|
.B -D
|
|
Produce debugging output.
|
|
.SH SOURCE
|
|
.B /sys/src/cmd/gzip
|
|
.br
|
|
.B /sys/src/cmd/bzip2
|
|
.br
|
|
.B /sys/src/cmd/compress
|
|
.SH SEE ALSO
|
|
.IR tar (1)
|
|
.br
|
|
"A Technique for High Performance Data Compression",
|
|
Terry A. Welch,
|
|
.IR "IEEE Computer" ,
|
|
vol. 17, no. 6 (June 1984), pp. 8-19.
|
|
.SH BUGS
|
|
.I Unzip
|
|
can only extract files which are uncompressed or compressed
|
|
with the
|
|
.B deflate
|
|
compression scheme. Recent zip files fall into this category.
|
|
Very recent zip files may have tables of contents that
|
|
.I unzip
|
|
cannot read. Such files are still readable by invoking
|
|
.I unzip
|
|
with the
|
|
.B -s
|
|
option.
|