|
Lines 1-4
Link Here
|
| 1 |
.TH TAR 1 "Oct 2004" "GNU" "tar" |
1 |
.TH TAR 1 "May 2007" "GNU" "tar" |
| 2 |
.SH NAME |
2 |
.SH NAME |
| 3 |
tar \- The GNU version of the tar archiving utility |
3 |
tar \- The GNU version of the tar archiving utility |
| 4 |
.SH SYNOPSIS |
4 |
.SH SYNOPSIS |
|
Lines 20-26
Link Here
|
| 20 |
.I Common Options: |
20 |
.I Common Options: |
| 21 |
.nf |
21 |
.nf |
| 22 |
.BR -C ", " --directory " DIR" |
22 |
.BR -C ", " --directory " DIR" |
| 23 |
.BR -f ", " --file " F" |
23 |
.BR -f ", " --file " FILE" |
| 24 |
.BR -j ", " --bzip2 |
24 |
.BR -j ", " --bzip2 |
| 25 |
.BR -p ", " --preserve-permissions |
25 |
.BR -p ", " --preserve-permissions |
| 26 |
.BR -v ", " --verbose |
26 |
.BR -v ", " --verbose |
|
Lines 48-63
Link Here
|
| 48 |
.BR -C ", " --directory " DIR" |
48 |
.BR -C ", " --directory " DIR" |
| 49 |
] |
49 |
] |
| 50 |
[ |
50 |
[ |
| 51 |
.BR --check-links |
51 |
.BR --checkpoint |
| 52 |
] |
52 |
] |
| 53 |
[ |
53 |
[ |
| 54 |
.BR --checkpoint |
54 |
.BR --delay-directory-restore |
|
|
55 |
] |
| 56 |
[ |
| 57 |
.BR --exclude " PATTERN" |
| 58 |
] |
| 59 |
[ |
| 60 |
.BR --exclude-caches |
| 61 |
] |
| 62 |
[ |
| 63 |
.BR --exclude-tag " FILE" |
| 55 |
] |
64 |
] |
| 56 |
[ |
65 |
[ |
| 57 |
.BR -f ", " --file " [HOSTNAME:]F" |
66 |
.BR -f ", " --file " [HOSTNAME:]FILE" |
| 58 |
] |
67 |
] |
| 59 |
[ |
68 |
[ |
| 60 |
.BR -F ", " --info-script " F, " --new-volume-script " F" |
69 |
.BR -F ", " --info-script " FILE, " --new-volume-script " FILE" |
| 61 |
] |
70 |
] |
| 62 |
[ |
71 |
[ |
| 63 |
.BR --force-local |
72 |
.BR --force-local |
|
Lines 66-72
Link Here
|
| 66 |
.BR --format " FORMAT" |
75 |
.BR --format " FORMAT" |
| 67 |
] |
76 |
] |
| 68 |
[ |
77 |
[ |
| 69 |
.BR -g ", " --listed-incremental " F" |
78 |
.BR -g ", " --listed-incremental " SNAPSHOT" |
| 70 |
] |
79 |
] |
| 71 |
[ |
80 |
[ |
| 72 |
.BR -G ", " --incremental |
81 |
.BR -G ", " --incremental |
|
Lines 87-92
Link Here
|
| 87 |
.BR --ignore-case |
96 |
.BR --ignore-case |
| 88 |
] |
97 |
] |
| 89 |
[ |
98 |
[ |
|
|
99 |
.BR --ignore-command-error |
| 100 |
] |
| 101 |
[ |
| 90 |
.BR --ignore-failed-read |
102 |
.BR --ignore-failed-read |
| 91 |
] |
103 |
] |
| 92 |
[ |
104 |
[ |
|
Lines 105-111
Link Here
|
| 105 |
.BR --keep-newer-files |
117 |
.BR --keep-newer-files |
| 106 |
] |
118 |
] |
| 107 |
[ |
119 |
[ |
| 108 |
.BR -l ", " --one-file-system |
120 |
.BR -l ", " --check-links |
| 109 |
] |
121 |
] |
| 110 |
[ |
122 |
[ |
| 111 |
.BR -L ", " --tape-length " N" |
123 |
.BR -L ", " --tape-length " N" |
|
Lines 120-125
Link Here
|
| 120 |
.BR --mode " PERMISSIONS" |
132 |
.BR --mode " PERMISSIONS" |
| 121 |
] |
133 |
] |
| 122 |
[ |
134 |
[ |
|
|
135 |
.BR --mtime " DATE" |
| 136 |
] |
| 137 |
[ |
| 123 |
.BR -N ", " --after-date " DATE, " --newer " DATE" |
138 |
.BR -N ", " --after-date " DATE, " --newer " DATE" |
| 124 |
] |
139 |
] |
| 125 |
[ |
140 |
[ |
|
Lines 129-143
Link Here
|
| 129 |
.BR --no-anchored |
144 |
.BR --no-anchored |
| 130 |
] |
145 |
] |
| 131 |
[ |
146 |
[ |
|
|
147 |
.BR --no-delay-directory-restore |
| 148 |
] |
| 149 |
[ |
| 132 |
.BR --no-ignore-case |
150 |
.BR --no-ignore-case |
| 133 |
] |
151 |
] |
| 134 |
[ |
152 |
[ |
|
|
153 |
.BR --no-ignore-command-error |
| 154 |
] |
| 155 |
[ |
| 156 |
.BR --no-overwrite-dir |
| 157 |
] |
| 158 |
[ |
| 159 |
.BR --no-quote-chars |
| 160 |
] |
| 161 |
[ |
| 135 |
.BR --no-recursion |
162 |
.BR --no-recursion |
| 136 |
] |
163 |
] |
| 137 |
[ |
164 |
[ |
| 138 |
.BR --no-same-permissions |
165 |
.BR --no-same-permissions |
| 139 |
] |
166 |
] |
| 140 |
[ |
167 |
[ |
|
|
168 |
.BR --no-unquote |
| 169 |
] |
| 170 |
[ |
| 141 |
.BR --no-wildcards |
171 |
.BR --no-wildcards |
| 142 |
] |
172 |
] |
| 143 |
[ |
173 |
[ |
|
Lines 159-164
Link Here
|
| 159 |
.BR --occurrence " NUM" |
189 |
.BR --occurrence " NUM" |
| 160 |
] |
190 |
] |
| 161 |
[ |
191 |
[ |
|
|
192 |
.BR --one-file-system |
| 193 |
] |
| 194 |
[ |
| 162 |
.BR --overwrite |
195 |
.BR --overwrite |
| 163 |
] |
196 |
] |
| 164 |
[ |
197 |
[ |
|
Lines 183-188
Link Here
|
| 183 |
.BR --preserve |
216 |
.BR --preserve |
| 184 |
] |
217 |
] |
| 185 |
[ |
218 |
[ |
|
|
219 |
.BR --quote-chars " STRING" |
| 220 |
] |
| 221 |
[ |
| 222 |
.BR --quote-style " STYLE" |
| 223 |
] |
| 224 |
[ |
| 186 |
.BR -R ", " --block-number |
225 |
.BR -R ", " --block-number |
| 187 |
] |
226 |
] |
| 188 |
[ |
227 |
[ |
|
Lines 198-203
Link Here
|
| 198 |
.BR --remove-files |
237 |
.BR --remove-files |
| 199 |
] |
238 |
] |
| 200 |
[ |
239 |
[ |
|
|
240 |
.BR --restrict |
| 241 |
] |
| 242 |
[ |
| 201 |
.BR --rmt-command " CMD" |
243 |
.BR --rmt-command " CMD" |
| 202 |
] |
244 |
] |
| 203 |
[ |
245 |
[ |
|
Lines 219-225
Link Here
|
| 219 |
.BR --show-omitted-dirs |
261 |
.BR --show-omitted-dirs |
| 220 |
] |
262 |
] |
| 221 |
[ |
263 |
[ |
| 222 |
.BR --strip-components " NUMBER, " --strip-path " NUMBER (1)" |
264 |
.BR --show-transformed-names ", " --show-stored-names |
|
|
265 |
] |
| 266 |
[ |
| 267 |
.BR --strip-components " NUMBER" |
| 223 |
] |
268 |
] |
| 224 |
[ |
269 |
[ |
| 225 |
.BR --suffix " SUFFIX" |
270 |
.BR --suffix " SUFFIX" |
|
Lines 228-239
Link Here
|
| 228 |
.BR -T ", " --files-from " FILE" |
273 |
.BR -T ", " --files-from " FILE" |
| 229 |
] |
274 |
] |
| 230 |
[ |
275 |
[ |
| 231 |
.BR --totals |
276 |
.BR --test-label |
|
|
277 |
] |
| 278 |
[ |
| 279 |
.BR --to-command " COMMAND" |
| 280 |
] |
| 281 |
[ |
| 282 |
.BR --totals |
| 283 |
] |
| 284 |
[ |
| 285 |
.BR --transform " EXPRESSION" |
| 232 |
] |
286 |
] |
| 233 |
[ |
287 |
[ |
| 234 |
.BR -U ", " --unlink-first |
288 |
.BR -U ", " --unlink-first |
| 235 |
] |
289 |
] |
| 236 |
[ |
290 |
[ |
|
|
291 |
.BR --unquote |
| 292 |
] |
| 293 |
[ |
| 237 |
.BR --use-compress-program " PROG" |
294 |
.BR --use-compress-program " PROG" |
| 238 |
] |
295 |
] |
| 239 |
[ |
296 |
[ |
|
Lines 264-285
Link Here
|
| 264 |
.BR --wildcards-match-slash |
321 |
.BR --wildcards-match-slash |
| 265 |
] |
322 |
] |
| 266 |
[ |
323 |
[ |
| 267 |
.BR --exclude " PATTERN" |
|
|
| 268 |
] |
| 269 |
[ |
| 270 |
.BR -X ", " --exclude-from " FILE" |
324 |
.BR -X ", " --exclude-from " FILE" |
| 271 |
] |
325 |
] |
| 272 |
[ |
326 |
[ |
| 273 |
.BR -Z ", " --compress ", " --uncompress |
327 |
.BR -z ", " --gzip ", " --gunzip ", " --ungzip |
| 274 |
] |
328 |
] |
| 275 |
[ |
329 |
[ |
| 276 |
.BR -z ", " --gzip ", " --gunzip ", " --ungzip |
330 |
.BR -Z ", " --compress ", " --uncompress |
| 277 |
] |
331 |
] |
| 278 |
[ |
332 |
[ |
| 279 |
.BR -[0-7][lmh] |
333 |
.BR -[0-7][lmh] |
| 280 |
] |
334 |
] |
| 281 |
|
|
|
| 282 |
(1) tar-1.14 uses --strip-path, tar-1.14.90+ uses --strip-components |
| 283 |
.SH DESCRIPTION |
335 |
.SH DESCRIPTION |
| 284 |
This manual page documents the GNU version of \fBtar\fR, an archiving |
336 |
This manual page documents the GNU version of \fBtar\fR, an archiving |
| 285 |
program designed to store and extract files from an archive file known |
337 |
program designed to store and extract files from an archive file known |
|
Lines 306-311
Link Here
|
| 306 |
.TP |
358 |
.TP |
| 307 |
.B tar -xzf foo.tar.gz blah.txt |
359 |
.B tar -xzf foo.tar.gz blah.txt |
| 308 |
extract the file blah.txt from foo.tar.gz |
360 |
extract the file blah.txt from foo.tar.gz |
|
|
361 |
.P |
| 362 |
Note: When extracting an archive, specifying -j or -z is not necessary, as |
| 363 |
\fBtar\fR will automatically detect the file type and apply the required |
| 364 |
filter. |
| 309 |
.SH "FUNCTION LETTERS" |
365 |
.SH "FUNCTION LETTERS" |
| 310 |
.TP |
366 |
.TP |
| 311 |
.B One of the following options must be used: |
367 |
.B One of the following options must be used: |
|
Lines 332-348
Link Here
|
| 332 |
extract files from an archive |
388 |
extract files from an archive |
| 333 |
.TP |
389 |
.TP |
| 334 |
.BR --delete |
390 |
.BR --delete |
| 335 |
delete from the archive (not for use on mag tapes!) |
391 |
delete from the archive (not for use on magnetic tapes!) |
| 336 |
.SH "COMMON OPTIONS" |
392 |
.SH "COMMON OPTIONS" |
| 337 |
.TP |
393 |
.TP |
| 338 |
.BR -C ", " --directory " DIR" |
394 |
.BR -C ", " --directory " DIR" |
| 339 |
change to directory DIR |
395 |
change to directory DIR |
| 340 |
.TP |
396 |
.TP |
| 341 |
.BR -f ", " --file " [HOSTNAME:]F" |
397 |
.BR -f ", " --file " [HOSTNAME:]FILE" |
| 342 |
use archive file or device F (default "-", meaning stdin/stdout) |
398 |
use archive file or device FILE (default is "-", meaning stdin/stdout) |
| 343 |
.TP |
399 |
.TP |
| 344 |
.BR -j ", " --bzip2 |
400 |
.BR -j ", " --bzip2 |
| 345 |
filter archive through bzip2, use to decompress .bz2 files |
401 |
filter archive through bzip2; use to decompress .bz2 files |
| 346 |
.TP |
402 |
.TP |
| 347 |
.BR -p ", " --preserve-permissions |
403 |
.BR -p ", " --preserve-permissions |
| 348 |
extract all protection information |
404 |
extract all protection information |
|
Lines 355-361
Link Here
|
| 355 |
.SH "ALL OPTIONS" |
411 |
.SH "ALL OPTIONS" |
| 356 |
.TP |
412 |
.TP |
| 357 |
.BR --atime-preserve |
413 |
.BR --atime-preserve |
| 358 |
don't change access times on dumped files |
414 |
don't change access times of files that are archived |
| 359 |
.TP |
415 |
.TP |
| 360 |
.BR -b ", " --blocking-factor " N" |
416 |
.BR -b ", " --blocking-factor " N" |
| 361 |
block size of Nx512 bytes (default N=20) |
417 |
block size of Nx512 bytes (default N=20) |
|
Lines 373-396
Link Here
|
| 373 |
.BR -C ", " --directory " DIR" |
429 |
.BR -C ", " --directory " DIR" |
| 374 |
change to directory DIR |
430 |
change to directory DIR |
| 375 |
.TP |
431 |
.TP |
| 376 |
.BR --check-links |
|
|
| 377 |
warn if number of hard links to the file on the filesystem mismatch the |
| 378 |
number of links recorded in the archive |
| 379 |
.TP |
| 380 |
.BR --checkpoint |
432 |
.BR --checkpoint |
| 381 |
print directory names while reading the archive |
433 |
print directory names while reading the archive |
| 382 |
.TP |
434 |
.TP |
| 383 |
.BR -f ", " --file " [HOSTNAME:]F" |
435 |
.BR --delay-directory-restore |
| 384 |
use archive file or device F (default "-", meaning stdin/stdout) |
436 |
delay setting modification times and permissions of extracted directories |
|
|
437 |
until the end of extraction |
| 438 |
.TP |
| 439 |
.BR --exclude " PATTERN" |
| 440 |
exclude files based upon PATTERN |
| 441 |
.TP |
| 442 |
.BR --exclude-caches |
| 443 |
exclude directories that contain a cache directory tag |
| 444 |
.TP |
| 445 |
.BR --exclude-tag " FILE" |
| 446 |
exclude directories that contain a file named FILE |
| 447 |
.TP |
| 448 |
.BR -f ", " --file " [HOSTNAME:]FILE" |
| 449 |
use archive file or device FILE (default is "-", meaning stdin/stdout) |
| 385 |
.TP |
450 |
.TP |
| 386 |
.BR -F ", " --info-script " FILE, " --new-volume-script " FILE" |
451 |
.BR -F ", " --info-script " FILE, " --new-volume-script " FILE" |
| 387 |
run script at end of each tape (implies \fI--multi-volume\fR) |
452 |
run script at end of each tape (implies \fI--multi-volume\fR) |
| 388 |
.TP |
453 |
.TP |
| 389 |
.BR --force-local |
454 |
.BR --force-local |
| 390 |
archive file is local even if has a colon |
455 |
archive file is local even if its name contains a colon |
| 391 |
.TP |
456 |
.TP |
| 392 |
.BR --format " FORMAT" |
457 |
.BR --format " FORMAT" |
| 393 |
selects output archive format |
458 |
selects the format of the created archive |
| 394 |
.nf |
459 |
.nf |
| 395 |
\fIv7\fR - Unix V7 |
460 |
\fIv7\fR - Unix V7 |
| 396 |
\fIoldgnu\fR - GNU tar <=1.12 |
461 |
\fIoldgnu\fR - GNU tar <=1.12 |
|
Lines 399-412
Link Here
|
| 399 |
\fIposix\fR - POSIX.1-2001 |
464 |
\fIposix\fR - POSIX.1-2001 |
| 400 |
.fi |
465 |
.fi |
| 401 |
.TP |
466 |
.TP |
| 402 |
.BR -g ", " --listed-incremental " F" |
467 |
.BR -g ", " --listed-incremental " SNAPSHOT" |
| 403 |
create/list/extract new GNU-format incremental backup |
468 |
create/list/extract new GNU-format incremental backup |
| 404 |
.TP |
469 |
.TP |
|
|
470 |
.BR --group " GROUP" |
| 471 |
give files added to the archive a group id of GROUP instead of the group id |
| 472 |
of the source file; this option does not affect extraction |
| 473 |
.TP |
| 405 |
.BR -G ", " --incremental |
474 |
.BR -G ", " --incremental |
| 406 |
create/list/extract old GNU-format incremental backup |
475 |
create/list/extract old GNU-format incremental backup |
| 407 |
.TP |
476 |
.TP |
| 408 |
.BR -h ", " --dereference |
477 |
.BR -h ", " --dereference |
| 409 |
don't dump symlinks; dump the files they point to |
478 |
don't archive symlinks; archive the files they point to |
| 410 |
.TP |
479 |
.TP |
| 411 |
.BR --help |
480 |
.BR --help |
| 412 |
like this manpage, but not as cool |
481 |
like this manpage, but not as cool |
|
Lines 417-422
Link Here
|
| 417 |
.BR --ignore-case |
486 |
.BR --ignore-case |
| 418 |
ignore case when excluding files |
487 |
ignore case when excluding files |
| 419 |
.TP |
488 |
.TP |
|
|
489 |
.BR --ignore-command-error |
| 490 |
ignore exit codes of subprocesses |
| 491 |
.TP |
| 420 |
.BR --ignore-failed-read |
492 |
.BR --ignore-failed-read |
| 421 |
don't exit with non-zero status on unreadable files |
493 |
don't exit with non-zero status on unreadable files |
| 422 |
.TP |
494 |
.TP |
|
Lines 430-442
Link Here
|
| 430 |
keep existing files; don't overwrite them from archive |
502 |
keep existing files; don't overwrite them from archive |
| 431 |
.TP |
503 |
.TP |
| 432 |
.BR -K ", " --starting-file " FILE" |
504 |
.BR -K ", " --starting-file " FILE" |
| 433 |
begin at file F in the archive |
505 |
begin at file FILE in the archive |
| 434 |
.TP |
506 |
.TP |
| 435 |
.BR --keep-newer-files |
507 |
.BR --keep-newer-files |
| 436 |
do not overwrite files which are newer than the archive |
508 |
do not overwrite files which are newer than the archive |
| 437 |
.TP |
509 |
.TP |
| 438 |
.BR -l ", " --one-file-system |
510 |
.BR -l ", " --check-links |
| 439 |
stay in local file system when creating an archive |
511 |
warn if the number of hard links to the file on the filesystem mismatches |
|
|
512 |
the number of links recorded in the archive |
| 440 |
.TP |
513 |
.TP |
| 441 |
.BR -L ", " --tape-length " N" |
514 |
.BR -L ", " --tape-length " N" |
| 442 |
change tapes after writing N*1024 bytes |
515 |
change tapes after writing N*1024 bytes |
|
Lines 450-458
Link Here
|
| 450 |
.BR --mode " PERMISSIONS" |
523 |
.BR --mode " PERMISSIONS" |
| 451 |
apply PERMISSIONS while adding files (see \fBchmod\fR(1)) |
524 |
apply PERMISSIONS while adding files (see \fBchmod\fR(1)) |
| 452 |
.TP |
525 |
.TP |
|
|
526 |
.BR --mtime " DATE" |
| 527 |
when creating archives, use DATE as the modification time of the members, |
| 528 |
instead of their actual modification times |
| 529 |
.TP |
| 453 |
.BR -N ", " --after-date " DATE, " --newer " DATE" |
530 |
.BR -N ", " --after-date " DATE, " --newer " DATE" |
| 454 |
only store files that were modified or had status updates (permissions, |
531 |
only store files that were modified or had status updates (permissions, |
| 455 |
ACLs, extended attributes,...) since DATE |
532 |
ACLs, extended attributes, ...) since DATE |
| 456 |
.TP |
533 |
.TP |
| 457 |
.BR --newer-mtime " DATE" |
534 |
.BR --newer-mtime " DATE" |
| 458 |
like \fI--newer\fR, but only store files that were modified since DATE |
535 |
like \fI--newer\fR, but only store files that were modified since DATE |
|
Lines 460-474
Link Here
|
| 460 |
.BR --no-anchored |
537 |
.BR --no-anchored |
| 461 |
match any subsequenceof the name's components with \fI--exclude\fR |
538 |
match any subsequenceof the name's components with \fI--exclude\fR |
| 462 |
.TP |
539 |
.TP |
|
|
540 |
.BR --no-delay-directory-restore |
| 541 |
modification times and permissions of extracted directories are set when |
| 542 |
all files from this directory have been extracted; this is the default |
| 543 |
.TP |
| 544 |
.BR --no-ignore-command-error |
| 545 |
print warnings about subprocesses that terminated with a non-zero exit code |
| 546 |
.TP |
| 463 |
.BR --no-ignore-case |
547 |
.BR --no-ignore-case |
| 464 |
use case-sensitive matching with \fI--exclude\fR |
548 |
use case-sensitive matching with \fI--exclude\fR |
| 465 |
.TP |
549 |
.TP |
|
|
550 |
.BR --no-overwrite-dir |
| 551 |
preserve metadata of existing directories when extracting files from an |
| 552 |
archive |
| 553 |
.TP |
| 554 |
.BR --no-quote-chars " STRING" |
| 555 |
remove characters listed in STRING from the list of quoted characters |
| 556 |
set by a previous \fI--quote-chars\fR option |
| 557 |
.TP |
| 466 |
.BR --no-recursion |
558 |
.BR --no-recursion |
| 467 |
don't recurse into directories |
559 |
don't recurse into directories |
| 468 |
.TP |
560 |
.TP |
| 469 |
.BR --no-same-permissions |
561 |
.BR --no-same-permissions |
| 470 |
apply user's umask when extracting files instead of recorded permissions |
562 |
apply user's umask when extracting files instead of recorded permissions |
| 471 |
.TP |
563 |
.TP |
|
|
564 |
.BR --no-unquote |
| 565 |
treat all input file or member names literally, do not interpret |
| 566 |
escape sequences |
| 567 |
.TP |
| 472 |
.BR --no-wildcards |
568 |
.BR --no-wildcards |
| 473 |
don't use wildcards with \fI--exclude\fR |
569 |
don't use wildcards with \fI--exclude\fR |
| 474 |
.TP |
570 |
.TP |
|
Lines 496-501
Link Here
|
| 496 |
process only NUM occurrences of each named file; used with |
592 |
process only NUM occurrences of each named file; used with |
| 497 |
\fI--delete\fR, \fI--diff\fR, \fI--extract\fR, or \fI--list\fR |
593 |
\fI--delete\fR, \fI--diff\fR, \fI--extract\fR, or \fI--list\fR |
| 498 |
.TP |
594 |
.TP |
|
|
595 |
.BR --one-file-system |
| 596 |
stay in local file system when creating an archive |
| 597 |
.TP |
| 499 |
.BR --overwrite |
598 |
.BR --overwrite |
| 500 |
overwrite existing files and directory metadata when extracting |
599 |
overwrite existing files and directory metadata when extracting |
| 501 |
.TP |
600 |
.TP |
|
Lines 503-511
Link Here
|
| 503 |
overwrite directory metadata when extracting |
602 |
overwrite directory metadata when extracting |
| 504 |
.TP |
603 |
.TP |
| 505 |
.BR --owner " USER" |
604 |
.BR --owner " USER" |
| 506 |
change owner of extraced files to USER |
605 |
give files added to the archive a user id of USER instead of the user id |
|
|
606 |
of the source file; this option does not affect extraction |
| 507 |
.TP |
607 |
.TP |
| 508 |
.BR -p ", " --same-permissions ", " --preserve-permissions |
608 |
.BR -p ", " --preserve-permissions ", " --same-permissions |
| 509 |
extract all protection information |
609 |
extract all protection information |
| 510 |
.TP |
610 |
.TP |
| 511 |
.BR -P ", " --absolute-names |
611 |
.BR -P ", " --absolute-names |
|
Lines 519-525
Link Here
|
| 519 |
like \fI--format=posix\fR |
619 |
like \fI--format=posix\fR |
| 520 |
.TP |
620 |
.TP |
| 521 |
.BR --preserve |
621 |
.BR --preserve |
| 522 |
like \fI--preserve-permissions\fR \fI--same-order\fR |
622 |
like \fI--preserve-permissions\fR plus \fI--same-order\fR |
|
|
623 |
.TP |
| 624 |
.BR --quote-chars " STRING" |
| 625 |
always quote the characters from STRING, even if the selected quoting |
| 626 |
style would not quote them |
| 627 |
.TP |
| 628 |
.BR --quote-style " STYLE" |
| 629 |
set the quoting style to be used when printing member and file names |
| 523 |
.TP |
630 |
.TP |
| 524 |
.BR -R ", " --record-number |
631 |
.BR -R ", " --record-number |
| 525 |
show record number within archive with each message |
632 |
show record number within archive with each message |
|
Lines 536-541
Link Here
|
| 536 |
.BR --remove-files |
643 |
.BR --remove-files |
| 537 |
remove files after adding them to the archive |
644 |
remove files after adding them to the archive |
| 538 |
.TP |
645 |
.TP |
|
|
646 |
.BR --restrict |
| 647 |
disable the use of some potentially harmful options; currently this |
| 648 |
disables shell invocation from the multi-volume menu |
| 649 |
.TP |
| 539 |
.BR --rmt-command " CMD" |
650 |
.BR --rmt-command " CMD" |
| 540 |
use CMD instead of the default /usr/sbin/rmt |
651 |
use CMD instead of the default /usr/sbin/rmt |
| 541 |
.TP |
652 |
.TP |
|
Lines 557-566
Link Here
|
| 557 |
.BR --show-omitted-dirs |
668 |
.BR --show-omitted-dirs |
| 558 |
print directories \fBtar\fR skips while operating on an archive |
669 |
print directories \fBtar\fR skips while operating on an archive |
| 559 |
.TP |
670 |
.TP |
| 560 |
.BR --strip-components " NUMBER, " --strip-path " NUMBER" |
671 |
.BR --show-transformed-names ", " --show-stored-names |
| 561 |
strip NUMBER of leading components from file names before extraction |
672 |
display file or member names after applying any \fBsed\fR transformations |
| 562 |
|
673 |
.TP |
| 563 |
(1) tar-1.14 uses --strip-path, tar-1.14.90+ uses --strip-components |
674 |
.BR --strip-components " NUMBER" |
|
|
675 |
strip NUMBER of leading path components from file names before extraction |
| 564 |
.TP |
676 |
.TP |
| 565 |
.BR --suffix " SUFFIX" |
677 |
.BR --suffix " SUFFIX" |
| 566 |
use SUFFIX instead of default '~' when backing up files |
678 |
use SUFFIX instead of default '~' when backing up files |
|
Lines 568-581
Link Here
|
| 568 |
.BR -T ", " --files-from " FILE" |
680 |
.BR -T ", " --files-from " FILE" |
| 569 |
get names to extract or create from file FILE |
681 |
get names to extract or create from file FILE |
| 570 |
.TP |
682 |
.TP |
|
|
683 |
.BR --test-label |
| 684 |
read the volume label; if an argument is specified, test whether it |
| 685 |
matches the volume label |
| 686 |
.TP |
| 687 |
.BR --to-command " COMMAND" |
| 688 |
during extraction, pipe extracted files to the standard input of COMMAND |
| 689 |
.TP |
| 571 |
.BR --totals |
690 |
.BR --totals |
| 572 |
print total bytes written with --create |
691 |
print total bytes written with --create |
| 573 |
.TP |
692 |
.TP |
|
|
693 |
.BR --transform " EXPRESSION" |
| 694 |
transform file or member names using the \fBsed\fR replacement expression |
| 695 |
EXPRESSION |
| 696 |
.TP |
| 574 |
.BR -U ", " --unlink-first |
697 |
.BR -U ", " --unlink-first |
| 575 |
remove existing files before extracting files of the same name |
698 |
remove existing files before extracting files of the same name |
| 576 |
.TP |
699 |
.TP |
|
|
700 |
.BR --unquote |
| 701 |
enable unquoting input file or member names; this is the default |
| 702 |
.TP |
| 577 |
.BR --use-compress-program " PROG" |
703 |
.BR --use-compress-program " PROG" |
| 578 |
access the archive through PROG which is generally a compression program |
704 |
access the archive through PROG (which is generally a compression program; |
|
|
705 |
it must accept option \fI-d\fR) |
| 579 |
.TP |
706 |
.TP |
| 580 |
.BR --utc |
707 |
.BR --utc |
| 581 |
display file modification dates in UTC |
708 |
display file modification dates in UTC |
|
Lines 605-624
Link Here
|
| 605 |
.BR --wildcards-match-slash |
732 |
.BR --wildcards-match-slash |
| 606 |
wildcards match slashes (/) with \fI--exclude\fR |
733 |
wildcards match slashes (/) with \fI--exclude\fR |
| 607 |
.TP |
734 |
.TP |
| 608 |
.BR --exclude " PATTERN" |
|
|
| 609 |
exclude files based upon PATTERN |
| 610 |
.TP |
| 611 |
.BR -X ", " --exclude-from " FILE" |
735 |
.BR -X ", " --exclude-from " FILE" |
| 612 |
exclude files listed in FILE |
736 |
exclude files listed in FILE |
| 613 |
.TP |
737 |
.TP |
| 614 |
.BR -Z ", " --compress ", " --uncompress |
|
|
| 615 |
filter the archive through compress |
| 616 |
.TP |
| 617 |
.BR -z ", " --gzip ", " --gunzip ", " --ungzip |
738 |
.BR -z ", " --gzip ", " --gunzip ", " --ungzip |
| 618 |
filter the archive through gzip |
739 |
filter the archive through gzip |
| 619 |
.TP |
740 |
.TP |
| 620 |
.BR --use-compress-program " PROG" |
741 |
.BR -Z ", " --compress ", " --uncompress |
| 621 |
filter the archive through PROG (which must accept -d) |
742 |
filter the archive through compress |
| 622 |
.TP |
743 |
.TP |
| 623 |
.BR -[0-7][lmh] |
744 |
.BR -[0-7][lmh] |
| 624 |
specify drive and density |
745 |
specify drive and density |
|
Lines 627-633
Link Here
|
| 627 |
The maintainer of \fBtar\fR falls into this category. Thus this man page may |
748 |
The maintainer of \fBtar\fR falls into this category. Thus this man page may |
| 628 |
not be complete, nor current, and was included in the Gentoo portage tree |
749 |
not be complete, nor current, and was included in the Gentoo portage tree |
| 629 |
because man is a great tool :). This man page was first taken from Debian |
750 |
because man is a great tool :). This man page was first taken from Debian |
| 630 |
Linux and has since been loving updated here. |
751 |
Linux and has since been lovingly updated here. |
| 631 |
.SH "REPORTING BUGS" |
752 |
.SH "REPORTING BUGS" |
| 632 |
Please report bugs via http://bugs.gentoo.org/ |
753 |
Please report bugs via http://bugs.gentoo.org/ |
| 633 |
.SH "AUTHORS" |
754 |
.SH "AUTHORS" |
