Import upstream version 1.26
[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.26, 12 March 2011), which
4 creates and extracts files from archives.
5
6    Copyright (C) 1992, 1994, 1995, 1996, 1997, 1999, 2000, 2001, 2003,
7 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software 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 no Invariant Sections, with the Front-Cover Texts
13      being "A GNU Manual", and with the Back-Cover Texts as in (a)
14      below.  A copy of the license is included in the section entitled
15      "GNU Free Documentation License".
16
17      (a) The FSF's Back-Cover Text is: "You have the freedom to copy
18      and modify this GNU manual.  Buying copies from the FSF supports
19      it in developing GNU and promoting software freedom."
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: 1253
34 tar.info-2: 301909
35 \1f
36 Tag Table:
37 (Indirect)
38 Node: Top\7f1253
39 Node: Introduction\7f10667
40 Node: Book Contents\7f11454
41 Node: Definitions\7f13626
42 Node: What tar Does\7f15429
43 Node: Naming tar Archives\7f18195
44 Node: Authors\7f18915
45 Node: Reports\7f20728
46 Node: Tutorial\7f21085
47 Node: assumptions\7f21898
48 Node: stylistic conventions\7f24373
49 Node: basic tar options\7f24816
50 Node: frequent operations\7f28454
51 Node: Two Frequent Options\7f29106
52 Node: file tutorial\7f29737
53 Node: verbose tutorial\7f31094
54 Ref: verbose member listing\7f33308
55 Node: help tutorial\7f36068
56 Node: create\7f36422
57 Node: prepare for examples\7f37923
58 Node: Creating the archive\7f39692
59 Node: create verbose\7f42524
60 Node: short create\7f43344
61 Node: create dir\7f46097
62 Node: list\7f48805
63 Ref: listing member and file names\7f50084
64 Node: list dir\7f52398
65 Node: extract\7f53410
66 Node: extracting archives\7f54524
67 Node: extracting files\7f55029
68 Ref: extracting files-Footnote-1\7f57676
69 Node: extract dir\7f58056
70 Node: extracting untrusted archives\7f60449
71 Node: failing commands\7f61328
72 Node: going further\7f62422
73 Node: tar invocation\7f62635
74 Node: Synopsis\7f64097
75 Node: using tar options\7f69052
76 Ref: TAR_OPTIONS\7f70629
77 Node: Styles\7f71646
78 Ref: Styles-Footnote-1\7f73145
79 Node: Long Options\7f73401
80 Node: Short Options\7f75573
81 Ref: Short Options-Footnote-1\7f77381
82 Node: Old Options\7f77598
83 Ref: Old Options-Footnote-1\7f80485
84 Node: Mixing\7f80655
85 Ref: Mixing-Footnote-1\7f83021
86 Node: All Options\7f83141
87 Node: Operation Summary\7f83746
88 Ref: --append\7f83866
89 Ref: --catenate\7f83946
90 Ref: --compare\7f84017
91 Ref: --concatenate\7f84220
92 Ref: --create\7f84330
93 Ref: --delete\7f84398
94 Ref: --diff\7f84512
95 Ref: --extract\7f84568
96 Ref: --get\7f84670
97 Ref: --list\7f84728
98 Ref: --update\7f84796
99 Node: Option Summary\7f85006
100 Ref: --absolute-names\7f85161
101 Ref: --after-date\7f85339
102 Ref: --anchored\7f85391
103 Ref: --atime-preserve\7f85524
104 Ref: --auto-compress\7f88044
105 Ref: --backup\7f88271
106 Ref: --block-number\7f88462
107 Ref: --blocking-factor\7f88636
108 Ref: --bzip2\7f88788
109 Ref: --check-device\7f88895
110 Ref: --checkpoint\7f89090
111 Ref: --checkpoint-action\7f89532
112 Ref: --check-links\7f90683
113 Ref: --compress\7f90960
114 Ref: --uncompress\7f90960
115 Ref: --confirmation\7f91164
116 Ref: --delay-directory-restore\7f91232
117 Ref: --dereference\7f91433
118 Ref: --directory\7f91627
119 Ref: --exclude\7f91880
120 Ref: --exclude-backups\7f91999
121 Ref: --exclude-from\7f92089
122 Ref: --exclude-caches\7f92235
123 Ref: --exclude-caches-under\7f92443
124 Ref: --exclude-caches-all\7f92621
125 Ref: --exclude-tag\7f92750
126 Ref: --exclude-tag-under\7f92921
127 Ref: --exclude-tag-all\7f93111
128 Ref: --exclude-vcs\7f93240
129 Ref: --file\7f93406
130 Ref: --files-from\7f93606
131 Ref: --force-local\7f93809
132 Ref: --format\7f94000
133 Ref: --full-time\7f94670
134 Ref: --group\7f95350
135 Ref: --gzip\7f95698
136 Ref: --gunzip\7f95698
137 Ref: --ungzip\7f95698
138 Ref: --hard-dereference\7f95921
139 Ref: --help\7f96108
140 Ref: --ignore-case\7f96242
141 Ref: --ignore-command-error\7f96369
142 Ref: --ignore-failed-read\7f96480
143 Ref: --ignore-zeros\7f96610
144 Ref: --incremental\7f96755
145 Ref: --index-file\7f97020
146 Ref: --info-script\7f97105
147 Ref: --new-volume-script\7f97105
148 Ref: --interactive\7f97426
149 Ref: --keep-newer-files\7f97638
150 Ref: --keep-old-files\7f97780
151 Ref: --label\7f97911
152 Ref: --level\7f98199
153 Ref: --listed-incremental\7f98640
154 Ref: --lzip\7f99004
155 Ref: --lzma\7f99104
156 Ref: --mode\7f99304
157 Ref: --mtime\7f99595
158 Ref: --multi-volume\7f100036
159 Ref: --newer\7f100240
160 Ref: --newer-mtime\7f100518
161 Ref: --no-anchored\7f100742
162 Ref: --no-auto-compress\7f100879
163 Ref: --no-check-device\7f101030
164 Ref: --no-delay-directory-restore\7f101213
165 Ref: --no-ignore-case\7f101466
166 Ref: --no-ignore-command-error\7f101559
167 Ref: --no-null\7f101714
168 Ref: --no-overwrite-dir\7f101919
169 Ref: --no-quote-chars\7f102062
170 Ref: --no-recursion\7f102243
171 Ref: --no-same-owner\7f102348
172 Ref: --no-same-permissions\7f102531
173 Ref: --no-seek\7f102733
174 Ref: --no-unquote\7f102951
175 Ref: --no-wildcards\7f103089
176 Ref: --no-wildcards-match-slash\7f103173
177 Ref: --null\7f103275
178 Ref: --numeric-owner\7f103503
179 Ref: --occurrence\7f104154
180 Ref: --old-archive\7f104721
181 Ref: --one-file-system\7f104770
182 Ref: --overwrite\7f104948
183 Ref: --overwrite-dir\7f105090
184 Ref: --owner\7f105235
185 Ref: --pax-option\7f105614
186 Ref: --portability\7f105921
187 Ref: --posix\7f105986
188 Ref: --preserve\7f106028
189 Ref: --preserve-order\7f106166
190 Ref: --preserve-permissions\7f106230
191 Ref: --same-permissions\7f106230
192 Ref: --quote-chars\7f106644
193 Ref: --quoting-style\7f106797
194 Ref: --read-full-records\7f107118
195 Ref: --record-size\7f107283
196 Ref: --recursion\7f107627
197 Ref: --recursive-unlink\7f107730
198 Ref: --remove-files\7f107897
199 Ref: --restrict\7f108043
200 Ref: --rmt-command\7f108231
201 Ref: --rsh-command\7f108372
202 Ref: --same-order\7f108494
203 Ref: --same-owner\7f108786
204 Ref: --seek\7f109163
205 Ref: --show-defaults\7f109532
206 Ref: --show-omitted-dirs\7f110022
207 Ref: --show-transformed-names\7f110176
208 Ref: --show-stored-names\7f110176
209 Ref: --sparse\7f110565
210 Ref: --sparse-version\7f110704
211 Ref: --starting-file\7f110928
212 Ref: --strip-components\7f111117
213 Ref: --suffix\7f111429
214 Ref: --tape-length\7f111548
215 Ref: --test-label\7f111963
216 Ref: --to-command\7f112115
217 Ref: --to-stdout\7f112274
218 Ref: --totals\7f112427
219 Ref: --touch\7f112658
220 Ref: --transform\7f112860
221 Ref: --xform\7f112860
222 Ref: --unlink-first\7f113471
223 Ref: --unquote\7f113639
224 Ref: --use-compress-program\7f113746
225 Ref: --utc\7f113924
226 Ref: --verbose\7f114017
227 Ref: --verify\7f114269
228 Ref: --version\7f114387
229 Ref: --volno-file\7f114559
230 Ref: --warning\7f114746
231 Ref: --wildcards\7f114923
232 Ref: --wildcards-match-slash\7f115043
233 Ref: --xz\7f115135
234 Ref: Option Summary-Footnote-1\7f115266
235 Node: Short Option Summary\7f115484
236 Node: help\7f117685
237 Ref: help-Footnote-1\7f121569
238 Node: defaults\7f121780
239 Node: verbose\7f122799
240 Ref: totals\7f125100
241 Ref: Progress information\7f126690
242 Ref: show-omitted-dirs\7f127669
243 Ref: block-number\7f128088
244 Ref: verbose-Footnote-1\7f129115
245 Node: checkpoints\7f129222
246 Node: warnings\7f134616
247 Node: interactive\7f137968
248 Node: operations\7f140050
249 Node: Basic tar\7f140309
250 Ref: Basic tar-Footnote-1\7f143413
251 Node: Advanced tar\7f143557
252 Node: Operations\7f144402
253 Node: append\7f146301
254 Ref: append-Footnote-1\7f149396
255 Node: appending files\7f149559
256 Node: multiple\7f151297
257 Node: update\7f154019
258 Node: how to update\7f154995
259 Node: concatenate\7f156779
260 Ref: concatenate-Footnote-1\7f160027
261 Node: delete\7f160170
262 Node: compare\7f161943
263 Node: create options\7f163375
264 Node: override\7f163833
265 Node: Ignore Failed Read\7f167261
266 Node: extract options\7f167481
267 Node: Reading\7f168314
268 Node: read full records\7f169814
269 Node: Ignore Zeros\7f170150
270 Node: Writing\7f171141
271 Node: Dealing with Old Files\7f171698
272 Node: Overwrite Old Files\7f174125
273 Node: Keep Old Files\7f175582
274 Node: Keep Newer Files\7f176092
275 Node: Unlink First\7f176382
276 Node: Recursive Unlink\7f176786
277 Node: Data Modification Times\7f177339
278 Node: Setting Access Permissions\7f178149
279 Node: Directory Modification Times and Permissions\7f178781
280 Node: Writing to Standard Output\7f182393
281 Node: Writing to an External Program\7f183928
282 Node: remove files\7f187067
283 Node: Scarce\7f187260
284 Node: Starting File\7f187508
285 Node: Same Order\7f188309
286 Node: backup\7f189145
287 Node: Applications\7f192231
288 Node: looking ahead\7f193692
289 Node: Backups\7f194518
290 Node: Full Dumps\7f196099
291 Node: Incremental Dumps\7f197905
292 Ref: --level=0\7f200819
293 Ref: device numbers\7f201352
294 Ref: incremental-op\7f205330
295 Ref: Incremental Dumps-Footnote-1\7f205704
296 Ref: Incremental Dumps-Footnote-2\7f205854
297 Node: Backup Levels\7f206342
298 Node: Backup Parameters\7f208729
299 Node: General-Purpose Variables\7f209910
300 Ref: RSH\7f213071
301 Node: Magnetic Tape Control\7f214950
302 Node: User Hooks\7f216288
303 Node: backup-specs example\7f217617
304 Node: Scripted Backups\7f218760
305 Ref: Scripted Backups-Footnote-1\7f221623
306 Node: Scripted Restoration\7f222007
307 Node: Choosing\7f224618
308 Node: file\7f225740
309 Ref: remote-dev\7f228376
310 Ref: local and remote archives\7f228761
311 Node: Selecting Archive Members\7f229792
312 Ref: input name quoting\7f230473
313 Node: files\7f232459
314 Ref: files-Footnote-1\7f235732
315 Node: nul\7f235890
316 Node: exclude\7f238289
317 Node: problems with exclude\7f243463
318 Node: wildcards\7f245508
319 Node: controlling pattern-matching\7f248092
320 Ref: controlling pattern-matching-Footnote-1\7f252082
321 Node: quoting styles\7f252298
322 Ref: escape sequences\7f252644
323 Node: transform\7f258779
324 Ref: show-transformed-names\7f260770
325 Node: after\7f266961
326 Node: recurse\7f270563
327 Node: one\7f273287
328 Node: directory\7f274720
329 Node: absolute\7f277782
330 Ref: absolute-Footnote-1\7f280953
331 Node: Date input formats\7f281304
332 Node: General date syntax\7f283626
333 Node: Calendar date items\7f286577
334 Node: Time of day items\7f288574
335 Node: Time zone items\7f290770
336 Node: Day of week items\7f292004
337 Node: Relative items in date strings\7f292993
338 Node: Pure numbers in date strings\7f295795
339 Node: Seconds since the Epoch\7f296776
340 Node: Specifying time zone rules\7f298397
341 Node: Authors of parse_datetime\7f300767
342 Ref: Authors of get_date\7f300946
343 Node: Formats\7f301909
344 Node: Compression\7f306597
345 Node: gzip\7f306889
346 Ref: alternative decompression programs\7f309098
347 Ref: auto-compress\7f312929
348 Ref: gzip-Footnote-1\7f315169
349 Ref: gzip-Footnote-2\7f315218
350 Node: lbzip2\7f315358
351 Node: sparse\7f316455
352 Node: Attributes\7f319509
353 Node: Portability\7f325330
354 Node: Portable Names\7f326816
355 Node: dereference\7f327521
356 Node: hard links\7f328648
357 Ref: hard links-Footnote-1\7f331533
358 Node: old\7f331589
359 Node: ustar\7f332773
360 Node: gnu\7f333364
361 Node: posix\7f334241
362 Node: PAX keywords\7f334722
363 Node: Checksumming\7f340332
364 Node: Large or Negative Values\7f342258
365 Node: Other Tars\7f343858
366 Node: Split Recovery\7f344994
367 Node: Sparse Recovery\7f348726
368 Ref: extracting sparse v.0.x\7f352359
369 Ref: Sparse Recovery-Footnote-1\7f355648
370 Ref: Sparse Recovery-Footnote-2\7f355671
371 Node: cpio\7f355792
372 Node: Media\7f360549
373 Node: Device\7f362496
374 Ref: size-suffixes\7f367285
375 Node: Remote Tape Server\7f368395
376 Node: Common Problems and Solutions\7f372118
377 Node: Blocking\7f372510
378 Node: Format Variations\7f378954
379 Node: Blocking Factor\7f379866
380 Node: Many\7f391518
381 Node: Tape Positioning\7f395312
382 Node: mt\7f397185
383 Node: Using Multiple Tapes\7f398740
384 Node: Multi-Volume Archives\7f400806
385 Ref: tape-length\7f402291
386 Ref: change volume prompt\7f402851
387 Ref: volno-file\7f403722
388 Ref: info-script\7f404274
389 Ref: Multi-Volume Archives-Footnote-1\7f409461
390 Ref: Multi-Volume Archives-Footnote-2\7f409571
391 Node: Tape Files\7f409639
392 Node: Tarcat\7f411121
393 Node: label\7f412166
394 Ref: --test-label option\7f413753
395 Ref: label-Footnote-1\7f417198
396 Ref: label-Footnote-2\7f417307
397 Ref: label-Footnote-3\7f417440
398 Node: verify\7f417675
399 Node: Write Protection\7f420975
400 Node: Reliability and security\7f421805
401 Node: Reliability\7f422193
402 Node: Permissions problems\7f422971
403 Node: Data corruption and repair\7f423410
404 Node: Race conditions\7f424336
405 Node: Security\7f426076
406 Node: Privacy\7f426679
407 Node: Integrity\7f427928
408 Node: Live untrusted data\7f429969
409 Node: Security rules of thumb\7f432309
410 Node: Changes\7f433838
411 Node: Configuring Help Summary\7f437453
412 Node: Fixing Snapshot Files\7f443954
413 Node: Tar Internals\7f446140
414 Node: Standard\7f446472
415 Node: Extensions\7f468673
416 Node: Sparse Formats\7f471233
417 Node: Old GNU Format\7f472523
418 Node: PAX 0\7f474924
419 Node: PAX 1\7f478055
420 Node: Snapshot Files\7f479793
421 Node: Dumpdir\7f484254
422 Node: Genfile\7f487500
423 Node: Generate Mode\7f488593
424 Node: Status Mode\7f492890
425 Node: Exec Mode\7f494689
426 Node: Free Software Needs Free Documentation\7f497434
427 Node: GNU Free Documentation License\7f502416
428 Node: Index of Command Line Options\7f527629
429 Node: Index\7f553128
430 \1f
431 End Tag Table