Penguin
Recent Changes
Annotated edit history of tar(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 TAR
2 !!!TAR
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 EXAMPLES
7 FUNCTION LETTERS
8 OTHER OPTIONS
9 BUGS
10 ----
11 !!NAME
12
13
14 tar - The GNU version of the tar archiving utility
15 !!SYNOPSIS
16
17
18 __tar__ [[ __-__ ] __A --catenate --concatenate | c
19 --create | d --diff --compare | r --append | t --list | u
20 --update | x -extract --get__ [[ __--atime-preserve__ ]
21 [[ __-b, --block-size N__ ] [[ __-B,
22 --read-full-blocks__ ] [[ __-C, --directory DIR__ ] [[
23 __--checkpoint__ ] [[ __-f, --file [[HOSTNAME:]F__ ] [[
24 __--force-local__ ] [[ __-F, --info-script F
25 --new-volume-script F__ ] [[ __-G, --incremental__ ] [[
26 __-g, --listed-incremental F__ ] [[ __-h,
27 --dereference__ ] [[ __-i, --ignore-zeros__ ] [[ __-j,
28 --bzip2__ ] [[ __--ignore-failed-read__ ] [[ __-k,
29 --keep-old-files__ ] [[ __-K, --starting-file F__ ] [[
30 __-l, --one-file-system__ ] [[ __-L, --tape-length N__
31 ] [[ __-m, --modification-time__ ] [[ __-M,
32 --multi-volume__ ] [[ __-N, --after-date DATE, --newer
33 DATE__ ] [[ __-o, --old-archive, --portability__ ] [[
34 __-O, --to-stdout__ ] [[ __-p, --same-permissions,
35 --preserve-permissions__ ] [[ __-P, --absolute-names__ ]
36 [[ __--preserve__ ] [[ __-R, --record-number__ ] [[
37 __--remove-files__ ] [[ __-s, --same-order,
38 --preserve-order__ ] [[ __--same-owner__ ] [[
39 __--numeric-owner__ ] [[ __-S, --sparse__ ] [[ __-T,
40 --files-from F__ ] [[ __--null__ ] [[ __--totals__ ] [[
41 __-v, --verbose__ ] [[ __-V, --label NAME__ ] [[
42 __--version__ ] [[ __-w, --interactive,
43 --confirmation__ ] [[ __-W, --verify__ ] [[
44 __--exclude=FILE__ ] [[ __-X, --exclude-from FILE__ ] [[
45 __-Z, --compress, --uncompress__ ] [[ __-z, --gzip,
46 --ungzip__ ] [[ __--use-compress-program PROG__ ] [[
47 __--block-compress__ ] [[ __--rsh-command=CMD__ ] [[
48 __-[[0-7][[lmh]__ ]
49
50
51 ''filename1 [[ filename2, ... filenameN ]''
52
53
54 ''directory1 [[ directory2, ...directoryN ]''
55 !!DESCRIPTION
56
57
58 This manual page documents the GNU version of __tar__ ,
59 an archiving program designed to store and extract files
60 from an archive file known as a ''tarfile.'' A
61 ''tarfile'' may be made on a tape drive, however, it is
62 also common to write a ''tarfile'' to a normal file. The
63 first argument to __tar__ must be one of the options:
64 __Acdrtux__, followed by any optional functions. The
65 final arguments to __tar__ are the names of the files or
66 directories which should be archived. The use of a directory
67 name always implies that the subdirectories below should be
68 included in the archive.
69 !!EXAMPLES
70
71
72 __tar -xvvf foo.tar__
73
74
75 extract foo.tar
76
77
78 __tar -xvvzf foo.tar.gz__
79
80
81 extract gzipped foo.tar.gz
82
83
84 __tar -cvvf foo.tar foo/__
85
86
87 tar contents of folder foo in foo.tar
88 !!FUNCTION LETTERS
89
90
91 __One of the following options must be
92 used:__
93
94
95 __-A, --catenate, --concatenate__
96
97
98 append tar files to an archive
99
100
101 __-c, --create__
102
103
104 create a new archive
105
106
107 __-d, --diff, --compare__
108
109
110 find differences between archive and file
111 system
112
113
114 __--delete__
115
116
117 delete from the archive (not for use on mag
118 tapes!)
119
120
121 __-r, --append__
122
123
124 append files to the end of an archive
125
126
127 __-t, --list__
128
129
130 list the contents of an archive
131
132
133 __-u, --update__
134
135
136 only append files that are newer than copy in
137 archive
138
139
140 __-x, --extract, --get__
141
142
143 extract files from an archive
144 !!OTHER OPTIONS
145
146
147 __--atime-preserve__
148
149
150 don't change access times on dumped files
151
152
153 __-b, --block-size N__
154
155
156 block size of Nx512 bytes (default N=20)
157
158
159 __-B, --read-full-blocks__
160
161
162 reblock as we read (for reading 4.2BSD pipes)
163
164
165 __-C, --directory DIR__
166
167
168 change to directory DIR
169
170
171 __--checkpoint__
172
173
174 print directory names while reading the archive
175
176
177 __-f, --file [[HOSTNAME:]F__
178
179
180 use archive file or device F (default
181
182
183 __--force-local__
184
185
186 archive file is local even if has a colon
187
188
189 __-F, --info-script F --new-volume-script
190 F__
191
192
193 run script at end of each tape (implies -M)
194
195
196 __-G, --incremental__
197
198
199 create/list/extract old GNU-format incremental
200 backup
201
202
203 __-g, --listed-incremental F__
204
205
206 create/list/extract new GNU-format incremental
207 backup
208
209
210 __-h, --dereference__
211
212
213 don't dump symlinks; dump the files they point
214 to
215
216
217 __-i, --ignore-zeros__
218
219
220 ignore blocks of zeros in archive (normally mean
221 EOF)
222
223
224 __-j, --bzip2__
225
226
227 filter archive through bzip2, use to decompress .bz2
228 files
229
230
231 __--ignore-failed-read__
232
233
234 don't exit with non-zero status on unreadable
235 files
236
237
238 __-k, --keep-old-files__
239
240
241 keep existing files; don't overwrite them from
242 archive
243
244
245 __-K, --starting-file F__
246
247
248 begin at file F in the archive
249
250
251 __-l, --one-file-system__
252
253
254 stay in local file system when creating an
255 archive
256
257
258 __-L, --tape-length N__
259
260
261 change tapes after writing N*1024 bytes
262
263
264 __-m, --modification-time__
265
266
267 don't extract file modified time
268
269
270 __-M, --multi-volume__
271
272
273 create/list/extract multi-volume archive
274
275
276 __-N, --after-date DATE, --newer DATE__
277
278
279 only store files newer than DATE
280
281
282 __-o, --old-archive, --portability__
283
284
285 write a V7 format archive, rather than ANSI
286 format
287
288
289 __-O, --to-stdout__
290
291
292 extract files to standard output
293
294
295 __-p, --same-permissions,
296 --preserve-permissions__
297
298
299 extract all protection information
300
301
302 __-P, --absolute-paths__
303
304
305 don't strip leading `/'s from file names
306
307
308 __--preserve__
309
310
311 like -p -s
312
313
314 __-R, --record-number__
315
316
317 show record number within archive with each
318 message
319
320
321 __--remove-files__
322
323
324 remove files after adding them to the archive
325
326
327 __-s, --same-order, --preserve-order__
328
329
330 list of names to extract is sorted to match
331 archive
332
333
334 __--same-owner__
335
336
337 create extracted files with the same ownership
338
339
340 __--numeric-owner__
341
342
343 always use numbers for user/group names
344
345
346 __-S, --sparse__
347
348
349 handle sparse files efficiently
350
351
352 __-T, --files-from F__
353
354
355 get names to extract or create from file F
356
357
358 __--null__
359
360
361 -T reads null-terminated names, disable -C
362
363
364 __--totals__
365
366
367 print total bytes written with --create
368
369
370 __-v, --verbose__
371
372
373 verbosely list files processed
374
375
376 __-V, --label NAME__
377
378
379 create archive with volume name NAME
380
381
382 __--version__
383
384
385 print tar program version number
386
387
388 __-w, --interactive, --confirmation__
389
390
391 ask for confirmation for every action
392
393
394 __-W, --verify__
395
396
397 attempt to verify the archive after writing it
398
399
400 __--exclude=FILE__
401
402
403 exclude file FILE
404
405
406 __-X, --exclude-from FILE__
407
408
409 exclude files listed in FILE
410
411
412 __-Z, --compress, --uncompress__
413
414
415 filter the archive through compress
416
417
418 __-z, --gzip, --ungzip__
419
420
421 filter the archive through gzip
422
423
424 __--use-compress-program PROG__
425
426
427 filter the archive through PROG (which must accept
428 -d)
429
430
431 __--block-compress__
432
433
434 block the output of compression program for
435 tapes
436
437
438 __--rsh-command=CMD__
439
440
441 Use remote COMMAND instead of `rsh'. This option exists so
442 that people who use something other than the standard `rsh'
443 (e.g., a Kerberized `rsh') can access a remote
444 device.
445
446
447 __-[[0-7][[lmh]__
448
449
450 specify drive and density
451 !!BUGS
452
453
454 The GNU folks, in general, abhor man pages, and create info
455 documents instead. The maintainer of tar falls into this
456 category. This man page is neither complete, nor current,
457 and was included in the Debian Linux packaging of tar
458 entirely to reduce the frequency with which the lack of a
459 man page gets reported as a bug in our defect tracking
460 system.
461
462
463 If you really want to understand tar, then you should run
464 info and read the tar info pages, or use the info mode in
465 emacs.
466 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.