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 libarchi)74.5 48 Q -.15(ve)-.25 G(-formats 5).15 E
229
(</title>)36 72 Q 0 Cg EP
234
/F0 10/Times-Roman@0 SF(<style type="te)36 12 Q(xt/css">)-.15 E(<!--)36
235
24 Q(body { mar)72 36 Q(gin-left:4%; })-.18 E(H1, H2, H3, H4, H5 {)72 48
236
Q(color: maroon; padding: 4pt; mar)108 60 Q(gin-left: -4%;)-.18 E
237
(border: solid; border)108 72 Q(-width: thin; width: 100%;)-.2 E 0 Cg EP
242
/F0 10/Times-Roman@0 SF(background: r)108 12 Q(gb\(204,204,255\))-.18 E
243
(})72 24 Q(-->)36 36 Q(</style>)36 48 Q(</head>)0 60 Q
244
(<body bgcolor="#FFFFFF" te)0 72 Q(xt="#000000">)-.15 E 0 Cg EP
249
/F0 10/Times-Roman@0 SF(<h3 id="N)36 12 Q(AME">)-.35 E -.35(NA)36 24 S
250
(ME).35 E(</h3>)36 36 Q(<b>libarchi)0 48 Q -.15(ve)-.25 G(-formats</b>)
251
.15 E 2.5(-a)0 60 S(rchi)-2.5 E .3 -.15(ve f)-.25 H
252
(ormats supported by the libarchi).15 E .3 -.15(ve l)-.25 H(ibrary).15 E
253
(<h3 id="DESCRIPTION">)36 72 Q 0 Cg EP
258
/F0 10/Times-Roman@0 SF(DESCRIPTION)36 12 Q(</h3>)36 24 Q(The)0 36 Q
259
(<a href="../html3/libarchi)0 48 Q -.15(ve)-.25 G(.html">libarchi).15 E
260
-.15(ve)-.25 G(\(3\)</a>).15 E(library reads and writes a v)0 60 Q
261
(ariety of streaming archi)-.25 E .3 -.15(ve f)-.25 H(ormats.).15 E
262
(Generally speaking, all of these archi)0 72 Q .3 -.15(ve f)-.25 H
263
(ormats consist of a series of).15 E 0 Cg EP
268
/F0 10/Times-Roman@0 SF -.74(``)0 12 S(entries').74 E('.)-.74 E(Each en\
269
try stores a single \214le system object, such as a \214le, directory)0
270
24 Q(,)-.65 E(or symbolic link.)0 36 Q(<p>)36 48 Q(The follo)0 60 Q
271
(wing pro)-.25 E(vides a brief description of each format supported)-.15
272
E(by libarchi)0 72 Q -.15(ve)-.25 G 2.5(,w).15 G
273
(ith some information about recognized e)-2.5 E(xtensions or)-.15 E 0 Cg
279
/F0 10/Times-Roman@0 SF(limitations of the current library support.)0 12
280
Q(Note that just because a format is supported by libarchi)0 24 Q .3
281
-.15(ve d)-.25 H(oes not).15 E(imply that a program that uses libarchi)0
282
36 Q .3 -.15(ve w)-.25 H(ill support that format.).15 E
283
(Applications that use libarchi)0 48 Q .3 -.15(ve s)-.25 H
284
(pecify which formats the).15 E 2.5(yw)-.15 G(ish)-2.5 E
285
(to support, though man)0 60 Q 2.5(yp)-.15 G(rograms do use libarchi)
286
-2.5 E .3 -.15(ve c)-.25 H(on).15 E -.15(ve)-.4 G(nience).15 E
287
(functions to enable all supported formats.)0 72 Q 0 Cg EP
292
/F0 10/Times-Roman@0 SF(<h4 id="T)36 12 Q(ar F)-.8 E(ormats">)-.15 E -.8
293
(Ta)36 24 S 2.5(rF).8 G(ormats)-2.65 E(</h4>)36 36 Q(The)0 48 Q
294
(<a href="../html3/libarchi)0 60 Q -.15(ve)-.25 G(.html">libarchi).15 E
295
-.15(ve)-.25 G(\(3\)</a>).15 E(library can read most tar archi)0 72 Q
296
-.15(ve)-.25 G(s.).15 E 0 Cg EP
301
/F0 10/Times-Roman@0 SF(Ho)0 12 Q(we)-.25 E -.15(ve)-.25 G .8 -.4(r, i)
302
.15 H 2.5(to).4 G(nly writes POSIX-standard)-2.5 E -.74(``)0 24 S
303
(ustar').74 E(')-.74 E(and)0 36 Q -.74(``)0 48 S(pax interchange').74 E
304
(')-.74 E(formats.)0 60 Q(<p>)36 72 Q 0 Cg EP
309
/F0 10/Times-Roman@0 SF
310
(All tar formats store each entry in one or more 512-byte records.)0 12
311
Q(The \214rst record is used for \214le metadata, including \214lename,)
313
(timestamp, and mode information, and the \214le data is stored in)0 36
314
Q(subsequent records.)0 48 Q(Later v)0 60 Q(ariants ha)-.25 E .3 -.15
315
(ve ex)-.2 H(tended this by either appropriating unde\214ned).15 E
316
(areas of the header record, e)0 72 Q
317
(xtending the header to multiple records,)-.15 E 0 Cg EP
322
/F0 10/Times-Roman@0 SF
323
(or by storing special entries that modify the interpretation of)0 12 Q
324
(subsequent entries.)0 24 Q(<p>)36 36 Q(<dl compact>)0 48 Q
325
(<p><dt><b></b><b>gnutar</b><dd>)0 60 Q(The)0 72 Q 0 Cg EP
330
/F0 10/Times-Roman@0 SF(<a href="../html3/libarchi)0 12 Q -.15(ve)-.25 G
331
(.html">libarchi).15 E -.15(ve)-.25 G(\(3\)</a>).15 E
332
(library can read GNU-format tar archi)0 24 Q -.15(ve)-.25 G(s.).15 E
333
(It currently supports the most popular GNU e)0 36 Q
334
(xtensions, including)-.15 E(modern long \214lename and linkname suppor\
335
t, as well as atime and ctime data.)0 48 Q(The libarchi)0 60 Q .3 -.15
336
(ve l)-.25 H(ibrary does not support multi-v).15 E(olume)-.2 E(archi)0
337
72 Q -.15(ve)-.25 G(s, nor the old GNU long \214lename format.).15 E 0
343
/F0 10/Times-Roman@0 SF
344
(It can read GNU sparse \214le entries, including the ne)0 12 Q 2.5(wP)
345
-.25 G(OSIX-based)-2.5 E(formats, b)0 24 Q
346
(ut cannot write GNU sparse \214le entries.)-.2 E
347
(<p><dt><b></b><b>pax</b><dd>)0 36 Q(The)0 48 Q
348
(<a href="../html3/libarchi)0 60 Q -.15(ve)-.25 G(.html">libarchi).15 E
349
-.15(ve)-.25 G(\(3\)</a>).15 E
350
(library can read and write POSIX-compliant pax interchange format)0 72
356
/F0 10/Times-Roman@0 SF(archi)0 12 Q -.15(ve)-.25 G(s.).15 E -.15(Pa)0
357
24 S 2.5(xi).15 G(nterchange format archi)-2.5 E -.15(ve)-.25 G 2.5(sa)
358
.15 G(re an e)-2.5 E(xtension of the older ustar)-.15 E
359
(format that adds a separate entry with additional attrib)0 36 Q
360
(utes stored)-.2 E(as k)0 48 Q -.15(ey)-.1 G(/v).15 E
361
(alue pairs immediately before each re)-.25 E(gular entry)-.15 E(.)-.65
362
E(The presence of these additional entries is the only dif)0 60 Q
363
(ference between)-.25 E
364
(pax interchange format and the older ustar format.)0 72 Q 0 Cg EP
369
/F0 10/Times-Roman@0 SF(The e)0 12 Q(xtended attrib)-.15 E
370
(utes are of unlimited length and are stored)-.2 E
371
(as UTF-8 Unicode strings.)0 24 Q -2.15 -.25(Ke y)0 36 T -.1(wo).25 G
372
(rds de\214ned in the standard are in all lo).1 E(wercase; v)-.25 E
373
(endors are allo)-.15 E(wed)-.25 E(to de\214ne custom k)0 48 Q -.15(ey)
374
-.1 G 2.5(sb).15 G 2.5(yp)-2.5 G(receding them with the v)-2.5 E
375
(endor name in all uppercase.)-.15 E(When writing pax archi)0 60 Q -.15
376
(ve)-.25 G(s, libarchi).15 E .3 -.15(ve u)-.25 H(ses man).15 E 2.5(yo)
377
-.15 G 2.5(ft)-2.5 G(he SCHIL)-2.5 E 2.5(Yk)-1 G -.15(ey)-2.6 G(s).15 E
378
(de\214ned by Joer)0 72 Q 2.5(gS)-.18 G(chilling')-2.5 E(s)-.55 E 0 Cg
384
/F0 10/Times-Roman@0 SF -.74(``)0 12 S(star').74 E(')-.74 E(archi)0 24 Q
385
-.15(ve)-.25 G 2.5(ra).15 G(nd a fe)-2.5 E 2.5(wL)-.25 G(IB)-2.5 E
386
(ARCHIVE k)-.35 E -.15(ey)-.1 G(s.).15 E(The libarchi)0 36 Q .3 -.15
387
(ve l)-.25 H(ibrary can read most of the SCHIL).15 E 2.5(Yk)-1 G -.15
388
(ey)-2.6 G(s).15 E(and most of the GNU k)0 48 Q -.15(ey)-.1 G 2.5(si).15
389
G(ntroduced by GNU tar)-2.5 E(.)-.55 E(It silently ignores an)0 60 Q 2.5
390
(yk)-.15 G -.15(ey)-2.6 G -.1(wo).15 G(rds that it does not understand.)
391
.1 E(<p><dt><b></b><b>restricted</b><b> pax</b><dd>)0 72 Q 0 Cg EP
396
/F0 10/Times-Roman@0 SF(The libarchi)0 12 Q .3 -.15(ve l)-.25 H
397
(ibrary can also write pax archi).15 E -.15(ve)-.25 G 2.5(si).15 G 2.5
398
(nw)-2.5 G(hich it)-2.5 E(attempts to suppress the e)0 24 Q
399
(xtended attrib)-.15 E(utes entry whene)-.2 E -.15(ve)-.25 G(r).15 E
400
(possible.)0 36 Q(The result will be identical to a ustar archi)0 48 Q
401
.3 -.15(ve u)-.25 H(nless the).15 E -.15(ex)0 60 S(tended attrib).15 E
402
(utes entry is required to store a long \214le)-.2 E
403
(name, long linkname, e)0 72 Q(xtended A)-.15 E
404
(CL, \214le \215ags, or if an)-.4 E 2.5(yo)-.15 G 2.5(ft)-2.5 G
405
(he standard)-2.5 E 0 Cg EP
410
/F0 10/Times-Roman@0 SF
411
(ustar data \(user name, group name, UID, GID, etc\) cannot be fully)0
412
12 Q(represented in the ustar header)0 24 Q(.)-.55 E
413
(In all cases, the result can be dearchi)0 36 Q -.15(ve)-.25 G 2.5(db)
414
.15 G 2.5(ya)-2.5 G .3 -.15(ny p)-2.5 H(rogram that).15 E
415
(can read POSIX-compliant pax interchange format archi)0 48 Q -.15(ve)
416
-.25 G(s.).15 E(Programs that correctly read ustar format \(see belo)0
417
60 Q(w\) will also be)-.25 E(able to read this format; an)0 72 Q 2.5(ye)
418
-.15 G(xtended attrib)-2.65 E(utes will be e)-.2 E(xtracted as)-.15 E 0
424
/F0 10/Times-Roman@0 SF(separate \214les stored in)0 12 Q
425
(<code></code><code>P)0 24 Q(axHeader</code>)-.15 E(directories.)0 36 Q
426
(<p><dt><b></b><b>ustar</b><dd>)0 48 Q(The libarchi)0 60 Q .3 -.15(ve l)
427
-.25 H(ibrary can both read and write this format.).15 E
428
(This format has the follo)0 72 Q(wing limitations:)-.25 E 0 Cg EP
433
/F0 10/Times-Roman@0 SF(<ul>)0 12 Q(<li>)0 24 Q(De)0 36 Q
434
(vice major and minor numbers are limited to 21 bits.)-.25 E
435
(Nodes with lar)0 48 Q(ger numbers will not be added to the archi)-.18 E
436
-.15(ve)-.25 G(.).15 E(<li>)0 60 Q -.15(Pa)0 72 S(th names in the archi)
437
.15 E .3 -.15(ve a)-.25 H(re limited to 255 bytes.).15 E 0 Cg EP
442
/F0 10/Times-Roman@0 SF(\(Shorter if there is no / character in e)0 12 Q
443
(xactly the right place.\))-.15 E(<li>)0 24 Q
444
(Symbolic links and hard links are stored in the archi)0 36 Q .3 -.15
445
(ve w)-.25 H(ith).15 E(the name of the referenced \214le.)0 48 Q
446
(This name is limited to 100 bytes.)0 60 Q(<li>)0 72 Q 0 Cg EP
451
/F0 10/Times-Roman@0 SF(Extended attrib)0 12 Q
452
(utes, \214le \215ags, and other e)-.2 E(xtended)-.15 E
453
(security information cannot be stored.)0 24 Q(<li>)0 36 Q(Archi)0 48 Q
454
.3 -.15(ve e)-.25 H(ntries are limited to 8 gig).15 E(abytes in size.)
456
(Note that the pax interchange format has none of these restrictions.)0
462
/F0 10/Times-Roman@0 SF(</dl>)0 12 Q(<p>)36 24 Q(The libarchi)0 36 Q .3
463
-.15(ve l)-.25 H(ibrary also reads a v).15 E(ariety of commonly-used e)
464
-.25 E(xtensions to)-.15 E(the basic tar format.)0 48 Q(These e)0 60 Q
465
(xtensions are recognized automatically whene)-.15 E -.15(ve)-.25 G 2.5
466
(rt).15 G(he)-2.5 E 2.5(ya)-.15 G(ppear)-2.5 E(.)-.55 E(<dl compact>)0
472
/F0 10/Times-Roman@0 SF(<p><dt>Numeric e)0 12 Q(xtensions.<dd>)-.15 E
473
(The POSIX standards require \214x)0 24 Q
474
(ed-length numeric \214elds to be written with)-.15 E
475
(some character position reserv)0 36 Q(ed for terminators.)-.15 E
476
(Libarchi)0 48 Q .3 -.15(ve a)-.25 H(llo).15 E
477
(ws these \214elds to be written without terminator characters.)-.25 E
478
(This e)0 60 Q(xtends the allo)-.15 E -.1(wa)-.25 G
479
(ble range; in particular).1 E 2.5(,u)-.4 G(star archi)-2.5 E -.15(ve)
480
-.25 G 2.5(sw).15 G(ith this)-2.5 E -.15(ex)0 72 S
481
(tension can support entries up to 64 gig).15 E(abytes in size.)-.05 E 0
487
/F0 10/Times-Roman@0 SF(Libarchi)0 12 Q .3 -.15(ve a)-.25 H
488
(lso recognizes base-256 v).15 E(alues in most numeric \214elds.)-.25 E
489
(This essentially remo)0 24 Q -.15(ve)-.15 G 2.5(sa).15 G
490
(ll limitations on \214le size, modi\214cation time,)-2.5 E(and de)0 36
491
Q(vice numbers.)-.25 E(<p><dt>Solaris e)0 48 Q(xtensions<dd>)-.15 E
492
(Libarchi)0 60 Q .3 -.15(ve r)-.25 H(ecognizes A).15 E(CL and e)-.4 E
493
(xtended attrib)-.15 E(ute records written)-.2 E(by Solaris tar)0 72 Q
499
/F0 10/Times-Roman@0 SF(Currently)0 12 Q 2.5(,l)-.65 G(ibarchi)-2.5 E .3
500
-.15(ve o)-.25 H(nly has support for old-style A).15 E(CLs; the)-.4 E
501
(ne)0 24 Q(wer NFSv4 A)-.25 E(CLs are recognized b)-.4 E(ut discarded.)
502
-.2 E(</dl>)0 36 Q(<p>)36 48 Q(The \214rst tar program appeared in Se)0
503
60 Q -.15(ve)-.25 G(nth Edition Unix in 1979.).15 E(The \214rst of)0 72
504
Q(\214cial standard for the tar \214le format w)-.25 E(as the)-.1 E 0 Cg
510
/F0 10/Times-Roman@0 SF -.74(``)0 12 S(ustar').74 E(')-.74 E
511
(\(Unix Standard T)0 24 Q(ar\) format de\214ned by POSIX in 1988.)-.8 E
512
(POSIX.1-2001 e)0 36 Q(xtended the ustar format to create the)-.15 E
513
-.74(``)0 48 S(pax interchange').74 E(')-.74 E(format.)0 60 Q
514
(<h4 id="Cpio F)36 72 Q(ormats">)-.15 E 0 Cg EP
519
/F0 10/Times-Roman@0 SF(Cpio F)36 12 Q(ormats)-.15 E(</h4>)36 24 Q
520
(The libarchi)0 36 Q .3 -.15(ve l)-.25 H
521
(ibrary can read a number of common cpio v).15 E(ariants and can write)
522
-.25 E -.74(``)0 48 S(odc').74 E(')-.74 E(and)0 60 Q -.74(``)0 72 S(ne)
523
.74 E(wc')-.25 E(')-.74 E 0 Cg EP
528
/F0 10/Times-Roman@0 SF(format archi)0 12 Q -.15(ve)-.25 G(s.).15 E 2.5
529
(Ac)0 24 S(pio archi)-2.5 E .3 -.15(ve s)-.25 H
530
(tores each entry as a \214x).15 E(ed-size header follo)-.15 E(wed)-.25
531
E(by a v)0 36 Q(ariable-length \214lename and v)-.25 E
532
(ariable-length data.)-.25 E(Unlik)0 48 Q 2.5(et)-.1 G
533
(he tar format, the cpio format does only minimal padding)-2.5 E
534
(of the header or \214le data.)0 60 Q(There are se)0 72 Q -.15(ve)-.25 G
535
(ral cpio v).15 E(ariants, which dif)-.25 E(fer primarily in)-.25 E 0 Cg
541
/F0 10/Times-Roman@0 SF(ho)0 12 Q 2.5(wt)-.25 G(he)-2.5 E 2.5(ys)-.15 G
542
(tore the initial header: some store the v)-2.5 E(alues as)-.25 E
543
(octal or he)0 24 Q(xadecimal numbers in ASCII, others as binary v)-.15
544
E(alues of)-.25 E -.25(va)0 36 S(rying byte order and length.).25 E
545
(<dl compact>)0 48 Q(<p><dt><b></b><b>binary</b><dd>)0 60 Q
546
(The libarchi)0 72 Q .3 -.15(ve l)-.25 H
547
(ibrary transparently reads both big-endian and little-endian).15 E 0 Cg
553
/F0 10/Times-Roman@0 SF -.25(va)0 12 S
554
(riants of the original binary cpio format.).25 E
555
(This format used 32-bit binary v)0 24 Q
556
(alues for \214le size and mtime,)-.25 E(and 16-bit binary v)0 36 Q
557
(alues for the other \214elds.)-.25 E(<p><dt><b></b><b>odc</b><dd>)0 48
558
Q(The libarchi)0 60 Q .3 -.15(ve l)-.25 H
559
(ibrary can both read and write this).15 E
560
(POSIX-standard format, which is of)0 72 Q(\214cially kno)-.25 E
561
(wn as the)-.25 E 0 Cg EP
566
/F0 10/Times-Roman@0 SF -.74(``)0 12 S(cpio interchange format').74 E(')
567
-.74 E(or the)0 24 Q -.74(``)0 36 S(octet-oriented cpio archi).74 E .3
568
-.15(ve f)-.25 H(ormat').15 E(')-.74 E(and sometimes unof)0 48 Q
569
(\214cially referred to as the)-.25 E -.74(``)0 60 S
570
(old character format').74 E('.)-.74 E
571
(This format stores the header contents as octal v)0 72 Q
572
(alues in ASCII.)-.25 E 0 Cg EP
577
/F0 10/Times-Roman@0 SF
578
(It is standard, portable, and immune from byte-order confusion.)0 12 Q
579
(File sizes and mtime are limited to 33 bits \(8GB \214le size\),)0 24 Q
580
(other \214elds are limited to 18 bits.)0 36 Q
581
(<p><dt><b></b><b>SVR4</b><dd>)0 48 Q(The libarchi)0 60 Q .3 -.15(ve l)
582
-.25 H(ibrary can read both CRC and non-CRC v).15 E(ariants of)-.25 E
583
(this format.)0 72 Q 0 Cg EP
588
/F0 10/Times-Roman@0 SF(The SVR4 format uses eight-digit he)0 12 Q
589
(xadecimal v)-.15 E(alues for)-.25 E(all header \214elds.)0 24 Q
590
(This limits \214le size to 4GB, and also limits the mtime and)0 36 Q
591
(other \214elds to 32 bits.)0 48 Q
592
(The SVR4 format can optionally include a CRC of the \214le)0 60 Q
593
(contents, although libarchi)0 72 Q .3 -.15(ve d)-.25 H
594
(oes not currently v).15 E(erify this CRC.)-.15 E 0 Cg EP
599
/F0 10/Times-Roman@0 SF(</dl>)0 12 Q(<p>)36 24 Q
600
(Cpio \214rst appeared in PWB/UNIX 1.0, which w)0 36 Q
601
(as released within)-.1 E -1.11(AT)0 48 S(&T in 1977.)1.11 E
602
(PWB/UNIX 1.0 formed the basis of System III Unix, released outside)0 60
603
Q(of A)0 72 Q(T&T in 1981.)-1.11 E 0 Cg EP
608
/F0 10/Times-Roman@0 SF(This mak)0 12 Q(es cpio older than tar)-.1 E 2.5
609
(,a)-.4 G(lthough cpio w)-2.5 E(as not included)-.1 E(in V)0 24 Q
610
(ersion 7 A)-1.11 E(T&T Unix.)-1.11 E
611
(As a result, the tar command became much better kno)0 36 Q(wn in uni)
612
-.25 E -.15(ve)-.25 G(rsities).15 E(and research groups that used V)0 48
613
Q(ersion 7.)-1.11 E(The combination of the)0 60 Q(<b>\214nd</b>)0 72 Q 0
619
/F0 10/Times-Roman@0 SF(and)0 12 Q(<b>cpio</b>)0 24 Q(utilities pro)0 36
620
Q(vided v)-.15 E(ery precise control o)-.15 E -.15(ve)-.15 G 2.5<728c>
621
.15 G(le selection.)-2.5 E(Unfortunately)0 48 Q 2.5(,t)-.65 G
622
(he format has man)-2.5 E 2.5(yl)-.15 G(imitations that mak)-2.5 E 2.5
623
(ei)-.1 G 2.5(tu)-2.5 G(nsuitable)-2.5 E(for widespread use.)0 60 Q
624
(Only the POSIX format permits \214les o)0 72 Q -.15(ve)-.15 G 2.5(r4)
625
.15 G(GB, and its 18-bit)-2.5 E 0 Cg EP
630
/F0 10/Times-Roman@0 SF(limit for most other \214elds mak)0 12 Q
631
(es it unsuitable for modern systems.)-.1 E
632
(In addition, cpio formats only store numeric UID/GID v)0 24 Q
633
(alues \(not)-.25 E(usernames and group names\), which can mak)0 36 Q
634
2.5(ei)-.1 G 2.5(tv)-2.5 G(ery dif)-2.65 E(\214cult to correctly)-.25 E
635
(transfer archi)0 48 Q -.15(ve)-.25 G 2.5(sa).15 G
636
(cross systems with dissimilar user numbering.)-2.5 E(<h4 id="Shar F)36
637
60 Q(ormats">)-.15 E(Shar F)36 72 Q(ormats)-.15 E 0 Cg EP
642
/F0 10/Times-Roman@0 SF(</h4>)36 12 Q(A)0 24 Q -.74(``)0 36 S
643
(shell archi).74 E -.15(ve)-.25 G -.74('').15 G
644
(is a shell script that, when e)0 48 Q -.15(xe)-.15 G
645
(cuted on a POSIX-compliant).15 E
646
(system, will recreate a collection of \214le system objects.)0 60 Q
647
(The libarchi)0 72 Q .3 -.15(ve l)-.25 H(ibrary can write tw).15 E 2.5
648
(od)-.1 G(if)-2.5 E(ferent kinds of shar archi)-.25 E -.15(ve)-.25 G(s:)
654
/F0 10/Times-Roman@0 SF(<dl compact>)0 12 Q
655
(<p><dt><b></b><b>shar</b><dd>)0 24 Q
656
(The traditional shar format uses a limited set of POSIX)0 36 Q
657
(commands, including)0 48 Q(<a href="../html1/echo.html">echo\(1\)</a>,)
658
0 60 Q(<a href="../html1/mkdir)0 72 Q(.html">mkdir\(1\)</a>,)-.55 E 0 Cg
664
/F0 10/Times-Roman@0 SF(and)0 12 Q
665
(<a href="../html1/sed.html">sed\(1\)</a>.)0 24 Q
666
(It is suitable for portably archi)0 36 Q
667
(ving small collections of plain te)-.25 E(xt \214les.)-.15 E(Ho)0 48 Q
668
(we)-.25 E -.15(ve)-.25 G .8 -.4(r, i).15 H 2.5(ti).4 G 2.5(sn)-2.5 G
669
(ot generally well-suited for lar)-2.5 E(ge archi)-.18 E -.15(ve)-.25 G
670
(s).15 E(\(man)0 60 Q 2.5(yi)-.15 G(mplementations of)-2.5 E
671
(<a href="../html1/sh.html">sh\(1\)</a>)0 72 Q 0 Cg EP
676
/F0 10/Times-Roman@0 SF(ha)0 12 Q .3 -.15(ve l)-.2 H
677
(imits on the size of a script\) nor should it be used with non-te).15 E
678
(xt \214les.)-.15 E(<p><dt><b></b><b>shardump</b><dd>)0 24 Q
679
(This format is similar to shar b)0 36 Q(ut encodes \214les using)-.2 E
680
(<a href="../html1/uuencode.html">uuencode\(1\)</a>)0 48 Q
681
(so that the result will be a plain te)0 60 Q(xt \214le re)-.15 E -.05
682
(ga)-.15 G(rdless of the \214le contents.).05 E(It also includes additi\
683
onal shell commands that attempt to reproduce as)0 72 Q 0 Cg EP
688
/F0 10/Times-Roman@0 SF(man)0 12 Q 2.5<798c>-.15 G(le attrib)-2.5 E
689
(utes as possible, including o)-.2 E(wner)-.25 E 2.5(,m)-.4 G
690
(ode, and \215ags.)-2.5 E
691
(The additional commands used to restore \214le attrib)0 24 Q(utes mak)
692
-.2 E(e)-.1 E(shardump archi)0 36 Q -.15(ve)-.25 G 2.5(sl).15 G
693
(ess portable than plain shar archi)-2.5 E -.15(ve)-.25 G(s.).15 E
694
(</dl>)0 48 Q(<h4 id="ISO9660 format">)36 60 Q(ISO9660 format)36 72 Q 0
700
/F0 10/Times-Roman@0 SF(</h4>)36 12 Q(Libarchi)0 24 Q .3 -.15(ve c)-.25
701
H(an read and e).15 E(xtract from \214les containing ISO9660-compliant)
702
-.15 E(CDR)0 36 Q(OM images.)-.4 E(In man)0 48 Q 2.5(yc)-.15 G
703
(ases, this can remo)-2.5 E .3 -.15(ve t)-.15 H(he need to b).15 E
704
(urn a ph)-.2 E(ysical CDR)-.05 E(OM)-.4 E
705
(just in order to read the \214les contained in an ISO9660 image.)0 60 Q
706
(It also a)0 72 Q -.2(vo)-.2 G(ids security and comple).2 E
707
(xity issues that come with)-.15 E 0 Cg EP
712
/F0 10/Times-Roman@0 SF(virtual mounts and loopback de)0 12 Q(vices.)
713
-.25 E(Libarchi)0 24 Q .3 -.15(ve s)-.25 H
714
(upports the most common Rockridge e).15 E(xtensions and has partial)
715
-.15 E(support for Joliet e)0 36 Q(xtensions.)-.15 E(If both e)0 48 Q
716
(xtensions are present, the Joliet e)-.15 E(xtensions will be)-.15 E
717
(used and the Rockridge e)0 60 Q(xtensions will be ignored.)-.15 E
718
(In particular)0 72 Q 2.5(,t)-.4 G
719
(his can create problems with hardlinks and symlinks,)-2.5 E 0 Cg EP
724
/F0 10/Times-Roman@0 SF(which are supported by Rockridge b)0 12 Q
725
(ut not by Joliet.)-.2 E(<h4 id="Zip format">)36 24 Q(Zip format)36 36 Q
726
(</h4>)36 48 Q(Libarchi)0 60 Q .3 -.15(ve c)-.25 H
727
(an read and write zip format archi).15 E -.15(ve)-.25 G 2.5(st).15 G
728
(hat ha)-2.5 E -.15(ve)-.2 G
729
(uncompressed entries and entries compressed with the)0 72 Q 0 Cg EP
734
/F0 10/Times-Roman@0 SF -.74(``)0 12 S(de\215ate').74 E(')-.74 E
735
(algorithm.)0 24 Q(Older zip compression algorithms are not supported.)0
736
36 Q(It can e)0 48 Q(xtract jar archi)-.15 E -.15(ve)-.25 G(s, archi).15
737
E -.15(ve)-.25 G 2.5(st).15 G(hat use Zip64 e)-2.5 E(xtensions and man)
738
-.15 E(y)-.15 E(self-e)0 60 Q(xtracting zip archi)-.15 E -.15(ve)-.25 G
739
(s.).15 E(Libarchi)0 72 Q .3 -.15(ve r)-.25 H(eads Zip archi).15 E -.15
740
(ve)-.25 G 2.5(sa).15 G 2.5(st)-2.5 G(he)-2.5 E 2.5(ya)-.15 G
741
(re being streamed,)-2.5 E 0 Cg EP
746
/F0 10/Times-Roman@0 SF(which allo)0 12 Q(ws it to read archi)-.25 E
747
-.15(ve)-.25 G 2.5(so).15 G 2.5(fa)-2.5 G(rbitrary size.)-2.5 E
748
(It currently does not use the central directory; this)0 24 Q
749
(limits libarchi)0 36 Q -.15(ve)-.25 G 1.1 -.55('s a).15 H
750
(bility to support some self-e).55 E(xtracting)-.15 E(archi)0 48 Q -.15
751
(ve)-.25 G 2.5(sa).15 G(nd ones that ha)-2.5 E .3 -.15(ve b)-.2 H
752
(een modi\214ed in certain w).15 E(ays.)-.1 E(<h4 id="Archi)36 60 Q .3
753
-.15(ve \()-.25 H(library\) \214le format">).15 E(Archi)36 72 Q .3 -.15
754
(ve \()-.25 H(library\) \214le format).15 E 0 Cg EP
759
/F0 10/Times-Roman@0 SF(</h4>)36 12 Q(The Unix archi)0 24 Q .3 -.15
760
(ve f)-.25 H(ormat \(commonly created by the).15 E(<a href="../html1/ar)
761
0 36 Q(.html">ar\(1\)</a>)-.55 E(archi)0 48 Q -.15(ve)-.25 G
762
(r\) is a general-purpose format which is).15 E(used almost e)0 60 Q
763
(xclusi)-.15 E -.15(ve)-.25 G(ly for object \214les to be).15 E
764
(read by the link editor)0 72 Q 0 Cg EP
769
/F0 10/Times-Roman@0 SF(<a href="../html1/ld.html">ld\(1\)</a>.)0 12 Q
770
(The ar format has ne)0 24 Q -.15(ve)-.25 G 2.5(rb).15 G
771
(een standardised.)-2.5 E(There are tw)0 36 Q 2.5(oc)-.1 G(ommon v)-2.5
772
E(ariants:)-.25 E(the GNU format deri)0 48 Q -.15(ve)-.25 G 2.5(df).15 G
773
(rom SVR4,)-2.5 E(and the BSD format, which \214rst appeared in 4.4BSD.)
774
0 60 Q(The tw)0 72 Q 2.5(od)-.1 G(if)-2.5 E
775
(fer primarily in their handling of \214lenames)-.25 E 0 Cg EP
780
/F0 10/Times-Roman@0 SF(longer than 15 characters:)0 12 Q
781
(the GNU/SVR4 v)0 24 Q(ariant writes a \214lename table at the be)-.25 E
782
(ginning of the archi)-.15 E -.15(ve)-.25 G(;).15 E
783
(the BSD format stores each long \214lename in an e)0 36 Q(xtension)-.15
784
E(area adjacent to the entry)0 48 Q(.)-.65 E(Libarchi)0 60 Q .3 -.15
785
(ve c)-.25 H(an read both e).15 E(xtensions,)-.15 E(including archi)0 72
786
Q -.15(ve)-.25 G 2.5(st).15 G
787
(hat may include both types of long \214lenames.)-2.5 E 0 Cg EP
792
/F0 10/Times-Roman@0 SF(Programs using libarchi)0 12 Q .3 -.15(ve c)-.25
793
H(an write GNU/SVR4 format).15 E(if the)0 24 Q 2.5(yp)-.15 G(ro)-2.5 E
794
(vide a \214lename table to be written into)-.15 E(the archi)0 36 Q .3
795
-.15(ve b)-.25 H(efore an).15 E 2.5(yo)-.15 G 2.5(ft)-2.5 G(he entries.)
796
-2.5 E(An)0 48 Q 2.5(ye)-.15 G
797
(ntries whose names are not in the \214lename table)-2.5 E
798
(will be written using BSD-style long \214lenames.)0 60 Q
799
(This can cause problems for programs such as)0 72 Q 0 Cg EP
804
/F0 10/Times-Roman@0 SF
805
(GNU ld that do not support the BSD-style long \214lenames.)0 12 Q
806
(<h4 id="mtree">)36 24 Q(mtree)36 36 Q(</h4>)36 48 Q(Libarchi)0 60 Q .3
807
-.15(ve c)-.25 H(an read and write \214les in).15 E
808
(<a href="../html5/mtree.html">mtree\(5\)</a>)0 72 Q 0 Cg EP
813
/F0 10/Times-Roman@0 SF(format.)0 12 Q(This format is not a true archi)0
814
24 Q .3 -.15(ve f)-.25 H(ormat, b).15 E(ut rather a te)-.2 E
815
(xtual description)-.15 E(of a \214le hierarch)0 36 Q 2.5(yi)-.05 G 2.5
816
(nw)-2.5 G(hich each line speci\214es the name of a \214le and)-2.5 E
817
(pro)0 48 Q(vides speci\214c metadata about that \214le.)-.15 E
818
(Libarchi)0 60 Q .3 -.15(ve c)-.25 H(an read all of the k).15 E -.15(ey)
819
-.1 G -.1(wo).15 G(rds supported by both).1 E(the NetBSD and FreeBSD v)0
820
72 Q(ersions of)-.15 E 0 Cg EP
825
/F0 10/Times-Roman@0 SF(<a href="../html1/mtree.html">mtree\(1\)</a>,)0
826
12 Q(although man)0 24 Q 2.5(yo)-.15 G 2.5(ft)-2.5 G(he k)-2.5 E -.15
827
(ey)-.1 G -.1(wo).15 G(rds cannot currently be stored in an).1 E
828
(<font size="-1"></font><font size="-1">archi)0 36 Q -.15(ve)-.25 G
829
(_entry</font>).15 E(object.)0 48 Q(When writing, libarchi)0 60 Q .3
830
-.15(ve s)-.25 H(upports use of the).15 E(<a href="../html3/archi)0 72 Q
831
-.15(ve)-.25 G(_write_set_options.html">archi).15 E -.15(ve)-.25 G
832
(_write_set_options\(3\)</a>).15 E 0 Cg EP
837
/F0 10/Times-Roman@0 SF(interf)0 12 Q(ace to specify which k)-.1 E -.15
838
(ey)-.1 G -.1(wo).15 G(rds should be included in the).1 E(output.)0 24 Q
839
(If libarchi)0 36 Q .3 -.15(ve w)-.25 H
840
(as compiled with access to suitable).05 E
841
(cryptographic libraries \(such as the OpenSSL libraries\),)0 48 Q
842
(it can compute hash entries such as)0 60 Q(<b></b><b>sha512</b>)0 72 Q
848
/F0 10/Times-Roman@0 SF(or)0 12 Q(<b></b><b>md5</b>)0 24 Q
849
(from \214le data being written to the mtree writer)0 36 Q(.)-.55 E(<p>)
850
36 48 Q(When reading an mtree \214le, libarchi)0 60 Q .3 -.15(ve w)-.25
851
H(ill locate the corresponding).15 E(\214les on disk using the)0 72 Q 0
857
/F0 10/Times-Roman@0 SF(<b></b><b>contents</b>)0 12 Q -.1(ke)0 24 S(yw)
858
-.05 E(ord if present or the re)-.1 E(gular \214lename.)-.15 E
859
(If it can locate and open the \214le on disk, it will use that)0 36 Q
860
(to \214ll in an)0 48 Q 2.5(ym)-.15 G
861
(etadata that is missing from the mtree \214le)-2.5 E
862
(and will read the \214le contents and return those to the program)0 60
863
Q(using libarchi)0 72 Q -.15(ve)-.25 G(.).15 E 0 Cg EP
868
/F0 10/Times-Roman@0 SF
869
(If it cannot locate and open the \214le on disk, libarchi)0 12 Q -.15
870
(ve)-.25 G(will return an error for an)0 24 Q 2.5(ya)-.15 G
871
(ttempt to read the entry)-2.5 E(body)0 36 Q(.)-.65 E
872
(<h3 id="SEE ALSO">)36 48 Q(SEE ALSO)36 60 Q(</h3>)36 72 Q 0 Cg EP
877
/F0 10/Times-Roman@0 SF(<a href="../html1/ar)0 12 Q(.html">ar\(1\)</a>,)
878
-.55 E(<a href="../html1/cpio.html">cpio\(1\)</a>,)0 24 Q
879
(<a href="../html1/mkisofs.html">mkisofs\(1\)</a>,)0 36 Q
880
(<a href="../html1/shar)0 48 Q(.html">shar\(1\)</a>,)-.55 E
881
(<a href="../html1/tar)0 60 Q(.html">tar\(1\)</a>,)-.55 E
882
(<a href="../html1/zip.html">zip\(1\)</a>,)0 72 Q 0 Cg EP
887
/F0 10/Times-Roman@0 SF(<a href="../html3/zlib)0 12 Q
888
(.html">zlib\(3\)</a>,)-.4 E
889
(<a href="../html5/cpio.html">cpio\(5\)</a>,)0 24 Q
890
(<a href="../html5/mtree.html">mtree\(5\)</a>,)0 36 Q
891
(<a href="../html5/tar)0 48 Q(.html">tar\(5\)</a>)-.55 E(</body>)0 60 Q
892
(</html>)0 72 Q 0 Cg EP
added
removed
doc/html/libarchive-formats.5.html
