Import upstream version 1.27
[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, 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: 1146
34 tar.info-2: 298426
35 tar.info-3: 562228
36 \1f
37 Tag Table:
38 (Indirect)
39 Node: Top\7f1146
40 Node: Introduction\7f10453
41 Node: Book Contents\7f11240
42 Node: Definitions\7f13412
43 Node: What tar Does\7f15215
44 Node: Naming tar Archives\7f17981
45 Node: Authors\7f18701
46 Node: Reports\7f20514
47 Node: Tutorial\7f20871
48 Node: assumptions\7f21684
49 Node: stylistic conventions\7f24159
50 Node: basic tar options\7f24602
51 Node: frequent operations\7f28240
52 Node: Two Frequent Options\7f28892
53 Node: file tutorial\7f29523
54 Node: verbose tutorial\7f30880
55 Ref: verbose member listing\7f33094
56 Node: help tutorial\7f35854
57 Node: create\7f36208
58 Node: prepare for examples\7f37709
59 Node: Creating the archive\7f39478
60 Node: create verbose\7f42310
61 Node: short create\7f43130
62 Node: create dir\7f45883
63 Node: list\7f48591
64 Ref: listing member and file names\7f49870
65 Node: list dir\7f52184
66 Node: extract\7f53196
67 Node: extracting archives\7f54310
68 Node: extracting files\7f54815
69 Ref: extracting files-Footnote-1\7f57462
70 Node: extract dir\7f57842
71 Node: extracting untrusted archives\7f60235
72 Node: failing commands\7f61114
73 Node: going further\7f62208
74 Node: tar invocation\7f62421
75 Node: Synopsis\7f64201
76 Ref: exit status\7f67522
77 Node: using tar options\7f69156
78 Ref: TAR_OPTIONS\7f70733
79 Node: Styles\7f71750
80 Ref: Styles-Footnote-1\7f73249
81 Node: Long Options\7f73505
82 Node: Short Options\7f75677
83 Ref: Short Options-Footnote-1\7f77485
84 Node: Old Options\7f77702
85 Node: Mixing\7f80465
86 Ref: Mixing-Footnote-1\7f82831
87 Node: All Options\7f82951
88 Node: Operation Summary\7f83556
89 Ref: --append\7f83676
90 Ref: --catenate\7f83756
91 Ref: --compare\7f83827
92 Ref: --concatenate\7f84030
93 Ref: --create\7f84140
94 Ref: --delete\7f84208
95 Ref: --diff\7f84322
96 Ref: --extract\7f84378
97 Ref: --get\7f84480
98 Ref: --list\7f84538
99 Ref: --update\7f84606
100 Node: Option Summary\7f84816
101 Ref: --absolute-names\7f84971
102 Ref: --after-date\7f85261
103 Ref: --anchored\7f85313
104 Ref: --atime-preserve\7f85446
105 Ref: --auto-compress\7f87966
106 Ref: --backup\7f88193
107 Ref: --block-number\7f88384
108 Ref: --blocking-factor\7f88558
109 Ref: --bzip2\7f88710
110 Ref: --check-device\7f88817
111 Ref: --checkpoint\7f89012
112 Ref: --checkpoint-action\7f89454
113 Ref: --check-links\7f90605
114 Ref: --compress\7f90882
115 Ref: --uncompress\7f90882
116 Ref: --confirmation\7f91086
117 Ref: --delay-directory-restore\7f91154
118 Ref: --dereference\7f91355
119 Ref: --directory\7f91549
120 Ref: --exclude\7f91802
121 Ref: --exclude-backups\7f91921
122 Ref: --exclude-from\7f92011
123 Ref: --exclude-caches\7f92157
124 Ref: --exclude-caches-under\7f92365
125 Ref: --exclude-caches-all\7f92543
126 Ref: --exclude-tag\7f92672
127 Ref: --exclude-tag-under\7f92843
128 Ref: --exclude-tag-all\7f93033
129 Ref: --exclude-vcs\7f93162
130 Ref: --file\7f93328
131 Ref: --files-from\7f93528
132 Ref: --force-local\7f93731
133 Ref: --format\7f93922
134 Ref: --full-time\7f94592
135 Ref: --group\7f95272
136 Ref: --gzip\7f95568
137 Ref: --gunzip\7f95568
138 Ref: --ungzip\7f95568
139 Ref: --hard-dereference\7f95791
140 Ref: --help\7f95978
141 Ref: --ignore-case\7f96112
142 Ref: --ignore-command-error\7f96239
143 Ref: --ignore-failed-read\7f96350
144 Ref: --ignore-zeros\7f96491
145 Ref: --incremental\7f96636
146 Ref: --index-file\7f96901
147 Ref: --info-script\7f96986
148 Ref: --new-volume-script\7f96986
149 Ref: --interactive\7f97283
150 Ref: ----keep-directory-symlink\7f97495
151 Ref: --keep-newer-files\7f98043
152 Ref: --keep-old-files\7f98185
153 Ref: --label\7f98397
154 Ref: --level\7f98685
155 Ref: --listed-incremental\7f99126
156 Ref: --lzip\7f99490
157 Ref: --lzma\7f99590
158 Ref: --mode\7f99790
159 Ref: --mtime\7f100081
160 Ref: --multi-volume\7f100522
161 Ref: --newer\7f100726
162 Ref: --newer-mtime\7f101004
163 Ref: --no-anchored\7f101228
164 Ref: --no-auto-compress\7f101365
165 Ref: --no-check-device\7f101516
166 Ref: --no-delay-directory-restore\7f101699
167 Ref: --no-ignore-case\7f101952
168 Ref: --no-ignore-command-error\7f102045
169 Ref: --no-null\7f102200
170 Ref: --no-overwrite-dir\7f102405
171 Ref: --no-quote-chars\7f102548
172 Ref: --no-recursion\7f102729
173 Ref: --no-same-owner\7f102834
174 Ref: --no-same-permissions\7f103017
175 Ref: --no-seek\7f103219
176 Ref: --no-unquote\7f103437
177 Ref: --no-wildcards\7f103575
178 Ref: --no-wildcards-match-slash\7f103659
179 Ref: --null\7f103761
180 Ref: --numeric-owner\7f103989
181 Ref: --occurrence\7f104640
182 Ref: --old-archive\7f105207
183 Ref: --one-file-system\7f105256
184 Ref: --overwrite\7f105434
185 Ref: --overwrite-dir\7f105576
186 Ref: --owner\7f105721
187 Ref: --pax-option\7f106046
188 Ref: --portability\7f106353
189 Ref: --posix\7f106418
190 Ref: --preserve\7f106460
191 Ref: --preserve-order\7f106598
192 Ref: --preserve-permissions\7f106662
193 Ref: --same-permissions\7f106662
194 Ref: --quote-chars\7f107076
195 Ref: --quoting-style\7f107229
196 Ref: --read-full-records\7f107550
197 Ref: --record-size\7f107715
198 Ref: --recursion\7f108059
199 Ref: --recursive-unlink\7f108162
200 Ref: --remove-files\7f108329
201 Ref: --restrict\7f108475
202 Ref: --rmt-command\7f108663
203 Ref: --rsh-command\7f108804
204 Ref: --same-order\7f108926
205 Ref: --same-owner\7f109218
206 Ref: --seek\7f109595
207 Ref: --show-defaults\7f109964
208 Ref: --show-omitted-dirs\7f110472
209 Ref: --show-snapshot-field-ranges\7f110626
210 Ref: --show-transformed-names\7f110822
211 Ref: --show-stored-names\7f110822
212 Ref: --skip-old-files\7f111211
213 Ref: --sparse\7f111661
214 Ref: --sparse-version\7f111800
215 Ref: --starting-file\7f112024
216 Ref: --strip-components\7f112213
217 Ref: --suffix\7f112525
218 Ref: --tape-length\7f112644
219 Ref: --test-label\7f113059
220 Ref: --to-command\7f113211
221 Ref: --to-stdout\7f113370
222 Ref: --totals\7f113523
223 Ref: --touch\7f113754
224 Ref: --transform\7f113956
225 Ref: --xform\7f113956
226 Ref: --unlink-first\7f114567
227 Ref: --unquote\7f114735
228 Ref: --use-compress-program\7f114842
229 Ref: --utc\7f115020
230 Ref: --verbose\7f115113
231 Ref: --verify\7f115365
232 Ref: --version\7f115483
233 Ref: --volno-file\7f115655
234 Ref: --warning\7f115842
235 Ref: --wildcards\7f116019
236 Ref: --wildcards-match-slash\7f116139
237 Ref: --xz\7f116231
238 Ref: Option Summary-Footnote-1\7f116362
239 Node: Short Option Summary\7f116580
240 Node: help\7f118781
241 Ref: help-Footnote-1\7f122610
242 Node: defaults\7f122821
243 Node: verbose\7f123840
244 Ref: totals\7f126141
245 Ref: Progress information\7f127731
246 Ref: show-omitted-dirs\7f128710
247 Ref: block-number\7f129129
248 Ref: verbose-Footnote-1\7f130156
249 Node: checkpoints\7f130263
250 Ref: checkpoint exec\7f134138
251 Node: warnings\7f136164
252 Node: interactive\7f139563
253 Node: external\7f141662
254 Node: operations\7f143243
255 Node: Basic tar\7f143502
256 Ref: Basic tar-Footnote-1\7f146609
257 Node: Advanced tar\7f146753
258 Node: Operations\7f147598
259 Node: append\7f149497
260 Ref: append-Footnote-1\7f152592
261 Node: appending files\7f152779
262 Node: multiple\7f154517
263 Node: update\7f157239
264 Node: how to update\7f158215
265 Node: concatenate\7f159999
266 Ref: concatenate-Footnote-1\7f163247
267 Node: delete\7f163390
268 Node: compare\7f165163
269 Node: create options\7f166595
270 Node: override\7f167053
271 Node: Ignore Failed Read\7f171190
272 Node: extract options\7f171410
273 Node: Reading\7f172243
274 Node: read full records\7f173743
275 Node: Ignore Zeros\7f174079
276 Node: Writing\7f175070
277 Node: Dealing with Old Files\7f175627
278 Node: Overwrite Old Files\7f178430
279 Node: Keep Old Files\7f179887
280 Node: Keep Newer Files\7f180694
281 Node: Unlink First\7f180984
282 Node: Recursive Unlink\7f181388
283 Node: Data Modification Times\7f181941
284 Node: Setting Access Permissions\7f182751
285 Node: Directory Modification Times and Permissions\7f183383
286 Node: Writing to Standard Output\7f186995
287 Node: Writing to an External Program\7f188530
288 Node: remove files\7f192111
289 Node: Scarce\7f192304
290 Node: Starting File\7f192552
291 Node: Same Order\7f193353
292 Node: backup\7f194189
293 Node: Applications\7f197275
294 Node: looking ahead\7f198736
295 Node: Backups\7f199562
296 Node: Full Dumps\7f201143
297 Node: Incremental Dumps\7f202949
298 Ref: --level=0\7f205863
299 Ref: device numbers\7f206396
300 Ref: incremental-op\7f210374
301 Ref: Incremental Dumps-Footnote-1\7f210748
302 Ref: Incremental Dumps-Footnote-2\7f210898
303 Node: Backup Levels\7f211386
304 Node: Backup Parameters\7f213773
305 Node: General-Purpose Variables\7f214954
306 Ref: RSH\7f218115
307 Node: Magnetic Tape Control\7f219994
308 Node: User Hooks\7f221332
309 Node: backup-specs example\7f222661
310 Node: Scripted Backups\7f223804
311 Ref: Scripted Backups-Footnote-1\7f226667
312 Node: Scripted Restoration\7f227051
313 Node: Choosing\7f229662
314 Node: file\7f230784
315 Ref: remote-dev\7f233420
316 Ref: local and remote archives\7f233805
317 Node: Selecting Archive Members\7f234836
318 Ref: input name quoting\7f235517
319 Node: files\7f237503
320 Ref: files-Footnote-1\7f239999
321 Node: nul\7f240157
322 Node: exclude\7f242571
323 Node: problems with exclude\7f247745
324 Node: wildcards\7f249790
325 Node: controlling pattern-matching\7f252374
326 Ref: controlling pattern-matching-Footnote-1\7f256364
327 Node: quoting styles\7f256580
328 Ref: escape sequences\7f256926
329 Node: transform\7f263057
330 Ref: show-transformed-names\7f265048
331 Node: after\7f271239
332 Node: recurse\7f274841
333 Node: one\7f277565
334 Node: directory\7f278998
335 Node: absolute\7f282060
336 Ref: absolute-Footnote-1\7f285388
337 Node: Date input formats\7f285739
338 Node: General date syntax\7f288137
339 Node: Calendar date items\7f291120
340 Node: Time of day items\7f293117
341 Node: Time zone items\7f295313
342 Node: Combined date and time of day items\7f296565
343 Node: Day of week items\7f297417
344 Node: Relative items in date strings\7f298426
345 Node: Pure numbers in date strings\7f301228
346 Node: Seconds since the Epoch\7f302209
347 Node: Specifying time zone rules\7f303830
348 Node: Authors of parse_datetime\7f306202
349 Ref: Authors of get_date\7f306381
350 Node: Formats\7f307344
351 Node: Compression\7f312032
352 Node: gzip\7f312324
353 Ref: alternative decompression programs\7f314533
354 Ref: auto-compress\7f318303
355 Ref: use-compress-program\7f319034
356 Ref: gzip-Footnote-1\7f320957
357 Ref: gzip-Footnote-2\7f321006
358 Node: lbzip2\7f321146
359 Node: sparse\7f322243
360 Node: Attributes\7f325297
361 Node: Portability\7f331118
362 Node: Portable Names\7f332604
363 Node: dereference\7f333309
364 Node: hard links\7f334436
365 Ref: hard links-Footnote-1\7f337321
366 Node: old\7f337377
367 Node: ustar\7f338561
368 Node: gnu\7f339152
369 Node: posix\7f340029
370 Node: PAX keywords\7f340510
371 Node: Checksumming\7f346120
372 Node: Large or Negative Values\7f348046
373 Node: Other Tars\7f349646
374 Node: Split Recovery\7f350782
375 Node: Sparse Recovery\7f354514
376 Ref: extracting sparse v.0.x\7f358147
377 Ref: Sparse Recovery-Footnote-1\7f361436
378 Ref: Sparse Recovery-Footnote-2\7f361459
379 Node: cpio\7f361580
380 Node: Media\7f366337
381 Node: Device\7f368284
382 Ref: size-suffixes\7f373073
383 Node: Remote Tape Server\7f374193
384 Node: Common Problems and Solutions\7f377855
385 Node: Blocking\7f378247
386 Ref: Blocking-Footnote-1\7f384730
387 Node: Format Variations\7f384834
388 Node: Blocking Factor\7f385746
389 Node: Many\7f397398
390 Node: Tape Positioning\7f401192
391 Node: mt\7f403065
392 Node: Using Multiple Tapes\7f404620
393 Node: Multi-Volume Archives\7f406686
394 Ref: tape-length\7f408171
395 Ref: change volume prompt\7f408731
396 Ref: volno-file\7f409602
397 Ref: info-script\7f410154
398 Ref: Multi-Volume Archives-Footnote-1\7f415738
399 Ref: Multi-Volume Archives-Footnote-2\7f415848
400 Node: Tape Files\7f415916
401 Node: Tarcat\7f417398
402 Node: label\7f418443
403 Ref: --test-label option\7f420030
404 Ref: label-Footnote-1\7f423480
405 Ref: label-Footnote-2\7f423589
406 Ref: label-Footnote-3\7f423722
407 Node: verify\7f423957
408 Node: Write Protection\7f427257
409 Node: Reliability and security\7f428087
410 Node: Reliability\7f428475
411 Node: Permissions problems\7f429253
412 Node: Data corruption and repair\7f429692
413 Node: Race conditions\7f430618
414 Node: Security\7f432358
415 Node: Privacy\7f432961
416 Node: Integrity\7f434210
417 Node: Live untrusted data\7f436421
418 Node: Security rules of thumb\7f438761
419 Node: Changes\7f440290
420 Node: Configuring Help Summary\7f443905
421 Node: Fixing Snapshot Files\7f450406
422 Node: Tar Internals\7f453775
423 Node: Standard\7f454107
424 Node: Extensions\7f476308
425 Node: Sparse Formats\7f478868
426 Node: Old GNU Format\7f480158
427 Node: PAX 0\7f482559
428 Node: PAX 1\7f485690
429 Node: Snapshot Files\7f487428
430 Node: Dumpdir\7f492998
431 Node: Genfile\7f496244
432 Node: Generate Mode\7f497337
433 Node: Status Mode\7f501634
434 Node: Exec Mode\7f503432
435 Node: Free Software Needs Free Documentation\7f506177
436 Node: GNU Free Documentation License\7f511159
437 Node: Index of Command Line Options\7f536372
438 Node: Index\7f562228
439 \1f
440 End Tag Table