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