version 1.13, 2002/05/30 20:34:57 |
version 1.14, 2002/12/08 16:07:54 |
|
|
.Nd compress and expand data |
.Nd compress and expand data |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm compress |
.Nm compress |
.Op Fl cdftgOqv |
.Op Fl LV |
|
.Nm compress |
|
.Op Fl cdfgOqtv123456789 |
.Op Fl b Ar bits |
.Op Fl b Ar bits |
.Op Fl o Ar filename |
.Op Fl o Ar filename |
.Op Ar |
.Op Ar |
.Nm uncompress |
.Nm uncompress |
.Op Fl cftoqv |
.Op Fl cfoqtv |
.Op Fl o Ar filename |
.Op Fl o Ar filename |
.Op Ar |
.Op Ar |
.Nm zcat |
.Nm zcat |
|
|
Each |
Each |
.Ar file |
.Ar file |
is renamed to the same name plus the extension |
is renamed to the same name plus the extension |
.Dq .Z . |
.Dq .Z , |
|
or |
|
.Dq .gz |
|
(in deflate mode). |
As many of the modification time, access time, file flags, file mode, |
As many of the modification time, access time, file flags, file mode, |
user ID, and group ID as allowed by permissions are retained in the |
user ID, and group ID as allowed by permissions are retained in the |
new file. |
new file. |
If compression would not reduce the size of a |
If compression would not reduce the size of a |
.Ar file , |
.Ar file , |
the file is ignored. |
the file is ignored (unless |
|
.Fl f |
|
is used). |
.Pp |
.Pp |
The |
The |
.Nm uncompress |
.Nm uncompress |
utility restores compressed files to their original form, renaming the |
utility restores compressed files to their original form, renaming the |
files by removing the |
files by removing the |
.Dq .Z |
.Dq .Z |
|
or |
|
.Dq .gz |
extension. |
extension. |
.Pp |
.Pp |
The |
The |
|
|
.Pp |
.Pp |
The options are as follows: |
The options are as follows: |
.Bl -tag -width Ds |
.Bl -tag -width Ds |
|
.It Fl L |
|
Display the source code license and exit. |
|
.It Fl V |
|
Display the program version (RCS Ids of the source files) and exit. |
.It Fl b Ar bits |
.It Fl b Ar bits |
Specify the |
Specify the |
.Ar bits |
.Ar bits |
code limit (see below). |
code limit (see below). |
.It Fl c |
.It Fl c |
Compressed or uncompressed output is written to the standard output. |
Compressed or uncompressed output is written to the standard output. |
No files are modified. |
No files are modified (force |
|
.Nm zcat |
|
mode). |
.It Fl d |
.It Fl d |
Decompress the source files instead of compressing them. |
Decompress the source files instead of compressing them (force |
|
.Nm uncompress |
|
mode). |
.It Fl f |
.It Fl f |
Force compression of |
Force compression of |
.Ar file , |
.Ar file , |
even if it is not actually reduced in size. |
even if it is not actually reduced in size. |
Additionally, files are overwritten without prompting for confirmation. |
Additionally, files are overwritten without prompting for confirmation. |
.It Fl g |
.It Fl g |
Use deflate scheme which reportedly provides better compression rates. |
Use deflate scheme which reportedly provides better compression rates (force |
|
.Nm gzip |
|
mode). |
|
.It Fl 1...9 |
|
Use deflate scheme with compression factor of one to nine. |
.It Fl O |
.It Fl O |
Use old compression method (default is based on the program name). |
Use old compression method. |
.It Fl o Ar filename |
.It Fl o Ar filename |
Set the output file name. |
Set the output file name. |
|
.It Fl S Ar suffix |
|
Set suffix for compressed files. |
.It Fl t |
.It Fl t |
Test the integrity of each file leaving any files intact. |
Test the integrity of each file leaving any files intact. |
.It Fl q |
.It Fl q |
Be quiet, suppress any messages. |
Be quiet, suppress all messages. |
.It Fl v |
.It Fl v |
Print the percentage reduction of each file. |
Print the percentage reduction of each file and other information. |
.El |
.El |
.Pp |
.Pp |
|
In normal mode, |
.Nm |
.Nm |
uses a modified Lempel-Ziv algorithm. |
uses a modified Lempel-Ziv algorithm. |
Common substrings in the file are first replaced by 9-bit codes 257 and up. |
Common substrings in the file are first replaced by 9-bit codes 257 and up. |
|
|
.Pp |
.Pp |
The |
The |
.Nm |
.Nm |
utility exits 0 on success, 1 if an error occurred, or 2 if one or |
utility exits with 0 on success, 1 if an error occurred, or 2 if one or |
more files were not compressed because they would have grown in |
more files were not compressed because they would have grown in |
size (and |
size (and |
.Fl f |
.Fl f |