File: z.html

package info (click to toggle)
comprez 2.6.1-2
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd, wheezy
  • size: 152 kB
  • ctags: 57
  • sloc: sh: 484; makefile: 43
file content (184 lines) | stat: -rw-r--r-- 6,973 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
<html><head>
<title>z(1) man page</title>
<LINK REV="made" HREF="mailto:kinzler@cs.indiana.edu">
<meta name="resource-type" content="document">
<meta name="description"
content="HTML version of Unix man page for z(1)">
<meta name="keywords"
content="z, tar, untar, compress, uncompress, zip, unzip, feather, defeather,
gzip, gunzip, bzip2, bunzip2, lzip, jar">
<meta name="distribution" content="global">
</head><body bgcolor="#FFFFFF">

<h2>NAME</h2>

<p>z - safely (un)tar and (de)feather files and directories</p>

<h2>SYNOPSIS</h2>

<p><b>z</b> [ <b>-t</b> | <b>-T</b> ] [ <b>-v</b> | <b>-V</b> ]
[ <b>-l</b> | <b>-L</b> ]
[ <b>-gz</b> | <b>-z</b> | <b>-I</b> | <b>-lz</b> | <b>-Z</b> | <b>-zip</b> | <b>-jar</b> ]
[ <b>-#</b> ] [ <b>-s</b> <i>suffix</i> ] [ <b>-m</b> <i>mode</i> ]
[ <b>-p</b> | <b>-P</b> ] [ <b>-h</b> ] [ <b>--</b> ] <i>file ...</i></p>

<h2>DESCRIPTION</h2>

<p><i>Z</i> is a simple, safe and convenient front-end for the
<i>compress</i>(1), <i>uncompress</i>(1), <i>gzip</i>(1),
<i>bzip2</i>(1), <i>lzip</i>(1), <i>tar</i>(1), <i>zip</i>(1) and
<i>unzip</i>(1) utilities for compressing and uncompressing files and
directories. It processes each of its arguments according to the type of
the file or directory given:</p>

<p>If the argument is a plain file, then the file is compressed, ie,
feathered.</p>

<p>If the argument is a compressed file with a name ending in <b>.Z</b>,
<b>.gz</b>, <b>.z</b>, <b>.bz2</b>, <b>.lz</b>, <b>.zip</b> or
<b>.jar</b>, then the file is uncompressed, ie, defeathered.</p>

<p>If the argument is a directory, then the directory is archived into one
tar or zip file which is then compressed, ie, tarred and feathered.</p>

<p>If the argument is a compressed tar or zip archive with a name ending
in <b>.{tar.,tar,ta,t}{Z,gz,z,bz2,lz}</b> or <b>.{zip,jar}</b>, then the
archive is uncompressed and untarred, ie, untarred and defeathered.</p>

<p>The new compressed or uncompressed version will be in the same
directory as the original.  A compressed file is always uncompressed
into a file with the same name sans the feather suffix.  A compressed
tar or zip archive is always unpacked into a subdirectory with the same
name as the archive sans the tar and feather suffix, even if the archive
did not itself contain such a subdirectory.</p>

<h2>OPTIONS</h2>

<dl>
<dt>--
<dd>Interprets all following arguments as files instead of options.
<dt>-#
<dd>Where <b>#</b> is a digit from 1 through 9.  This option is passed on
    to <i>gzip</i>(1), <i>bzip2</i>(1), <i>lzip</i>(1) and <i>zip</i>(1)
    when feathering with them.  <b>--fast</b> may be used instead of
    <b>-1</b> and <b>--best</b> instead of <b>-9</b>.
<dt>-gz
<dd>Uses <i>gzip</i>(1) and a <b>.gz</b> compression suffix when
    feathering.
<dt>-h
<dd>Prints a helpful usage message.
<dt>-I
<dd>Uses <i>bzip2</i>(1) and a <b>.bz2</b> compression suffix when
    feathering.
<dt>-l
<dd>Lists the file or directory name created resulting from each argument.
<dt>-L
<dd>Does not report created files or directories.  Default.
<dt>-lz
<dd>Uses <i>lzip</i>(1) and a <b>.lz</b> compression suffix when
    feathering.
<dt>-m mode
<dd>Apply the given <i>chmod</i>(1) mode argument to any created tar
    and feather files.  Before this argument is applied, the files
    have the same read and write permissions as the directories from
    which they were created.  For security, the default argument is
    <b>go-rwx</b>.  If the mode is <b>-</b>, then no argument is applied.
    See <i>chmod</i>(1) for all other allowable formats of this argument.
<dt>-p
<dd>Preserves modes when untarring by giving the <b>p</b> flag to
    <i>tar</i>(1).  Default.
<dt>-P
<dd>Doesn't preserve modes when untarring by not giving the <b>p</b>
    flag to <i>tar</i>(1).  This option may be necessary on systems
    where ordinary users are allowed to run <i>chown</i>(2).
<dt>-s suffix
<dd>Creates tar and feather files using the given suffix style.
    The default suffix style is <b>.tar.Z</b>.  Note that the suffix
    style does not dictate the program used for feathering nor the
    compression suffix.
<dt>-t
<dd>Only lists the table of contents of the given files.  Does not make
    any changes.
<dt>-T
<dd>(Un)tars and (de)feathers the given files according to their type.
    Default.
<dt>-v
<dd>Verbose output.  For example, reports compression ratios when feathering.
<dt>-V
<dd>Non-verbose output.  Does not report compression ratios.  Default.
    <b>-q</b> is a synonym.
<dt>-z
<dd>Uses <i>gzip</i>(1) and a <b>.z</b> compression suffix when
    feathering.
<dt>-Z
<dd>Uses <i>compress</i>(1) and a <b>.Z</b> compression suffix when
    feathering.  Default.
<dt>-zip, -jar
<dd>Uses <i>zip</i>(1) and a <b>.zip</b> or <b>.jar</b> compression
    suffix when tarring and/or feathering.  The zip format combines
    tarring and feathering.  <b>WARNING:</b> zip does not preserve
    complete Unix filesystem information for the files it archives,
    such as links, some permissions, etc.  A <i>tar</i>(1)-based format
    should be used if this is required.
</dl>

<h2>ENVIRONMENT VARIABLES</h2>

<dl>
<dt>ZOPTS
<dd>This variable may be set to a string of the above options to supersede
    the default settings.  They may still be overridden by options given
    on the command line.
<dt>GZIP
<dd>This environment variable for <i>gzip</i>(1) is <b>not</b> passed
    on by <i>z</i> so that <i>gzip</i>'s behavior is standard and
    predictable.
<dt>ZIPOPT, UNZIP
<dd>These environment variables for <i>zip</i>(1) and <i>unzip</i>(1)
    are <b>not</b> passed on by <i>z</i> so that their behavior is
    standard and predictable.
</dl>

<h2>BUGS</h2>

<p>There should be an option to allow the use of another directory
for temporary files needed during the (un)tarring and (de)feathering
processes.  This would make <i>z</i> more useful when the quota or disk
is nearly full.</p>

<p>There should be <b>-k</b> and <b>-K</b> options for keeping the
original input files or not.</p>

<h2>CAVEATS</h2>

<p><i>Z</i> is written to work with <i>gzip</i> versions 1.2.3 and 1.2.4,
<i>bzip2</i> versions 0.9.0 and 1.0.0, Unix <i>zip</i> version 2.0.1
and Unix <i>unzip</i> version 5.12.  Other versions will probably work
safely, too, but should still be checked for compatibility.</p>

<p>Every effort has been made to assure that the use of this program
will not lead to the inappropriate deletion or corruption of any files.
However, there are never any guarantees, so please use at your own
risk.</p>

<h2>VERSION</h2>

<p>2.6.1</p>

<h2>AUTHOR</h2>

<p><a href="http://www.cs.indiana.edu/~kinzler/">Steve Kinzler</a>,
<a href="mailto:kinzler@cs.indiana.edu">kinzler@cs.indiana.edu</a>,
May 89/Jun 93/Aug 99/Dec 00</p>

<h2>URL</h2>

<p><a href="http://www.cs.indiana.edu/~kinzler/z/">
http://www.cs.indiana.edu/~kinzler/z</a></p>

<h2>SEE ALSO</h2>

<p>compress(1), uncompress(1), gzip(1), bzip2(1), lzip(1), tar(1),
zip(1), unzip(1)</p>

</body></html>