path: root/archivers/libarchive/files/doc/html/archive_write_disk.3.html

%!PS-Adobe-3.0
%%Creator: groff version 1.19.2
%%CreationDate: Sun Mar 14 02:49:16 2010
%%DocumentNeededResources: font Times-Roman
%%DocumentSuppliedResources: procset grops 1.19 2
%%Pages: 63
%%PageOrder: Ascend
%%DocumentMedia: Default 612 792 0 () ()
%%Orientation: Portrait
%%EndComments
%%BeginDefaults
%%PageMedia: Default
%%EndDefaults
%%BeginProlog
%%BeginResource: procset grops 1.19 2
%!PS-Adobe-3.0 Resource-ProcSet
/setpacking where{
pop
currentpacking
true setpacking
}if
/grops 120 dict dup begin
/SC 32 def
/A/show load def
/B{0 SC 3 -1 roll widthshow}bind def
/C{0 exch ashow}bind def
/D{0 exch 0 SC 5 2 roll awidthshow}bind def
/E{0 rmoveto show}bind def
/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
/G{0 rmoveto 0 exch ashow}bind def
/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/I{0 exch rmoveto show}bind def
/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
/K{0 exch rmoveto 0 exch ashow}bind def
/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/M{rmoveto show}bind def
/N{rmoveto 0 SC 3 -1 roll widthshow}bind def
/O{rmoveto 0 exch ashow}bind def
/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/Q{moveto show}bind def
/R{moveto 0 SC 3 -1 roll widthshow}bind def
/S{moveto 0 exch ashow}bind def
/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/SF{
findfont exch
[exch dup 0 exch 0 exch neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/MF{
findfont
[5 2 roll
0 3 1 roll
neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/level0 0 def
/RES 0 def
/PL 0 def
/LS 0 def
/MANUAL{
statusdict begin/manualfeed true store end
}bind def
/PLG{
gsave newpath clippath pathbbox grestore
exch pop add exch pop
}bind def
/BP{
/level0 save def
1 setlinecap
1 setlinejoin
72 RES div dup scale
LS{
90 rotate
}{
0 PL translate
}ifelse
1 -1 scale
}bind def
/EP{
level0 restore
showpage
}def
/DA{
newpath arcn stroke
}bind def
/SN{
transform
.25 sub exch .25 sub exch
round .25 add exch round .25 add exch
itransform
}bind def
/DL{
SN
moveto
SN
lineto stroke
}bind def
/DC{
newpath 0 360 arc closepath
}bind def
/TM matrix def
/DE{
TM currentmatrix pop
translate scale newpath 0 0 .5 0 360 arc closepath
TM setmatrix
}bind def
/RC/rcurveto load def
/RL/rlineto load def
/ST/stroke load def
/MT/moveto load def
/CL/closepath load def
/Fr{
setrgbcolor fill
}bind def
/setcmykcolor where{
pop
/Fk{
setcmykcolor fill
}bind def
}if
/Fg{
setgray fill
}bind def
/FL/fill load def
/LW/setlinewidth load def
/Cr/setrgbcolor load def
/setcmykcolor where{
pop
/Ck/setcmykcolor load def
}if
/Cg/setgray load def
/RE{
findfont
dup maxlength 1 index/FontName known not{1 add}if dict begin
{
1 index/FID ne{def}{pop pop}ifelse
}forall
/Encoding exch def
dup/FontName exch def
currentdict end definefont pop
}bind def
/DEFS 0 def
/EBEGIN{
moveto
DEFS begin
}bind def
/EEND/end load def
/CNT 0 def
/level1 0 def
/PBEGIN{
/level1 save def
translate
div 3 1 roll div exch scale
neg exch neg exch translate
0 setgray
0 setlinecap
1 setlinewidth
0 setlinejoin
10 setmiterlimit
[]0 setdash
/setstrokeadjust where{
pop
false setstrokeadjust
}if
/setoverprint where{
pop
false setoverprint
}if
newpath
/CNT countdictstack def
userdict begin
/showpage{}def
/setpagedevice{}def
}bind def
/PEND{
countdictstack CNT sub{end}repeat
level1 restore
}bind def
end def
/setpacking where{
pop
setpacking
}if
%%EndResource
%%EndProlog
%%BeginSetup
%%BeginFeature: *PageSize Default
<< /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice
%%EndFeature
%%IncludeResource: font Times-Roman
grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron
/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
/semicolon/less/equal/greater/question/at/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/Z/bracketleft/backslash/bracketright/circumflex
/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
/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft
/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl
/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen
/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft
/logicalnot/minus/registered/macron/degree/plusminus/twosuperior
/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior
/ordmasculine/guilsinglright/onequarter/onehalf/threequarters
/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE
/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex
/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn
/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla
/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis
/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash
/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def
/Times-Roman@0 ENC0/Times-Roman RE
%%EndSetup
%%Page: 1 1
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<html>)0 12 Q(<head>)0 24 Q(<title>)36 36 Q
(August 5, 2008 archi)74.5 48 Q -.15(ve)-.25 G(_write_disk 3).15 E
(</title>)36 72 Q 0 Cg EP
%%Page: 2 2
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<style type="te)36 12 Q(xt/css">)-.15 E(<!--)36
24 Q(body { mar)72 36 Q(gin-left:4%; })-.18 E(H1, H2, H3, H4, H5 {)72 48
Q(color: maroon; padding: 4pt; mar)108 60 Q(gin-left: -4%;)-.18 E
(border: solid; border)108 72 Q(-width: thin; width: 100%;)-.2 E 0 Cg EP
%%Page: 3 3
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(background: r)108 12 Q(gb\(204,204,255\))-.18 E
(})72 24 Q(-->)36 36 Q(</style>)36 48 Q(</head>)0 60 Q
(<body bgcolor="#FFFFFF" te)0 72 Q(xt="#000000">)-.15 E 0 Cg EP
%%Page: 4 4
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<h3 id="N)36 12 Q(AME">)-.35 E -.35(NA)36 24 S
(ME).35 E(</h3>)36 36 Q(<b>archi)0 48 Q -.15(ve)-.25 G(_write_disk_ne)
.15 E(w</b>,)-.25 E(<b>archi)0 60 Q -.15(ve)-.25 G
(_write_disk_set_options</b>,).15 E(<b>archi)0 72 Q -.15(ve)-.25 G
(_write_disk_set_skip_\214le</b>,).15 E 0 Cg EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>archi)0 12 Q -.15(ve)-.25 G
(_write_disk_set_group_lookup</b>,).15 E(<b>archi)0 24 Q -.15(ve)-.25 G
(_write_disk_set_standard_lookup</b>,).15 E(<b>archi)0 36 Q -.15(ve)-.25
G(_write_disk_set_user_lookup</b>,).15 E(<b>archi)0 48 Q -.15(ve)-.25 G
(_write_header</b>,).15 E(<b>archi)0 60 Q -.15(ve)-.25 G
(_write_data</b>,).15 E(<b>archi)0 72 Q -.15(ve)-.25 G
(_write_\214nish_entry</b>,).15 E 0 Cg EP
%%Page: 6 6
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>archi)0 12 Q -.15(ve)-.25 G
(_write_close</b>,).15 E(<b>archi)0 24 Q -.15(ve)-.25 G
(_write_\214nish</b>).15 E 2.5(-f)0 36 S
(unctions for creating objects on disk)-2.5 E(<h3 id="SYNOPSIS">)36 48 Q
(SYNOPSIS)36 60 Q(</h3>)36 72 Q 0 Cg EP
%%Page: 7 7
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(<br><br><code></code><code>struct</code><code> archi)0 12 Q -.15(ve)
-.25 G(</code><code> *</code>).15 E(<b>archi)0 24 Q -.15(ve)-.25 G
(_write_disk_ne).15 E(w</b>\(<code></code><code>v)-.25 E(oid</code>\))
-.2 E(<br><br><code></code><code>int</code>)0 36 Q(<b>archi)0 48 Q -.15
(ve)-.25 G(_write_disk_set_options</b>\(<code></code><code>struct archi)
.15 E .3 -.15(ve *)-.25 H(</code><code>, int \215ags</code>\)).15 E
(<br><br><code></code><code>int</code>)0 60 Q(<b>archi)0 72 Q -.15(ve)
-.25 G(_write_disk_set_skip_\214le</b>\(<code></code><code>struct archi)
.15 E .3 -.15(ve *)-.25 H(</code><code>, de).15 E
(v_t</code><code>, ino_t</code>\))-.25 E 0 Cg EP
%%Page: 8 8
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<br><br><code></code><code>int</code>)0 12 Q
(<b>archi)0 24 Q -.15(ve)-.25 G
(_write_disk_set_group_lookup</b>\(<code></code>).15 E
(<code></code><code>struct archi)0 36 Q .3 -.15(ve *)-.25 H(</code>).15
E(<code></code><code>v)0 48 Q(oid *</code>)-.2 E
(<code></code>gid_t \(*\)\(v)0 60 Q
(oid *, const char *gname, gid_t gid\))-.2 E(<code></code><code>v)0 72 Q
(oid \(*cleanup\)\(v)-.2 E(oid *\)</code>)-.2 E 0 Cg EP
%%Page: 9 9
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\))0 12 Q(<br><br><code></code><code>int</code>)
0 24 Q(<b>archi)0 36 Q -.15(ve)-.25 G
(_write_disk_set_standard_lookup</b>\(<code></code><code>struct archi)
.15 E .3 -.15(ve *)-.25 H(</code>\)).15 E
(<br><br><code></code><code>int</code>)0 48 Q(<b>archi)0 60 Q -.15(ve)
-.25 G(_write_disk_set_user_lookup</b>\(<code></code>).15 E
(<code></code><code>struct archi)0 72 Q .3 -.15(ve *)-.25 H(</code>).15
E 0 Cg EP
%%Page: 10 10
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<code></code><code>v)0 12 Q(oid *</code>)-.2 E
(<code></code>uid_t \(*\)\(v)0 24 Q
(oid *, const char *uname, uid_t uid\))-.2 E(<code></code><code>v)0 36 Q
(oid \(*cleanup\)\(v)-.2 E(oid *\)</code>)-.2 E(\))0 48 Q
(<br><br><code></code><code>int</code>)0 60 Q(<b>archi)0 72 Q -.15(ve)
-.25 G(_write_header</b>\(<code></code><code>struct archi).15 E .3 -.15
(ve *)-.25 H(</code><code>, struct archi).15 E -.15(ve)-.25 G
(_entry *</code>\)).15 E 0 Cg EP
%%Page: 11 11
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<br><br><code></code><code>ssize_t</code>)0 12 Q
(<b>archi)0 24 Q -.15(ve)-.25 G
(_write_data</b>\(<code></code><code>struct archi).15 E .3 -.15(ve *)
-.25 H(</code><code>, const v).15 E(oid *</code><code>, size_t</code>\))
-.2 E(<br><br><code></code><code>int</code>)0 36 Q(<b>archi)0 48 Q -.15
(ve)-.25 G(_write_\214nish_entry</b>\(<code></code><code>struct archi)
.15 E .3 -.15(ve *)-.25 H(</code>\)).15 E
(<br><br><code></code><code>int</code>)0 60 Q(<b>archi)0 72 Q -.15(ve)
-.25 G(_write_close</b>\(<code></code><code>struct archi).15 E .3 -.15
(ve *)-.25 H(</code>\)).15 E 0 Cg EP
%%Page: 12 12
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<br><br><code></code><code>int</code>)0 12 Q
(<b>archi)0 24 Q -.15(ve)-.25 G
(_write_\214nish</b>\(<code></code><code>struct archi).15 E .3 -.15
(ve *)-.25 H(</code>\)).15 E(<h3 id="DESCRIPTION">)36 36 Q(DESCRIPTION)
36 48 Q(</h3>)36 60 Q(These functions pro)0 72 Q
(vide a complete API for creating objects on)-.15 E 0 Cg EP
%%Page: 13 13
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(disk from)0 12 Q(<font size="-1"></font><font s\
ize="-1">struct</font><font size="-1"> archi)0 24 Q -.15(ve)-.25 G
(_entry</font>).15 E(descriptions.)0 36 Q(The)0 48 Q 2.5(ya)-.15 G
(re most naturally used when e)-2.5 E(xtracting objects from an archi)
-.15 E -.15(ve)-.25 G(using the)0 60 Q(<b>archi)0 72 Q -.15(ve)-.25 G
(_read</b>\(<code></code>\)).15 E 0 Cg EP
%%Page: 14 14
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(interf)0 12 Q(ace.)-.1 E
(The general process is to read)0 24 Q(<font size="-1"></font><font siz\
e="-1">struct</font><font size="-1"> archi)0 36 Q -.15(ve)-.25 G
(_entry</font>).15 E(objects from an archi)0 48 Q -.15(ve)-.25 G 2.5(,t)
.15 G(hen write those objects to a)-2.5 E(<font size="-1"></font><font \
size="-1">struct</font><font size="-1"> archi)0 60 Q -.15(ve)-.25 G
(</font>).15 E(object created using the)0 72 Q 0 Cg EP
%%Page: 15 15
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>archi)0 12 Q -.15(ve)-.25 G
(_write_disk</b>\(<code></code>\)).15 E -.1(fa)0 24 S(mily functions.).1
E(This interf)0 36 Q(ace is deliberately v)-.1 E(ery similar to the)-.15
E(<b>archi)0 48 Q -.15(ve)-.25 G(_write</b>\(<code></code>\)).15 E
(interf)0 60 Q(ace used to write objects to a streaming archi)-.1 E -.15
(ve)-.25 G(.).15 E(<dl compact>)0 72 Q 0 Cg EP
%%Page: 16 16
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p><dt><b>archi)0 12 Q -.15(ve)-.25 G
(_write_disk_ne).15 E(w</b>\(<code></code>\)<dd>)-.25 E
(Allocates and initializes a)0 24 Q(<font size="-1"></font><font size="\
-1">struct</font><font size="-1"> archi)0 36 Q -.15(ve)-.25 G(</font>)
.15 E(object suitable for writing objects to disk.)0 48 Q
(<p><dt><b>archi)0 60 Q -.15(ve)-.25 G
(_write_disk_set_skip_\214le</b>\(<code></code>\)<dd>).15 E
(Records the de)0 72 Q
(vice and inode numbers of a \214le that should not be)-.25 E 0 Cg EP
%%Page: 17 17
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.15(ove)0 12 S(rwritten.).15 E
(This is typically used to ensure that an e)0 24 Q
(xtraction process does not)-.15 E -.15(ove)0 36 S(rwrite the archi).15
E .3 -.15(ve f)-.25 H(rom which objects are being read.).15 E
(This capability is technically unnecessary b)0 48 Q
(ut can be a signi\214cant)-.2 E(performance optimization in practice.)0
60 Q(<p><dt><b>archi)0 72 Q -.15(ve)-.25 G
(_write_disk_set_options</b>\(<code></code>\)<dd>).15 E 0 Cg EP
%%Page: 18 18
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(The options \214eld consists of a bitwise OR of one or more of the)0 12
Q(follo)0 24 Q(wing v)-.25 E(alues:)-.25 E(<dl compact>)0 36 Q
(<dt><b></b><b>ARCHIVE_EXTRA)0 48 Q(CT_O)-.4 E(WNER</b><dd>)-.35 E
(The user and group IDs should be set on the restored \214le.)0 60 Q
(By def)0 72 Q(ault, the user and group IDs are not restored.)-.1 E 0 Cg
EP
%%Page: 19 19
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<dt><b></b><b>ARCHIVE_EXTRA)0 12 Q
(CT_PERM</b><dd>)-.4 E
(Full permissions \(including SGID, SUID, and stick)0 24 Q 2.5(yb)-.15 G
(its\) should)-2.5 E(be restored e)0 36 Q
(xactly as speci\214ed, without obe)-.15 E(ying the)-.15 E
(current umask.)0 48 Q
(Note that SUID and SGID bits can only be restored if the)0 60 Q
(user and group ID of the object on disk are correct.)0 72 Q 0 Cg EP
%%Page: 20 20
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(If)0 12 Q(<b></b><b>ARCHIVE_EXTRA)0 24 Q(CT_O)
-.4 E(WNER</b>)-.35 E
(is not speci\214ed, then SUID and SGID bits will only be restored)0 36
Q(if the def)0 48 Q(ault user and group IDs of ne)-.1 E
(wly-created objects on disk)-.25 E
(happen to match those speci\214ed in the archi)0 60 Q .3 -.15(ve e)-.25
H(ntry).15 E(.)-.65 E(By def)0 72 Q
(ault, only basic permissions are restored, and umask is obe)-.1 E(yed.)
-.15 E 0 Cg EP
%%Page: 21 21
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<dt><b></b><b>ARCHIVE_EXTRA)0 12 Q
(CT_TIME</b><dd>)-.4 E
(The timestamps \(mtime, ctime, and atime\) should be restored.)0 24 Q
(By def)0 36 Q(ault, the)-.1 E 2.5(ya)-.15 G(re ignored.)-2.5 E
(Note that restoring of atime is not currently supported.)0 48 Q
(<dt><b></b><b>ARCHIVE_EXTRA)0 60 Q(CT_NO_O)-.4 E(VER)-.5 E
(WRITE</b><dd>)-.55 E(Existing \214les on disk will not be o)0 72 Q -.15
(ve)-.15 G(rwritten.).15 E 0 Cg EP
%%Page: 22 22
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(By def)0 12 Q(ault, e)-.1 E(xisting re)-.15 E
(gular \214les are truncated and o)-.15 E -.15(ve)-.15 G(rwritten;).15 E
-.15(ex)0 24 S(isting directories will ha).15 E .3 -.15(ve t)-.2 H
(heir permissions updated;).15 E(other pre-e)0 36 Q
(xisting objects are unlink)-.15 E(ed and recreated from scratch.)-.1 E
(<dt><b></b><b>ARCHIVE_EXTRA)0 48 Q(CT_UNLINK</b><dd>)-.4 E
(Existing \214les on disk will be unlink)0 60 Q(ed before an)-.1 E 2.5
(ya)-.15 G(ttempt to)-2.5 E(create them.)0 72 Q 0 Cg EP
%%Page: 23 23
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(In some cases, this can pro)0 12 Q .3 -.15(ve t)
-.15 H 2.5(ob).15 G 2.5(eas)-2.5 G(igni\214cant performance impro)-2.5 E
-.15(ve)-.15 G(ment.).15 E(By def)0 24 Q(ault, e)-.1 E
(xisting \214les are truncated and re)-.15 E(written, b)-.25 E(ut)-.2 E
(the \214le is not recreated.)0 36 Q(In particular)0 48 Q 2.5(,t)-.4 G
(he def)-2.5 E(ault beha)-.1 E(vior does not break e)-.2 E
(xisting hard links.)-.15 E(<dt><b></b><b>ARCHIVE_EXTRA)0 60 Q(CT_A)-.4
E(CL</b><dd>)-.4 E(Attempt to restore A)0 72 Q(CLs.)-.4 E 0 Cg EP
%%Page: 24 24
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(By def)0 12 Q(ault, e)-.1 E(xtended A)-.15 E
(CLs are ignored.)-.4 E(<dt><b></b><b>ARCHIVE_EXTRA)0 24 Q(CT_FFLA)-.4 E
(GS</b><dd>)-.4 E(Attempt to restore e)0 36 Q(xtended \214le \215ags.)
-.15 E(By def)0 48 Q(ault, \214le \215ags are ignored.)-.1 E
(<dt><b></b><b>ARCHIVE_EXTRA)0 60 Q(CT_XA)-.4 E(TTR</b><dd>)-1.11 E
(Attempt to restore POSIX.1e e)0 72 Q(xtended attrib)-.15 E(utes.)-.2 E
0 Cg EP
%%Page: 25 25
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(By def)0 12 Q(ault, the)-.1 E 2.5(ya)-.15 G
(re ignored.)-2.5 E(<dt><b></b><b>ARCHIVE_EXTRA)0 24 Q
(CT_SECURE_SYMLINKS</b><dd>)-.4 E(Refuse to e)0 36 Q(xtract an)-.15 E
2.5(yo)-.15 G(bject whose \214nal location w)-2.5 E(ould be altered)-.1
E(by a symlink on disk.)0 48 Q(This is intended to help guard ag)0 60 Q
(ainst a v)-.05 E(ariety of mischief)-.25 E(caused by archi)0 72 Q -.15
(ve)-.25 G 2.5(st).15 G(hat \(deliberately or otherwise\) e)-2.5 E
(xtract)-.15 E 0 Cg EP
%%Page: 26 26
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\214les outside of the current directory)0 12 Q
(.)-.65 E(The def)0 24 Q(ault is not to perform this check.)-.1 E(If)0
36 Q(<b></b><b>ARCHIVE_EXTRA)0 48 Q(CT_UNLINK</b>)-.4 E
(is speci\214ed together with this option, the library will)0 60 Q(remo)
0 72 Q .3 -.15(ve a)-.15 H .3 -.15(ny i).15 H
(ntermediate symlinks it \214nds and return an).15 E 0 Cg EP
%%Page: 27 27
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(error only if such symlink could not be remo)0
12 Q -.15(ve)-.15 G(d.).15 E(<dt><b></b><b>ARCHIVE_EXTRA)0 24 Q
(CT_SECURE_NODO)-.4 E(TDO)-.4 E(T</b><dd>)-.4 E(Refuse to e)0 36 Q
(xtract a path that contains a)-.15 E(<code></code><code>..</code>)0 48
Q(element an)0 60 Q(ywhere within it.)-.15 E(The def)0 72 Q
(ault is to not refuse such paths.)-.1 E 0 Cg EP
%%Page: 28 28
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Note that paths ending in)0 12 Q
(<code></code><code>..</code>)0 24 Q(al)0 36 Q -.1(wa)-.1 G
(ys cause an error).1 E 2.5(,r)-.4 G -2.25 -.15(eg a)-2.5 H
(rdless of this \215ag.).15 E(<dt><b></b><b>ARCHIVE_EXTRA)0 48 Q(CT_SP)
-.4 E(ARSE</b><dd>)-.92 E
(Scan data for blocks of NUL bytes and try to recreate them with holes.)
0 60 Q(This results in sparse \214les, independent of whether the archi)
0 72 Q .3 -.15(ve f)-.25 H(ormat).15 E 0 Cg EP
%%Page: 29 29
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(supports or uses them.)0 12 Q(</dl>)0 24 Q
(<p><dt>Xo<dd>)0 36 Q(<b>archi)0 48 Q -.15(ve)-.25 G
(_write_disk_set_group_lookup</b>\(<code></code>\),).15 E(<b>archi)0 60
Q -.15(ve)-.25 G(_write_disk_set_user_lookup</b>\(<code></code>\)).15 E
(The)0 72 Q 0 Cg EP
%%Page: 30 30
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<font size="-1"></font><font size="-1">struct</\
font><font size="-1"> archi)0 12 Q -.15(ve)-.25 G(_entry</font>).15 E
(objects contain both names and ids that can be used to identify users)0
24 Q(and groups.)0 36 Q(These names and ids describe the o)0 48 Q
(wnership of the \214le itself and)-.25 E(also appear in A)0 60 Q
(CL lists.)-.4 E(By def)0 72 Q
(ault, the library uses the ids and ignores the names, b)-.1 E(ut)-.2 E
0 Cg EP
%%Page: 31 31
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(this can be o)0 12 Q -.15(ve)-.15 G
(rridden by re).15 E(gistering user and group lookup functions.)-.15 E
1.6 -.8(To r)0 24 T -.15(eg).8 G(ister).15 E 2.5(,y)-.4 G(ou must pro)
-2.5 E(vide a lookup function which)-.15 E
(accepts both a name and id and returns a suitable id.)0 36 Q -1.1(Yo)0
48 S 2.5(um)1.1 G(ay also pro)-2.5 E(vide a)-.15 E
(<font size="-1"></font><font size="-1">v)0 60 Q
(oid</font><font size="-1"> *</font>)-.2 E(pointer to a pri)0 72 Q -.25
(va)-.25 G(te data structure and a cleanup function for).25 E 0 Cg EP
%%Page: 32 32
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(that data.)0 12 Q
(The cleanup function will be in)0 24 Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw)
.1 G(hen the)-2.5 E(<font size="-1"></font><font size="-1">struct</font\
><font size="-1"> archi)0 36 Q -.15(ve)-.25 G(</font>).15 E
(object is destro)0 48 Q(yed.)-.1 E(<p><dt><b>archi)0 60 Q -.15(ve)-.25
G(_write_disk_set_standard_lookup</b>\(<code></code>\)<dd>).15 E
(This con)0 72 Q -.15(ve)-.4 G
(nience function installs a standard set of user).15 E 0 Cg EP
%%Page: 33 33
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(and group lookup functions.)0 12 Q
(These functions use)0 24 Q
(<a href="../html3/getpwnam.html">getpwnam\(3\)</a>)0 36 Q(and)0 48 Q
(<a href="../html3/getgrnam.html">getgrnam\(3\)</a>)0 60 Q(to con)0 72 Q
-.15(ve)-.4 G(rt names to ids, def).15 E
(aulting to the ids if the names cannot)-.1 E 0 Cg EP
%%Page: 34 34
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(be look)0 12 Q(ed up.)-.1 E
(These functions also implement a simple memory cache to reduce)0 24 Q
(the number of calls to)0 36 Q
(<a href="../html3/getpwnam.html">getpwnam\(3\)</a>)0 48 Q(and)0 60 Q
(<a href="../html3/getgrnam.html">getgrnam\(3\)</a>.)0 72 Q 0 Cg EP
%%Page: 35 35
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p><dt><b>archi)0 12 Q -.15(ve)-.25 G
(_write_header</b>\(<code></code>\)<dd>).15 E
(Build and write a header using the data in the pro)0 24 Q(vided)-.15 E
(<font size="-1"></font><font size="-1">struct</font><font size="-1"> a\
rchi)0 36 Q -.15(ve)-.25 G(_entry</font>).15 E(structure.)0 48 Q(See)0
60 Q(<a href="../html3/archi)0 72 Q -.15(ve)-.25 G(_entry).15 E
(.html">archi)-.65 E -.15(ve)-.25 G(_entry\(3\)</a>).15 E 0 Cg EP
%%Page: 36 36
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(for information on creating and populating)0 12
Q(<font size="-1"></font><font size="-1">struct</font><font size="-1"> \
archi)0 24 Q -.15(ve)-.25 G(_entry</font>).15 E(objects.)0 36 Q
(<p><dt><b>archi)0 48 Q -.15(ve)-.25 G
(_write_data</b>\(<code></code>\)<dd>).15 E
(Write data corresponding to the header just written.)0 60 Q
(Returns number of bytes written or -1 on error)0 72 Q(.)-.55 E 0 Cg EP
%%Page: 37 37
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p><dt><b>archi)0 12 Q -.15(ve)-.25 G
(_write_\214nish_entry</b>\(<code></code>\)<dd>).15 E
(Close out the entry just written.)0 24 Q(Ordinarily)0 36 Q 2.5(,c)-.65
G(lients ne)-2.5 E -.15(ve)-.25 G 2.5(rn).15 G(eed to call this, as it)
-2.5 E(is called automatically by)0 48 Q(<b>archi)0 60 Q -.15(ve)-.25 G
(_write_ne).15 E(xt_header</b>\(<code></code>\))-.15 E(and)0 72 Q 0 Cg
EP
%%Page: 38 38
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>archi)0 12 Q -.15(ve)-.25 G
(_write_close</b>\(<code></code>\)).15 E(as needed.)0 24 Q
(<p><dt><b>archi)0 36 Q -.15(ve)-.25 G
(_write_close</b>\(<code></code>\)<dd>).15 E(Set an)0 48 Q 2.5(ya)-.15 G
(ttrib)-2.5 E(utes that could not be set during the initial restore.)-.2
E -.15(Fo)0 60 S 2.5(re).15 G
(xample, directory timestamps are not restored initially because)-2.65 E
(restoring a subsequent \214le w)0 72 Q(ould alter that timestamp.)-.1 E
0 Cg EP
%%Page: 39 39
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Similarly)0 12 Q 2.5(,n)-.65 G
(on-writable directories are initially created with)-2.5 E
(write permissions \(so that their contents can be restored\).)0 24 Q
(The)0 36 Q(<b>archi)0 48 Q -.15(ve)-.25 G(_write_disk_ne).15 E(w</b>)
-.25 E(library maintains a list of all such deferred attrib)0 60 Q
(utes and)-.2 E(sets them when this function is in)0 72 Q -.2(vo)-.4 G
-.1(ke).2 G(d.).1 E 0 Cg EP
%%Page: 40 40
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p><dt><b>archi)0 12 Q -.15(ve)-.25 G
(_write_\214nish</b>\(<code></code>\)<dd>).15 E(In)0 24 Q -.2(vo)-.4 G
-.1(ke).2 G(s).1 E(<b>archi)0 36 Q -.15(ve)-.25 G
(_write_close</b>\(<code></code>\)).15 E(if it w)0 48 Q(as not in)-.1 E
-.2(vo)-.4 G -.1(ke).2 G 2.5(dm).1 G(anually)-2.5 E 2.5(,t)-.65 G
(hen releases all resources.)-2.5 E(</dl>)0 60 Q
(More information about the)0 72 Q 0 Cg EP
%%Page: 41 41
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<i></i><i>struct</i><i> archi)0 12 Q -.15(ve)
-.25 G(</i>).15 E(object and the o)0 24 Q -.15(ve)-.15 G
(rall design of the library can be found in the).15 E
(<a href="../html3/libarchi)0 36 Q -.15(ve)-.25 G(.html">libarchi).15 E
-.15(ve)-.25 G(\(3\)</a>).15 E -.15(ove)0 48 S(rvie).15 E -.65(w.)-.25 G
(Man)0 60 Q 2.5(yo)-.15 G 2.5(ft)-2.5 G
(hese functions are also documented under)-2.5 E
(<a href="../html3/archi)0 72 Q -.15(ve)-.25 G(_write.html">archi).15 E
-.15(ve)-.25 G(_write\(3\)</a>.).15 E 0 Cg EP
%%Page: 42 42
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<h3 id="RETURN V)36 12 Q(ALUES">)-1.35 E
(RETURN V)36 24 Q(ALUES)-1.35 E(</h3>)36 36 Q(Most functions return)0 48
Q(<b></b><b>ARCHIVE_OK</b>)0 60 Q(\(zero\) on success, or one of se)0 72
Q -.15(ve)-.25 G(ral non-zero).15 E 0 Cg EP
%%Page: 43 43
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(error codes for errors.)0 12 Q
(Speci\214c error codes include:)0 24 Q(<b></b><b>ARCHIVE_RETR)0 36 Q
(Y</b>)-.65 E(for operations that might succeed if retried,)0 48 Q
(<b></b><b>ARCHIVE_W)0 60 Q(ARN</b>)-1.2 E
(for unusual conditions that do not pre)0 72 Q -.15(ve)-.25 G
(nt further operations, and).15 E 0 Cg EP
%%Page: 44 44
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b></b><b>ARCHIVE_F)0 12 Q -1.21 -1.11(AT A)-.74
H(L</b>)1.11 E(for serious errors that mak)0 24 Q 2.5(er)-.1 G
(emaining operations impossible.)-2.5 E(The)0 36 Q(<b>archi)0 48 Q -.15
(ve)-.25 G(_errno</b>\(<code></code>\)).15 E(and)0 60 Q(<b>archi)0 72 Q
-.15(ve)-.25 G(_error_string</b>\(<code></code>\)).15 E 0 Cg EP
%%Page: 45 45
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(functions can be used to retrie)0 12 Q .3 -.15
(ve a)-.25 H 2.5(na).15 G(ppropriate error code and a)-2.5 E(te)0 24 Q
(xtual error message.)-.15 E(<p>)36 36 Q(<b>archi)0 48 Q -.15(ve)-.25 G
(_write_disk_ne).15 E(w</b>\(<code></code>\))-.25 E
(returns a pointer to a ne)0 60 Q(wly-allocated)-.25 E(<font size="-1">\
</font><font size="-1">struct</font><font size="-1"> archi)0 72 Q -.15
(ve)-.25 G(</font>).15 E 0 Cg EP
%%Page: 46 46
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(object.)0 12 Q(<p>)36 24 Q(<b>archi)0 36 Q -.15
(ve)-.25 G(_write_data</b>\(<code></code>\)).15 E
(returns a count of the number of bytes actually written.)0 48 Q
(On error)0 60 Q 2.5(,-)-.4 G 2.5(1i)-2.5 G 2.5(sr)-2.5 G
(eturned and the)-2.5 E(<b>archi)0 72 Q -.15(ve)-.25 G
(_errno</b>\(<code></code>\)).15 E 0 Cg EP
%%Page: 47 47
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(and)0 12 Q(<b>archi)0 24 Q -.15(ve)-.25 G
(_error_string</b>\(<code></code>\)).15 E
(functions will return appropriate v)0 36 Q(alues.)-.25 E
(<h3 id="SEE ALSO">)36 48 Q(SEE ALSO)36 60 Q(</h3>)36 72 Q 0 Cg EP
%%Page: 48 48
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<a href="../html3/archi)0 12 Q -.15(ve)-.25 G
(_read.html">archi).15 E -.15(ve)-.25 G(_read\(3\)</a>,).15 E
(<a href="../html3/archi)0 24 Q -.15(ve)-.25 G(_write.html">archi).15 E
-.15(ve)-.25 G(_write\(3\)</a>,).15 E(<a href="../html1/tar)0 36 Q
(.html">tar\(1\)</a>,)-.55 E(<a href="../html3/libarchi)0 48 Q -.15(ve)
-.25 G(.html">libarchi).15 E -.15(ve)-.25 G(\(3\)</a>).15 E
(<h3 id="HIST)36 60 Q(OR)-.18 E(Y">)-.65 E(HIST)36 72 Q(OR)-.18 E(Y)-.65
E 0 Cg EP
%%Page: 49 49
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(</h3>)36 12 Q(The)0 24 Q(<b>libarchi)0 36 Q -.15
(ve)-.25 G(</b>).15 E(library \214rst appeared in)0 48 Q(FreeBSD5.3.)0
60 Q(The)0 72 Q 0 Cg EP
%%Page: 50 50
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>archi)0 12 Q -.15(ve)-.25 G(_write_disk</b>)
.15 E(interf)0 24 Q(ace w)-.1 E(as added to)-.1 E(<b>libarchi)0 36 Q
-.15(ve)-.25 G(</b><b>2.0</b>).15 E(and \214rst appeared in)0 48 Q
(FreeBSD6.3.)0 60 Q(<h3 id="A)36 72 Q(UTHORS">)-.55 E 0 Cg EP
%%Page: 51 51
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.55(AU)36 12 S(THORS).55 E(</h3>)36 24 Q(<p>)36
36 Q(The)0 48 Q(<b>libarchi)0 60 Q -.15(ve)-.25 G(</b>).15 E(library w)0
72 Q(as written by)-.1 E 0 Cg EP
%%Page: 52 52
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(Ti)0 12 S 2.5(mK).35 G
(ientzle &lt;kientzle@acm.or)-2.5 E(g&gt;.)-.18 E(<h3 id="B)36 24 Q
(UGS">)-.1 E -.1(BU)36 36 S(GS).1 E(</h3>)36 48 Q
(Directories are actually e)0 60 Q(xtracted in tw)-.15 E 2.5(od)-.1 G
(istinct phases.)-2.5 E(Directories are created during)0 72 Q 0 Cg EP
%%Page: 53 53
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>archi)0 12 Q -.15(ve)-.25 G
(_write_header</b>\(<code></code>\),).15 E -.2(bu)0 24 S 2.5<748c>.2 G
(nal permissions are not set until)-2.5 E(<b>archi)0 36 Q -.15(ve)-.25 G
(_write_close</b>\(<code></code>\).).15 E
(This separation is necessary to correctly handle borderline)0 48 Q
(cases such as a non-writable directory containing)0 60 Q(\214les, b)0
72 Q(ut can cause une)-.2 E(xpected results.)-.15 E 0 Cg EP
%%Page: 54 54
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(In particular)0 12 Q 2.5(,d)-.4 G
(irectory permissions are not fully)-2.5 E(restored until the archi)0 24
Q .3 -.15(ve i)-.25 H 2.5(sc).15 G(losed.)-2.5 E(If you use)0 36 Q
(<a href="../html2/chdir)0 48 Q(.html">chdir\(2\)</a>)-.55 E
(to change the current directory between calls to)0 60 Q(<b>archi)0 72 Q
-.15(ve)-.25 G(_read_e).15 E(xtract</b>\(<code></code>\))-.15 E 0 Cg EP
%%Page: 55 55
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(or before calling)0 12 Q(<b>archi)0 24 Q -.15
(ve)-.25 G(_read_close</b>\(<code></code>\),).15 E
(you may confuse the permission-setting logic with)0 36 Q
(the result that directory permissions are restored)0 48 Q(incorrectly)0
60 Q(.)-.65 E(<p>)36 72 Q 0 Cg EP
%%Page: 56 56
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(The library attempts to create objects with \214lenames longer than)0
12 Q(<b></b><b>P)0 24 Q -1.11(AT)-.92 G(H_MAX</b>)1.11 E
(by creating pre\214x)0 36 Q
(es of the full path and changing the current directory)-.15 E(.)-.65 E
(Currently)0 48 Q 2.5(,t)-.65 G
(his logic is limited in scope; the \214xup pass does)-2.5 E(not w)0 60
Q(ork correctly for such objects and the symlink security check)-.1 E
(option disables the support for v)0 72 Q(ery long pathnames.)-.15 E 0
Cg EP
%%Page: 57 57
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p>)36 12 Q(Restoring the path)0 24 Q
(<code></code><code>aa/../bb</code>)0 36 Q
(does create each intermediate directory)0 48 Q(.)-.65 E(In particular)0
60 Q 2.5(,t)-.4 G(he directory)-2.5 E(<code></code><code>aa</code>)0 72
Q 0 Cg EP
%%Page: 58 58
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(is created as well as the \214nal object)0 12 Q
(<code></code><code>bb</code>.)0 24 Q(In theory)0 36 Q 2.5(,t)-.65 G
(his can be e)-2.5 E(xploited to create an entire directory heirarch)
-.15 E(y)-.05 E(with a single request.)0 48 Q
(Of course, this does not w)0 60 Q(ork if the)-.1 E
(<b></b><b>ARCHIVE_EXTRA)0 72 Q(CT_NODO)-.4 E(TDO)-.4 E(T</b>)-.4 E 0 Cg
EP
%%Page: 59 59
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(option is speci\214ed.)0 12 Q(<p>)36 24 Q
(Implicit directories are al)0 36 Q -.1(wa)-.1 G(ys created obe).1 E
(ying the current umask.)-.15 E(Explicit objects are created obe)0 48 Q
(ying the current umask unless)-.15 E(<b></b><b>ARCHIVE_EXTRA)0 60 Q
(CT_PERM</b>)-.4 E(is speci\214ed, in which case the)0 72 Q 2.5(yc)-.15
G(urrent umask is ignored.)-2.5 E 0 Cg EP
%%Page: 60 60
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p>)36 12 Q
(SGID and SUID bits are restored only if the correct user and)0 24 Q
(group could be set.)0 36 Q(If)0 48 Q(<b></b><b>ARCHIVE_EXTRA)0 60 Q
(CT_O)-.4 E(WNER</b>)-.35 E
(is not speci\214ed, then no attempt is made to set the o)0 72 Q
(wnership.)-.25 E 0 Cg EP
%%Page: 61 61
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(In this case, SGID and SUID bits are restored only if the)0 12 Q
(user and group of the \214nal object happen to match those speci\214ed)
0 24 Q(in the entry)0 36 Q(.)-.65 E(<p>)36 48 Q(The)0 60 Q -.74(``)0 72
S(standard').74 E(')-.74 E 0 Cg EP
%%Page: 62 62
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(user)0 12 Q
(-id and group-id lookup functions are not the def)-.2 E(aults because)
-.1 E(<a href="../html3/getgrnam.html">getgrnam\(3\)</a>)0 24 Q(and)0 36
Q(<a href="../html3/getpwnam.html">getpwnam\(3\)</a>)0 48 Q
(are sometimes too lar)0 60 Q(ge for particular applications.)-.18 E
(The current design allo)0 72 Q(ws the application author to use a more)
-.25 E 0 Cg EP
%%Page: 63 63
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(compact implementation when appropriate.)0 12 Q
(<p>)36 24 Q(There should be a corresponding)0 36 Q(<b>archi)0 48 Q -.15
(ve)-.25 G(_read_disk</b>).15 E(interf)0 60 Q(ace that w)-.1 E
(alks a directory heirarch)-.1 E 2.5(ya)-.05 G(nd returns archi)-2.5 E
-.15(ve)-.25 G(entry objects.)0 72 Q 0 Cg EP
%%Trailer
end
%%EOF