67c5c648e53f2b8a9f8f65718156cacfafc9aec7
[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.27.1, 24 September 2013), 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: 1148
34 tar.info-2: 298438
35 tar.info-3: 562252
36 \1f
37 Tag Table:
38 (Indirect)
39 Node: Top\7f1148
40 Node: Introduction\7f10457
41 Node: Book Contents\7f11244
42 Node: Definitions\7f13416
43 Node: What tar Does\7f15219
44 Node: Naming tar Archives\7f17985
45 Node: Authors\7f18705
46 Node: Reports\7f20520
47 Node: Tutorial\7f20877
48 Node: assumptions\7f21690
49 Node: stylistic conventions\7f24165
50 Node: basic tar options\7f24608
51 Node: frequent operations\7f28246
52 Node: Two Frequent Options\7f28898
53 Node: file tutorial\7f29529
54 Node: verbose tutorial\7f30886
55 Ref: verbose member listing\7f33100
56 Node: help tutorial\7f35860
57 Node: create\7f36214
58 Node: prepare for examples\7f37715
59 Node: Creating the archive\7f39484
60 Node: create verbose\7f42316
61 Node: short create\7f43136
62 Node: create dir\7f45889
63 Node: list\7f48597
64 Ref: listing member and file names\7f49876
65 Node: list dir\7f52190
66 Node: extract\7f53202
67 Node: extracting archives\7f54316
68 Node: extracting files\7f54821
69 Ref: extracting files-Footnote-1\7f57468
70 Node: extract dir\7f57848
71 Node: extracting untrusted archives\7f60241
72 Node: failing commands\7f61120
73 Node: going further\7f62214
74 Node: tar invocation\7f62427
75 Node: Synopsis\7f64207
76 Ref: exit status\7f67528
77 Node: using tar options\7f69162
78 Ref: TAR_OPTIONS\7f70739
79 Node: Styles\7f71756
80 Ref: Styles-Footnote-1\7f73255
81 Node: Long Options\7f73511
82 Node: Short Options\7f75683
83 Ref: Short Options-Footnote-1\7f77491
84 Node: Old Options\7f77708
85 Node: Mixing\7f80471
86 Ref: Mixing-Footnote-1\7f82837
87 Node: All Options\7f82957
88 Node: Operation Summary\7f83562
89 Ref: --append\7f83682
90 Ref: --catenate\7f83762
91 Ref: --compare\7f83833
92 Ref: --concatenate\7f84036
93 Ref: --create\7f84146
94 Ref: --delete\7f84214
95 Ref: --diff\7f84328
96 Ref: --extract\7f84384
97 Ref: --get\7f84486
98 Ref: --list\7f84544
99 Ref: --update\7f84612
100 Node: Option Summary\7f84822
101 Ref: --absolute-names\7f84977
102 Ref: --after-date\7f85267
103 Ref: --anchored\7f85319
104 Ref: --atime-preserve\7f85452
105 Ref: --auto-compress\7f87972
106 Ref: --backup\7f88199
107 Ref: --block-number\7f88390
108 Ref: --blocking-factor\7f88564
109 Ref: --bzip2\7f88716
110 Ref: --check-device\7f88823
111 Ref: --checkpoint\7f89018
112 Ref: --checkpoint-action\7f89460
113 Ref: --check-links\7f90611
114 Ref: --compress\7f90888
115 Ref: --uncompress\7f90888
116 Ref: --confirmation\7f91092
117 Ref: --delay-directory-restore\7f91160
118 Ref: --dereference\7f91361
119 Ref: --directory\7f91555
120 Ref: --exclude\7f91808
121 Ref: --exclude-backups\7f91927
122 Ref: --exclude-from\7f92017
123 Ref: --exclude-caches\7f92163
124 Ref: --exclude-caches-under\7f92371
125 Ref: --exclude-caches-all\7f92549
126 Ref: --exclude-tag\7f92678
127 Ref: --exclude-tag-under\7f92849
128 Ref: --exclude-tag-all\7f93039
129 Ref: --exclude-vcs\7f93168
130 Ref: --file\7f93334
131 Ref: --files-from\7f93534
132 Ref: --force-local\7f93737
133 Ref: --format\7f93928
134 Ref: --full-time\7f94598
135 Ref: --group\7f95278
136 Ref: --gzip\7f95574
137 Ref: --gunzip\7f95574
138 Ref: --ungzip\7f95574
139 Ref: --hard-dereference\7f95797
140 Ref: --help\7f95984
141 Ref: --ignore-case\7f96118
142 Ref: --ignore-command-error\7f96245
143 Ref: --ignore-failed-read\7f96356
144 Ref: --ignore-zeros\7f96497
145 Ref: --incremental\7f96642
146 Ref: --index-file\7f96907
147 Ref: --info-script\7f96992
148 Ref: --new-volume-script\7f96992
149 Ref: --interactive\7f97289
150 Ref: ----keep-directory-symlink\7f97501
151 Ref: --keep-newer-files\7f98049
152 Ref: --keep-old-files\7f98191
153 Ref: --label\7f98403
154 Ref: --level\7f98691
155 Ref: --listed-incremental\7f99134
156 Ref: --lzip\7f99498
157 Ref: --lzma\7f99598
158 Ref: --mode\7f99798
159 Ref: --mtime\7f100089
160 Ref: --multi-volume\7f100530
161 Ref: --newer\7f100734
162 Ref: --newer-mtime\7f101012
163 Ref: --no-anchored\7f101236
164 Ref: --no-auto-compress\7f101373
165 Ref: --no-check-device\7f101524
166 Ref: --no-delay-directory-restore\7f101707
167 Ref: --no-ignore-case\7f101960
168 Ref: --no-ignore-command-error\7f102053
169 Ref: --no-null\7f102208
170 Ref: --no-overwrite-dir\7f102413
171 Ref: --no-quote-chars\7f102556
172 Ref: --no-recursion\7f102737
173 Ref: --no-same-owner\7f102842
174 Ref: --no-same-permissions\7f103025
175 Ref: --no-seek\7f103227
176 Ref: --no-unquote\7f103445
177 Ref: --no-wildcards\7f103583
178 Ref: --no-wildcards-match-slash\7f103667
179 Ref: --null\7f103769
180 Ref: --numeric-owner\7f103997
181 Ref: --occurrence\7f104648
182 Ref: --old-archive\7f105215
183 Ref: --one-file-system\7f105264
184 Ref: --overwrite\7f105442
185 Ref: --overwrite-dir\7f105584
186 Ref: --owner\7f105729
187 Ref: --pax-option\7f106054
188 Ref: --portability\7f106361
189 Ref: --posix\7f106426
190 Ref: --preserve\7f106468
191 Ref: --preserve-order\7f106606
192 Ref: --preserve-permissions\7f106670
193 Ref: --same-permissions\7f106670
194 Ref: --quote-chars\7f107084
195 Ref: --quoting-style\7f107237
196 Ref: --read-full-records\7f107558
197 Ref: --record-size\7f107723
198 Ref: --recursion\7f108067
199 Ref: --recursive-unlink\7f108170
200 Ref: --remove-files\7f108337
201 Ref: --restrict\7f108483
202 Ref: --rmt-command\7f108671
203 Ref: --rsh-command\7f108812
204 Ref: --same-order\7f108934
205 Ref: --same-owner\7f109226
206 Ref: --seek\7f109603
207 Ref: --show-defaults\7f109972
208 Ref: --show-omitted-dirs\7f110480
209 Ref: --show-snapshot-field-ranges\7f110634
210 Ref: --show-transformed-names\7f110830
211 Ref: --show-stored-names\7f110830
212 Ref: --skip-old-files\7f111219
213 Ref: --sparse\7f111669
214 Ref: --sparse-version\7f111808
215 Ref: --starting-file\7f112032
216 Ref: --strip-components\7f112221
217 Ref: --suffix\7f112533
218 Ref: --tape-length\7f112652
219 Ref: --test-label\7f113067
220 Ref: --to-command\7f113219
221 Ref: --to-stdout\7f113378
222 Ref: --totals\7f113531
223 Ref: --touch\7f113762
224 Ref: --transform\7f113964
225 Ref: --xform\7f113964
226 Ref: --unlink-first\7f114575
227 Ref: --unquote\7f114743
228 Ref: --use-compress-program\7f114850
229 Ref: --utc\7f115028
230 Ref: --verbose\7f115121
231 Ref: --verify\7f115373
232 Ref: --version\7f115491
233 Ref: --volno-file\7f115663
234 Ref: --warning\7f115850
235 Ref: --wildcards\7f116027
236 Ref: --wildcards-match-slash\7f116147
237 Ref: --xz\7f116239
238 Ref: Option Summary-Footnote-1\7f116370
239 Node: Short Option Summary\7f116588
240 Node: help\7f118789
241 Ref: help-Footnote-1\7f122620
242 Node: defaults\7f122831
243 Node: verbose\7f123850
244 Ref: totals\7f126151
245 Ref: Progress information\7f127741
246 Ref: show-omitted-dirs\7f128720
247 Ref: block-number\7f129139
248 Ref: verbose-Footnote-1\7f130166
249 Node: checkpoints\7f130273
250 Ref: checkpoint exec\7f134148
251 Node: warnings\7f136174
252 Node: interactive\7f139573
253 Node: external\7f141672
254 Node: operations\7f143253
255 Node: Basic tar\7f143512
256 Ref: Basic tar-Footnote-1\7f146619
257 Node: Advanced tar\7f146763
258 Node: Operations\7f147608
259 Node: append\7f149507
260 Ref: append-Footnote-1\7f152602
261 Node: appending files\7f152789
262 Node: multiple\7f154527
263 Node: update\7f157249
264 Node: how to update\7f158225
265 Node: concatenate\7f160009
266 Ref: concatenate-Footnote-1\7f163257
267 Node: delete\7f163400
268 Node: compare\7f165173
269 Node: create options\7f166605
270 Node: override\7f167063
271 Node: Ignore Failed Read\7f171200
272 Node: extract options\7f171420
273 Node: Reading\7f172253
274 Node: read full records\7f173753
275 Node: Ignore Zeros\7f174089
276 Node: Writing\7f175080
277 Node: Dealing with Old Files\7f175637
278 Node: Overwrite Old Files\7f178440
279 Node: Keep Old Files\7f179897
280 Node: Keep Newer Files\7f180704
281 Node: Unlink First\7f180994
282 Node: Recursive Unlink\7f181398
283 Node: Data Modification Times\7f181951
284 Node: Setting Access Permissions\7f182761
285 Node: Directory Modification Times and Permissions\7f183393
286 Node: Writing to Standard Output\7f187005
287 Node: Writing to an External Program\7f188540
288 Node: remove files\7f192121
289 Node: Scarce\7f192314
290 Node: Starting File\7f192562
291 Node: Same Order\7f193363
292 Node: backup\7f194199
293 Node: Applications\7f197285
294 Node: looking ahead\7f198746
295 Node: Backups\7f199572
296 Node: Full Dumps\7f201153
297 Node: Incremental Dumps\7f202959
298 Ref: --level=0\7f205873
299 Ref: device numbers\7f206406
300 Ref: incremental-op\7f210384
301 Ref: Incremental Dumps-Footnote-1\7f210758
302 Ref: Incremental Dumps-Footnote-2\7f210908
303 Node: Backup Levels\7f211396
304 Node: Backup Parameters\7f213783
305 Node: General-Purpose Variables\7f214964
306 Ref: RSH\7f218125
307 Node: Magnetic Tape Control\7f220004
308 Node: User Hooks\7f221342
309 Node: backup-specs example\7f222671
310 Node: Scripted Backups\7f223814
311 Ref: Scripted Backups-Footnote-1\7f226677
312 Node: Scripted Restoration\7f227061
313 Node: Choosing\7f229672
314 Node: file\7f230794
315 Ref: remote-dev\7f233430
316 Ref: local and remote archives\7f233815
317 Node: Selecting Archive Members\7f234846
318 Ref: input name quoting\7f235527
319 Node: files\7f237513
320 Ref: files-Footnote-1\7f240009
321 Node: nul\7f240167
322 Node: exclude\7f242581
323 Node: problems with exclude\7f247757
324 Node: wildcards\7f249802
325 Node: controlling pattern-matching\7f252386
326 Ref: controlling pattern-matching-Footnote-1\7f256376
327 Node: quoting styles\7f256592
328 Ref: escape sequences\7f256938
329 Node: transform\7f263069
330 Ref: show-transformed-names\7f265060
331 Node: after\7f271251
332 Node: recurse\7f274853
333 Node: one\7f277577
334 Node: directory\7f279010
335 Node: absolute\7f282072
336 Ref: absolute-Footnote-1\7f285400
337 Node: Date input formats\7f285751
338 Node: General date syntax\7f288149
339 Node: Calendar date items\7f291132
340 Node: Time of day items\7f293129
341 Node: Time zone items\7f295325
342 Node: Combined date and time of day items\7f296577
343 Node: Day of week items\7f297429
344 Node: Relative items in date strings\7f298438
345 Node: Pure numbers in date strings\7f301240
346 Node: Seconds since the Epoch\7f302221
347 Node: Specifying time zone rules\7f303842
348 Node: Authors of parse_datetime\7f306214
349 Ref: Authors of get_date\7f306393
350 Node: Formats\7f307356
351 Node: Compression\7f312046
352 Node: gzip\7f312338
353 Ref: alternative decompression programs\7f314547
354 Ref: auto-compress\7f318319
355 Ref: use-compress-program\7f319050
356 Ref: gzip-Footnote-1\7f320973
357 Ref: gzip-Footnote-2\7f321022
358 Node: lbzip2\7f321162
359 Node: sparse\7f322259
360 Node: Attributes\7f325313
361 Node: Portability\7f331134
362 Node: Portable Names\7f332620
363 Node: dereference\7f333325
364 Node: hard links\7f334452
365 Ref: hard links-Footnote-1\7f337337
366 Node: old\7f337393
367 Node: ustar\7f338577
368 Node: gnu\7f339168
369 Node: posix\7f340045
370 Node: PAX keywords\7f340526
371 Node: Checksumming\7f346136
372 Node: Large or Negative Values\7f348062
373 Node: Other Tars\7f349662
374 Node: Split Recovery\7f350798
375 Node: Sparse Recovery\7f354530
376 Ref: extracting sparse v.0.x\7f358163
377 Ref: Sparse Recovery-Footnote-1\7f361452
378 Ref: Sparse Recovery-Footnote-2\7f361475
379 Node: cpio\7f361596
380 Node: Media\7f366353
381 Node: Device\7f368300
382 Ref: size-suffixes\7f373089
383 Node: Remote Tape Server\7f374209
384 Node: Common Problems and Solutions\7f377871
385 Node: Blocking\7f378263
386 Ref: Blocking-Footnote-1\7f384746
387 Node: Format Variations\7f384850
388 Node: Blocking Factor\7f385762
389 Node: Many\7f397414
390 Node: Tape Positioning\7f401208
391 Node: mt\7f403081
392 Node: Using Multiple Tapes\7f404636
393 Node: Multi-Volume Archives\7f406702
394 Ref: tape-length\7f408187
395 Ref: change volume prompt\7f408747
396 Ref: volno-file\7f409618
397 Ref: info-script\7f410170
398 Ref: Multi-Volume Archives-Footnote-1\7f415754
399 Ref: Multi-Volume Archives-Footnote-2\7f415864
400 Node: Tape Files\7f415932
401 Node: Tarcat\7f417414
402 Node: label\7f418459
403 Ref: --test-label option\7f420046
404 Ref: label-Footnote-1\7f423496
405 Ref: label-Footnote-2\7f423605
406 Ref: label-Footnote-3\7f423738
407 Node: verify\7f423973
408 Node: Write Protection\7f427273
409 Node: Reliability and security\7f428103
410 Node: Reliability\7f428491
411 Node: Permissions problems\7f429269
412 Node: Data corruption and repair\7f429708
413 Node: Race conditions\7f430634
414 Node: Security\7f432374
415 Node: Privacy\7f432977
416 Node: Integrity\7f434226
417 Node: Live untrusted data\7f436437
418 Node: Security rules of thumb\7f438777
419 Node: Changes\7f440306
420 Node: Configuring Help Summary\7f443923
421 Node: Fixing Snapshot Files\7f450424
422 Node: Tar Internals\7f453793
423 Node: Standard\7f454125
424 Node: Extensions\7f476326
425 Node: Sparse Formats\7f478886
426 Node: Old GNU Format\7f480176
427 Node: PAX 0\7f482577
428 Node: PAX 1\7f485708
429 Node: Snapshot Files\7f487446
430 Node: Dumpdir\7f493022
431 Node: Genfile\7f496268
432 Node: Generate Mode\7f497361
433 Node: Status Mode\7f501658
434 Node: Exec Mode\7f503456
435 Node: Free Software Needs Free Documentation\7f506201
436 Node: GNU Free Documentation License\7f511183
437 Node: Index of Command Line Options\7f536396
438 Node: Index\7f562252
439 \1f
440 End Tag Table