2
%%Creator: groff version 1.19.2
3
%%CreationDate: Wed Jun 30 11:55:53 2010
4
%%DocumentNeededResources: font Times-Roman
5
%%DocumentSuppliedResources: procset grops 1.19 2
8
%%DocumentMedia: Default 612 792 0 () ()
9
%%Orientation: Portrait
15
%%BeginResource: procset grops 1.19 2
16
%!PS-Adobe-3.0 Resource-ProcSet
22
/grops 120 dict dup begin
25
/B{0 SC 3 -1 roll widthshow}bind def
26
/C{0 exch ashow}bind def
27
/D{0 exch 0 SC 5 2 roll awidthshow}bind def
28
/E{0 rmoveto show}bind def
29
/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
30
/G{0 rmoveto 0 exch ashow}bind def
31
/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
32
/I{0 exch rmoveto show}bind def
33
/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
34
/K{0 exch rmoveto 0 exch ashow}bind def
35
/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
36
/M{rmoveto show}bind def
37
/N{rmoveto 0 SC 3 -1 roll widthshow}bind def
38
/O{rmoveto 0 exch ashow}bind def
39
/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
40
/Q{moveto show}bind def
41
/R{moveto 0 SC 3 -1 roll widthshow}bind def
42
/S{moveto 0 exch ashow}bind def
43
/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
46
[exch dup 0 exch 0 exch neg 0 0]makefont
48
[exch/setfont cvx]cvx bind def
56
[exch/setfont cvx]cvx bind def
63
statusdict begin/manualfeed true store end
66
gsave newpath clippath pathbbox grestore
90
.25 sub exch .25 sub exch
91
round .25 add exch round .25 add exch
101
newpath 0 360 arc closepath
106
translate scale newpath 0 0 .5 0 360 arc closepath
109
/RC/rcurveto load def
113
/CL/closepath load def
127
/LW/setlinewidth load def
128
/Cr/setrgbcolor load def
131
/Ck/setcmykcolor load def
136
dup maxlength 1 index/FontName known not{1 add}if dict begin
138
1 index/FID ne{def}{pop pop}ifelse
141
dup/FontName exch def
142
currentdict end definefont pop
155
div 3 1 roll div exch scale
156
neg exch neg exch translate
163
/setstrokeadjust where{
165
false setstrokeadjust
172
/CNT countdictstack def
178
countdictstack CNT sub{end}repeat
189
%%BeginFeature: *PageSize Default
190
<< /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice
192
%%IncludeResource: font Times-Roman
193
grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
194
def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron
195
/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef
196
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
197
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
198
/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
199
/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
200
/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
201
/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
202
/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex
203
/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y
204
/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft
205
/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl
206
/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
207
/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
208
/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen
209
/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft
210
/logicalnot/minus/registered/macron/degree/plusminus/twosuperior
211
/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior
212
/ordmasculine/guilsinglright/onequarter/onehalf/threequarters
213
/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE
214
/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex
215
/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
216
/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn
217
/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla
218
/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis
219
/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash
220
/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def
221
/Times-Roman@0 ENC0/Times-Roman RE
227
/F0 10/Times-Roman@0 SF(<html>)0 12 Q(<head>)0 24 Q(<title>)36 36 Q
228
(December 27, 2009 tar 5)74.5 48 Q(</title>)36 72 Q 0 Cg EP
233
/F0 10/Times-Roman@0 SF(<style type="te)36 12 Q(xt/css">)-.15 E(<!--)36
234
24 Q(body { mar)72 36 Q(gin-left:4%; })-.18 E(H1, H2, H3, H4, H5 {)72 48
235
Q(color: maroon; padding: 4pt; mar)108 60 Q(gin-left: -4%;)-.18 E
236
(border: solid; border)108 72 Q(-width: thin; width: 100%;)-.2 E 0 Cg EP
241
/F0 10/Times-Roman@0 SF(background: r)108 12 Q(gb\(204,204,255\))-.18 E
242
(})72 24 Q(-->)36 36 Q(</style>)36 48 Q(</head>)0 60 Q
243
(<body bgcolor="#FFFFFF" te)0 72 Q(xt="#000000">)-.15 E 0 Cg EP
248
/F0 10/Times-Roman@0 SF(<h3 id="N)36 12 Q(AME">)-.35 E -.35(NA)36 24 S
249
(ME).35 E(</h3>)36 36 Q(<b>tar</b>)0 48 Q 2.5(-f)0 60 S
250
(ormat of tape archi)-2.5 E .3 -.15(ve \214)-.25 H(les).15 E
251
(<h3 id="DESCRIPTION">)36 72 Q 0 Cg EP
256
/F0 10/Times-Roman@0 SF(DESCRIPTION)36 12 Q(</h3>)36 24 Q(The)0 36 Q
257
(<b>tar</b>)0 48 Q(archi)0 60 Q .3 -.15(ve f)-.25 H(ormat collects an)
258
.15 E 2.5(yn)-.15 G(umber of \214les, directories, and other)-2.5 E
259
(\214le system objects \(symbolic links, de)0 72 Q
260
(vice nodes, etc.\) into a single)-.25 E 0 Cg EP
265
/F0 10/Times-Roman@0 SF(stream of bytes.)0 12 Q(The format w)0 24 Q
266
(as originally designed to be used with)-.1 E(tape dri)0 36 Q -.15(ve)
267
-.25 G 2.5(st).15 G(hat operate with \214x)-2.5 E(ed-size blocks, b)-.15
268
E(ut is widely used as)-.2 E 2.5(ag)0 48 S(eneral packaging mechanism.)
269
-2.5 E(<h4 id="General F)36 60 Q(ormat">)-.15 E(General F)36 72 Q(ormat)
275
/F0 10/Times-Roman@0 SF(</h4>)36 12 Q(A)0 24 Q(<b>tar</b>)0 36 Q(archi)0
276
48 Q .3 -.15(ve c)-.25 H(onsists of a series of 512-byte records.).15 E
277
(Each \214le system object requires a header record which stores basic \
278
metadata)0 60 Q(\(pathname, o)0 72 Q(wner)-.25 E 2.5(,p)-.4 G
279
(ermissions, etc.\) and zero or more records containing an)-2.5 E(y)-.15
285
/F0 10/Times-Roman@0 SF(\214le data.)0 12 Q(The end of the archi)0 24 Q
286
.3 -.15(ve i)-.25 H 2.5(si).15 G(ndicated by tw)-2.5 E 2.5(or)-.1 G
287
(ecords consisting)-2.5 E(entirely of zero bytes.)0 36 Q(<p>)36 48 Q
288
-.15(Fo)0 60 S 2.5(rc).15 G(ompatibility with tape dri)-2.5 E -.15(ve)
289
-.25 G 2.5(st).15 G(hat use \214x)-2.5 E(ed block sizes,)-.15 E
290
(programs that read or write tar \214les al)0 72 Q -.1(wa)-.1 G
291
(ys read or write a \214x).1 E(ed)-.15 E 0 Cg EP
296
/F0 10/Times-Roman@0 SF(number of records with each I/O operation.)0 12
297
Q(These)0 24 Q -.74(``)0 36 S(blocks').74 E(')-.74 E(are al)0 48 Q -.1
298
(wa)-.1 G(ys a multiple of the record size.).1 E
299
(The maximum block size supported by early)0 60 Q(implementations w)0 72
300
Q(as 10240 bytes or 20 records.)-.1 E 0 Cg EP
305
/F0 10/Times-Roman@0 SF(This is still the def)0 12 Q
306
(ault for most implementations)-.1 E
307
(although block sizes of 1MiB \(2048 records\) or lar)0 24 Q(ger are)
308
-.18 E(commonly used with modern high-speed tape dri)0 36 Q -.15(ve)-.25
309
G(s.).15 E(\(Note: the terms)0 48 Q -.74(``)0 60 S(block').74 E(')-.74 E
315
/F0 10/Times-Roman@0 SF -.74(``)0 12 S(record').74 E(')-.74 E
316
(here are not entirely standard; this document follo)0 24 Q(ws the)-.25
317
E(con)0 36 Q -.15(ve)-.4 G
318
(ntion established by John Gilmore in documenting).15 E(<b>pdtar</b>.\))
319
0 48 Q(<h4 id="Old-Style Archi)36 60 Q .3 -.15(ve Fo)-.25 H(rmat">).15 E
320
(Old-Style Archi)36 72 Q .3 -.15(ve Fo)-.25 H(rmat).15 E 0 Cg EP
325
/F0 10/Times-Roman@0 SF(</h4>)36 12 Q(The original tar archi)0 24 Q .3
326
-.15(ve f)-.25 H(ormat has been e).15 E(xtended man)-.15 E 2.5(yt)-.15 G
327
(imes to)-2.5 E(include additional information that v)0 36 Q
328
(arious implementors found)-.25 E(necessary)0 48 Q(.)-.65 E
329
(This section describes the v)0 60 Q
330
(ariant implemented by the tar command)-.25 E(included in)0 72 Q 0 Cg EP
335
/F0 10/Times-Roman@0 SF -1.11(Ve)0 12 S(rsion 7 <code>A)1.11 E
336
(T&T UNIX</code>,)-1.11 E(which seems to be the earliest widely-used v)0
337
24 Q(ersion of the tar program.)-.15 E(<p>)36 36 Q
338
(The header record for an old-style)0 48 Q(<b>tar</b>)0 60 Q(archi)0 72
339
Q .3 -.15(ve c)-.25 H(onsists of the follo).15 E(wing:)-.25 E 0 Cg EP
344
/F0 10/Times-Roman@0 SF(<dl compact><dt><dd>)0 12 Q(<code>)0 24 Q(<pre>)
345
0 36 Q(struct header_old_tar {)0 48 Q(char name[100];)36 60 Q
346
(char mode[8];)36 72 Q 0 Cg EP
351
/F0 10/Times-Roman@0 SF(char uid[8];)36 12 Q(char gid[8];)36 24 Q
352
(char size[12];)36 36 Q(char mtime[12];)36 48 Q(char checksum[8];)36 60
353
Q(char link\215ag[1];)36 72 Q 0 Cg EP
358
/F0 10/Times-Roman@0 SF(char linkname[100];)36 12 Q(char pad[255];)36 24
359
Q(};)0 36 Q(</pre>)0 48 Q(</code>)0 60 Q(</dl>)0 72 Q 0 Cg EP
364
/F0 10/Times-Roman@0 SF
365
(All unused bytes in the header record are \214lled with nulls.)0 12 Q
366
(<dl compact>)0 24 Q(<p><dt><i></i><i>name</i><dd>)0 36 Q -.15(Pa)0 48 S
367
(thname, stored as a null-terminated string.).15 E
368
(Early tar implementations only stored re)0 60 Q
369
(gular \214les \(including)-.15 E(hardlinks to those \214les\).)0 72 Q 0
375
/F0 10/Times-Roman@0 SF(One common early con)0 12 Q -.15(ve)-.4 G
376
(ntion used a trailing "/" character to indicate).15 E 2.5(ad)0 24 S
377
(irectory name, allo)-2.5 E(wing directory permissions and o)-.25 E
378
(wner information)-.25 E(to be archi)0 36 Q -.15(ve)-.25 G 2.5(da).15 G
379
(nd restored.)-2.5 E(<p><dt><i></i><i>mode</i><dd>)0 48 Q
380
(File mode, stored as an octal number in ASCII.)0 60 Q
381
(<p><dt><i></i><i>uid</i><i></i>,<i> gid</i><dd>)0 72 Q 0 Cg EP
386
/F0 10/Times-Roman@0 SF(User id and group id of o)0 12 Q(wner)-.25 E 2.5
387
(,a)-.4 G 2.5(so)-2.5 G(ctal numbers in ASCII.)-2.5 E
388
(<p><dt><i></i><i>size</i><dd>)0 24 Q
389
(Size of \214le, as octal number in ASCII.)0 36 Q -.15(Fo)0 48 S 2.5(rr)
390
.15 G -.15(eg)-2.5 G(ular \214les only).15 E 2.5(,t)-.65 G
391
(his indicates the amount of data)-2.5 E(that follo)0 60 Q
392
(ws the header)-.25 E(.)-.55 E(In particular)0 72 Q 2.5(,t)-.4 G
393
(his \214eld w)-2.5 E(as ignored by early tar implementations)-.1 E 0 Cg
399
/F0 10/Times-Roman@0 SF(when e)0 12 Q(xtracting hardlinks.)-.15 E
400
(Modern writers should al)0 24 Q -.1(wa)-.1 G
401
(ys store a zero length for hardlink entries.).1 E
402
(<p><dt><i></i><i>mtime</i><dd>)0 36 Q
403
(Modi\214cation time of \214le, as an octal number in ASCII.)0 48 Q
404
(This indicates the number of seconds since the start of the epoch,)0 60
405
Q(00:00:00 UTC January 1, 1970.)0 72 Q 0 Cg EP
410
/F0 10/Times-Roman@0 SF(Note that ne)0 12 Q -.05(ga)-.15 G(ti).05 E .3
411
-.15(ve v)-.25 H(alues should be a)-.1 E -.2(vo)-.2 G(ided).2 E
412
(here, as the)0 24 Q 2.5(ya)-.15 G(re handled inconsistently)-2.5 E(.)
413
-.65 E(<p><dt><i></i><i>checksum</i><dd>)0 36 Q
414
(Header checksum, stored as an octal number in ASCII.)0 48 Q 1.6 -.8
416
(ompute the checksum, set the checksum \214eld to all spaces,).8 E
417
(then sum all bytes in the header using unsigned arithmetic.)0 72 Q 0 Cg
423
/F0 10/Times-Roman@0 SF
424
(This \214eld should be stored as six octal digits follo)0 12 Q
425
(wed by a null and a space)-.25 E(character)0 24 Q(.)-.55 E
426
(Note that man)0 36 Q 2.5(ye)-.15 G
427
(arly implementations of tar used signed arithmetic)-2.5 E
428
(for the checksum \214eld, which can cause interoperability problems)0
429
48 Q(when transferring archi)0 60 Q -.15(ve)-.25 G 2.5(sb).15 G
430
(etween systems.)-2.5 E(Modern rob)0 72 Q
431
(ust readers compute the checksum both w)-.2 E(ays and accept the)-.1 E
437
/F0 10/Times-Roman@0 SF(header if either computation matches.)0 12 Q
438
(<p><dt><i></i><i>link\215ag</i><i></i>,<i> linkname</i><dd>)0 24 Q
439
(In order to preserv)0 36 Q 2.5(eh)-.15 G(ardlinks and conserv)-2.5 E
440
2.5(et)-.15 G(ape, a \214le)-2.5 E
441
(with multiple links is only written to the archi)0 48 Q .3 -.15(ve t)
442
-.25 H(he \214rst).15 E(time it is encountered.)0 60 Q(The ne)0 72 Q
443
(xt time it is encountered, the)-.15 E 0 Cg EP
448
/F0 10/Times-Roman@0 SF(<i></i><i>link\215ag</i>)0 12 Q
449
(is set to an ASCII)0 24 Q(`1')0 36 Q(and the)0 48 Q
450
(<i></i><i>linkname</i>)0 60 Q
451
(\214eld holds the \214rst name under which this \214le appears.)0 72 Q
457
/F0 10/Times-Roman@0 SF(\(Note that re)0 12 Q(gular \214les ha)-.15 E .3
458
-.15(ve a n)-.2 H(ull v).15 E(alue in the)-.25 E
459
(<i></i><i>link\215ag</i>)0 24 Q(\214eld.\))0 36 Q(</dl>)0 48 Q(<p>)36
460
60 Q(Early tar implementations v)0 72 Q(aried in ho)-.25 E 2.5(wt)-.25 G
461
(he)-2.5 E 2.5(yt)-.15 G(erminated these \214elds.)-2.5 E 0 Cg EP
466
/F0 10/Times-Roman@0 SF(The tar command in)0 12 Q -1.11(Ve)0 24 S
467
(rsion 7 <code>A)1.11 E(T&T UNIX</code>)-1.11 E(used the follo)0 36 Q
468
(wing con)-.25 E -.15(ve)-.4 G
469
(ntions \(this is also documented in early BSD manpages\):).15 E
470
(the pathname must be null-terminated;)0 48 Q
471
(the mode, uid, and gid \214elds must end in a space and a null byte;)0
472
60 Q(the size and mtime \214elds must end in a space;)0 72 Q 0 Cg EP
477
/F0 10/Times-Roman@0 SF
478
(the checksum is terminated by a null and a space.)0 12 Q(Early impleme\
479
ntations \214lled the numeric \214elds with leading spaces.)0 24 Q
480
(This seems to ha)0 36 Q .3 -.15(ve b)-.2 H
481
(een common practice until the).15 E(IEEE Std 1003.1-1988 \(`)2.5 48 Q
482
(`<font size="-1">POSIX</font>.1')-.74 E('\))-.74 E(standard w)0 60 Q
483
(as released.)-.1 E -.15(Fo)0 72 S 2.5(rb).15 G(est portability)-2.5 E
484
2.5(,m)-.65 G(odern implementations should \214ll the numeric)-2.5 E 0
490
/F0 10/Times-Roman@0 SF(\214elds with leading zeros.)0 12 Q
491
(<h4 id="Pre-POSIX Archi)36 24 Q -.15(ve)-.25 G(s">).15 E
492
(Pre-POSIX Archi)36 36 Q -.15(ve)-.25 G(s).15 E(</h4>)36 48 Q
493
(An early draft of)0 60 Q(IEEE Std 1003.1-1988 \(`)2.5 72 Q
494
(`<font size="-1">POSIX</font>.1')-.74 E('\))-.74 E 0 Cg EP
499
/F0 10/Times-Roman@0 SF(serv)0 12 Q(ed as the basis for John Gilmore')
500
-.15 E(s)-.55 E(<b>pdtar</b>)0 24 Q(program and man)0 36 Q 2.5(ys)-.15 G
501
(ystem implementations from the late 1980s)-2.5 E(and early 1990s.)0 48
502
Q(These archi)0 60 Q -.15(ve)-.25 G 2.5(sg).15 G(enerally follo)-2.5 E
503
2.5(wt)-.25 G(he POSIX ustar)-2.5 E(format described belo)0 72 Q 2.5(ww)
504
-.25 G(ith the follo)-2.5 E(wing v)-.25 E(ariations:)-.25 E 0 Cg EP
509
/F0 10/Times-Roman@0 SF(<ul>)0 12 Q(<li>)0 24 Q(The magic v)0 36 Q
510
(alue is)-.25 E -.74(``)0 48 S(ustar ').74 E(')-.74 E(\(note the follo)0
511
60 Q(wing space\).)-.25 E(The v)0 72 Q
512
(ersion \214eld contains a space character follo)-.15 E(wed by a null.)
518
/F0 10/Times-Roman@0 SF(<li>)0 12 Q
519
(The numeric \214elds are generally \214lled with leading spaces)0 24 Q
520
(\(not leading zeros as recommended in the \214nal standard\).)0 36 Q
522
(The pre\214x \214eld is often not used, limiting pathnames to)0 60 Q
523
(the 100 characters of old-style archi)0 72 Q -.15(ve)-.25 G(s.).15 E 0
529
/F0 10/Times-Roman@0 SF(</ul>)0 12 Q(<h4 id="POSIX ustar Archi)36 24 Q
530
-.15(ve)-.25 G(s">).15 E(POSIX ustar Archi)36 36 Q -.15(ve)-.25 G(s).15
531
E(</h4>)36 48 Q(IEEE Std 1003.1-1988 \(`)2.5 60 Q
532
(`<font size="-1">POSIX</font>.1')-.74 E('\))-.74 E
533
(de\214ned a standard tar \214le format to be read and written)0 72 Q 0
539
/F0 10/Times-Roman@0 SF(by compliant implementations of)0 12 Q
540
(<a href="../html1/tar)0 24 Q(.html">tar\(1\)</a>.)-.55 E
541
(This format is often called the)0 36 Q -.74(``)0 48 S(ustar').74 E(')
542
-.74 E(format, after the magic v)0 60 Q(alue used)-.25 E(in the header)0
543
72 Q(.)-.55 E 0 Cg EP
548
/F0 10/Times-Roman@0 SF(\(The name is an acron)0 12 Q(ym for)-.15 E -.74
549
(``)0 24 S(Unix Standard T).74 E(AR')-.93 E('.\))-.74 E(It e)0 36 Q
550
(xtends the historic format with ne)-.15 E 2.5<778c>-.25 G(elds:)-2.5 E
551
(<dl compact><dt><dd>)0 48 Q(<code>)0 60 Q(<pre>)0 72 Q 0 Cg EP
556
/F0 10/Times-Roman@0 SF(struct header_posix_ustar {)0 12 Q
557
(char name[100];)36 24 Q(char mode[8];)36 36 Q(char uid[8];)36 48 Q
558
(char gid[8];)36 60 Q(char size[12];)36 72 Q 0 Cg EP
563
/F0 10/Times-Roman@0 SF(char mtime[12];)36 12 Q(char checksum[8];)36 24
564
Q(char type\215ag[1];)36 36 Q(char linkname[100];)36 48 Q
565
(char magic[6];)36 60 Q(char v)36 72 Q(ersion[2];)-.15 E 0 Cg EP
570
/F0 10/Times-Roman@0 SF(char uname[32];)36 12 Q(char gname[32];)36 24 Q
571
(char de)36 36 Q(vmajor[8];)-.25 E(char de)36 48 Q(vminor[8];)-.25 E
572
(char pre\214x[155];)36 60 Q(char pad[12];)36 72 Q 0 Cg EP
577
/F0 10/Times-Roman@0 SF(};)0 12 Q(</pre>)0 24 Q(</code>)0 36 Q(</dl>)0
578
48 Q(<dl compact>)0 60 Q(<p><dt><i></i><i>type\215ag</i><dd>)0 72 Q 0 Cg
584
/F0 10/Times-Roman@0 SF -.8(Ty)0 12 S(pe of entry).8 E(.)-.65 E(POSIX e)
585
0 24 Q(xtended the earlier)-.15 E(<i></i><i>link\215ag</i>)0 36 Q
586
(\214eld with se)0 48 Q -.15(ve)-.25 G(ral ne).15 E 2.5(wt)-.25 G(ype v)
587
-2.5 E(alues:)-.25 E(<dl compact>)0 60 Q(<dt>`)0 72 Q(`0')-.74 E('<dd>)
593
/F0 10/Times-Roman@0 SF(Re)0 12 Q(gular \214le.)-.15 E
594
(NUL should be treated as a synon)0 24 Q
595
(ym, for compatibility purposes.)-.15 E(<dt>`)0 36 Q(`1')-.74 E('<dd>)
596
-.74 E(Hard link.)0 48 Q(<dt>`)0 60 Q(`2')-.74 E('<dd>)-.74 E
597
(Symbolic link.)0 72 Q 0 Cg EP
602
/F0 10/Times-Roman@0 SF(<dt>`)0 12 Q(`3')-.74 E('<dd>)-.74 E
603
(Character de)0 24 Q(vice node.)-.25 E(<dt>`)0 36 Q(`4')-.74 E('<dd>)
604
-.74 E(Block de)0 48 Q(vice node.)-.25 E(<dt>`)0 60 Q(`5')-.74 E('<dd>)
605
-.74 E(Directory)0 72 Q(.)-.65 E 0 Cg EP
610
/F0 10/Times-Roman@0 SF(<dt>`)0 12 Q(`6')-.74 E('<dd>)-.74 E(FIFO node.)
611
0 24 Q(<dt>`)0 36 Q(`7')-.74 E('<dd>)-.74 E(Reserv)0 48 Q(ed.)-.15 E
612
(<dt>Other<dd>)0 60 Q 2.5(AP)0 72 S
613
(OSIX-compliant implementation must treat an)-2.5 E 2.5(yu)-.15 G
614
(nrecognized type\215ag v)-2.5 E(alue)-.25 E 0 Cg EP
619
/F0 10/Times-Roman@0 SF(as a re)0 12 Q(gular \214le.)-.15 E
620
(In particular)0 24 Q 2.5(,w)-.4 G
621
(riters should ensure that all entries)-2.5 E(ha)0 36 Q .3 -.15(ve a v)
622
-.2 H(alid \214lename so that the)-.1 E 2.5(yc)-.15 G
623
(an be restored by readers that do not)-2.5 E
624
(support the corresponding e)0 48 Q(xtension.)-.15 E
625
(Uppercase letters "A" through "Z" are reserv)0 60 Q(ed for custom e)
626
-.15 E(xtensions.)-.15 E(Note that sock)0 72 Q
627
(ets and whiteout entries are not archi)-.1 E -.25(va)-.25 G(ble.).25 E
633
/F0 10/Times-Roman@0 SF(</dl>)0 12 Q(It is w)0 24 Q
634
(orth noting that the)-.1 E(<i></i><i>size</i>)0 36 Q
635
(\214eld, in particular)0 48 Q 2.5(,h)-.4 G(as dif)-2.5 E
636
(ferent meanings depending on the type.)-.25 E -.15(Fo)0 60 S 2.5(rr).15
638
(ular \214les, of course, it indicates the amount of data).15 E(follo)0
639
72 Q(wing the header)-.25 E(.)-.55 E 0 Cg EP
644
/F0 10/Times-Roman@0 SF -.15(Fo)0 12 S 2.5(rd).15 G
645
(irectories, it may be used to indicate the total size of all)-2.5 E
646
(\214les in the directory)0 24 Q 2.5(,f)-.65 G
647
(or use by operating systems that pre-allocate)-2.5 E(directory space.)0
648
36 Q -.15(Fo)0 48 S 2.5(ra).15 G
649
(ll other types, it should be set to zero by writers and ignored)-2.5 E
650
(by readers.)0 60 Q(<p><dt><i></i><i>magic</i><dd>)0 72 Q 0 Cg EP
655
/F0 10/Times-Roman@0 SF(Contains the magic v)0 12 Q(alue)-.25 E -.74(``)
656
0 24 S(ustar').74 E(')-.74 E(follo)0 36 Q
657
(wed by a NUL byte to indicate that this is a POSIX standard archi)-.25
658
E -.15(ve)-.25 G(.).15 E
659
(Full compliance requires the uname and gname \214elds be properly set.)
660
0 48 Q(<p><dt><i></i><i>v)0 60 Q(ersion</i><dd>)-.15 E -1.11(Ve)0 72 S
661
(rsion.)1.11 E 0 Cg EP
666
/F0 10/Times-Roman@0 SF(This should be)0 12 Q -.74(``)0 24 S(00').74 E
667
(')-.74 E(\(tw)0 36 Q 2.5(oc)-.1 G
668
(opies of the ASCII digit zero\) for POSIX standard archi)-2.5 E -.15
669
(ve)-.25 G(s.).15 E(<p><dt><i></i><i>uname</i><i></i>,<i> gname</i><dd>)
670
0 48 Q(User and group names, as null-terminated ASCII strings.)0 60 Q
671
(These should be used in preference to the uid/gid v)0 72 Q(alues)-.25 E
677
/F0 10/Times-Roman@0 SF(when the)0 12 Q 2.5(ya)-.15 G
678
(re set and the corresponding names e)-2.5 E(xist on)-.15 E(the system.)
679
0 24 Q(<p><dt><i></i><i>de)0 36 Q(vmajor</i><i></i>,<i> de)-.25 E
680
(vminor</i><dd>)-.25 E(Major and minor numbers for character de)0 48 Q
681
(vice or block de)-.25 E(vice entry)-.25 E(.)-.65 E
682
(<p><dt><i></i><i>name</i><i></i>,<i> pre\214x</i><dd>)0 60 Q
683
(If the pathname is too long to \214t in the 100 bytes pro)0 72 Q
684
(vided by the standard)-.15 E 0 Cg EP
689
/F0 10/Times-Roman@0 SF(format, it can be split at an)0 12 Q(y)-.15 E
690
(<code></code><code>/</code>)0 24 Q
691
(character with the \214rst portion going into the pre\214x \214eld.)0
692
36 Q(If the pre\214x \214eld is not empty)0 48 Q 2.5(,t)-.65 G
693
(he reader will prepend)-2.5 E(the pre\214x v)0 60 Q(alue and a)-.25 E
694
(<code></code><code>/</code>)0 72 Q 0 Cg EP
699
/F0 10/Times-Roman@0 SF(character to the re)0 12 Q
700
(gular name \214eld to obtain the full pathname.)-.15 E
701
(The standard does not require a trailing)0 24 Q
702
(<code></code><code>/</code>)0 36 Q
703
(character on directory names, though most implementations still)0 48 Q
704
(include this for compatibility reasons.)0 60 Q(</dl>)0 72 Q 0 Cg EP
709
/F0 10/Times-Roman@0 SF(<p>)36 12 Q
710
(Note that all unused bytes must be set to)0 24 Q
711
(<code></code><code>NUL</code>.)0 36 Q(<p>)36 48 Q
712
(Field termination is speci\214ed slightly dif)0 60 Q(ferently by POSIX)
713
-.25 E(than by pre)0 72 Q(vious implementations.)-.25 E 0 Cg EP
718
/F0 10/Times-Roman@0 SF(The)0 12 Q(<i></i><i>magic</i>,)0 24 Q
719
(<i></i><i>uname</i>,)0 36 Q(and)0 48 Q(<i></i><i>gname</i>)0 60 Q
720
(\214elds must ha)0 72 Q .3 -.15(ve a t)-.2 H(railing).15 E 0 Cg EP
725
/F0 10/Times-Roman@0 SF(<code></code><code>NUL</code>.)0 12 Q(The)0 24 Q
726
(<i></i><i>pathname</i>,)0 36 Q(<i></i><i>linkname</i>,)0 48 Q(and)0 60
727
Q(<i></i><i>pre\214x</i>)0 72 Q 0 Cg EP
732
/F0 10/Times-Roman@0 SF(\214elds must ha)0 12 Q .3 -.15(ve a t)-.2 H
733
(railing).15 E(<code></code><code>NUL</code>)0 24 Q(unless the)0 36 Q
734
2.5<798c>-.15 G(ll the entire \214eld.)-2.5 E(\(In particular)0 48 Q 2.5
735
(,i)-.4 G 2.5(ti)-2.5 G 2.5(sp)-2.5 G
736
(ossible to store a 256-character pathname if it)-2.5 E(happens to ha)0
737
60 Q .3 -.15(ve a)-.2 H(<code></code><code>/</code>)0 72 Q 0 Cg EP
742
/F0 10/Times-Roman@0 SF(as the 156th character)0 12 Q(.\))-.55 E(POSIX \
743
requires numeric \214elds to be zero-padded in the front, and requires)0
744
24 Q(them to be terminated with either space or)0 36 Q
745
(<code></code><code>NUL</code>)0 48 Q(characters.)0 60 Q(<p>)36 72 Q 0
751
/F0 10/Times-Roman@0 SF(Currently)0 12 Q 2.5(,m)-.65 G
752
(ost tar implementations comply with the ustar)-2.5 E
753
(format, occasionally e)0 24 Q(xtending it by adding ne)-.15 E 2.5<778c>
754
-.25 G(elds to the)-2.5 E(blank area at the end of the header record.)0
755
36 Q(<h4 id="P)36 48 Q(ax Interchange F)-.15 E(ormat">)-.15 E -.15(Pa)36
756
60 S 2.5(xI).15 G(nterchange F)-2.5 E(ormat)-.15 E(</h4>)36 72 Q 0 Cg EP
761
/F0 10/Times-Roman@0 SF(There are man)0 12 Q 2.5(ya)-.15 G(ttrib)-2.5 E
762
(utes that cannot be portably stored in a)-.2 E(POSIX ustar archi)0 24 Q
763
-.15(ve)-.25 G(.).15 E(IEEE Std 1003.1-2001 \(`)2.5 36 Q
764
(`<font size="-1">POSIX</font>.1')-.74 E('\))-.74 E(de\214ned a)0 48 Q
765
-.74(``)0 60 S(pax interchange format').74 E(')-.74 E(that uses tw)0 72
766
Q 2.5(on)-.1 G .5 -.25(ew t)-2.5 H(ypes of entries to hold te).25 E
767
(xt-formatted)-.15 E 0 Cg EP
772
/F0 10/Times-Roman@0 SF(metadata that applies to follo)0 12 Q
773
(wing entries.)-.25 E(Note that a pax interchange format archi)0 24 Q .3
774
-.15(ve i)-.25 H 2.5(sau).15 G(star archi)-2.5 E .3 -.15(ve i)-.25 H 2.5
775
(ne).15 G -.15(ve)-2.75 G(ry).15 E(respect.)0 36 Q(The ne)0 48 Q 2.5(wd)
776
-.25 G(ata is stored in ustar)-2.5 E(-compatible archi)-.2 E .3 -.15
777
(ve e)-.25 H(ntries that use the).15 E -.74(``)0 60 S(x').74 E(')-.74 E
783
/F0 10/Times-Roman@0 SF -.74(``)0 12 S(g').74 E(')-.74 E(type\215ag.)0
784
24 Q(In particular)0 36 Q 2.5(,o)-.4 G
785
(lder implementations that do not fully support these)-2.5 E -.15(ex)0
786
48 S(tensions will e).15 E(xtract the metadata into re)-.15 E
787
(gular \214les, where the)-.15 E(metadata can be e)0 60 Q
788
(xamined as necessary)-.15 E(.)-.65 E(<p>)36 72 Q 0 Cg EP
793
/F0 10/Times-Roman@0 SF(An entry in a pax interchange format archi)0 12
794
Q .3 -.15(ve c)-.25 H(onsists of one or).15 E(tw)0 24 Q 2.5(os)-.1 G
795
(tandard ustar entries, each with its o)-2.5 E(wn header and data.)-.25
796
E(The \214rst optional entry stores the e)0 36 Q(xtended attrib)-.15 E
797
(utes)-.2 E(for the follo)0 48 Q(wing entry)-.25 E(.)-.65 E(This option\
798
al \214rst entry has an "x" type\215ag and a size \214eld that)0 60 Q
799
(indicates the total size of the e)0 72 Q(xtended attrib)-.15 E(utes.)
805
/F0 10/Times-Roman@0 SF(The e)0 12 Q(xtended attrib)-.15 E
806
(utes themselv)-.2 E(es are stored as a series of te)-.15 E(xt-format)
807
-.15 E(lines encoded in the portable UTF-8 encoding.)0 24 Q
808
(Each line consists of a decimal number)0 36 Q 2.5(,as)-.4 G(pace, a k)
809
-2.5 E .3 -.15(ey s)-.1 H(tring, an equals).15 E(sign, a v)0 48 Q
810
(alue string, and a ne)-.25 E 2.5(wl)-.25 G(ine.)-2.5 E(The decimal num\
811
ber indicates the length of the entire line, including the)0 60 Q
812
(initial length \214eld and the trailing ne)0 72 Q(wline.)-.25 E 0 Cg EP
817
/F0 10/Times-Roman@0 SF(An e)0 12 Q(xample of such a \214eld is:)-.15 E
818
(<br>)0 24 Q( )0 36 Q
819
(<code></code><code>25</code><code> ctime=1084839148.1212\\n</code>)0 48
820
Q(<br>)0 60 Q -2.15 -.25(Ke y)0 72 T 2.5(si).25 G 2.5(na)-2.5 G(ll lo)
821
-2.5 E(wercase are standard k)-.25 E -.15(ey)-.1 G(s.).15 E 0 Cg EP
826
/F0 10/Times-Roman@0 SF -1.11(Ve)0 12 S(ndors can add their o)1.11 E
827
(wn k)-.25 E -.15(ey)-.1 G 2.5(sb).15 G 2.5(yp)-2.5 G
828
(re\214xing them with an all uppercase)-2.5 E -.15(ve)0 24 S
829
(ndor name and a period.).15 E(Note that, unlik)0 36 Q 2.5(et)-.1 G
830
(he historic header)-2.5 E 2.5(,n)-.4 G(umeric v)-2.5 E
831
(alues are stored using)-.25 E(decimal, not octal.)0 48 Q 2.5(Ad)0 60 S
832
(escription of some common k)-2.5 E -.15(ey)-.1 G 2.5(sf).15 G(ollo)-2.5
833
E(ws:)-.25 E(<dl compact>)0 72 Q 0 Cg EP
838
/F0 10/Times-Roman@0 SF(<p><dt><b></b><b>atime</b><b></b>,<b> ctime</b>\
839
<b></b>,<b> mtime</b><dd>)0 12 Q
840
(File access, inode change, and modi\214cation times.)0 24 Q
841
(These \214elds can be ne)0 36 Q -.05(ga)-.15 G(ti).05 E .3 -.15(ve o)
842
-.25 H 2.5(ri).15 G(nclude a decimal point and a fractional v)-2.5 E
843
(alue.)-.25 E(<p><dt><b></b><b>uname</b><b></b>,<b> uid</b><b></b>,<b> \
844
gname</b><b></b>,<b> gid</b><dd>)0 48 Q
845
(User name, group name, and numeric UID and GID v)0 60 Q(alues.)-.25 E
846
(The user name and group name stored here are encoded in UTF8)0 72 Q 0
852
/F0 10/Times-Roman@0 SF(and can thus include non-ASCII characters.)0 12
853
Q(The UID and GID \214elds can be of arbitrary length.)0 24 Q
854
(<p><dt><b></b><b>linkpath</b><dd>)0 36 Q(The full path of the link)0 48
855
Q(ed-to \214le.)-.1 E(Note that this is encoded in UTF8 and can thus in\
856
clude non-ASCII characters.)0 60 Q(<p><dt><b></b><b>path</b><dd>)0 72 Q
862
/F0 10/Times-Roman@0 SF(The full pathname of the entry)0 12 Q(.)-.65 E(\
863
Note that this is encoded in UTF8 and can thus include non-ASCII charac\
864
ters.)0 24 Q(<p><dt><b></b><b>realtime.*</b><b></b>,<b> security)0 36 Q
865
(.*</b><dd>)-.65 E(These k)0 48 Q -.15(ey)-.1 G 2.5(sa).15 G(re reserv)
866
-2.5 E(ed and may be used for future standardization.)-.15 E
867
(<p><dt><b></b><b>size</b><dd>)0 60 Q(The size of the \214le.)0 72 Q 0
873
/F0 10/Times-Roman@0 SF
874
(Note that there is no length limit on this \214eld, allo)0 12 Q
875
(wing conforming)-.25 E(archi)0 24 Q -.15(ve)-.25 G 2.5(st).15 G 2.5(os)
876
-2.5 G(tore \214les much lar)-2.5 E(ger than the historic 8GB limit.)
877
-.18 E(<p><dt><b></b><b>SCHIL)0 36 Q -1.29(Y.)-1 G(*</b><dd>)1.29 E
878
-1.11(Ve)0 48 S(ndor)1.11 E(-speci\214c attrib)-.2 E(utes used by Joer)
879
-.2 E 2.5(gS)-.18 G(chilling')-2.5 E(s)-.55 E(<b>star</b>)0 60 Q
880
(implementation.)0 72 Q 0 Cg EP
885
/F0 10/Times-Roman@0 SF(<p><dt><b></b><b>SCHIL)0 12 Q -1.29(Y.)-1 G
886
(acl.access</b><b></b>,<b> SCHIL)1.29 E -1.29(Y.)-1 G(acl.def)1.29 E
887
(ault</b><dd>)-.1 E(Stores the access and def)0 24 Q(ault A)-.1 E
888
(CLs as te)-.4 E(xtual strings in a format)-.15 E(that is an e)0 36 Q
889
(xtension of the format speci\214ed by POSIX.1e draft 17.)-.15 E
890
(In particular)0 48 Q 2.5(,e)-.4 G
891
(ach user or group access speci\214cation can include a fourth)-2.5 E
892
(colon-separated \214eld with the numeric UID or GID.)0 60 Q(This allo)0
893
72 Q(ws A)-.25 E(CLs to be restored on systems that may not ha)-.4 E .3
894
-.15(ve c)-.2 H(omplete).15 E 0 Cg EP
899
/F0 10/Times-Roman@0 SF(user or group information a)0 12 Q -.25(va)-.2 G
900
(ilable \(such as when NIS/YP or LD).25 E(AP services)-.4 E
901
(are temporarily una)0 24 Q -.25(va)-.2 G(ilable\).).25 E
902
(<p><dt><b></b><b>SCHIL)0 36 Q -1.29(Y.)-1 G(de)1.29 E
903
(vminor</b><b></b>,<b> SCHIL)-.25 E -1.29(Y.)-1 G(de)1.29 E
904
(vmajor</b><dd>)-.25 E(The full minor and major numbers for de)0 48 Q
905
(vice nodes.)-.25 E(<p><dt><b></b><b>SCHIL)0 60 Q -1.29(Y.)-1 G -.25
906
<668d>1.29 G(ags</b><dd>).25 E(The \214le \215ags.)0 72 Q 0 Cg EP
911
/F0 10/Times-Roman@0 SF(<p><dt><b></b><b>SCHIL)0 12 Q -1.29(Y.)-1 G
912
(realsize</b><dd>)1.29 E(The full size of the \214le on disk.)0 24 Q
913
(XXX e)0 36 Q(xplain? XXX)-.15 E(<p><dt><b></b><b>SCHIL)0 48 Q -1.29(Y.)
914
-1 G(de)1.29 E -.65(v,)-.25 G(</b><b></b><b> SCHIL).65 E -1.29(Y.)-1 G
915
(ino</b><b></b>,<b> SCHIL)1.29 E -1.29(Y.)-1 G(nlinks</b><dd>)1.29 E
916
(The de)0 60 Q(vice number)-.25 E 2.5(,i)-.4 G(node number)-2.5 E 2.5
917
(,a)-.4 G(nd link count for the entry)-2.5 E(.)-.65 E(In particular)0 72
918
Q 2.5(,n)-.4 G(ote that a pax interchange format archi)-2.5 E .3 -.15
919
(ve u)-.25 H(sing Joer).15 E(g)-.18 E 0 Cg EP
924
/F0 10/Times-Roman@0 SF(Schilling')0 12 Q(s)-.55 E(<b></b><b>SCHIL)0 24
925
Q -1.29(Y.)-1 G(*</b>)1.29 E -.15(ex)0 36 S
926
(tensions can store all of the data from).15 E
927
(<i></i><i>struct</i><i> stat</i>.)0 48 Q(<p><dt><b></b><b>LIB)0 60 Q
928
(ARCHIVE.xattr)-.35 E(.</b><i></i><i>namespace</i><i></i>.<i>k)-.55 E
929
-.15(ey)-.1 G(</i><dd>).15 E(Libarchi)0 72 Q .3 -.15(ve s)-.25 H
930
(tores POSIX.1e-style e).15 E(xtended attrib)-.15 E(utes using)-.2 E 0
936
/F0 10/Times-Roman@0 SF -.1(ke)0 12 S(ys of this form.)-.05 E(The)0 24 Q
937
(<i></i><i>k)0 36 Q -.15(ey)-.1 G(</i>).15 E -.25(va)0 48 S
938
(lue is URL-encoded:).25 E(All non-ASCII characters and the tw)0 60 Q
939
2.5(os)-.1 G(pecial characters)-2.5 E -.74(``)0 72 S(=').74 E(')-.74 E 0
945
/F0 10/Times-Roman@0 SF(and)0 12 Q -.74(``)0 24 S(%').74 E(')-.74 E
946
(are encoded as)0 36 Q -.74(``)0 48 S(%').74 E(')-.74 E(follo)0 60 Q
947
(wed by tw)-.25 E 2.5(ou)-.1 G(ppercase he)-2.5 E(xadecimal digits.)-.15
948
E(The v)0 72 Q(alue of this k)-.25 E .3 -.15(ey i)-.1 H 2.5(st).15 G
949
(he e)-2.5 E(xtended attrib)-.15 E(ute v)-.2 E(alue)-.25 E 0 Cg EP
954
/F0 10/Times-Roman@0 SF(encoded in base 64.)0 12 Q
955
(XXX Detail the base-64 format here XXX)0 24 Q
956
(<p><dt><b></b><b>VENDOR.*</b><dd>)0 36 Q(XXX document other v)0 48 Q
957
(endor)-.15 E(-speci\214c e)-.2 E(xtensions XXX)-.15 E(</dl>)0 60 Q(<p>)
963
/F0 10/Times-Roman@0 SF(An)0 12 Q 2.5(yv)-.15 G(alues stored in an e)
964
-2.75 E(xtended attrib)-.15 E(ute o)-.2 E -.15(ve)-.15 G
965
(rride the corresponding).15 E -.25(va)0 24 S(lues in the re).25 E
966
(gular tar header)-.15 E(.)-.55 E
967
(Note that compliant readers should ignore the re)0 36 Q
968
(gular \214elds when the)-.15 E(y)-.15 E(are o)0 48 Q -.15(ve)-.15 G
969
(rridden.).15 E(This is important, as e)0 60 Q(xisting archi)-.15 E -.15
970
(ve)-.25 G(rs are kno).15 E(wn to store non-compliant)-.25 E -.25(va)0
971
72 S(lues in the standard header \214elds in this situation.).25 E 0 Cg
977
/F0 10/Times-Roman@0 SF(There are no limits on length for an)0 12 Q 2.5
978
(yo)-.15 G 2.5(ft)-2.5 G(hese \214elds.)-2.5 E(In particular)0 24 Q 2.5
979
(,n)-.4 G(umeric \214elds can be arbitrarily lar)-2.5 E(ge.)-.18 E
980
(All te)0 36 Q(xt \214elds are encoded in UTF8.)-.15 E
981
(Compliant writers should store only portable 7-bit ASCII characters in)
982
0 48 Q(the standard ustar header and use e)0 60 Q(xtended)-.15 E(attrib)
983
0 72 Q(utes whene)-.2 E -.15(ve)-.25 G 2.5(rat).15 G -.15(ex)-2.5 G 2.5
984
(tv).15 G(alue contains non-ASCII characters.)-2.75 E 0 Cg EP
989
/F0 10/Times-Roman@0 SF(<p>)36 12 Q(In addition to the)0 24 Q
990
(<b></b><b>x</b>)0 36 Q(entry described abo)0 48 Q -.15(ve)-.15 G 2.5
991
(,t).15 G(he pax interchange format)-2.5 E(also supports a)0 60 Q
992
(<b></b><b>g</b>)0 72 Q 0 Cg EP
997
/F0 10/Times-Roman@0 SF(entry)0 12 Q(.)-.65 E(The)0 24 Q
998
(<b></b><b>g</b>)0 36 Q(entry is identical in format, b)0 48 Q
999
(ut speci\214es attrib)-.2 E(utes that serv)-.2 E 2.5(ea)-.15 G(s)-2.5 E
1000
(def)0 60 Q(aults for all subsequent archi)-.1 E .3 -.15(ve e)-.25 H
1001
(ntries.).15 E(The)0 72 Q 0 Cg EP
1006
/F0 10/Times-Roman@0 SF(<b></b><b>g</b>)0 12 Q
1007
(entry is not widely used.)0 24 Q(<p>)36 36 Q(Besides the ne)0 48 Q(w)
1008
-.25 E(<b></b><b>x</b>)0 60 Q(and)0 72 Q 0 Cg EP
1013
/F0 10/Times-Roman@0 SF(<b></b><b>g</b>)0 12 Q
1014
(entries, the pax interchange format has a fe)0 24 Q 2.5(wo)-.25 G
1015
(ther minor v)-2.5 E(ariations)-.25 E(from the earlier ustar format.)0
1016
36 Q(The most troubling one is that hardlinks are permitted to ha)0 48 Q
1017
-.15(ve)-.2 G(data follo)0 60 Q(wing them.)-.25 E(This allo)0 72 Q
1018
(ws readers to restore an)-.25 E 2.5(yh)-.15 G
1019
(ardlink to a \214le without)-2.5 E 0 Cg EP
1024
/F0 10/Times-Roman@0 SF(ha)0 12 Q(ving to re)-.2 E(wind the archi)-.25 E
1025
.3 -.15(ve t)-.25 H 2.5<6f8c>.15 G(nd an earlier entry)-2.5 E(.)-.65 E
1026
(Ho)0 24 Q(we)-.25 E -.15(ve)-.25 G .8 -.4(r, i).15 H 2.5(tc).4 G
1027
(reates complications for rob)-2.5 E(ust readers, as it is no longer)-.2
1028
E(clear whether or not the)0 36 Q 2.5(ys)-.15 G
1029
(hould ignore the size \214eld for hardlink entries.)-2.5 E
1030
(<h4 id="GNU T)36 48 Q(ar Archi)-.8 E -.15(ve)-.25 G(s">).15 E(GNU T)36
1031
60 Q(ar Archi)-.8 E -.15(ve)-.25 G(s).15 E(</h4>)36 72 Q 0 Cg EP
1036
/F0 10/Times-Roman@0 SF
1037
(The GNU tar program started with a pre-POSIX format similar to that)0
1038
12 Q(described earlier and has e)0 24 Q(xtended it using se)-.15 E -.15
1039
(ve)-.25 G(ral dif).15 E(ferent mechanisms:)-.25 E(It added ne)0 36 Q
1040
2.5<778c>-.25 G(elds to the empty space in the header \(some of which w)
1041
-2.5 E(as later)-.1 E(used by POSIX for con\215icting purposes\);)0 48 Q
1042
(it allo)0 60 Q(wed the header to be continued o)-.25 E -.15(ve)-.15 G
1043
2.5(rm).15 G(ultiple records;)-2.5 E(and it de\214ned ne)0 72 Q 2.5(we)
1044
-.25 G(ntries that modify follo)-2.5 E(wing entries)-.25 E 0 Cg EP
1049
/F0 10/Times-Roman@0 SF(\(similar in principle to the)0 12 Q
1050
(<b></b><b>x</b>)0 24 Q(entry described abo)0 36 Q -.15(ve)-.15 G 2.5
1051
(,b).15 G(ut each GNU special entry is single-purpose,)-2.7 E(unlik)0 48
1052
Q 2.5(et)-.1 G(he general-purpose)-2.5 E(<b></b><b>x</b>)0 60 Q
1053
(entry\).)0 72 Q 0 Cg EP
1058
/F0 10/Times-Roman@0 SF(As a result, GNU tar archi)0 12 Q -.15(ve)-.25 G
1059
2.5(sa).15 G(re not POSIX compatible, although)-2.5 E
1060
(more lenient POSIX-compliant readers can successfully e)0 24 Q
1061
(xtract most)-.15 E(GNU tar archi)0 36 Q -.15(ve)-.25 G(s.).15 E
1062
(<dl compact><dt><dd>)0 48 Q(<code>)0 60 Q(<pre>)0 72 Q 0 Cg EP
1067
/F0 10/Times-Roman@0 SF(struct header_gnu_tar {)0 12 Q(char name[100];)
1068
36 24 Q(char mode[8];)36 36 Q(char uid[8];)36 48 Q(char gid[8];)36 60 Q
1069
(char size[12];)36 72 Q 0 Cg EP
1074
/F0 10/Times-Roman@0 SF(char mtime[12];)36 12 Q(char checksum[8];)36 24
1075
Q(char type\215ag[1];)36 36 Q(char linkname[100];)36 48 Q
1076
(char magic[6];)36 60 Q(char v)36 72 Q(ersion[2];)-.15 E 0 Cg EP
1081
/F0 10/Times-Roman@0 SF(char uname[32];)36 12 Q(char gname[32];)36 24 Q
1082
(char de)36 36 Q(vmajor[8];)-.25 E(char de)36 48 Q(vminor[8];)-.25 E
1083
(char atime[12];)36 60 Q(char ctime[12];)36 72 Q 0 Cg EP
1088
/F0 10/Times-Roman@0 SF(char of)36 12 Q(fset[12];)-.25 E
1089
(char longnames[4];)36 24 Q(char unused[1];)36 36 Q(struct {)36 48 Q
1090
(char of)72 60 Q(fset[12];)-.25 E(char numbytes[12];)72 72 Q 0 Cg EP
1095
/F0 10/Times-Roman@0 SF 2.5(}s)36 12 S(parse[4];)-2.5 E(char ise)36 24 Q
1096
(xtended[1];)-.15 E(char realsize[12];)36 36 Q(char pad[17];)36 48 Q(};)
1097
0 60 Q(</pre>)0 72 Q 0 Cg EP
1102
/F0 10/Times-Roman@0 SF(</code>)0 12 Q(</dl>)0 24 Q(<dl compact>)0 36 Q
1103
(<p><dt><i></i><i>type\215ag</i><dd>)0 48 Q(GNU tar uses the follo)0 60
1104
Q(wing special entry types, in addition to)-.25 E
1105
(those de\214ned by POSIX:)0 72 Q 0 Cg EP
1110
/F0 10/Times-Roman@0 SF(<dl compact>)0 12 Q(<p><dt>7<dd>)0 24 Q
1111
(GNU tar treats type "7" records identically to type "0" records,)0 36 Q
1112
-.15(ex)0 48 S(cept on one obscure R).15 E -.18(TO)-.6 G 2.5(Sw).18 G
1113
(here the)-2.5 E 2.5(ya)-.15 G(re used to indicate the)-2.5 E
1114
(pre-allocation of a contiguous \214le on disk.)0 60 Q(<p><dt>D<dd>)0 72
1120
/F0 10/Times-Roman@0 SF(This indicates a directory entry)0 12 Q(.)-.65 E
1121
(Unlik)0 24 Q 2.5(et)-.1 G(he POSIX-standard "5")-2.5 E
1122
(type\215ag, the header is follo)0 36 Q
1123
(wed by data records listing the names)-.25 E
1124
(of \214les in this directory)0 48 Q(.)-.65 E
1125
(Each name is preceded by an ASCII "Y")0 60 Q
1126
(if the \214le is stored in this archi)0 72 Q .3 -.15(ve o)-.25 H 2.5
1127
(r").15 G(N" if the \214le is not)-2.5 E 0 Cg EP
1132
/F0 10/Times-Roman@0 SF(stored in this archi)0 12 Q -.15(ve)-.25 G(.).15
1133
E(Each name is terminated with a null, and)0 24 Q(an e)0 36 Q
1134
(xtra null marks the end of the name list.)-.15 E(The purpose of this)0
1135
48 Q(entry is to support incremental backups; a program restoring from)0
1136
60 Q(such an archi)0 72 Q .3 -.15(ve m)-.25 H
1137
(ay wish to delete \214les on disk that did not e).15 E(xist)-.15 E 0 Cg
1143
/F0 10/Times-Roman@0 SF(in the directory when the archi)0 12 Q .3 -.15
1144
(ve w)-.25 H(as made.).05 E(<p>)36 24 Q(Note that the "D" type\215ag sp\
1145
eci\214cally violates POSIX, which requires)0 36 Q
1146
(that unrecognized type\215ags be restored as normal \214les.)0 48 Q
1147
(In this case, restoring the "D" entry as a \214le could interfere)0 60
1148
Q(with subsequent creation of the lik)0 72 Q(e-named directory)-.1 E(.)
1154
/F0 10/Times-Roman@0 SF(<p><dt>K<dd>)0 12 Q
1155
(The data for this entry is a long linkname for the follo)0 24 Q
1156
(wing re)-.25 E(gular entry)-.15 E(.)-.65 E(<p><dt>L<dd>)0 36 Q
1157
(The data for this entry is a long pathname for the follo)0 48 Q
1158
(wing re)-.25 E(gular entry)-.15 E(.)-.65 E(<p><dt>M<dd>)0 60 Q
1159
(This is a continuation of the last \214le on the pre)0 72 Q(vious v)
1160
-.25 E(olume.)-.2 E 0 Cg EP
1165
/F0 10/Times-Roman@0 SF(GNU multi-v)0 12 Q(olume archi)-.2 E -.15(ve)
1166
-.25 G 2.5(sg).15 G(uarantee that each v)-2.5 E(olume be)-.2 E
1167
(gins with a v)-.15 E(alid)-.25 E(entry header)0 24 Q(.)-.55 E 1.6 -.8
1168
(To e)0 36 T(nsure this, a \214le may be split, with part stored at the\
1169
end of one v).8 E(olume,)-.2 E(and part stored at the be)0 48 Q
1170
(ginning of the ne)-.15 E(xt v)-.15 E(olume.)-.2 E
1171
(The "M" type\215ag indicates that this entry continues an e)0 60 Q
1172
(xisting \214le.)-.15 E
1173
(Such entries can only occur as the \214rst or second entry)0 72 Q 0 Cg
1179
/F0 10/Times-Roman@0 SF(in an archi)0 12 Q .3 -.15(ve \()-.25 H
1180
(the latter only if the \214rst entry is a v).15 E(olume label\).)-.2 E
1181
(The)0 24 Q(<i></i><i>size</i>)0 36 Q
1182
(\214eld speci\214es the size of this entry)0 48 Q(.)-.65 E(The)0 60 Q
1183
(<i></i><i>of)0 72 Q(fset</i>)-.25 E 0 Cg EP
1188
/F0 10/Times-Roman@0 SF(\214eld at bytes 369-380 speci\214es the of)0 12
1189
Q(fset where this \214le fragment)-.25 E(be)0 24 Q(gins.)-.15 E(The)0 36
1190
Q(<i></i><i>realsize</i>)0 48 Q
1191
(\214eld speci\214es the total size of the \214le \(which must equal)0
1192
60 Q(<i></i><i>size</i>)0 72 Q 0 Cg EP
1197
/F0 10/Times-Roman@0 SF(plus)0 12 Q(<i></i><i>of)0 24 Q(fset</i>\).)-.25
1199
(xtracting, GNU tar checks that the header \214le name is the one it is)
1200
-.15 E -.15(ex)0 48 S(pecting, that the header of).15 E
1201
(fset is in the correct sequence, and that)-.25 E(the sum of of)0 60 Q
1202
(fset and size is equal to realsize.)-.25 E(<p><dt>N<dd>)0 72 Q 0 Cg EP
1207
/F0 10/Times-Roman@0 SF -.8(Ty)0 12 S
1208
(pe "N" records are no longer generated by GNU tar).8 E(.)-.55 E(The)0
1209
24 Q 2.5(yc)-.15 G(ontained a)-2.5 E
1210
(list of \214les to be renamed or symlink)0 36 Q(ed after e)-.1 E
1211
(xtraction; this w)-.15 E(as)-.1 E
1212
(originally used to support long names.)0 48 Q
1213
(The contents of this record)0 60 Q(are a te)0 72 Q
1214
(xt description of the operations to be done, in the form)-.15 E 0 Cg EP
1219
/F0 10/Times-Roman@0 SF -.74(``)0 12 S(Rename %s to %s\\n').74 E(')-.74
1220
E(or)0 24 Q -.74(``)0 36 S(Symlink %s to %s\\n').74 E(';)-.74 E
1221
(in either case, both)0 48 Q
1222
(\214lenames are escaped using K&R C syntax.)0 60 Q
1223
(Due to security concerns, "N" records are no)0 72 Q 2.5(wg)-.25 G
1224
(enerally ignored)-2.5 E 0 Cg EP
1229
/F0 10/Times-Roman@0 SF(when reading archi)0 12 Q -.15(ve)-.25 G(s.).15
1230
E(<p><dt>S<dd>)0 24 Q(This is a)0 36 Q -.74(``)0 48 S(sparse').74 E(')
1231
-.74 E(re)0 60 Q(gular \214le.)-.15 E
1232
(Sparse \214les are stored as a series of fragments.)0 72 Q 0 Cg EP
1237
/F0 10/Times-Roman@0 SF(The header contains a list of fragment of)0 12 Q
1238
(fset/length pairs.)-.25 E
1239
(If more than four such entries are required, the header is)0 24 Q -.15
1240
(ex)0 36 S(tended as necessary with).15 E -.74(``)0 48 S -.15(ex).74 G
1241
(tra').15 E(')-.74 E(header e)0 60 Q
1242
(xtensions \(an older format that is no longer used\), or)-.15 E -.74
1243
(``)0 72 S(sparse').74 E(')-.74 E 0 Cg EP
1248
/F0 10/Times-Roman@0 SF -.15(ex)0 12 S(tensions.).15 E(<p><dt>V<dd>)0 24
1249
Q(The)0 36 Q(<i></i><i>name</i>)0 48 Q
1250
(\214eld should be interpreted as a tape/v)0 60 Q(olume header name.)-.2
1251
E(This entry should generally be ignored on e)0 72 Q(xtraction.)-.15 E 0
1257
/F0 10/Times-Roman@0 SF(</dl>)0 12 Q(<p><dt><i></i><i>magic</i><dd>)0 24
1258
Q(The magic \214eld holds the \214v)0 36 Q 2.5(ec)-.15 G(haracters)-2.5
1259
E -.74(``)0 48 S(ustar').74 E(')-.74 E(follo)0 60 Q(wed by a space.)-.25
1260
E(Note that POSIX ustar archi)0 72 Q -.15(ve)-.25 G 2.5(sh).15 G -2.25
1261
-.2(av e)-2.5 H 2.5(at)2.7 G(railing null.)-2.5 E 0 Cg EP
1266
/F0 10/Times-Roman@0 SF(<p><dt><i></i><i>v)0 12 Q(ersion</i><dd>)-.15 E
1267
(The v)0 24 Q(ersion \214eld holds a space character follo)-.15 E
1268
(wed by a null.)-.25 E(Note that POSIX ustar archi)0 36 Q -.15(ve)-.25 G
1269
2.5(su).15 G(se tw)-2.5 E 2.5(oc)-.1 G(opies of the ASCII digit)-2.5 E
1270
-.74(``)0 48 S(0').74 E('.)-.74 E
1271
(<p><dt><i></i><i>atime</i><i></i>,<i> ctime</i><dd>)0 60 Q
1272
(The time the \214le w)0 72 Q(as last accessed and the time of)-.1 E 0
1278
/F0 10/Times-Roman@0 SF
1279
(last change of \214le information, stored in octal as with)0 12 Q
1280
(<i></i><i>mtime</i>.)0 24 Q(<p><dt><i></i><i>longnames</i><dd>)0 36 Q
1281
(This \214eld is apparently no longer used.)0 48 Q
1282
(<p><dt>Sparse<i></i><i> of)0 60 Q
1283
(fset</i><i> /</i><i></i><i> numbytes</i><dd>)-.25 E
1284
(Each such structure speci\214es a single fragment of a sparse)0 72 Q 0
1290
/F0 10/Times-Roman@0 SF(\214le.)0 12 Q(The tw)0 24 Q 2.5<6f8c>-.1 G
1291
(elds store v)-2.5 E(alues as octal numbers.)-.25 E
1292
(The fragments are each padded to a multiple of 512 bytes)0 36 Q
1293
(in the archi)0 48 Q -.15(ve)-.25 G(.).15 E(On e)0 60 Q
1294
(xtraction, the list of fragments is collected from the)-.15 E
1295
(header \(including an)0 72 Q 2.5(ye)-.15 G
1296
(xtension headers\), and the data)-2.65 E 0 Cg EP
1301
/F0 10/Times-Roman@0 SF
1302
(is then read and written to the \214le at appropriate of)0 12 Q(fsets.)
1303
-.25 E(<p><dt><i></i><i>ise)0 24 Q(xtended</i><dd>)-.15 E
1304
(If this is set to non-zero, the header will be follo)0 36 Q
1305
(wed by additional)-.25 E -.74(``)0 48 S(sparse header').74 E(')-.74 E
1306
(records.)0 60 Q(Each such record contains information about as man)0 72
1307
Q 2.5(ya)-.15 G 2.5(s2)-2.5 G 2.5(1a)-2.5 G(dditional)-2.5 E 0 Cg EP
1312
/F0 10/Times-Roman@0 SF(sparse blocks as sho)0 12 Q(wn here:)-.25 E
1313
(<dl compact><dt><dd>)0 24 Q(<code>)0 36 Q(<pre>)0 48 Q
1314
(struct gnu_sparse_header {)0 60 Q(struct {)36 72 Q 0 Cg EP
1319
/F0 10/Times-Roman@0 SF(char of)72 12 Q(fset[12];)-.25 E
1320
(char numbytes[12];)72 24 Q 2.5(}s)36 36 S(parse[21];)-2.5 E 7.5
1321
(char ise)36 48 R(xtended[1];)-.15 E 7.5(char padding[7];)36 60 R(};)0
1327
/F0 10/Times-Roman@0 SF(</pre>)0 12 Q(</code>)0 24 Q(</dl>)0 36 Q
1328
(<p><dt><i></i><i>realsize</i><dd>)0 48 Q 2.5(Ab)0 60 S
1329
(inary representation of the \214le')-2.5 E 2.5(sc)-.55 G
1330
(omplete size, with a much lar)-2.5 E(ger range)-.18 E
1331
(than the POSIX \214le size.)0 72 Q 0 Cg EP
1336
/F0 10/Times-Roman@0 SF(In particular)0 12 Q 2.5(,w)-.4 G(ith)-2.5 E
1337
(<b></b><b>M</b>)0 24 Q
1338
(type \214les, the current entry is only a portion of the \214le.)0 36 Q
1339
(In that case, the POSIX size \214eld will indicate the size of this)0
1340
48 Q(entry; the)0 60 Q(<i></i><i>realsize</i>)0 72 Q 0 Cg EP
1345
/F0 10/Times-Roman@0 SF
1346
(\214eld will indicate the total size of the \214le.)0 12 Q(</dl>)0 24 Q
1347
(<h4 id="GNU tar pax archi)36 36 Q -.15(ve)-.25 G(s">).15 E
1348
(GNU tar pax archi)36 48 Q -.15(ve)-.25 G(s).15 E(</h4>)36 60 Q
1349
(GNU tar 1.14 \(XXX check this XXX\) and later will write)0 72 Q 0 Cg EP
1354
/F0 10/Times-Roman@0 SF(pax interchange format archi)0 12 Q -.15(ve)-.25
1355
G 2.5(sw).15 G(hen you specify the)-2.5 E(<b>\255</b><b>-posix</b>)0 24
1356
Q(\215ag.)0 36 Q(This format uses custom k)0 48 Q -.15(ey)-.1 G -.1(wo)
1357
.15 G(rds to store sparse \214le information.).1 E(There ha)0 60 Q .3
1358
-.15(ve b)-.2 H(een three iterations of this support, referred to).15 E
1364
/F0 10/Times-Roman@0 SF -.74(``)0 12 S(0.0').74 E(',)-.74 E -.74(``)0 24
1365
S(0.1').74 E(',)-.74 E(and)0 36 Q -.74(``)0 48 S(1.0').74 E('.)-.74 E
1366
(<dl compact>)0 60 Q
1367
(<p><dt><b></b><b>GNU.sparse.numblocks</b><b></b>,<b> GNU.sparse.of)0 72
1368
Q(fset</b><b></b>,<b> GNU.sparse.numbytes</b><b></b>,<b> GNU.sparse.siz\
1369
e</b><dd>)-.25 E 0 Cg EP
1374
/F0 10/Times-Roman@0 SF(The)0 12 Q -.74(``)0 24 S(0.0').74 E(')-.74 E
1375
(format used an initial)0 36 Q(<b></b><b>GNU.sparse.numblocks</b>)0 48 Q
1377
(ute to indicate the number of blocks in the \214le, a pair of)-.2 E
1378
(<b></b><b>GNU.sparse.of)0 72 Q(fset</b>)-.25 E 0 Cg EP
1383
/F0 10/Times-Roman@0 SF(and)0 12 Q(<b></b><b>GNU.sparse.numbytes</b>)0
1384
24 Q(to indicate the of)0 36 Q(fset and size of each block,)-.25 E
1385
(and a single)0 48 Q(<b></b><b>GNU.sparse.size</b>)0 60 Q
1386
(to indicate the full size of the \214le.)0 72 Q 0 Cg EP
1391
/F0 10/Times-Roman@0 SF
1392
(This is not the same as the size in the tar header because the)0 12 Q
1393
(latter v)0 24 Q(alue does not include the size of an)-.25 E 2.5(yh)-.15
1394
G(oles.)-2.5 E(This format required that the order of attrib)0 36 Q
1395
(utes be preserv)-.2 E(ed and)-.15 E
1396
(relied on readers accepting multiple appearances of the same attrib)0
1397
48 Q(ute)-.2 E(names, which is not of)0 60 Q
1398
(\214cially permitted by the standards.)-.25 E
1399
(<p><dt><b></b><b>GNU.sparse.map</b><dd>)0 72 Q 0 Cg EP
1404
/F0 10/Times-Roman@0 SF(The)0 12 Q -.74(``)0 24 S(0.1').74 E(')-.74 E
1405
(format used a single attrib)0 36 Q(ute that stored a comma-separated)
1406
-.2 E(list of decimal numbers.)0 48 Q
1407
(Each pair of numbers indicated the of)0 60 Q(fset and size, respecti)
1408
-.25 E -.15(ve)-.25 G(ly).15 E(,)-.65 E(of a block of data.)0 72 Q 0 Cg
1414
/F0 10/Times-Roman@0 SF(This does not w)0 12 Q(ork well if the archi)-.1
1415
E .3 -.15(ve i)-.25 H 2.5(se).15 G(xtracted by an archi)-2.65 E -.15(ve)
1416
-.25 G(r).15 E(that does not recognize this e)0 24 Q
1417
(xtension, since man)-.15 E 2.5(yp)-.15 G(ax implementations)-2.5 E
1418
(simply discard unrecognized attrib)0 36 Q(utes.)-.2 E(<p><dt><b></b><b\
1419
>GNU.sparse.major</b><b></b>,<b> GNU.sparse.minor</b><b></b>,<b> GNU.sp\
1420
arse.name</b><b></b>,<b> GNU.sparse.realsize</b><dd>)0 48 Q(The)0 60 Q
1421
-.74(``)0 72 S(1.0').74 E(')-.74 E 0 Cg EP
1426
/F0 10/Times-Roman@0 SF
1427
(format stores the sparse block map in one or more 512-byte blocks)0 12
1428
Q(prepended to the \214le data in the entry body)0 24 Q(.)-.65 E
1429
(The pax attrib)0 36 Q(utes indicate the e)-.2 E(xistence of this map)
1430
-.15 E(\(via the)0 48 Q(<b></b><b>GNU.sparse.major</b>)0 60 Q(and)0 72 Q
1436
/F0 10/Times-Roman@0 SF(<b></b><b>GNU.sparse.minor</b>)0 12 Q
1437
(\214elds\))0 24 Q(and the full size of the \214le.)0 36 Q(The)0 48 Q
1438
(<b></b><b>GNU.sparse.name</b>)0 60 Q
1439
(holds the true name of the \214le.)0 72 Q 0 Cg EP
1444
/F0 10/Times-Roman@0 SF 1.6 -.8(To a)0 12 T -.2(vo).6 G
1445
(id confusion, the name stored in the re).2 E(gular tar header)-.15 E
1446
(is a modi\214ed name so that e)0 24 Q
1447
(xtraction errors will be apparent)-.15 E(to users.)0 36 Q(</dl>)0 48 Q
1448
(<h4 id="Solaris T)36 60 Q(ar">)-.8 E(Solaris T)36 72 Q(ar)-.8 E 0 Cg EP
1453
/F0 10/Times-Roman@0 SF(</h4>)36 12 Q(XXX More Details Needed XXX)0 24 Q
1454
(<p>)36 36 Q(Solaris tar \(be)0 48 Q
1455
(ginning with SunOS XXX 5.7 ?? XXX\) supports an)-.15 E -.74(``)0 60 S
1456
-.15(ex).74 G(tended').15 E(')-.74 E
1457
(format that is fundamentally similar to pax interchange format,)0 72 Q
1463
/F0 10/Times-Roman@0 SF(with the follo)0 12 Q(wing dif)-.25 E(ferences:)
1464
-.25 E(<ul>)0 24 Q(<li>)0 36 Q(Extended attrib)0 48 Q
1465
(utes are stored in an entry whose type is)-.2 E(<b></b><b>X</b>,)0 60 Q
1471
/F0 10/Times-Roman@0 SF(<b></b><b>x</b>,)0 12 Q
1472
(as used by pax interchange format.)0 24 Q
1473
(The detailed format of this entry appears to be the same)0 36 Q
1474
(as detailed abo)0 48 Q .3 -.15(ve f)-.15 H(or the).15 E
1475
(<b></b><b>x</b>)0 60 Q(entry)0 72 Q(.)-.65 E 0 Cg EP
1480
/F0 10/Times-Roman@0 SF(<li>)0 12 Q(An additional)0 24 Q
1481
(<b></b><b>A</b>)0 36 Q(entry is used to store an A)0 48 Q
1482
(CL for the follo)-.4 E(wing re)-.25 E(gular entry)-.15 E(.)-.65 E
1483
(The body of this entry contains a se)0 60 Q -.15(ve)-.25 G
1484
(n-digit octal number).15 E(follo)0 72 Q(wed by a zero byte, follo)-.25
1485
E(wed by the)-.25 E 0 Cg EP
1490
/F0 10/Times-Roman@0 SF(te)0 12 Q(xtual A)-.15 E(CL description.)-.4 E
1491
(The octal v)0 24 Q(alue is the number of A)-.25 E(CL entries)-.4 E
1492
(plus a constant that indicates the A)0 36 Q(CL type: 01000000)-.4 E
1493
(for POSIX.1e A)0 48 Q(CLs and 03000000 for NFSv4 A)-.4 E(CLs.)-.4 E
1494
(</ul>)0 60 Q(<h4 id="AIX T)36 72 Q(ar">)-.8 E 0 Cg EP
1499
/F0 10/Times-Roman@0 SF(AIX T)36 12 Q(ar)-.8 E(</h4>)36 24 Q
1500
(XXX More details needed XXX)0 36 Q(<h4 id="Mac OS X T)36 48 Q(ar">)-.8
1501
E(Mac OS X T)36 60 Q(ar)-.8 E(</h4>)36 72 Q 0 Cg EP
1506
/F0 10/Times-Roman@0 SF(The tar distrib)0 12 Q(uted with Apple')-.2 E
1507
2.5(sM)-.55 G(ac OS X stores most re)-2.5 E(gular \214les)-.15 E(as tw)0
1508
24 Q 2.5(os)-.1 G(eparate entries in the tar archi)-2.5 E -.15(ve)-.25 G
1509
(.).15 E(The tw)0 36 Q 2.5(oe)-.1 G(ntries ha)-2.5 E .3 -.15(ve t)-.2 H
1510
(he same name e).15 E(xcept that the \214rst)-.15 E(one has)0 48 Q -.74
1511
(``)0 60 S(._').74 E(')-.74 E(added to the be)0 72 Q
1512
(ginning of the name.)-.15 E 0 Cg EP
1517
/F0 10/Times-Roman@0 SF(This \214rst entry stores the)0 12 Q -.74(``)0
1518
24 S(resource fork').74 E(')-.74 E(with additional attrib)0 36 Q
1519
(utes for the \214le.)-.2 E(The Mac OS X)0 48 Q(<b>Cop)0 60 Q
1520
(yFile</b>\(<code></code>\))-.1 E
1521
(API is used to separate a \214le on disk into separate)0 72 Q 0 Cg EP
1526
/F0 10/Times-Roman@0 SF
1527
(resource and data streams and to reassemble those separate)0 12 Q
1528
(streams when the \214le is restored to disk.)0 24 Q
1529
(<h4 id="Other Extensions">)36 36 Q(Other Extensions)36 48 Q(</h4>)36 60
1530
Q(One ob)0 72 Q(vious e)-.15 E
1531
(xtension to increase the size of \214les is to)-.15 E 0 Cg EP
1536
/F0 10/Times-Roman@0 SF(eliminate the terminating characters from the v)
1537
0 12 Q(arious)-.25 E(numeric \214elds.)0 24 Q -.15(Fo)0 36 S 2.5(re).15
1538
G(xample, the standard only allo)-2.65 E(ws the size \214eld to contain)
1539
-.25 E(11 octal digits, reserving the twelfth byte for a trailing)0 48 Q
1540
(NUL character)0 60 Q(.)-.55 E(Allo)0 72 Q(wing 12 octal digits allo)
1541
-.25 E(ws \214le sizes up to 64 GB.)-.25 E 0 Cg EP
1546
/F0 10/Times-Roman@0 SF(<p>)36 12 Q(Another e)0 24 Q
1547
(xtension, utilized by GNU tar)-.15 E 2.5(,s)-.4 G(tar)-2.5 E 2.5(,a)-.4
1548
G(nd other ne)-2.5 E(wer)-.25 E(<b>tar</b>)0 36 Q(implementations, perm\
1549
its binary numbers in the standard numeric \214elds.)0 48 Q
1550
(This is \215agged by setting the high bit of the \214rst byte.)0 60 Q
1551
(This permits 95-bit v)0 72 Q(alues for the length and time \214elds)
1557
/F0 10/Times-Roman@0 SF(and 63-bit v)0 12 Q
1558
(alues for the uid, gid, and de)-.25 E(vice numbers.)-.25 E
1559
(GNU tar supports this e)0 24 Q(xtension for the)-.15 E
1560
(length, mtime, ctime, and atime \214elds.)0 36 Q(Joer)0 48 Q 2.5(gS)
1561
-.18 G(chilling')-2.5 E 2.5(ss)-.55 G(tar program supports this e)-2.5 E
1562
(xtension for)-.15 E(all numeric \214elds.)0 60 Q(Note that this e)0 72
1563
Q(xtension is lar)-.15 E(gely obsoleted by the e)-.18 E(xtended attrib)
1564
-.15 E(ute)-.2 E 0 Cg EP
1569
/F0 10/Times-Roman@0 SF(record pro)0 12 Q
1570
(vided by the pax interchange format.)-.15 E(<p>)36 24 Q
1571
(Another early GNU e)0 36 Q(xtension allo)-.15 E(wed base-64 v)-.25 E
1572
(alues rather than octal.)-.25 E(This e)0 48 Q(xtension w)-.15 E
1573
(as short-li)-.1 E -.15(ve)-.25 G 2.5(da).15 G
1574
(nd is no longer supported by an)-2.5 E(y)-.15 E(implementation.)0 60 Q
1575
(<h3 id="SEE ALSO">)36 72 Q 0 Cg EP
1580
/F0 10/Times-Roman@0 SF(SEE ALSO)36 12 Q(</h3>)36 24 Q
1581
(<a href="../html1/ar)0 36 Q(.html">ar\(1\)</a>,)-.55 E
1582
(<a href="../html1/pax.html">pax\(1\)</a>,)0 48 Q(<a href="../html1/tar)
1583
0 60 Q(.html">tar\(1\)</a>)-.55 E(<h3 id="ST)36 72 Q(AND)-.93 E(ARDS">)
1589
/F0 10/Times-Roman@0 SF(ST)36 12 Q(AND)-.93 E(ARDS)-.4 E(</h3>)36 24 Q
1590
(The)0 36 Q(<b>tar</b>)0 48 Q
1591
(utility is no longer a part of POSIX or the Single Unix Standard.)0 60
1592
Q(It last appeared in)0 72 Q 0 Cg EP
1597
/F0 10/Times-Roman@0 SF -1.11(Ve)2.5 12 S
1598
(rsion 2 of the Single UNIX Speci\214cation \(`)1.11 E(`SUSv2')-.74 E
1599
('\) .)-.74 E(It has been supplanted in subsequent standards by)0 24 Q
1600
(<a href="../html1/pax.html">pax\(1\)</a>.)0 36 Q
1601
(The ustar format is currently part of the speci\214cation for the)0 48
1602
Q(<a href="../html1/pax.html">pax\(1\)</a>)0 60 Q(utility)0 72 Q(.)-.65
1608
/F0 10/Times-Roman@0 SF(The pax interchange \214le format is ne)0 12 Q
1609
2.5(ww)-.25 G(ith)-2.5 E(IEEE Std 1003.1-2001 \(`)2.5 24 Q
1610
(`<font size="-1">POSIX</font>.1')-.74 E('\) .)-.74 E(<h3 id="HIST)36 36
1611
Q(OR)-.18 E(Y">)-.65 E(HIST)36 48 Q(OR)-.18 E(Y)-.65 E(</h3>)36 60 Q(A)0
1617
/F0 10/Times-Roman@0 SF(<b>tar</b>)0 12 Q(command appeared in Se)0 24 Q
1618
-.15(ve)-.25 G(nth Edition Unix, which w).15 E(as released in January)
1619
-.1 E 2.5(,1)-.65 G(979.)-2.5 E(It replaced the)0 36 Q(<b>tp</b>)0 48 Q
1620
(program from F)0 60 Q(ourth Edition Unix which in turn replaced the)
1621
-.15 E(<b>tap</b>)0 72 Q 0 Cg EP
1626
/F0 10/Times-Roman@0 SF(program from First Edition Unix.)0 12 Q
1627
(John Gilmore')0 24 Q(s)-.55 E(<b>pdtar</b>)0 36 Q
1628
(public-domain implementation \(circa 1987\) w)0 48 Q
1629
(as highly in\215uential)-.1 E(and formed the basis of)0 60 Q
1630
(<b>GNU</b><b>tar</b>)0 72 Q 0 Cg EP
1635
/F0 10/Times-Roman@0 SF(\(circa 1988\).)0 12 Q(Joer)0 24 Q 2.5(gS)-.18 G
1636
(hilling')-2.5 E(s)-.55 E(<b>star</b>)0 36 Q(archi)0 48 Q -.15(ve)-.25 G
1637
2.5(ri).15 G 2.5(sa)-2.5 G(nother open-source \(GPL\) archi)-2.5 E -.15
1638
(ve)-.25 G 2.5(r\().15 G(originally de)-2.5 E -.15(ve)-.25 G(loped).15 E
1639
(circa 1985\) which features complete support for pax interchange)0 60 Q
1640
(format.)0 72 Q 0 Cg EP
1645
/F0 10/Times-Roman@0 SF(<p>)36 12 Q(This documentation w)0 24 Q
1646
(as written as part of the)-.1 E(<b>libarchi)0 36 Q -.15(ve)-.25 G(</b>)
1647
.15 E(and)0 48 Q(<b>bsdtar</b>)0 60 Q(project by)0 72 Q 0 Cg EP
1652
/F0 10/Times-Roman@0 SF -.35(Ti)0 12 S 2.5(mK).35 G
1653
(ientzle <kientzle@FreeBSD.or)-2.5 E(g><br>.)-.18 E(</body>)0 24 Q
1654
(</html>)0 36 Q 0 Cg EP