X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;ds=sidebyside;f=doc%2Ftar.info;h=0dd4e8d79851be2e82d8452851328077000abfd5;hb=785cdec4450a1459fdbb90df1344b69be34e0059;hp=9f26ab47815d0096992bcee778c2dfa1d39c43ae;hpb=cf7169a2ede9bb08b71de68fe0c8bbecf827abe6;p=tar diff --git a/doc/tar.info b/doc/tar.info index 9f26ab4..0dd4e8d 100644 --- a/doc/tar.info +++ b/doc/tar.info @@ -1,10 +1,10 @@ This is tar.info, produced by makeinfo version 4.13 from tar.texi. -This manual is for GNU `tar' (version 1.21, 30 October 2008), which +This manual is for GNU `tar' (version 1.22, 5 March 2009), which creates and extracts files from archives. Copyright (C) 1992, 1994, 1995, 1996, 1997, 1999, 2000, 2001, 2003, -2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. +2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, @@ -30,376 +30,377 @@ END-INFO-DIR-ENTRY  Indirect: -tar.info-1: 1243 -tar.info-2: 300672 +tar.info-1: 1246 +tar.info-2: 300776  Tag Table: (Indirect) -Node: Top1243 -Node: Introduction10510 -Node: Book Contents11297 -Node: Definitions13469 -Node: What tar Does15272 -Node: Naming tar Archives18038 -Node: Authors18758 -Node: Reports20571 -Node: Tutorial20931 -Node: assumptions21744 -Node: stylistic conventions24219 -Node: basic tar options24662 -Node: frequent operations28300 -Node: Two Frequent Options28952 -Node: file tutorial29583 -Node: verbose tutorial30944 -Ref: verbose member listing33158 -Node: help tutorial35911 -Node: create36265 -Node: prepare for examples37766 -Node: Creating the archive39534 -Node: create verbose42366 -Node: short create43187 -Node: create dir45940 -Node: list48647 -Ref: listing member and file names49921 -Node: list dir52202 -Node: extract53191 -Node: extracting archives54368 -Node: extracting files54858 -Ref: extracting files-Footnote-157505 -Node: extract dir57885 -Node: extracting untrusted archives60268 -Node: failing commands61147 -Node: going further62247 -Node: tar invocation62460 -Node: Synopsis63972 -Node: using tar options68941 -Ref: TAR_OPTIONS70526 -Node: Styles71543 -Node: Long Options73255 -Node: Short Options75427 -Ref: Short Options-Footnote-177235 -Node: Old Options77452 -Ref: Old Options-Footnote-180402 -Node: Mixing80572 -Ref: Mixing-Footnote-182938 -Node: All Options83058 -Node: Operation Summary83663 -Ref: --append83783 -Ref: --catenate83863 -Ref: --compare83934 -Ref: --concatenate84137 -Ref: --create84247 -Ref: --delete84315 -Ref: --diff84428 -Ref: --extract84484 -Ref: --get84586 -Ref: --list84644 -Ref: --update84712 -Node: Option Summary84922 -Ref: --absolute-names85077 -Ref: --after-date85255 -Ref: --anchored85307 -Ref: --atime-preserve85440 -Ref: --auto-compress87955 -Ref: --backup88182 -Ref: --block-number88373 -Ref: --blocking-factor88547 -Ref: --bzip288699 -Ref: --check-device88806 -Ref: --checkpoint89001 -Ref: --checkpoint-action89442 -Ref: --check-links90593 -Ref: --compress90870 -Ref: --uncompress90870 -Ref: --confirmation91074 -Ref: --delay-directory-restore91142 -Ref: --dereference91343 -Ref: --directory91528 -Ref: --exclude91781 -Ref: --exclude-from91900 -Ref: --exclude-caches92046 -Ref: --exclude-caches-under92240 -Ref: --exclude-caches-all92418 -Ref: --exclude-tag92547 -Ref: --exclude-tag-under92702 -Ref: --exclude-tag-all92870 -Ref: --exclude-vcs92984 -Ref: --file93139 -Ref: --files-from93339 -Ref: --force-local93542 -Ref: --format93733 -Ref: --group94403 -Ref: --gzip94751 -Ref: --gunzip94751 -Ref: --ungzip94751 -Ref: --hard-dereference94974 -Ref: --help95161 -Ref: --ignore-case95295 -Ref: --ignore-command-error95422 -Ref: --ignore-failed-read95533 -Ref: --ignore-zeros95663 -Ref: --incremental95808 -Ref: --index-file96073 -Ref: --info-script96158 -Ref: --new-volume-script96158 -Ref: --interactive96479 -Ref: --keep-newer-files96691 -Ref: --keep-old-files96833 -Ref: --label96964 -Ref: --listed-incremental97252 -Ref: --lzma97616 -Ref: --mode97821 -Ref: --mtime98112 -Ref: --multi-volume98553 -Ref: --newer98754 -Ref: --newer-mtime99032 -Ref: --no-anchored99256 -Ref: --no-auto-compress99393 -Ref: --no-check-device99544 -Ref: --no-delay-directory-restore99727 -Ref: --no-ignore-case99980 -Ref: --no-ignore-command-error100073 -Ref: --no-null100228 -Ref: --no-overwrite-dir100433 -Ref: --no-quote-chars100576 -Ref: --no-recursion100757 -Ref: --no-same-owner100862 -Ref: --no-same-permissions101045 -Ref: --no-unquote101247 -Ref: --no-wildcards101385 -Ref: --no-wildcards-match-slash101469 -Ref: --null101571 -Ref: --numeric-owner101799 -Ref: --occurrence102450 -Ref: --old-archive103017 -Ref: --one-file-system103066 -Ref: --overwrite103244 -Ref: --overwrite-dir103386 -Ref: --owner103531 -Ref: --pax-option103910 -Ref: --portability104209 -Ref: --posix104274 -Ref: --preserve104316 -Ref: --preserve-order104454 -Ref: --preserve-permissions104518 -Ref: --same-permissions104518 -Ref: --quote-chars104932 -Ref: --quoting-style105085 -Ref: --read-full-records105406 -Ref: --record-size105571 -Ref: --recursion105702 -Ref: --recursive-unlink105805 -Ref: --remove-files105972 -Ref: --restrict106118 -Ref: --rmt-command106306 -Ref: --rsh-command106447 -Ref: --same-order106569 -Ref: --same-owner106861 -Ref: --seek107238 -Ref: --show-defaults107495 -Ref: --show-omitted-dirs107863 -Ref: --show-transformed-names108017 -Ref: --show-stored-names108017 -Ref: --sparse108406 -Ref: --sparse-version108545 -Ref: --starting-file108769 -Ref: --strip-components108958 -Ref: --suffix109270 -Ref: --tape-length109405 -Ref: --test-label109560 -Ref: --to-command109712 -Ref: --to-stdout109871 -Ref: --totals110024 -Ref: --touch110255 -Ref: --transform110457 -Ref: --xform110457 -Ref: --unlink-first111068 -Ref: --unquote111236 -Ref: --use-compress-program111343 -Ref: --utc111511 -Ref: --verbose111604 -Ref: --verify111856 -Ref: --version111974 -Ref: --volno-file112146 -Ref: --wildcards112333 -Ref: --wildcards-match-slash112453 -Ref: Option Summary-Footnote-1112581 -Node: Short Option Summary112799 -Node: help115002 -Ref: help-Footnote-1118832 -Node: defaults119042 -Node: verbose120059 -Ref: totals122360 -Ref: Progress information123950 -Ref: show-omitted-dirs124929 -Ref: block-number125348 -Ref: verbose-Footnote-1126375 -Node: checkpoints126482 -Node: interactive131879 -Node: operations133962 -Node: Basic tar134221 -Ref: Basic tar-Footnote-1137325 -Node: Advanced tar137469 -Node: Operations138314 -Node: append140284 -Ref: append-Footnote-1143449 -Node: appending files143615 -Node: multiple145396 -Node: update148086 -Node: how to update149125 -Node: concatenate150908 -Ref: concatenate-Footnote-1154157 -Node: delete154295 -Node: compare156138 -Node: create options157628 -Node: override158086 -Node: Ignore Failed Read161524 -Node: extract options161744 -Node: Reading162640 -Node: read full records164203 -Node: Ignore Zeros164539 -Node: Writing165530 -Node: Dealing with Old Files166087 -Node: Overwrite Old Files168514 -Node: Keep Old Files169971 -Node: Keep Newer Files170481 -Node: Unlink First170771 -Node: Recursive Unlink171175 -Node: Data Modification Times171728 -Node: Setting Access Permissions172538 -Node: Directory Modification Times and Permissions173170 -Node: Writing to Standard Output176776 -Node: Writing to an External Program178311 -Node: remove files181048 -Node: Scarce181241 -Node: Starting File181489 -Node: Same Order182309 -Node: backup183145 -Node: Applications186369 -Node: looking ahead187882 -Node: Backups188708 -Node: Full Dumps190540 -Node: Incremental Dumps192346 -Ref: device numbers195482 -Ref: incremental-op199464 -Ref: Incremental Dumps-Footnote-1199838 -Ref: Incremental Dumps-Footnote-2199988 -Node: Backup Levels200475 -Node: Backup Parameters202862 -Node: General-Purpose Variables204043 -Ref: RSH207200 -Node: Magnetic Tape Control209079 -Node: User Hooks210416 -Node: backup-specs example211744 -Node: Scripted Backups212887 -Ref: Scripted Backups-Footnote-1215749 -Node: Scripted Restoration216133 -Node: Choosing218741 -Node: file219926 -Ref: remote-dev222625 -Ref: local and remote archives223017 -Node: Selecting Archive Members224047 -Ref: input name quoting224728 -Node: files226714 -Ref: files-Footnote-1229988 -Node: nul230146 -Node: exclude232545 -Node: problems with exclude237507 -Node: wildcards239552 -Node: controlling pattern-matching242136 -Ref: controlling pattern-matching-Footnote-1246126 -Node: quoting styles246342 -Ref: escape sequences246688 -Node: transform252823 -Ref: show-transformed-names254812 -Node: after261001 -Node: recurse264666 -Node: one267435 -Node: directory268931 -Node: absolute272004 -Ref: absolute-Footnote-1275138 -Node: Date input formats275489 -Node: General date syntax277805 -Node: Calendar date items280756 -Node: Time of day items282753 -Node: Time zone items284949 -Node: Day of week items286183 -Node: Relative items in date strings287172 -Node: Pure numbers in date strings289974 -Node: Seconds since the Epoch290955 -Node: Specifying time zone rules292576 -Node: Authors of get_date294940 -Node: Formats295692 -Node: Compression300380 -Node: gzip300672 -Ref: auto-compress303802 -Ref: gzip-Footnote-1307753 -Node: sparse307802 -Node: Attributes310856 -Node: Portability316827 -Node: Portable Names318313 -Node: dereference319018 -Node: hard links320419 -Ref: hard links-Footnote-1323377 -Node: old323433 -Node: ustar324617 -Node: gnu325208 -Node: posix326085 -Node: PAX keywords326566 -Node: Checksumming330894 -Node: Large or Negative Values332818 -Node: Other Tars334418 -Node: Split Recovery335554 -Node: Sparse Recovery339286 -Ref: extracting sparse v.0.x342919 -Ref: Sparse Recovery-Footnote-1346208 -Ref: Sparse Recovery-Footnote-2346231 -Node: cpio346352 -Node: Media351108 -Node: Device353038 -Node: Remote Tape Server358106 -Node: Common Problems and Solutions361836 -Node: Blocking362228 -Node: Format Variations368735 -Node: Blocking Factor369647 -Node: Many381301 -Node: Tape Positioning385095 -Node: mt386968 -Node: Using Multiple Tapes388523 -Node: Multi-Volume Archives390589 -Ref: tape-length392074 -Ref: change volume prompt392378 -Ref: volno-file393248 -Ref: info-script393800 -Ref: Multi-Volume Archives-Footnote-1398984 -Ref: Multi-Volume Archives-Footnote-2399094 -Node: Tape Files399161 -Node: Tarcat400644 -Node: label401689 -Ref: --test-label option403318 -Ref: label-Footnote-1406363 -Node: verify406598 -Node: Write Protection409898 -Node: Changes410728 -Node: Configuring Help Summary414313 -Node: Fixing Snapshot Files420814 -Node: Tar Internals422999 -Node: Standard423331 -Node: Extensions445532 -Node: Sparse Formats448092 -Node: Old GNU Format449382 -Node: PAX 0451793 -Node: PAX 1454920 -Node: Snapshot Files456654 -Node: Dumpdir461107 -Node: Genfile464353 -Node: Generate Mode465446 -Node: Status Mode469743 -Node: Exec Mode471542 -Node: Free Software Needs Free Documentation473778 -Node: Copying This Manual478749 -Node: GNU Free Documentation License479031 -Node: Index of Command Line Options501438 -Node: Index525681 +Node: Top1246 +Node: Introduction10516 +Node: Book Contents11303 +Node: Definitions13475 +Node: What tar Does15278 +Node: Naming tar Archives18044 +Node: Authors18764 +Node: Reports20577 +Node: Tutorial20937 +Node: assumptions21750 +Node: stylistic conventions24225 +Node: basic tar options24668 +Node: frequent operations28306 +Node: Two Frequent Options28958 +Node: file tutorial29589 +Node: verbose tutorial30950 +Ref: verbose member listing33164 +Node: help tutorial35917 +Node: create36271 +Node: prepare for examples37772 +Node: Creating the archive39540 +Node: create verbose42372 +Node: short create43193 +Node: create dir45946 +Node: list48653 +Ref: listing member and file names49927 +Node: list dir52208 +Node: extract53197 +Node: extracting archives54374 +Node: extracting files54864 +Ref: extracting files-Footnote-157511 +Node: extract dir57891 +Node: extracting untrusted archives60274 +Node: failing commands61153 +Node: going further62253 +Node: tar invocation62466 +Node: Synopsis63978 +Node: using tar options68947 +Ref: TAR_OPTIONS70532 +Node: Styles71549 +Node: Long Options73261 +Node: Short Options75433 +Ref: Short Options-Footnote-177241 +Node: Old Options77458 +Ref: Old Options-Footnote-180408 +Node: Mixing80578 +Ref: Mixing-Footnote-182944 +Node: All Options83064 +Node: Operation Summary83669 +Ref: --append83789 +Ref: --catenate83869 +Ref: --compare83940 +Ref: --concatenate84143 +Ref: --create84253 +Ref: --delete84321 +Ref: --diff84434 +Ref: --extract84490 +Ref: --get84592 +Ref: --list84650 +Ref: --update84718 +Node: Option Summary84928 +Ref: --absolute-names85083 +Ref: --after-date85261 +Ref: --anchored85313 +Ref: --atime-preserve85446 +Ref: --auto-compress87961 +Ref: --backup88188 +Ref: --block-number88379 +Ref: --blocking-factor88553 +Ref: --bzip288705 +Ref: --check-device88812 +Ref: --checkpoint89007 +Ref: --checkpoint-action89448 +Ref: --check-links90599 +Ref: --compress90876 +Ref: --uncompress90876 +Ref: --confirmation91080 +Ref: --delay-directory-restore91148 +Ref: --dereference91349 +Ref: --directory91534 +Ref: --exclude91787 +Ref: --exclude-from91906 +Ref: --exclude-caches92052 +Ref: --exclude-caches-under92246 +Ref: --exclude-caches-all92424 +Ref: --exclude-tag92553 +Ref: --exclude-tag-under92708 +Ref: --exclude-tag-all92876 +Ref: --exclude-vcs92990 +Ref: --file93145 +Ref: --files-from93345 +Ref: --force-local93548 +Ref: --format93739 +Ref: --group94409 +Ref: --gzip94757 +Ref: --gunzip94757 +Ref: --ungzip94757 +Ref: --hard-dereference94980 +Ref: --help95167 +Ref: --ignore-case95301 +Ref: --ignore-command-error95428 +Ref: --ignore-failed-read95539 +Ref: --ignore-zeros95669 +Ref: --incremental95814 +Ref: --index-file96079 +Ref: --info-script96164 +Ref: --new-volume-script96164 +Ref: --interactive96485 +Ref: --keep-newer-files96697 +Ref: --keep-old-files96839 +Ref: --label96970 +Ref: --listed-incremental97258 +Ref: --lzma97622 +Ref: --mode97822 +Ref: --mtime98113 +Ref: --multi-volume98554 +Ref: --newer98755 +Ref: --newer-mtime99033 +Ref: --no-anchored99257 +Ref: --no-auto-compress99394 +Ref: --no-check-device99545 +Ref: --no-delay-directory-restore99728 +Ref: --no-ignore-case99981 +Ref: --no-ignore-command-error100074 +Ref: --no-null100229 +Ref: --no-overwrite-dir100434 +Ref: --no-quote-chars100577 +Ref: --no-recursion100758 +Ref: --no-same-owner100863 +Ref: --no-same-permissions101046 +Ref: --no-unquote101248 +Ref: --no-wildcards101386 +Ref: --no-wildcards-match-slash101470 +Ref: --null101572 +Ref: --numeric-owner101800 +Ref: --occurrence102451 +Ref: --old-archive103018 +Ref: --one-file-system103067 +Ref: --overwrite103245 +Ref: --overwrite-dir103387 +Ref: --owner103532 +Ref: --pax-option103911 +Ref: --portability104210 +Ref: --posix104275 +Ref: --preserve104317 +Ref: --preserve-order104455 +Ref: --preserve-permissions104519 +Ref: --same-permissions104519 +Ref: --quote-chars104933 +Ref: --quoting-style105086 +Ref: --read-full-records105407 +Ref: --record-size105572 +Ref: --recursion105703 +Ref: --recursive-unlink105806 +Ref: --remove-files105973 +Ref: --restrict106119 +Ref: --rmt-command106307 +Ref: --rsh-command106448 +Ref: --same-order106570 +Ref: --same-owner106862 +Ref: --seek107239 +Ref: --show-defaults107496 +Ref: --show-omitted-dirs107864 +Ref: --show-transformed-names108018 +Ref: --show-stored-names108018 +Ref: --sparse108407 +Ref: --sparse-version108546 +Ref: --starting-file108770 +Ref: --strip-components108959 +Ref: --suffix109271 +Ref: --tape-length109406 +Ref: --test-label109561 +Ref: --to-command109713 +Ref: --to-stdout109872 +Ref: --totals110025 +Ref: --touch110256 +Ref: --transform110458 +Ref: --xform110458 +Ref: --unlink-first111069 +Ref: --unquote111237 +Ref: --use-compress-program111344 +Ref: --utc111522 +Ref: --verbose111615 +Ref: --verify111867 +Ref: --version111985 +Ref: --volno-file112157 +Ref: --wildcards112344 +Ref: --wildcards-match-slash112464 +Ref: --xz112556 +Ref: Option Summary-Footnote-1112687 +Node: Short Option Summary112905 +Node: help115106 +Ref: help-Footnote-1118936 +Node: defaults119146 +Node: verbose120163 +Ref: totals122464 +Ref: Progress information124054 +Ref: show-omitted-dirs125033 +Ref: block-number125452 +Ref: verbose-Footnote-1126479 +Node: checkpoints126586 +Node: interactive131983 +Node: operations134066 +Node: Basic tar134325 +Ref: Basic tar-Footnote-1137429 +Node: Advanced tar137573 +Node: Operations138418 +Node: append140388 +Ref: append-Footnote-1143553 +Node: appending files143719 +Node: multiple145500 +Node: update148190 +Node: how to update149229 +Node: concatenate151012 +Ref: concatenate-Footnote-1154261 +Node: delete154399 +Node: compare156242 +Node: create options157732 +Node: override158190 +Node: Ignore Failed Read161628 +Node: extract options161848 +Node: Reading162744 +Node: read full records164307 +Node: Ignore Zeros164643 +Node: Writing165634 +Node: Dealing with Old Files166191 +Node: Overwrite Old Files168618 +Node: Keep Old Files170075 +Node: Keep Newer Files170585 +Node: Unlink First170875 +Node: Recursive Unlink171279 +Node: Data Modification Times171832 +Node: Setting Access Permissions172642 +Node: Directory Modification Times and Permissions173274 +Node: Writing to Standard Output176880 +Node: Writing to an External Program178415 +Node: remove files181152 +Node: Scarce181345 +Node: Starting File181593 +Node: Same Order182413 +Node: backup183249 +Node: Applications186473 +Node: looking ahead187986 +Node: Backups188812 +Node: Full Dumps190644 +Node: Incremental Dumps192450 +Ref: device numbers195586 +Ref: incremental-op199568 +Ref: Incremental Dumps-Footnote-1199942 +Ref: Incremental Dumps-Footnote-2200092 +Node: Backup Levels200579 +Node: Backup Parameters202966 +Node: General-Purpose Variables204147 +Ref: RSH207304 +Node: Magnetic Tape Control209183 +Node: User Hooks210520 +Node: backup-specs example211848 +Node: Scripted Backups212991 +Ref: Scripted Backups-Footnote-1215853 +Node: Scripted Restoration216237 +Node: Choosing218845 +Node: file220030 +Ref: remote-dev222729 +Ref: local and remote archives223121 +Node: Selecting Archive Members224151 +Ref: input name quoting224832 +Node: files226818 +Ref: files-Footnote-1230092 +Node: nul230250 +Node: exclude232649 +Node: problems with exclude237611 +Node: wildcards239656 +Node: controlling pattern-matching242240 +Ref: controlling pattern-matching-Footnote-1246230 +Node: quoting styles246446 +Ref: escape sequences246792 +Node: transform252927 +Ref: show-transformed-names254916 +Node: after261105 +Node: recurse264770 +Node: one267539 +Node: directory269035 +Node: absolute272108 +Ref: absolute-Footnote-1275242 +Node: Date input formats275593 +Node: General date syntax277909 +Node: Calendar date items280860 +Node: Time of day items282857 +Node: Time zone items285053 +Node: Day of week items286287 +Node: Relative items in date strings287276 +Node: Pure numbers in date strings290078 +Node: Seconds since the Epoch291059 +Node: Specifying time zone rules292680 +Node: Authors of get_date295044 +Node: Formats295796 +Node: Compression300484 +Node: gzip300776 +Ref: auto-compress303938 +Ref: gzip-Footnote-1307972 +Node: sparse308021 +Node: Attributes311075 +Node: Portability316996 +Node: Portable Names318482 +Node: dereference319187 +Node: hard links320588 +Ref: hard links-Footnote-1323546 +Node: old323602 +Node: ustar324786 +Node: gnu325377 +Node: posix326254 +Node: PAX keywords326735 +Node: Checksumming331063 +Node: Large or Negative Values332987 +Node: Other Tars334587 +Node: Split Recovery335723 +Node: Sparse Recovery339455 +Ref: extracting sparse v.0.x343088 +Ref: Sparse Recovery-Footnote-1346377 +Ref: Sparse Recovery-Footnote-2346400 +Node: cpio346521 +Node: Media351277 +Node: Device353207 +Node: Remote Tape Server358275 +Node: Common Problems and Solutions362005 +Node: Blocking362397 +Node: Format Variations368904 +Node: Blocking Factor369816 +Node: Many381470 +Node: Tape Positioning385264 +Node: mt387137 +Node: Using Multiple Tapes388692 +Node: Multi-Volume Archives390758 +Ref: tape-length392243 +Ref: change volume prompt392547 +Ref: volno-file393417 +Ref: info-script393969 +Ref: Multi-Volume Archives-Footnote-1399153 +Ref: Multi-Volume Archives-Footnote-2399263 +Node: Tape Files399330 +Node: Tarcat400813 +Node: label401858 +Ref: --test-label option403487 +Ref: label-Footnote-1406532 +Node: verify406767 +Node: Write Protection410067 +Node: Changes410897 +Node: Configuring Help Summary414482 +Node: Fixing Snapshot Files420983 +Node: Tar Internals423168 +Node: Standard423500 +Node: Extensions445701 +Node: Sparse Formats448261 +Node: Old GNU Format449551 +Node: PAX 0451962 +Node: PAX 1455089 +Node: Snapshot Files456823 +Node: Dumpdir461276 +Node: Genfile464522 +Node: Generate Mode465615 +Node: Status Mode469912 +Node: Exec Mode471711 +Node: Free Software Needs Free Documentation473947 +Node: Copying This Manual478918 +Node: GNU Free Documentation License479200 +Node: Index of Command Line Options501607 +Node: Index525923  End Tag Table