Annotation of src/usr.bin/compress/znew.1, Revision 1.4
1.4 ! jmc 1: .\" $OpenBSD: znew.1,v 1.3 2007/01/24 10:53:43 jmc Exp $
1.1 otto 2: .\"
3: .\" Copyright (c) 2003 Otto Moerbeek <otto@drijf.net>
4: .\"
5: .\" Permission to use, copy, modify, and distribute this software for any
6: .\" purpose with or without fee is hereby granted, provided that the above
7: .\" copyright notice and this permission notice appear in all copies.
8: .\"
9: .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10: .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11: .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12: .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13: .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14: .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15: .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16: .\"
1.4 ! jmc 17: .Dd $Mdocdate$
1.1 otto 18: .Dt ZNEW 1
19: .Os
20: .Sh NAME
21: .Nm znew
22: .Nd convert compressed files to gzipped files
23: .Sh SYNOPSIS
24: .Nm
1.2 jmc 25: .Op Fl 9fKtv
1.1 otto 26: .Ar
27: .Sh DESCRIPTION
28: The
29: .Nm
30: utility uncompresses files compressed by
31: .Xr compress 1
32: and recompresses them with
33: .Xr gzip 1 .
34: .Pp
35: The options are as follows:
36: .Bl -tag -width Ds
1.2 jmc 37: .It Fl 9
38: Use the -9 mode of
39: .Xr gzip 1 ,
40: achieving better compression at the cost of slower execution.
1.1 otto 41: .It Fl f
42: Overwrite existing
43: .Sq .gz
44: files.
45: Unless this option is specified,
46: .Nm
47: refuses to overwrite existing files.
1.2 jmc 48: .It Fl K
49: Keep the original
50: .Sq .Z
51: file if it uses less disk blocks than the gzipped one.
52: A disk block is 1024 bytes.
1.1 otto 53: .It Fl t
54: Test integrity of the gzipped file before deleting the original file.
55: If the integrity check fails, the original
56: .Sq .Z
57: file is not removed.
58: .It Fl v
59: Print a report specifying the achieved compression ratios.
60: .El
61: .Sh SEE ALSO
1.3 jmc 62: .Xr compress 1 ,
1.1 otto 63: .Xr gzip 1
64: .Sh CAVEATS
65: The
66: .Nm
67: utility tries to maintain the file mode of the original file.
1.2 jmc 68: If the original file is not writable, it will be unable to do so and
1.1 otto 69: .Nm
70: will print a warning.