Import upstream version 1.29
[debian/tar] / doc / tar.info
1 This is tar.info, produced by makeinfo version 5.9.93 from tar.texi.
2
3 This manual is for GNU 'tar' (version 1.29, 14 April 2016), which
4 creates and extracts files from archives.
5
6    Copyright (C) 1992, 1994-1997, 1999-2001, 2003-2016 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 with
14      the Back-Cover Texts as in (a) below.  A copy of the license is
15      included in the section entitled "GNU Free Documentation License".
16
17      (a) The FSF's Back-Cover Text is: "You have the freedom to copy and
18      modify this GNU manual."
19 INFO-DIR-SECTION Archiving
20 START-INFO-DIR-ENTRY
21 * Tar: (tar).                   Making tape (or disk) archives.
22 END-INFO-DIR-ENTRY
23
24 INFO-DIR-SECTION Individual utilities
25 START-INFO-DIR-ENTRY
26 * tar: (tar)tar invocation.                     Invoking GNU 'tar'.
27 END-INFO-DIR-ENTRY
28
29 \1f
30 Indirect:
31 tar.info-1: 1138
32 tar.info-2: 302896
33 \1f
34 Tag Table:
35 (Indirect)
36 Node: Top\7f1138
37 Node: Introduction\7f10495
38 Node: Book Contents\7f11282
39 Node: Definitions\7f13454
40 Node: What tar Does\7f15257
41 Node: Naming tar Archives\7f18024
42 Node: Authors\7f18745
43 Node: Reports\7f20558
44 Node: Tutorial\7f20915
45 Node: assumptions\7f21728
46 Node: stylistic conventions\7f24202
47 Node: basic tar options\7f24645
48 Node: frequent operations\7f28284
49 Node: Two Frequent Options\7f28934
50 Node: file tutorial\7f29565
51 Node: verbose tutorial\7f30923
52 Ref: verbose member listing\7f33137
53 Node: help tutorial\7f35905
54 Node: create\7f36260
55 Node: prepare for examples\7f37698
56 Node: Creating the archive\7f39467
57 Node: create verbose\7f43054
58 Node: short create\7f43874
59 Node: create dir\7f46609
60 Node: list\7f49317
61 Ref: listing member and file names\7f50852
62 Node: list dir\7f53471
63 Node: extract\7f54483
64 Node: extracting archives\7f55597
65 Node: extracting files\7f56102
66 Ref: extracting files-Footnote-1\7f57988
67 Node: extract dir\7f58368
68 Node: extracting untrusted archives\7f60760
69 Node: failing commands\7f61640
70 Node: going further\7f63225
71 Node: tar invocation\7f63438
72 Node: Synopsis\7f65218
73 Ref: exit status\7f68540
74 Node: using tar options\7f70173
75 Ref: TAR_OPTIONS\7f71753
76 Node: Styles\7f72772
77 Ref: Styles-Footnote-1\7f74271
78 Node: Long Options\7f74527
79 Node: Short Options\7f76699
80 Ref: Short Options-Footnote-1\7f78507
81 Node: Old Options\7f78724
82 Node: Mixing\7f81487
83 Ref: Mixing-Footnote-1\7f83853
84 Node: All Options\7f83973
85 Node: Operation Summary\7f84609
86 Ref: --append\7f84729
87 Ref: --catenate\7f84810
88 Ref: --compare\7f84882
89 Ref: --concatenate\7f85086
90 Ref: --create\7f85197
91 Ref: --delete\7f85266
92 Ref: --diff\7f85381
93 Ref: --extract\7f85438
94 Ref: --get\7f85541
95 Ref: --list\7f85600
96 Ref: --update\7f85669
97 Node: Option Summary\7f85880
98 Ref: --absolute-names\7f86035
99 Ref: --acls\7f86327
100 Ref: --after-date\7f86408
101 Ref: --anchored\7f86461
102 Ref: --atime-preserve\7f86594
103 Ref: --auto-compress\7f89110
104 Ref: --backup\7f89338
105 Ref: --block-number\7f89530
106 Ref: --blocking-factor\7f89705
107 Ref: --bzip2\7f89858
108 Ref: --check-device\7f89966
109 Ref: --checkpoint\7f90161
110 Ref: --checkpoint-action\7f90604
111 Ref: --check-links\7f91763
112 Ref: --compress\7f92040
113 Ref: --uncompress\7f92040
114 Ref: --clamp-mtime\7f92245
115 Ref: --confirmation\7f92285
116 Ref: --delay-directory-restore\7f92354
117 Ref: --dereference\7f92557
118 Ref: --directory\7f92752
119 Ref: --exclude\7f93006
120 Ref: --exclude-backups\7f93126
121 Ref: --exclude-from\7f93216
122 Ref: --exclude-caches\7f93363
123 Ref: --exclude-caches-under\7f93572
124 Ref: --exclude-caches-all\7f93751
125 Ref: --exclude-ignore\7f93881
126 Ref: --exclude-ignore-recursive\7f94101
127 Ref: --exclude-tag\7f94345
128 Ref: --exclude-tag-under\7f94517
129 Ref: --exclude-tag-all\7f94708
130 Ref: --exclude-vcs\7f94838
131 Ref: --exclude-vcs-ignores\7f94998
132 Ref: --file\7f95391
133 Ref: --files-from\7f95592
134 Ref: --force-local\7f95796
135 Ref: --format\7f95988
136 Ref: --full-time\7f96663
137 Ref: --group\7f97343
138 Ref: --group-map\7f97670
139 Ref: --gzip\7f98062
140 Ref: --gunzip\7f98062
141 Ref: --ungzip\7f98062
142 Ref: --hard-dereference\7f98286
143 Ref: --help\7f98473
144 Ref: --hole-detection\7f98609
145 Ref: --ignore-case\7f98845
146 Ref: --ignore-command-error\7f98972
147 Ref: --ignore-failed-read\7f99084
148 Ref: --ignore-zeros\7f99226
149 Ref: --incremental\7f99371
150 Ref: --index-file\7f99637
151 Ref: --info-script\7f99723
152 Ref: --new-volume-script\7f99723
153 Ref: --interactive\7f100021
154 Ref: --keep-directory-symlink\7f100234
155 Ref: --keep-newer-files\7f100783
156 Ref: --keep-old-files\7f100926
157 Ref: --label\7f101139
158 Ref: --level\7f101428
159 Ref: --listed-incremental\7f101868
160 Ref: --lzip\7f102233
161 Ref: --lzma\7f102334
162 Ref: --mode\7f102536
163 Ref: --mtime\7f102829
164 Ref: --multi-volume\7f103509
165 Ref: --newer\7f103715
166 Ref: --newer-mtime\7f103994
167 Ref: --no-acls\7f104219
168 Ref: --no-anchored\7f104313
169 Ref: --no-auto-compress\7f104450
170 Ref: --no-check-device\7f104602
171 Ref: --no-delay-directory-restore\7f104785
172 Ref: --no-ignore-case\7f105034
173 Ref: --no-ignore-command-error\7f105127
174 Ref: --no-null\7f105283
175 Ref: --no-overwrite-dir\7f105489
176 Ref: --no-quote-chars\7f105633
177 Ref: --no-recursion\7f105814
178 Ref: --no-same-owner\7f105920
179 Ref: --no-same-permissions\7f106104
180 Ref: --no-seek\7f106307
181 Ref: --no-selinux\7f106526
182 Ref: --no-unquote\7f106627
183 Ref: --no-verbatim-files-from\7f106765
184 Ref: --no-wildcards\7f107266
185 Ref: --no-wildcards-match-slash\7f107350
186 Ref: --no-xattrs\7f107452
187 Ref: --null\7f107555
188 Ref: --numeric-owner\7f107906
189 Ref: --occurrence\7f108558
190 Ref: --old-archive\7f109126
191 Ref: --one-file-system\7f109175
192 Ref: --one-top-level\7f109353
193 Ref: --overwrite\7f109989
194 Ref: --overwrite-dir\7f110132
195 Ref: --owner\7f110278
196 Ref: --owner-map\7f110641
197 Ref: --pax-option\7f111017
198 Ref: --portability\7f111324
199 Ref: --posix\7f111389
200 Ref: --preserve-order\7f111431
201 Ref: --preserve-permissions\7f111496
202 Ref: --same-permissions\7f111496
203 Ref: --quote-chars\7f111911
204 Ref: --quoting-style\7f112064
205 Ref: --read-full-records\7f112387
206 Ref: --record-size\7f112553
207 Ref: --recursion\7f112906
208 Ref: --recursive-unlink\7f113011
209 Ref: --remove-files\7f113174
210 Ref: --restrict\7f113321
211 Ref: --rmt-command\7f113510
212 Ref: --rsh-command\7f113652
213 Ref: --same-order\7f113775
214 Ref: --same-owner\7f114068
215 Ref: --seek\7f114447
216 Ref: --selinux\7f114818
217 Ref: --show-defaults\7f114919
218 Ref: --show-omitted-dirs\7f115429
219 Ref: --show-snapshot-field-ranges\7f115584
220 Ref: --show-transformed-names\7f115781
221 Ref: --show-stored-names\7f115781
222 Ref: --skip-old-files\7f116171
223 Ref: --sort\7f116622
224 Ref: --sparse\7f117261
225 Ref: --sparse-version\7f117401
226 Ref: --starting-file\7f117627
227 Ref: --strip-components\7f117817
228 Ref: --suffix\7f118154
229 Ref: --tape-length\7f118274
230 Ref: --test-label\7f118699
231 Ref: --to-command\7f118852
232 Ref: --to-stdout\7f119012
233 Ref: --totals\7f119166
234 Ref: --touch\7f119398
235 Ref: --transform\7f119601
236 Ref: --xform\7f119601
237 Ref: --unlink-first\7f120215
238 Ref: --unquote\7f120379
239 Ref: --use-compress-program\7f120486
240 Ref: --utc\7f120665
241 Ref: --verbatim-files-from\7f120759
242 Ref: --verbose\7f121603
243 Ref: --verify\7f121856
244 Ref: --version\7f121975
245 Ref: --volno-file\7f122148
246 Ref: --warning\7f122336
247 Ref: --wildcards\7f122514
248 Ref: --wildcards-match-slash\7f122634
249 Ref: --xattrs\7f122726
250 Ref: --xattrs-exclude\7f122825
251 Ref: --xattrs-include\7f122952
252 Ref: --xz\7f123217
253 Ref: Option Summary-Footnote-1\7f123347
254 Node: Short Option Summary\7f123566
255 Node: Position-Sensitive Options\7f126469
256 Ref: Position-Sensitive Options-Footnote-1\7f129341
257 Node: help\7f129503
258 Ref: help-Footnote-1\7f133338
259 Node: defaults\7f133549
260 Node: verbose\7f134568
261 Ref: totals\7f136871
262 Ref: Progress information\7f138461
263 Ref: show-omitted-dirs\7f139440
264 Ref: block-number\7f139859
265 Ref: verbose-Footnote-1\7f140886
266 Node: checkpoints\7f140993
267 Ref: checkpoint exec\7f147058
268 Node: warnings\7f149087
269 Node: interactive\7f152490
270 Node: external\7f154589
271 Node: operations\7f156177
272 Node: Basic tar\7f156436
273 Ref: Basic tar-Footnote-1\7f159543
274 Node: Advanced tar\7f159687
275 Node: Operations\7f160532
276 Node: append\7f162427
277 Ref: append-Footnote-1\7f165524
278 Node: appending files\7f165711
279 Node: multiple\7f167448
280 Node: update\7f170170
281 Node: how to update\7f171147
282 Node: concatenate\7f172931
283 Ref: concatenate-Footnote-1\7f176179
284 Node: delete\7f176322
285 Node: compare\7f178096
286 Node: create options\7f179530
287 Node: override\7f180017
288 Node: Extended File Attributes\7f187078
289 Node: Ignore Failed Read\7f191713
290 Node: extract options\7f191949
291 Node: Reading\7f192782
292 Node: read full records\7f194282
293 Node: Ignore Zeros\7f194617
294 Node: Writing\7f195608
295 Node: Dealing with Old Files\7f196165
296 Node: Overwrite Old Files\7f198967
297 Node: Keep Old Files\7f200424
298 Node: Keep Newer Files\7f201231
299 Node: Unlink First\7f201521
300 Node: Recursive Unlink\7f201925
301 Node: Data Modification Times\7f202478
302 Node: Setting Access Permissions\7f203288
303 Node: Directory Modification Times and Permissions\7f203920
304 Node: Writing to Standard Output\7f207533
305 Node: Writing to an External Program\7f209068
306 Node: remove files\7f212658
307 Node: Scarce\7f212851
308 Node: Starting File\7f213099
309 Node: Same Order\7f213900
310 Node: backup\7f214736
311 Node: Applications\7f217827
312 Node: looking ahead\7f219291
313 Node: Backups\7f220117
314 Node: Full Dumps\7f221698
315 Node: Incremental Dumps\7f223507
316 Ref: --level=0\7f226421
317 Ref: device numbers\7f226954
318 Ref: incremental-op\7f230937
319 Ref: Incremental Dumps-Footnote-1\7f231311
320 Ref: Incremental Dumps-Footnote-2\7f231461
321 Node: Backup Levels\7f231949
322 Node: Backup Parameters\7f234336
323 Node: General-Purpose Variables\7f235517
324 Ref: RSH\7f238685
325 Node: Magnetic Tape Control\7f240569
326 Node: User Hooks\7f241908
327 Node: backup-specs example\7f243241
328 Node: Scripted Backups\7f244381
329 Ref: Scripted Backups-Footnote-1\7f247246
330 Node: Scripted Restoration\7f247630
331 Node: Choosing\7f250236
332 Node: file\7f251358
333 Ref: remote-dev\7f253994
334 Ref: local and remote archives\7f254379
335 Node: Selecting Archive Members\7f255410
336 Ref: input name quoting\7f256091
337 Node: files\7f258066
338 Ref: verbatim-files-from\7f260773
339 Ref: no-verbatim-files-from\7f261033
340 Ref: files-Footnote-1\7f261775
341 Node: nul\7f261933
342 Node: exclude\7f264391
343 Ref: exclude-vcs-ignores\7f265949
344 Ref: exclude-vcs\7f267662
345 Ref: exclude-Footnote-1\7f271598
346 Ref: exclude-Footnote-2\7f271852
347 Node: problems with exclude\7f271923
348 Node: wildcards\7f273973
349 Node: controlling pattern-matching\7f276556
350 Ref: anchored patterns\7f279197
351 Ref: case-insensitive matches\7f279467
352 Ref: controlling pattern-matching-Footnote-1\7f280544
353 Node: quoting styles\7f280761
354 Ref: escape sequences\7f281106
355 Node: transform\7f287250
356 Ref: show-transformed-names\7f289241
357 Node: after\7f295433
358 Node: recurse\7f299035
359 Node: one\7f302896
360 Node: directory\7f304329
361 Node: absolute\7f307428
362 Ref: absolute-Footnote-1\7f310755
363 Node: Date input formats\7f311106
364 Node: General date syntax\7f313502
365 Node: Calendar date items\7f316479
366 Node: Time of day items\7f318476
367 Node: Time zone items\7f320672
368 Node: Combined date and time of day items\7f321923
369 Node: Day of week items\7f322776
370 Node: Relative items in date strings\7f323784
371 Node: Pure numbers in date strings\7f326586
372 Node: Seconds since the Epoch\7f327567
373 Node: Specifying time zone rules\7f329189
374 Node: Authors of parse_datetime\7f331562
375 Ref: Authors of get_date\7f331741
376 Node: Formats\7f332704
377 Node: Compression\7f337379
378 Node: gzip\7f337671
379 Ref: alternative decompression programs\7f339882
380 Ref: auto-compress\7f343431
381 Ref: use-compress-program\7f344196
382 Ref: gzip-Footnote-1\7f346163
383 Ref: gzip-Footnote-2\7f346212
384 Node: lbzip2\7f346352
385 Node: sparse\7f347449
386 Node: Attributes\7f351993
387 Node: Portability\7f357655
388 Node: Portable Names\7f359141
389 Node: dereference\7f359846
390 Node: hard links\7f360973
391 Ref: hard links-Footnote-1\7f363858
392 Node: old\7f363914
393 Node: ustar\7f365097
394 Node: gnu\7f365700
395 Node: posix\7f366577
396 Node: PAX keywords\7f367058
397 Node: Checksumming\7f373056
398 Node: Large or Negative Values\7f375000
399 Node: Other Tars\7f376601
400 Node: Split Recovery\7f377737
401 Node: Sparse Recovery\7f381486
402 Ref: extracting sparse v.0.x\7f385115
403 Ref: Sparse Recovery-Footnote-1\7f388404
404 Ref: Sparse Recovery-Footnote-2\7f388427
405 Node: cpio\7f388548
406 Node: Media\7f393309
407 Node: Device\7f395260
408 Ref: size-suffixes\7f400051
409 Node: Remote Tape Server\7f401191
410 Node: Common Problems and Solutions\7f404855
411 Node: Blocking\7f405247
412 Ref: Blocking-Footnote-1\7f411731
413 Node: Format Variations\7f411835
414 Node: Blocking Factor\7f412750
415 Node: Many\7f424401
416 Node: Tape Positioning\7f428195
417 Node: mt\7f430071
418 Node: Using Multiple Tapes\7f431628
419 Node: Multi-Volume Archives\7f433694
420 Ref: tape-length\7f435179
421 Ref: change volume prompt\7f435734
422 Ref: volno-file\7f436601
423 Ref: info-script\7f437154
424 Ref: Multi-Volume Archives-Footnote-1\7f442739
425 Ref: Multi-Volume Archives-Footnote-2\7f442849
426 Node: Tape Files\7f442917
427 Node: Tarcat\7f444402
428 Node: label\7f445447
429 Ref: --test-label option\7f447035
430 Ref: label-Footnote-1\7f450486
431 Ref: label-Footnote-2\7f450595
432 Ref: label-Footnote-3\7f450728
433 Node: verify\7f450963
434 Node: Write Protection\7f454263
435 Node: Reliability and security\7f455093
436 Node: Reliability\7f455481
437 Node: Permissions problems\7f456259
438 Node: Data corruption and repair\7f456698
439 Node: Race conditions\7f457625
440 Node: Security\7f459364
441 Node: Privacy\7f459967
442 Node: Integrity\7f461216
443 Node: Live untrusted data\7f463427
444 Node: Security rules of thumb\7f465766
445 Node: Changes\7f467294
446 Node: Configuring Help Summary\7f470915
447 Node: Fixing Snapshot Files\7f477431
448 Node: Tar Internals\7f480800
449 Node: Standard\7f481132
450 Node: Extensions\7f503335
451 Node: Sparse Formats\7f505897
452 Node: Old GNU Format\7f507186
453 Node: PAX 0\7f509573
454 Node: PAX 1\7f512691
455 Node: Snapshot Files\7f514419
456 Node: Dumpdir\7f520017
457 Node: Genfile\7f523247
458 Node: Generate Mode\7f524343
459 Node: Status Mode\7f529583
460 Node: Exec Mode\7f531385
461 Node: Free Software Needs Free Documentation\7f534145
462 Node: GNU Free Documentation License\7f539126
463 Node: Index of Command Line Options\7f564329
464 Node: Index\7f592555
465 \1f
466 End Tag Table