| blob | d367d126fe2e505819a6cfa4e68e041e42fdb608 |
1 # --- T2-COPYRIGHT-NOTE-BEGIN ---
2 # This copyright note is auto-generated by ./scripts/Create-CopyPatch.
3 #
4 # T2 SDE: package/.../tar/tar-1.13.18-manpage.patch
5 # Copyright (C) 2004 - 2005 The T2 SDE Project
6 # Copyright (C) 1998 - 2003 ROCK Linux Project
7 #
8 # More information can be found in the files COPYING and README.
9 #
10 # This patch file is dual-licensed. It is available under the license the
11 # patched project is licensed under, as long as it is an OpenSource license
12 # as defined at http://www.opensource.org/ (e.g. BSD, X11) or under the terms
13 # of the GNU General Public License as published by the Free Software
14 # Foundation; either version 2 of the License, or (at your option) any later
15 # version.
16 # --- T2-COPYRIGHT-NOTE-END ---
18 --- ./tar.1.manpage Mon Oct 30 12:52:03 2000
19 +++ ./tar.1 Mon Oct 30 12:56:15 2000
20 @@ -0,0 +1,336 @@
21 +.\" @(#)tar.1 1.13.14 2000/10/30 Bero;
22 +.TH TAR 1 "30 October 2000"
23 +.SH NAME
24 +tar \- The GNU version of the tar archiving utility
25 +.SH SYNOPSIS
26 +.B tar
27 +[
28 +.B \-
29 +]
30 +.B A --catenate --concatenate \||\| c --create \||\| d --diff --compare \||\| r --append \||\| t --list \||\| u --update \||\| x -extract --get
31 +[
32 +.B --atime-preserve
33 +]
34 +[
35 +.B -b, --block-size N
36 +]
37 +[
38 +.B -B, --read-full-blocks
39 +]
40 +[
41 +.B -C, --directory DIR
42 +]
43 +[
44 +.B --checkpoint
45 +]
46 +[
47 +.B -f, --file [HOSTNAME:]F
48 +]
49 +[
50 +.B --force-local
51 +]
52 +[
53 +.B -F, --info-script F --new-volume-script F
54 +]
55 +[
56 +.B -G, --incremental
57 +]
58 +[
59 +.B -g, --listed-incremental F
60 +]
61 +[
62 +.B -h, --dereference
63 +]
64 +[
65 +.B -i, --ignore-zeros
66 +]
67 +[
68 +.B -j, -I, --bzip
69 +]
70 +[
71 +.B --ignore-failed-read
72 +]
73 +[
74 +.B -k, --keep-old-files
75 +]
76 +[
77 +.B -K, --starting-file F
78 +]
79 +[
80 +.B -l, --one-file-system
81 +]
82 +[
83 +.B -L, --tape-length N
84 +]
85 +[
86 +.B -m, --modification-time
87 +]
88 +[
89 +.B -M, --multi-volume
90 +]
91 +[
92 +.B -N, --after-date DATE, --newer DATE
93 +]
94 +[
95 +.B -o, --old-archive, --portability
96 +]
97 +[
98 +.B -O, --to-stdout
99 +]
100 +[
101 +.B -p, --same-permissions, --preserve-permissions
102 +]
103 +[
104 +.B -P, --absolute-paths
105 +]
106 +[
107 +.B --preserve
108 +]
109 +[
110 +.B -R, --record-number
111 +]
112 +[
113 +.B --remove-files
114 +]
115 +[
116 +.B -s, --same-order, --preserve-order
117 +]
118 +[
119 +.B --same-owner
120 +]
121 +[
122 +.B -S, --sparse
123 +]
124 +[
125 +.B -T, --files-from=F
126 +]
127 +[
128 +.B --null
129 +]
130 +[
131 +.B --totals
132 +]
133 +[
134 +.B -v, --verbose
135 +]
136 +[
137 +.B -V, --label NAME
138 +]
139 +[
140 +.B --version
141 +]
142 +[
143 +.B -w, --interactive, --confirmation
144 +]
145 +[
146 +.B -W, --verify
147 +]
148 +[
149 +.B --exclude FILE
150 +]
151 +[
152 +.B -X, --exclude-from FILE
153 +]
154 +[
155 +.B -Z, --compress, --uncompress
156 +]
157 +[
158 +.B -z, --gzip, --ungzip
159 +]
160 +[
161 +.B --use-compress-program PROG
162 +]
163 +[
164 +.B --block-compress
165 +]
166 +[
167 +.B -[0-7][lmh]
168 +]
169 +.TP
170 +.I filename1 [ filename2, ... filenameN ]
171 +.TP
172 +.I directory1 [ directory2, ...directoryN ]
173 +.SH DESCRIPTION
174 +.LP
175 +This manual page documents the GNU version of
176 +.B tar
177 +, an archiving program designed to store and extract files from
178 +an archive file known as a
179 +.IR tarfile.
180 +A
181 +.IR tarfile
182 +may be made on a tape drive, however, it is also common
183 +to write a
184 +.IR tarfile
185 +to a normal file.
186 +The first argument to
187 +.B tar
188 +must be one of the options:
189 +.BR Acdrtux ,
190 +followed by any optional functions.
191 +The final arguments to
192 +.B tar
193 +are the names of the files or directories which should be archived. The use
194 +of a directory name always implies that the subdirectories below should be
195 +included in the archive.
196 +.SH "FUNCTION LETTERS"
197 +.TP
198 +.B One of the following options must be used:
199 +.TP
200 +.B -A, --catenate, --concatenate
201 +append tar files to an archive
202 +.TP
203 +.B -c, --create
204 +create a new archive
205 +.TP
206 +.B -d, --diff, --compare
207 +find differences between archive and file system
208 +.TP
209 +.B --delete
210 +delete from the archive (not for use on mag tapes!)
211 +.TP
212 +.B -r, --append
213 +append files to the end of an archive
214 +.TP
215 +.B -t, --list
216 +list the contents of an archive
217 +.TP
218 +.B -u, --update
219 +only append files that are newer than copy in archive
220 +.TP
221 +.B -x, --extract, --get
222 +extract files from an archive
223 +.SH "OTHER OPTIONS"
224 +.TP
225 +.B --atime-preserve
226 +don't change access times on dumped files
227 +.TP
228 +.B -b, --block-size N
229 +block size of Nx512 bytes (default N=20)
230 +.TP
231 +.B -B, --read-full-blocks
232 +reblock as we read (for reading 4.2BSD pipes)
233 +.TP
234 +.B -C, --directory DIR
235 +change to directory DIR
236 +.TP
237 +.B --checkpoint
238 +print directory names while reading the archive
239 +.TP
240 +.B -f, --file [HOSTNAME:]F
241 +use archive file or device F (default /dev/rmt0)
242 +.TP
243 +.B --force-local
244 +archive file is local even if has a colon
245 +.TP
246 +.B -F, --info-script F --new-volume-script F
247 +run script at end of each tape (implies -M)
248 +.TP
249 +.B -G, --incremental
250 +create/list/extract old GNU-format incremental backup
251 +.TP
252 +.B -g, --listed-incremental F
253 +create/list/extract new GNU-format incremental backup
254 +.TP
255 +.B -h, --dereference
256 +don't dump symlinks; dump the files they point to
257 +.TP
258 +.B -i, --ignore-zeros
259 +ignore blocks of zeros in archive (normally mean EOF)
260 +.TP
261 +.B -j, -I, --bzip
262 +filter the archive through bzip2. Note: -I is deprecated and may get a
263 +different meaning in the near future.
264 +.TP
265 +.B --ignore-failed-read
266 +don't exit with non-zero status on unreadable files
267 +.TP
268 +.B -k, --keep-old-files
269 +keep existing files; don't overwrite them from archive
270 +.TP
271 +.B -K, --starting-file F
272 +begin at file F in the archive
273 +.TP
274 +.B -l, --one-file-system
275 +stay in local file system when creating an archive
276 +.TP
277 +.B -L, --tape-length N
278 +change tapes after writing N*1024 bytes
279 +.TP
280 +.B -m, --modification-time
281 +don't extract file modified time
282 +.TP
283 +.B -M, --multi-volume
284 +create/list/extract multi-volume archive
285 +.TP
286 +.B -N, --after-date DATE, --newer DATE
287 +only store files newer than DATE
288 +.TP
289 +.B -o, --old-archive, --portability
290 +write a V7 format archive, rather than ANSI format
291 +.TP
292 +.B -O, --to-stdout
293 +extract files to standard output
294 +.TP
295 +.B -p, --same-permissions, --preserve-permissions
296 +extract all protection information
297 +.TP
298 +.B -P, --absolute-paths
299 +don't strip leading `/'s from file names
300 +.TP
301 +.B --preserve
302 +like -p -s
303 +.TP
304 +.B -R, --record-number
305 +show record number within archive with each message
306 +.TP
307 +.B --remove-files
308 +remove files after adding them to the archive
309 +.TP
310 +.B -s, --same-order, --preserve-order
311 +list of names to extract is sorted to match archive
312 +.TP
313 +.B --same-owner
314 +create extracted files with the same ownership
315 +.TP
316 +.B -S, --sparse
317 +handle sparse files efficiently
318 +.TP
319 +.B -T, --files-from=F
320 +get names to extract or create from file F
321 +.TP
322 +.B --null
323 +-T reads null-terminated names, disable -C
324 +.TP
325 +.B --totals
326 +print total bytes written with --create
327 +.TP
328 +.B -v, --verbose
329 +verbosely list files processed
330 +.TP
331 +.B -V, --label NAME
332 +create archive with volume name NAME
333 +.TP
334 +.B --version
335 +print tar program version number
336 +.TP
337 +.B -w, --interactive, --confirmation
338 +ask for confirmation for every action
339 +.TP
340 +.B -W, --verify
341 +attempt to verify the archive after writing it
342 +.TP
343 +.B --exclude FILE
344 +exclude file FILE
345 +.TP
346 +.B -X, --exclude-from FILE
347 +exclude files listed in FILE
348 +.TP
349 +.B -Z, --compress, --uncompress
350 +filter the archive through compress
351 +.TP
352 +.B -z, --gzip, --ungzip
353 +filter the archive through gzip
354 +.TP
355 +.B --use-compress-program PROG
356 +filter the archive through PROG (which must accept -d)