Import upstream version 1.28
[debian/tar] / doc / tar.info
1 This is tar.info, produced by makeinfo version 4.13 from tar.texi.
2
3 This manual is for GNU `tar' (version 1.28, 22 July 2014), which
4 creates and extracts files from archives.
5
6    Copyright (C) 1992, 1994-1997, 1999-2001, 2003-2013 Free Software
7 Foundation, Inc.
8
9      Permission is granted to copy, distribute and/or modify this
10      document under the terms of the GNU Free Documentation License,
11      Version 1.3 or any later version published by the Free Software
12      Foundation; with the Invariant Sections being "GNU General Public
13      License", with the Front-Cover Texts being "A GNU Manual", and
14      with the Back-Cover Texts as in (a) below.  A copy of the license
15      is included in the section entitled "GNU Free Documentation
16      License".
17
18      (a) The FSF's Back-Cover Text is: "You have the freedom to copy
19      and modify this GNU manual."
20
21 INFO-DIR-SECTION Archiving
22 START-INFO-DIR-ENTRY
23 * Tar: (tar).                   Making tape (or disk) archives.
24 END-INFO-DIR-ENTRY
25
26 INFO-DIR-SECTION Individual utilities
27 START-INFO-DIR-ENTRY
28 * tar: (tar)tar invocation.                     Invoking GNU `tar'.
29 END-INFO-DIR-ENTRY
30
31 \1f
32 Indirect:
33 tar.info-1: 1141
34 tar.info-2: 299746
35 tar.info-3: 569473
36 \1f
37 Tag Table:
38 (Indirect)
39 Node: Top\7f1141
40 Node: Introduction\7f10443
41 Node: Book Contents\7f11230
42 Node: Definitions\7f13402
43 Node: What tar Does\7f15205
44 Node: Naming tar Archives\7f17971
45 Node: Authors\7f18691
46 Node: Reports\7f20504
47 Node: Tutorial\7f20861
48 Node: assumptions\7f21674
49 Node: stylistic conventions\7f24149
50 Node: basic tar options\7f24592
51 Node: frequent operations\7f28230
52 Node: Two Frequent Options\7f28882
53 Node: file tutorial\7f29513
54 Node: verbose tutorial\7f30870
55 Ref: verbose member listing\7f33084
56 Node: help tutorial\7f35844
57 Node: create\7f36198
58 Node: prepare for examples\7f37699
59 Node: Creating the archive\7f39468
60 Node: create verbose\7f42300
61 Node: short create\7f43120
62 Node: create dir\7f45873
63 Node: list\7f48581
64 Ref: listing member and file names\7f49860
65 Node: list dir\7f52174
66 Node: extract\7f53186
67 Node: extracting archives\7f54300
68 Node: extracting files\7f54805
69 Ref: extracting files-Footnote-1\7f57452
70 Node: extract dir\7f57832
71 Node: extracting untrusted archives\7f60225
72 Node: failing commands\7f61104
73 Node: going further\7f62198
74 Node: tar invocation\7f62411
75 Node: Synopsis\7f64191
76 Ref: exit status\7f67512
77 Node: using tar options\7f69146
78 Ref: TAR_OPTIONS\7f70723
79 Node: Styles\7f71740
80 Ref: Styles-Footnote-1\7f73239
81 Node: Long Options\7f73495
82 Node: Short Options\7f75667
83 Ref: Short Options-Footnote-1\7f77475
84 Node: Old Options\7f77692
85 Node: Mixing\7f80455
86 Ref: Mixing-Footnote-1\7f82821
87 Node: All Options\7f82941
88 Node: Operation Summary\7f83546
89 Ref: --append\7f83666
90 Ref: --catenate\7f83746
91 Ref: --compare\7f83817
92 Ref: --concatenate\7f84020
93 Ref: --create\7f84130
94 Ref: --delete\7f84198
95 Ref: --diff\7f84312
96 Ref: --extract\7f84368
97 Ref: --get\7f84470
98 Ref: --list\7f84528
99 Ref: --update\7f84596
100 Node: Option Summary\7f84806
101 Ref: --absolute-names\7f84961
102 Ref: --after-date\7f85251
103 Ref: --anchored\7f85303
104 Ref: --atime-preserve\7f85436
105 Ref: --auto-compress\7f87956
106 Ref: --backup\7f88183
107 Ref: --block-number\7f88374
108 Ref: --blocking-factor\7f88548
109 Ref: --bzip2\7f88700
110 Ref: --check-device\7f88807
111 Ref: --checkpoint\7f89002
112 Ref: --checkpoint-action\7f89444
113 Ref: --check-links\7f90595
114 Ref: --compress\7f90872
115 Ref: --uncompress\7f90872
116 Ref: --confirmation\7f91076
117 Ref: --delay-directory-restore\7f91144
118 Ref: --dereference\7f91345
119 Ref: --directory\7f91539
120 Ref: --exclude\7f91792
121 Ref: --exclude-backups\7f91911
122 Ref: --exclude-from\7f92001
123 Ref: --exclude-caches\7f92147
124 Ref: --exclude-caches-under\7f92355
125 Ref: --exclude-caches-all\7f92533
126 Ref: --exclude-ignore\7f92662
127 Ref: --exclude-ignore-recursive\7f92882
128 Ref: --exclude-tag\7f93126
129 Ref: --exclude-tag-under\7f93297
130 Ref: --exclude-tag-all\7f93487
131 Ref: --exclude-vcs\7f93616
132 Ref: --exclude-vcs-ignores\7f93775
133 Ref: --file\7f94167
134 Ref: --files-from\7f94367
135 Ref: --force-local\7f94570
136 Ref: --format\7f94761
137 Ref: --full-time\7f95431
138 Ref: --group\7f96111
139 Ref: --gzip\7f96407
140 Ref: --gunzip\7f96407
141 Ref: --ungzip\7f96407
142 Ref: --hard-dereference\7f96630
143 Ref: --help\7f96817
144 Ref: --ignore-case\7f96951
145 Ref: --ignore-command-error\7f97078
146 Ref: --ignore-failed-read\7f97189
147 Ref: --ignore-zeros\7f97330
148 Ref: --incremental\7f97475
149 Ref: --index-file\7f97740
150 Ref: --info-script\7f97825
151 Ref: --new-volume-script\7f97825
152 Ref: --interactive\7f98122
153 Ref: ----keep-directory-symlink\7f98334
154 Ref: --keep-newer-files\7f98882
155 Ref: --keep-old-files\7f99024
156 Ref: --label\7f99236
157 Ref: --level\7f99524
158 Ref: --listed-incremental\7f99965
159 Ref: --lzip\7f100329
160 Ref: --lzma\7f100429
161 Ref: --mode\7f100629
162 Ref: --mtime\7f100920
163 Ref: --multi-volume\7f101361
164 Ref: --newer\7f101565
165 Ref: --newer-mtime\7f101843
166 Ref: --no-anchored\7f102067
167 Ref: --no-auto-compress\7f102204
168 Ref: --no-check-device\7f102355
169 Ref: --no-delay-directory-restore\7f102538
170 Ref: --no-ignore-case\7f102791
171 Ref: --no-ignore-command-error\7f102884
172 Ref: --no-null\7f103039
173 Ref: --no-overwrite-dir\7f103244
174 Ref: --no-quote-chars\7f103387
175 Ref: --no-recursion\7f103568
176 Ref: --no-same-owner\7f103673
177 Ref: --no-same-permissions\7f103856
178 Ref: --no-seek\7f104058
179 Ref: --no-unquote\7f104276
180 Ref: --no-wildcards\7f104414
181 Ref: --no-wildcards-match-slash\7f104498
182 Ref: --null\7f104600
183 Ref: --numeric-owner\7f104828
184 Ref: --occurrence\7f105479
185 Ref: --old-archive\7f106046
186 Ref: --one-file-system\7f106095
187 Ref: --one-top-level\7f106273
188 Ref: --overwrite\7f106909
189 Ref: --overwrite-dir\7f107051
190 Ref: --owner\7f107196
191 Ref: --pax-option\7f107521
192 Ref: --portability\7f107828
193 Ref: --posix\7f107893
194 Ref: --preserve\7f107935
195 Ref: --preserve-order\7f108073
196 Ref: --preserve-permissions\7f108137
197 Ref: --same-permissions\7f108137
198 Ref: --quote-chars\7f108551
199 Ref: --quoting-style\7f108704
200 Ref: --read-full-records\7f109025
201 Ref: --record-size\7f109190
202 Ref: --recursion\7f109534
203 Ref: --recursive-unlink\7f109637
204 Ref: --remove-files\7f109804
205 Ref: --restrict\7f109950
206 Ref: --rmt-command\7f110138
207 Ref: --rsh-command\7f110279
208 Ref: --same-order\7f110401
209 Ref: --same-owner\7f110693
210 Ref: --seek\7f111070
211 Ref: --show-defaults\7f111439
212 Ref: --show-omitted-dirs\7f111947
213 Ref: --show-snapshot-field-ranges\7f112101
214 Ref: --show-transformed-names\7f112297
215 Ref: --show-stored-names\7f112297
216 Ref: --skip-old-files\7f112686
217 Ref: --sort\7f113136
218 Ref: --sparse\7f113780
219 Ref: --sparse-version\7f113919
220 Ref: --starting-file\7f114143
221 Ref: --strip-components\7f114332
222 Ref: --suffix\7f114644
223 Ref: --tape-length\7f114763
224 Ref: --test-label\7f115178
225 Ref: --to-command\7f115330
226 Ref: --to-stdout\7f115489
227 Ref: --totals\7f115642
228 Ref: --touch\7f115873
229 Ref: --transform\7f116075
230 Ref: --xform\7f116075
231 Ref: --unlink-first\7f116686
232 Ref: --unquote\7f116854
233 Ref: --use-compress-program\7f116961
234 Ref: --utc\7f117139
235 Ref: --verbose\7f117232
236 Ref: --verify\7f117484
237 Ref: --version\7f117602
238 Ref: --volno-file\7f117774
239 Ref: --warning\7f117961
240 Ref: --wildcards\7f118138
241 Ref: --wildcards-match-slash\7f118258
242 Ref: --xz\7f118350
243 Ref: Option Summary-Footnote-1\7f118481
244 Node: Short Option Summary\7f118699
245 Node: help\7f120900
246 Ref: help-Footnote-1\7f124734
247 Node: defaults\7f124945
248 Node: verbose\7f125964
249 Ref: totals\7f128265
250 Ref: Progress information\7f129855
251 Ref: show-omitted-dirs\7f130834
252 Ref: block-number\7f131253
253 Ref: verbose-Footnote-1\7f132280
254 Node: checkpoints\7f132387
255 Ref: checkpoint exec\7f138449
256 Node: warnings\7f140475
257 Node: interactive\7f143874
258 Node: external\7f145973
259 Node: operations\7f147554
260 Node: Basic tar\7f147813
261 Ref: Basic tar-Footnote-1\7f150920
262 Node: Advanced tar\7f151064
263 Node: Operations\7f151909
264 Node: append\7f153808
265 Ref: append-Footnote-1\7f156903
266 Node: appending files\7f157090
267 Node: multiple\7f158828
268 Node: update\7f161550
269 Node: how to update\7f162526
270 Node: concatenate\7f164310
271 Ref: concatenate-Footnote-1\7f167558
272 Node: delete\7f167701
273 Node: compare\7f169474
274 Node: create options\7f170906
275 Node: override\7f171364
276 Node: Ignore Failed Read\7f175501
277 Node: extract options\7f175721
278 Node: Reading\7f176554
279 Node: read full records\7f178054
280 Node: Ignore Zeros\7f178390
281 Node: Writing\7f179381
282 Node: Dealing with Old Files\7f179938
283 Node: Overwrite Old Files\7f182741
284 Node: Keep Old Files\7f184198
285 Node: Keep Newer Files\7f185005
286 Node: Unlink First\7f185295
287 Node: Recursive Unlink\7f185699
288 Node: Data Modification Times\7f186252
289 Node: Setting Access Permissions\7f187062
290 Node: Directory Modification Times and Permissions\7f187694
291 Node: Writing to Standard Output\7f191306
292 Node: Writing to an External Program\7f192841
293 Node: remove files\7f196422
294 Node: Scarce\7f196615
295 Node: Starting File\7f196863
296 Node: Same Order\7f197664
297 Node: backup\7f198500
298 Node: Applications\7f201586
299 Node: looking ahead\7f203047
300 Node: Backups\7f203873
301 Node: Full Dumps\7f205454
302 Node: Incremental Dumps\7f207260
303 Ref: --level=0\7f210174
304 Ref: device numbers\7f210707
305 Ref: incremental-op\7f214685
306 Ref: Incremental Dumps-Footnote-1\7f215059
307 Ref: Incremental Dumps-Footnote-2\7f215209
308 Node: Backup Levels\7f215697
309 Node: Backup Parameters\7f218084
310 Node: General-Purpose Variables\7f219265
311 Ref: RSH\7f222426
312 Node: Magnetic Tape Control\7f224305
313 Node: User Hooks\7f225643
314 Node: backup-specs example\7f226972
315 Node: Scripted Backups\7f228115
316 Ref: Scripted Backups-Footnote-1\7f230978
317 Node: Scripted Restoration\7f231362
318 Node: Choosing\7f233973
319 Node: file\7f235095
320 Ref: remote-dev\7f237731
321 Ref: local and remote archives\7f238116
322 Node: Selecting Archive Members\7f239147
323 Ref: input name quoting\7f239828
324 Node: files\7f241814
325 Ref: files-Footnote-1\7f244310
326 Node: nul\7f244468
327 Node: exclude\7f246882
328 Ref: exclude-vcs-ignores\7f248437
329 Ref: exclude-vcs\7f250146
330 Ref: exclude-Footnote-1\7f254048
331 Ref: exclude-Footnote-2\7f254303
332 Node: problems with exclude\7f254374
333 Node: wildcards\7f256419
334 Node: controlling pattern-matching\7f259003
335 Ref: controlling pattern-matching-Footnote-1\7f262993
336 Node: quoting styles\7f263209
337 Ref: escape sequences\7f263555
338 Node: transform\7f269686
339 Ref: show-transformed-names\7f271677
340 Node: after\7f277868
341 Node: recurse\7f281470
342 Node: one\7f284194
343 Node: directory\7f285627
344 Node: absolute\7f288689
345 Ref: absolute-Footnote-1\7f292017
346 Node: Date input formats\7f292368
347 Node: General date syntax\7f294766
348 Node: Calendar date items\7f297749
349 Node: Time of day items\7f299746
350 Node: Time zone items\7f301942
351 Node: Combined date and time of day items\7f303194
352 Node: Day of week items\7f304046
353 Node: Relative items in date strings\7f305055
354 Node: Pure numbers in date strings\7f307857
355 Node: Seconds since the Epoch\7f308838
356 Node: Specifying time zone rules\7f310459
357 Node: Authors of parse_datetime\7f312831
358 Ref: Authors of get_date\7f313010
359 Node: Formats\7f313973
360 Node: Compression\7f318661
361 Node: gzip\7f318953
362 Ref: alternative decompression programs\7f321162
363 Ref: auto-compress\7f324932
364 Ref: use-compress-program\7f325663
365 Ref: gzip-Footnote-1\7f327586
366 Ref: gzip-Footnote-2\7f327635
367 Node: lbzip2\7f327775
368 Node: sparse\7f328872
369 Node: Attributes\7f331926
370 Node: Portability\7f337747
371 Node: Portable Names\7f339233
372 Node: dereference\7f339938
373 Node: hard links\7f341065
374 Ref: hard links-Footnote-1\7f343950
375 Node: old\7f344006
376 Node: ustar\7f345190
377 Node: gnu\7f345793
378 Node: posix\7f346670
379 Node: PAX keywords\7f347151
380 Node: Checksumming\7f352761
381 Node: Large or Negative Values\7f354704
382 Node: Other Tars\7f356304
383 Node: Split Recovery\7f357440
384 Node: Sparse Recovery\7f361172
385 Ref: extracting sparse v.0.x\7f364805
386 Ref: Sparse Recovery-Footnote-1\7f368094
387 Ref: Sparse Recovery-Footnote-2\7f368117
388 Node: cpio\7f368238
389 Node: Media\7f372995
390 Node: Device\7f374942
391 Ref: size-suffixes\7f379731
392 Node: Remote Tape Server\7f380851
393 Node: Common Problems and Solutions\7f384513
394 Node: Blocking\7f384905
395 Ref: Blocking-Footnote-1\7f391388
396 Node: Format Variations\7f391492
397 Node: Blocking Factor\7f392404
398 Node: Many\7f404056
399 Node: Tape Positioning\7f407850
400 Node: mt\7f409723
401 Node: Using Multiple Tapes\7f411278
402 Node: Multi-Volume Archives\7f413344
403 Ref: tape-length\7f414829
404 Ref: change volume prompt\7f415389
405 Ref: volno-file\7f416260
406 Ref: info-script\7f416812
407 Ref: Multi-Volume Archives-Footnote-1\7f422396
408 Ref: Multi-Volume Archives-Footnote-2\7f422506
409 Node: Tape Files\7f422574
410 Node: Tarcat\7f424056
411 Node: label\7f425101
412 Ref: --test-label option\7f426688
413 Ref: label-Footnote-1\7f430138
414 Ref: label-Footnote-2\7f430247
415 Ref: label-Footnote-3\7f430380
416 Node: verify\7f430615
417 Node: Write Protection\7f433915
418 Node: Reliability and security\7f434745
419 Node: Reliability\7f435133
420 Node: Permissions problems\7f435911
421 Node: Data corruption and repair\7f436350
422 Node: Race conditions\7f437276
423 Node: Security\7f439016
424 Node: Privacy\7f439619
425 Node: Integrity\7f440868
426 Node: Live untrusted data\7f443079
427 Node: Security rules of thumb\7f445419
428 Node: Changes\7f446948
429 Node: Configuring Help Summary\7f450563
430 Node: Fixing Snapshot Files\7f457064
431 Node: Tar Internals\7f460433
432 Node: Standard\7f460765
433 Node: Extensions\7f482966
434 Node: Sparse Formats\7f485526
435 Node: Old GNU Format\7f486816
436 Node: PAX 0\7f489217
437 Node: PAX 1\7f492348
438 Node: Snapshot Files\7f494086
439 Node: Dumpdir\7f499656
440 Node: Genfile\7f502902
441 Node: Generate Mode\7f503995
442 Node: Status Mode\7f508292
443 Node: Exec Mode\7f510090
444 Node: Free Software Needs Free Documentation\7f512835
445 Node: GNU Free Documentation License\7f517817
446 Node: Index of Command Line Options\7f543033
447 Node: Index\7f569473
448 \1f
449 End Tag Table