path: root/archivers/libarchive/files/doc/html/bsdtar.1.html

%!PS-Adobe-3.0
%%Creator: groff version 1.19.2
%%CreationDate: Sun Mar 14 02:49:18 2010
%%DocumentNeededResources: font Times-Roman
%%DocumentSuppliedResources: procset grops 1.19 2
%%Pages: 167
%%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
(Oct 12, 2009 BSDT)74.5 48 Q(AR 1)-.93 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>tar</b>)0 48 Q 2.5(-m)0 60 S
(anipulate tape archi)-2.5 E -.15(ve)-.25 G(s).15 E(<h3 id="SYNOPSIS">)
36 72 Q 0 Cg EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(SYNOPSIS)36 12 Q(</h3>)36 24 Q(<b>tar</b>)0 36 Q
([<i></i><i>b)0 48 Q(undled-\215ags </i><i>ar)-.2 E
(gs&lt;.blm Pp</i><i> &gt;</i>])-.18 E([<i></i><i>\214le&lt;.blm Pp</i>\
<i> | </i><i></i><i>pattern&lt;.blm Pp</i><i> ...</i><i> &gt;</i><i> &g\
t;</i>])0 60 Q(<b>tar</b>)0 72 Q 0 Cg EP
%%Page: 6 6
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF({<b>\255</b><b>c</b>})0 12 Q
([<i></i><i>options</i>])0 24 Q
([<i></i><i>\214les</i><i> |</i><i></i><i> directories</i>])0 36 Q
(<b>tar</b>)0 48 Q({<b>\255</b><b>r</b><b> |</b><b> \255</b><b>u</b>})0
60 Q(<b>\255</b><b>f</b><i></i><i> archi)0 72 Q -.15(ve)-.25 G
(-\214le</i>).15 E 0 Cg EP
%%Page: 7 7
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF([<i></i><i>options</i>])0 12 Q
([<i></i><i>\214les</i><i> |</i><i></i><i> directories</i>])0 24 Q
(<b>tar</b>)0 36 Q({<b>\255</b><b>t</b><b> |</b><b> \255</b><b>x</b>})0
48 Q([<i></i><i>options</i>])0 60 Q([<i></i><i>patterns</i>])0 72 Q 0 Cg
EP
%%Page: 8 8
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<h3 id="DESCRIPTION">)36 12 Q(DESCRIPTION)36 24
Q(</h3>)36 36 Q(<b>tar</b>)0 48 Q
(creates and manipulates streaming archi)0 60 Q .3 -.15(ve \214)-.25 H
(les.).15 E(This implementation can e)0 72 Q(xtract from tar)-.15 E 2.5
(,p)-.4 G(ax, cpio, zip, jar)-2.5 E 2.5(,a)-.4 G -.4(r,)-2.5 G 0 Cg EP
%%Page: 9 9
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(and ISO 9660 cdrom images and can create tar)0
12 Q 2.5(,p)-.4 G(ax, cpio, ar)-2.5 E(,)-.4 E(and shar archi)0 24 Q -.15
(ve)-.25 G(s.).15 E(<p>)36 36 Q(The \214rst synopsis form sho)0 48 Q
(ws a)-.25 E -.74(``)0 60 S -.2(bu).74 G(ndled').2 E(')-.74 E(option w)0
72 Q(ord.)-.1 E 0 Cg EP
%%Page: 10 10
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(This usage is pro)0 12 Q
(vided for compatibility with historical implementations.)-.15 E
(See COMP)0 24 Q -1.11(AT)-.92 G(IBILITY belo)1.11 E 2.5(wf)-.25 G
(or details.)-2.5 E(<p>)36 36 Q(The other synopsis forms sho)0 48 Q 2.5
(wt)-.25 G(he preferred usage.)-2.5 E(The \214rst option to)0 60 Q
(<b>tar</b>)0 72 Q 0 Cg EP
%%Page: 11 11
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(is a mode indicator from the follo)0 12 Q
(wing list:)-.25 E(<dl compact>)0 24 Q(<dt><b>\255</b><b>c</b><dd>)0 36
Q(Create a ne)0 48 Q 2.5(wa)-.25 G(rchi)-2.5 E .3 -.15(ve c)-.25 H
(ontaining the speci\214ed items.).15 E(<dt><b>\255</b><b>r</b><dd>)0 60
Q(Lik)0 72 Q(e)-.1 E 0 Cg EP
%%Page: 12 12
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>\255</b><b>c</b>,)0 12 Q -.2(bu)0 24 S 2.5
(tn).2 G .5 -.25(ew e)-2.5 H(ntries are appended to the archi).25 E -.15
(ve)-.25 G(.).15 E(Note that this only w)0 36 Q
(orks on uncompressed archi)-.1 E -.15(ve)-.25 G 2.5(ss).15 G
(tored in re)-2.5 E(gular \214les.)-.15 E(The)0 48 Q
(<b>\255</b><b>f</b>)0 60 Q(option is required.)0 72 Q 0 Cg EP
%%Page: 13 13
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<dt><b>\255</b><b>t</b><dd>)0 12 Q(List archi)0
24 Q .3 -.15(ve c)-.25 H(ontents to stdout.).15 E
(<dt><b>\255</b><b>u</b><dd>)0 36 Q(Lik)0 48 Q(e)-.1 E
(<b>\255</b><b>r</b>,)0 60 Q -.2(bu)0 72 S 2.5(tn).2 G .5 -.25(ew e)-2.5
H(ntries are added only if the).25 E 2.5(yh)-.15 G -2.25 -.2(av e)-2.5 H
2.5(am)2.7 G(odi\214cation date)-2.5 E 0 Cg EP
%%Page: 14 14
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(ne)0 12 Q
(wer than the corresponding entry in the archi)-.25 E -.15(ve)-.25 G(.)
.15 E(Note that this only w)0 24 Q(orks on uncompressed archi)-.1 E -.15
(ve)-.25 G 2.5(ss).15 G(tored in re)-2.5 E(gular \214les.)-.15 E(The)0
36 Q(<b>\255</b><b>f</b>)0 48 Q(option is required.)0 60 Q
(<dt><b>\255</b><b>x</b><dd>)0 72 Q 0 Cg EP
%%Page: 15 15
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Extract to disk from the archi)0 12 Q -.15(ve)
-.25 G(.).15 E
(If a \214le with the same name appears more than once in the archi)0 24
Q -.15(ve)-.25 G(,).15 E(each cop)0 36 Q 2.5(yw)-.1 G(ill be e)-2.5 E
(xtracted, with later copies o)-.15 E -.15(ve)-.15 G
(rwriting \(replacing\)).15 E(earlier copies.)0 48 Q(</dl>)0 60 Q(<p>)36
72 Q 0 Cg EP
%%Page: 16 16
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(In)0 12 Q(<b>\255</b><b>c</b>,)0 24 Q
(<b>\255</b><b>r</b>,)0 36 Q(or)0 48 Q(<b>\255</b><b>u</b>)0 60 Q
(mode, each speci\214ed \214le or directory is added to the)0 72 Q 0 Cg
EP
%%Page: 17 17
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(archi)0 12 Q .3 -.15(ve i)-.25 H 2.5(nt).15 G
(he order speci\214ed on the command line.)-2.5 E(By def)0 24 Q
(ault, the contents of each directory are also archi)-.1 E -.15(ve)-.25
G(d.).15 E(<p>)36 36 Q(In e)0 48 Q
(xtract or list mode, the entire command line)-.15 E
(is read and parsed before the archi)0 60 Q .3 -.15(ve i)-.25 H 2.5(so)
.15 G(pened.)-2.5 E
(The pathnames or patterns on the command line indicate)0 72 Q 0 Cg EP
%%Page: 18 18
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(which items in the archi)0 12 Q .3 -.15(ve s)
-.25 H(hould be processed.).15 E -.15(Pa)0 24 S
(tterns are shell-style globbing patterns as).15 E(documented in)0 36 Q
(<a href="../html1/tcsh.html">tcsh\(1\)</a>.)0 48 Q(<h3 id="OPTIONS">)36
60 Q(OPTIONS)36 72 Q 0 Cg EP
%%Page: 19 19
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(</h3>)36 12 Q
(Unless speci\214cally stated otherwise, options are applicable in)0 24
Q(all operating modes.)0 36 Q(<dl compact>)0 48 Q
(<p><dt><b></b><b>@</b><code></code><code>archi)0 60 Q -.15(ve)-.25 G
(</code><dd>).15 E(\(c and r mode only\))0 72 Q 0 Cg EP
%%Page: 20 20
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(The speci\214ed archi)0 12 Q .3 -.15(ve i)-.25 H
2.5(so).15 G(pened and the entries)-2.5 E
(in it will be appended to the current archi)0 24 Q -.15(ve)-.25 G(.).15
E(As a simple e)0 36 Q(xample,)-.15 E(<br>)0 48 Q
(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 60 Q(<code></code><b>Fl</b><b>c\
</b><b> \255</b><b>f</b><code></code><code> -</code><code></code><code>\
 ne)0 72 Q
(w\214le</code><b></b><b> @</b><code></code><code>original.tar</code>)
-.25 E 0 Cg EP
%%Page: 21 21
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<br>)0 12 Q(writes a ne)0 24 Q 2.5(wa)-.25 G
(rchi)-2.5 E .3 -.15(ve t)-.25 H 2.5(os).15 G
(tandard output containing a \214le)-2.5 E(<code></code><code>ne)0 36 Q
(w\214le</code>)-.25 E(and all of the entries from)0 48 Q
(<code></code><code>original.tar</code>.)0 60 Q(In contrast,)0 72 Q 0 Cg
EP
%%Page: 22 22
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<br>)0 12 Q
(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 24 Q(<code></code><b>Fl</b><b>c\
</b><b> \255</b><b>f</b><code></code><code> -</code><code></code><code>\
 ne)0 36 Q(w\214le</code><code></code><code> original.tar</code>)-.25 E
(<br>)0 48 Q(creates a ne)0 60 Q 2.5(wa)-.25 G(rchi)-2.5 E .3 -.15(ve w)
-.25 H(ith only tw).15 E 2.5(oe)-.1 G(ntries.)-2.5 E(Similarly)0 72 Q(,)
-.65 E 0 Cg EP
%%Page: 23 23
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<br>)0 12 Q
(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 24 Q(<code></code><b>Fl</b><b>c\
zf</b><code></code><code> -</code><b> \255</b><b>-format</b><b></b><b> \
pax</b><b></b><b> @</b><code></code><code>-</code>)0 36 Q(<br>)0 48 Q
(reads an archi)0 60 Q .3 -.15(ve f)-.25 H
(rom standard input \(whose format will be determined).15 E
(automatically\) and con)0 72 Q -.15(ve)-.4 G
(rts it into a gzip-compressed).15 E 0 Cg EP
%%Page: 24 24
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(pax-format archi)0 12 Q .3 -.15(ve o)-.25 H 2.5
(ns).15 G(tdout.)-2.5 E(In this w)0 24 Q(ay)-.1 E(,)-.65 E(<b>tar</b>)0
36 Q(can be used to con)0 48 Q -.15(ve)-.4 G(rt archi).15 E -.15(ve)-.25
G 2.5(sf).15 G(rom one format to another)-2.5 E(.)-.55 E
(<p><dt><b>\255</b><b>b</b><i></i><i> blocksize</i><dd>)0 60 Q
(Specify the block size, in 512-byte records, for tape dri)0 72 Q .3
-.15(ve I)-.25 H(/O.).15 E 0 Cg EP
%%Page: 25 25
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(As a rule, this ar)0 12 Q
(gument is only needed when reading from or writing)-.18 E(to tape dri)0
24 Q -.15(ve)-.25 G(s, and usually not e).15 E -.15(ve)-.25 G 2.5(nt).15
G(hen as the def)-2.5 E(ault block size of)-.1 E
(20 records \(10240 bytes\) is v)0 36 Q(ery common.)-.15 E
(<p><dt><b>\255</b><b>C</b><i></i><i> directory</i><dd>)0 48 Q
(In c and r mode, this changes the directory before adding)0 60 Q
(the follo)0 72 Q(wing \214les.)-.25 E 0 Cg EP
%%Page: 26 26
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(In x mode, change directories after opening the archi)0 12 Q -.15(ve)
-.25 G -.2(bu)0 24 S 2.5(tb).2 G(efore e)-2.5 E
(xtracting entries from the archi)-.15 E -.15(ve)-.25 G(.).15 E
(<p><dt><b>\255</b><b>-check-links</b><dd>)0 36 Q
(\(c and r modes only\))0 48 Q(Issue a w)0 60 Q
(arning message unless all links to each \214le are archi)-.1 E -.15(ve)
-.25 G(d.).15 E(<p><dt><b>\255</b><b>-chroot</b><dd>)0 72 Q 0 Cg EP
%%Page: 27 27
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\(x mode only\))0 12 Q
(<b>chroot</b>\(<code></code>\))0 24 Q
(to the current directory after processing an)0 36 Q(y)-.15 E
(<b>\255</b><b>C</b>)0 48 Q(options and before e)0 60 Q(xtracting an)
-.15 E 2.5<798c>-.15 G(les.)-2.5 E(<p><dt><b>\255</b><b>-e)0 72 Q
(xclude</b><i></i><i> pattern</i><dd>)-.15 E 0 Cg EP
%%Page: 28 28
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(Do not process \214les or directories that match the)0 12 Q
(speci\214ed pattern.)0 24 Q(Note that e)0 36 Q(xclusions tak)-.15 E 2.5
(ep)-.1 G(recedence o)-2.5 E -.15(ve)-.15 G 2.5(rp).15 G
(atterns or \214lenames)-2.5 E(speci\214ed on the command line.)0 48 Q
(<p><dt><b>\255</b><b>-format</b><i></i><i> format</i><dd>)0 60 Q
(\(c, r)0 72 Q 2.5(,um)-.4 G(ode only\))-2.5 E 0 Cg EP
%%Page: 29 29
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(Use the speci\214ed format for the created archi)0 12 Q -.15(ve)-.25 G
(.).15 E(Supported formats include)0 24 Q -.74(``)0 36 S(cpio').74 E(',)
-.74 E -.74(``)0 48 S(pax').74 E(',)-.74 E -.74(``)0 60 S(shar').74 E
(',)-.74 E(and)0 72 Q 0 Cg EP
%%Page: 30 30
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.74(``)0 12 S(ustar').74 E('.)-.74 E
(Other formats may also be supported; see)0 24 Q
(<a href="../html5/libarchi)0 36 Q -.15(ve)-.25 G
(-formats.html">libarchi).15 E -.15(ve)-.25 G(-formats\(5\)</a>).15 E
(for more information about currently-supported formats.)0 48 Q
(In r and u modes, when e)0 60 Q(xtending an e)-.15 E(xisting archi)-.15
E -.15(ve)-.25 G 2.5(,t).15 G(he format speci\214ed)-2.5 E
(here must be compatible with the format of the e)0 72 Q(xisting archi)
-.15 E .3 -.15(ve o)-.25 H 2.5(nd).15 G(isk.)-2.5 E 0 Cg EP
%%Page: 31 31
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(<p><dt><b>\255</b><b>f</b><i></i><i> \214le</i><dd>)0 12 Q
(Read the archi)0 24 Q .3 -.15(ve f)-.25 H(rom or write the archi).15 E
.3 -.15(ve t)-.25 H 2.5(ot).15 G(he speci\214ed \214le.)-2.5 E
(The \214lename can be)0 36 Q(<code></code><code>-</code>)0 48 Q
(for standard input or standard output.)0 60 Q
(If not speci\214ed, the def)0 72 Q(ault tape de)-.1 E
(vice will be used.)-.25 E 0 Cg EP
%%Page: 32 32
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\(On)0 12 Q(FreeBSD,)0 24 Q(the def)0 36 Q
(ault tape de)-.1 E(vice is)-.25 E(<code></code><code>/de)0 48 Q
(v/sa0</code>.\))-.25 E(<p><dt><b>\255</b><b>H</b><dd>)0 60 Q
(\(c and r mode only\))0 72 Q 0 Cg EP
%%Page: 33 33
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(Symbolic links named on the command line will be follo)0 12 Q(wed; the)
-.25 E(tar)0 24 Q(get of the link will be archi)-.18 E -.15(ve)-.25 G
(d, not the link itself.).15 E(<p><dt><b>\255</b><b>h</b><dd>)0 36 Q
(\(c and r mode only\))0 48 Q(Synon)0 60 Q(ym for)-.15 E
(<b>\255</b><b>L</b>.)0 72 Q 0 Cg EP
%%Page: 34 34
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p><dt><b>\255</b><b>I</b><dd>)0 12 Q(Synon)0 24
Q(ym for)-.15 E(<b>\255</b><b>T</b>.)0 36 Q
(<p><dt><b>\255</b><b>-include</b><i></i><i> pattern</i><dd>)0 48 Q(Pro\
cess only \214les or directories that match the speci\214ed pattern.)0
60 Q(Note that e)0 72 Q(xclusions speci\214ed with)-.15 E 0 Cg EP
%%Page: 35 35
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>\255</b><b>-e)0 12 Q(xclude</b>)-.15 E(tak)0
24 Q 2.5(ep)-.1 G(recedence o)-2.5 E -.15(ve)-.15 G 2.5(ri).15 G
(nclusions.)-2.5 E(If no inclusions are e)0 36 Q
(xplicitly speci\214ed, all entries are processed by)-.15 E(def)0 48 Q
(ault.)-.1 E(The)0 60 Q(<b>\255</b><b>-include</b>)0 72 Q 0 Cg EP
%%Page: 36 36
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(option is especially useful when \214ltering archi)0 12 Q -.15(ve)-.25
G(s.).15 E -.15(Fo)0 24 S 2.5(re).15 G(xample, the command)-2.65 E(<br>)
0 36 Q(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 48 Q(<code></code><b>Fl</\
b><b>c</b><b> \255</b><b>f</b><code></code><code> ne)0 60 Q -.65(w.)-.25
G(tar</code><b> \255</b><b>-include='*foo*'</b><b></b><b> @</b><code></\
code><code>old.tgz</code>).65 E(<br>)0 72 Q 0 Cg EP
%%Page: 37 37
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(creates a ne)0 12 Q 2.5(wa)-.25 G(rchi)-2.5 E
-.15(ve)-.25 G(<code></code><code>ne)0 24 Q -.65(w.)-.25 G(tar</code>)
.65 E(containing only the entries from)0 36 Q
(<code></code><code>old.tgz</code>)0 48 Q(containing the string)0 60 Q
(`foo'.)0 72 Q 0 Cg EP
%%Page: 38 38
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p><dt><b>\255</b><b>j</b><dd>)0 12 Q
(\(c mode only\))0 24 Q(Compress the resulting archi)0 36 Q .3 -.15
(ve w)-.25 H(ith).15 E(<a href="../html1/bzip2.html">bzip2\(1\)</a>.)0
48 Q(In e)0 60 Q(xtract or list modes, this option is ignored.)-.15 E
(Note that, unlik)0 72 Q 2.5(eo)-.1 G(ther)-2.5 E 0 Cg EP
%%Page: 39 39
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>tar</b>)0 12 Q
(implementations, this implementation recognizes bzip2 compression)0 24
Q(automatically when reading archi)0 36 Q -.15(ve)-.25 G(s.).15 E
(<p><dt><b>\255</b><b>k</b><dd>)0 48 Q(\(x mode only\))0 60 Q(Do not o)0
72 Q -.15(ve)-.15 G(rwrite e).15 E(xisting \214les.)-.15 E 0 Cg EP
%%Page: 40 40
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(In particular)0 12 Q 2.5(,i)-.4 G 2.5(fa\214)
-2.5 G(le appears more than once in an archi)-2.5 E -.15(ve)-.25 G(,).15
E(later copies will not o)0 24 Q -.15(ve)-.15 G(rwrite earlier copies.)
.15 E(<p><dt><b>\255</b><b>-k)0 36 Q(eep-ne)-.1 E(wer)-.25 E
(-\214les</b><dd>)-.2 E(\(x mode only\))0 48 Q(Do not o)0 60 Q -.15(ve)
-.15 G(rwrite e).15 E(xisting \214les that are ne)-.15 E(wer than the)
-.25 E -.15(ve)0 72 S(rsions appearing in the archi).15 E .3 -.15(ve b)
-.25 H(eing e).15 E(xtracted.)-.15 E 0 Cg EP
%%Page: 41 41
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p><dt><b>\255</b><b>L</b><dd>)0 12 Q
(\(c and r mode only\))0 24 Q(All symbolic links will be follo)0 36 Q
(wed.)-.25 E(Normally)0 48 Q 2.5(,s)-.65 G(ymbolic links are archi)-2.5
E -.15(ve)-.25 G 2.5(da).15 G 2.5(ss)-2.5 G(uch.)-2.5 E -.4(Wi)0 60 S
(th this option, the tar).4 E(get of the link will be archi)-.18 E -.15
(ve)-.25 G 2.5(di).15 G(nstead.)-2.5 E(<p><dt><b>\255</b><b>l</b><dd>)0
72 Q 0 Cg EP
%%Page: 42 42
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(This is a synon)0 12 Q(ym for the)-.15 E
(<b>\255</b><b>-check-links</b>)0 24 Q(option.)0 36 Q
(<p><dt><b>\255</b><b>m</b><dd>)0 48 Q(\(x mode only\))0 60 Q(Do not e)0
72 Q(xtract modi\214cation time.)-.15 E 0 Cg EP
%%Page: 43 43
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(By def)0 12 Q
(ault, the modi\214cation time is set to the time stored in the archi)
-.1 E -.15(ve)-.25 G(.).15 E(<p><dt><b>\255</b><b>n</b><dd>)0 24 Q
(\(c, r)0 36 Q 2.5(,um)-.4 G(odes only\))-2.5 E(Do not recursi)0 48 Q
-.15(ve)-.25 G(ly archi).15 E .3 -.15(ve t)-.25 H
(he contents of directories.).15 E(<p><dt><b>\255</b><b>-ne)0 60 Q
(wer</b><i></i><i> date</i><dd>)-.25 E(\(c, r)0 72 Q 2.5(,um)-.4 G
(odes only\))-2.5 E 0 Cg EP
%%Page: 44 44
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Only include \214les and directories ne)0 12 Q
(wer than the speci\214ed date.)-.25 E(This compares ctime entries.)0 24
Q(<p><dt><b>\255</b><b>-ne)0 36 Q(wer)-.25 E
(-mtime</b><i></i><i> date</i><dd>)-.2 E(\(c, r)0 48 Q 2.5(,um)-.4 G
(odes only\))-2.5 E(Lik)0 60 Q(e)-.1 E(<b>\255</b><b>-ne)0 72 Q
(wer</b>,)-.25 E 0 Cg EP
%%Page: 45 45
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.15(ex)0 12 S
(cept it compares mtime entries instead of ctime entries.).15 E
(<p><dt><b>\255</b><b>-ne)0 24 Q(wer)-.25 E
(-than</b><code></code><code> \214le</code><dd>)-.2 E(\(c, r)0 36 Q 2.5
(,um)-.4 G(odes only\))-2.5 E(Only include \214les and directories ne)0
48 Q(wer than the speci\214ed \214le.)-.25 E
(This compares ctime entries.)0 60 Q(<p><dt><b>\255</b><b>-ne)0 72 Q
(wer)-.25 E(-mtime-than</b><code></code><code> \214le</code><dd>)-.2 E 0
Cg EP
%%Page: 46 46
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\(c, r)0 12 Q 2.5(,um)-.4 G(odes only\))-2.5 E
(Lik)0 24 Q(e)-.1 E(<b>\255</b><b>-ne)0 36 Q(wer)-.25 E(-than</b>,)-.2 E
-.15(ex)0 48 S(cept it compares mtime entries instead of ctime entries.)
.15 E(<p><dt><b>\255</b><b>-nodump</b><dd>)0 60 Q
(\(c and r modes only\))0 72 Q 0 Cg EP
%%Page: 47 47
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(Honor the nodump \214le \215ag by skipping this \214le.)0 12 Q
(<p><dt><b>\255</b><b>-null</b><dd>)0 24 Q(\(use with)0 36 Q
(<b>\255</b><b>I</b>,)0 48 Q(<b>\255</b><b>T</b>,)0 60 Q(or)0 72 Q 0 Cg
EP
%%Page: 48 48
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>\255</b><b>X</b>\))0 12 Q
(Filenames or patterns are separated by null characters,)0 24 Q
(not by ne)0 36 Q(wlines.)-.25 E
(This is often used to read \214lenames output by the)0 48 Q
(<b>\255</b><b>print0</b>)0 60 Q(option to)0 72 Q 0 Cg EP
%%Page: 49 49
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<a href="../html1/\214nd.html">\214nd\(1\)</a>.)
0 12 Q(<p><dt><b>\255</b><b>-numeric-o)0 24 Q(wner</b><dd>)-.25 E
(\(x mode only\))0 36 Q
(Ignore symbolic user and group names when restoring archi)0 48 Q -.15
(ve)-.25 G 2.5(st).15 G 2.5(od)-2.5 G(isk,)-2.5 E
(only numeric uid and gid v)0 60 Q(alues will be obe)-.25 E(yed.)-.15 E
(<p><dt><b>\255</b><b>O</b><dd>)0 72 Q 0 Cg EP
%%Page: 50 50
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\(x, t modes only\))0 12 Q(In e)0 24 Q(xtract \
\(-x\) mode, \214les will be written to standard out rather than)-.15 E
(being e)0 36 Q(xtracted to disk.)-.15 E(In list \(-t\) mode, the \214l\
e listing will be written to stderr rather than)0 48 Q
(the usual stdout.)0 60 Q(<p><dt><b>\255</b><b>o</b><dd>)0 72 Q 0 Cg EP
%%Page: 51 51
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\(x mode\))0 12 Q
(Use the user and group of the user running the program rather)0 24 Q
(than those speci\214ed in the archi)0 36 Q -.15(ve)-.25 G(.).15 E
(Note that this has no signi\214cance unless)0 48 Q(<b>\255</b><b>p</b>)
0 60 Q(is speci\214ed, and the program is being run by the root user)0
72 Q(.)-.55 E 0 Cg EP
%%Page: 52 52
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(In this case, the \214le modes and \215ags from)
0 12 Q(the archi)0 24 Q .3 -.15(ve w)-.25 H(ill be restored, b).15 E
(ut A)-.2 E(CLs or o)-.4 E(wner information in)-.25 E(the archi)0 36 Q
.3 -.15(ve w)-.25 H(ill be discarded.).15 E
(<p><dt><b>\255</b><b>o</b><dd>)0 48 Q(\(c, r)0 60 Q 2.5(,um)-.4 G
(ode\))-2.5 E 2.5(As)0 72 S(ynon)-2.5 E(ym for)-.15 E 0 Cg EP
%%Page: 53 53
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>\255</b><b>-format</b><i></i><i> ustar</i>)0
12 Q(<p><dt><b>\255</b><b>-one-\214le-system</b><dd>)0 24 Q(\(c, r)0 36
Q 2.5(,a)-.4 G(nd u modes\))-2.5 E(Do not cross mount points.)0 48 Q
(<p><dt><b>\255</b><b>-options</b><i></i><i> options</i><dd>)0 60 Q
(Select optional beha)0 72 Q(viors for particular modules.)-.2 E 0 Cg EP
%%Page: 54 54
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(The ar)0 12 Q(gument is a te)-.18 E
(xt string containing comma-separated)-.15 E -.1(ke)0 24 S(yw)-.05 E
(ords and v)-.1 E(alues.)-.25 E
(These are passed to the modules that handle particular)0 36 Q
(formats to control ho)0 48 Q 2.5(wt)-.25 G(hose formats will beha)-2.5
E -.15(ve)-.2 G(.).15 E(Each option has one of the follo)0 60 Q
(wing forms:)-.25 E(<dl compact>)0 72 Q 0 Cg EP
%%Page: 55 55
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<dt><i></i><i>k)0 12 Q -.15(ey)-.1 G(=v).15 E
(alue</i><dd>)-.25 E(The k)0 24 Q .3 -.15(ey w)-.1 H
(ill be set to the speci\214ed v).15 E(alue in e)-.25 E -.15(ve)-.25 G
(ry module that supports it.).15 E(Modules that do not support this k)0
36 Q .3 -.15(ey w)-.1 H(ill ignore it.).15 E(<dt><i></i><i>k)0 48 Q -.15
(ey)-.1 G(</i><dd>).15 E(The k)0 60 Q .3 -.15(ey w)-.1 H
(ill be enabled in e).15 E -.15(ve)-.25 G(ry module that supports it.)
.15 E(This is equi)0 72 Q -.25(va)-.25 G(lent to).25 E 0 Cg EP
%%Page: 56 56
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<i></i><i>k)0 12 Q -.15(ey)-.1 G
(</i><b></b><b>=1</b>.).15 E(<dt><i></i><i>!k)0 24 Q -.15(ey)-.1 G
(</i><dd>).15 E(The k)0 36 Q .3 -.15(ey w)-.1 H(ill be disabled in e).15
E -.15(ve)-.25 G(ry module that supports it.).15 E
(<dt><i></i><i>module:k)0 48 Q -.15(ey)-.1 G(=v).15 E
(alue</i><i></i>,<i> module:k)-.25 E -.15(ey)-.1 G
(</i><i></i>,<i> module:!k).15 E -.15(ey)-.1 G(</i><dd>).15 E(As abo)0
60 Q -.15(ve)-.15 G 2.5(,b).15 G(ut the corresponding k)-2.7 E .3 -.15
(ey a)-.1 H(nd v).15 E(alue will be pro)-.25 E(vided)-.15 E
(only to modules whose name matches)0 72 Q 0 Cg EP
%%Page: 57 57
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<i></i><i>module</i>.)0 12 Q(</dl>)0 24 Q
(The currently supported modules and k)0 36 Q -.15(ey)-.1 G 2.5(sa).15 G
(re:)-2.5 E(<dl compact>)0 48 Q(<dt><b></b><b>iso9660:joliet</b><dd>)0
60 Q(Support Joliet e)0 72 Q(xtensions.)-.15 E 0 Cg EP
%%Page: 58 58
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(This is enabled by def)0 12 Q(ault, use)-.1 E
(<b></b><b>!joliet</b>)0 24 Q(or)0 36 Q(<b></b><b>iso9660:!joliet</b>)0
48 Q(to disable.)0 60 Q(<dt><b></b><b>iso9660:rockridge</b><dd>)0 72 Q 0
Cg EP
%%Page: 59 59
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Support Rock Ridge e)0 12 Q(xtensions.)-.15 E
(This is enabled by def)0 24 Q(ault, use)-.1 E(<b></b><b>!rockridge</b>)
0 36 Q(or)0 48 Q(<b></b><b>iso9660:!rockridge</b>)0 60 Q(to disable.)0
72 Q 0 Cg EP
%%Page: 60 60
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<dt><b></b><b>gzip:compression-le)0 12 Q -.15
(ve)-.25 G(l</b><dd>).15 E 2.5(Ad)0 24 S(ecimal inte)-2.5 E
(ger from 0 to 9 specifying the gzip compression le)-.15 E -.15(ve)-.25
G(l.).15 E(<dt><b></b><b>xz:compression-le)0 36 Q -.15(ve)-.25 G
(l</b><dd>).15 E 2.5(Ad)0 48 S(ecimal inte)-2.5 E
(ger from 0 to 9 specifying the xz compression le)-.15 E -.15(ve)-.25 G
(l.).15 E(<dt><b></b><b>mtree:</b><i></i><i>k)0 60 Q -.15(ey)-.1 G -.1
(wo).15 G(rd</i><dd>).1 E(The mtree writer module allo)0 72 Q
(ws you to specify which mtree k)-.25 E -.15(ey)-.1 G -.1(wo).15 G(rds)
.1 E 0 Cg EP
%%Page: 61 61
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(will be included in the output.)0 12 Q
(Supported k)0 24 Q -.15(ey)-.1 G -.1(wo).15 G(rds include:).1 E
(<b></b><b>cksum</b><b></b>,<b> de)0 36 Q(vice</b><b></b>,<b> \215ags</\
b><b></b>,<b> gid</b><b></b>,<b> gname</b><b></b>,<b> indent</b>,)-.25 E
(<b></b><b>link</b><b></b>,<b> md5</b><b></b>,<b> mode</b><b></b>,<b> n\
link</b><b></b>,<b> rmd160</b><b></b>,<b> sha1</b><b></b>,<b> sha256</b\
>,)0 48 Q(<b></b><b>sha384</b><b></b>,<b> sha512</b><b></b>,<b> size</b\
><b></b>,<b> time</b><b></b>,<b> uid</b><b></b>,<b> uname</b>.)0 60 Q
(The def)0 72 Q(ault is equi)-.1 E -.25(va)-.25 G(lent to:).25 E 0 Cg EP
%%Page: 62 62
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.74(``)0 12 S(de).74 E(vice, \215ags, gid, gna\
me, link, mode, nlink, size, time, type, uid, uname')-.25 E('.)-.74 E
(<dt><b></b><b>mtree:all</b><dd>)0 24 Q(Enables all of the abo)0 36 Q .3
-.15(ve k)-.15 H -.15(ey).05 G -.1(wo).15 G(rds.).1 E -1.1(Yo)0 48 S 2.5
(uc)1.1 G(an also use)-2.5 E(<b></b><b>mtree:!all</b>)0 60 Q
(to disable all k)0 72 Q -.15(ey)-.1 G -.1(wo).15 G(rds.).1 E 0 Cg EP
%%Page: 63 63
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<dt><b></b><b>mtree:use-set</b><dd>)0 12 Q
(Enable generation of)0 24 Q(<b></b><b>/set</b>)0 36 Q
(lines in the output.)0 48 Q(<dt><b></b><b>mtree:indent</b><dd>)0 60 Q
(Produce human-readable output by indenting options and splitting lines)
0 72 Q 0 Cg EP
%%Page: 64 64
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(to \214t into 80 columns.)0 12 Q
(<dt><b></b><b>zip:compression</b>=<i></i><i>type</i><dd>)0 24 Q(Use)0
36 Q(<i></i><i>type</i>)0 48 Q(as compression method.)0 60 Q
(Supported v)0 72 Q
(alues are store \(uncompressed\) and de\215ate \(gzip algorithm\).)-.25
E 0 Cg EP
%%Page: 65 65
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(</dl>)0 12 Q(If a pro)0 24 Q
(vided option is not supported by an)-.15 E 2.5(ym)-.15 G(odule, that)
-2.5 E(is a f)0 36 Q(atal error)-.1 E(.)-.55 E
(<p><dt><b>\255</b><b>P</b><dd>)0 48 Q(Preserv)0 60 Q 2.5(ep)-.15 G
(athnames.)-2.5 E(By def)0 72 Q
(ault, absolute pathnames \(those that be)-.1 E(gin with a /)-.15 E 0 Cg
EP
%%Page: 66 66
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(character\) ha)0 12 Q .3 -.15(ve t)-.2 H
(he leading slash remo).15 E -.15(ve)-.15 G 2.5(db).15 G
(oth when creating archi)-2.5 E -.15(ve)-.25 G(s).15 E(and e)0 24 Q
(xtracting from them.)-.15 E(Also,)0 36 Q(<b>tar</b>)0 48 Q
(will refuse to e)0 60 Q(xtract archi)-.15 E .3 -.15(ve e)-.25 H
(ntries whose pathnames contain).15 E(<code></code><code>..</code>)0 72
Q 0 Cg EP
%%Page: 67 67
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(or whose tar)0 12 Q(get directory w)-.18 E
(ould be altered by a symlink.)-.1 E(This option suppresses these beha)0
24 Q(viors.)-.2 E(<p><dt><b>\255</b><b>p</b><dd>)0 36 Q(\(x mode only\))
0 48 Q(Preserv)0 60 Q 2.5<658c>-.15 G(le permissions.)-2.5 E
(Attempt to restore the full permissions, including o)0 72 Q(wner)-.25 E
2.5<2c8c>-.4 G(le modes, \214le)-2.5 E 0 Cg EP
%%Page: 68 68
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\215ags and A)0 12 Q(CLs, if a)-.4 E -.25(va)-.2
G(ilable, for each item e).25 E(xtracted from the archi)-.15 E -.15(ve)
-.25 G(.).15 E(By def)0 24 Q(ault, ne)-.1 E(wly-created \214les are o)
-.25 E(wned by the user running)-.25 E(<b>,</b>)0 36 Q
(the \214le mode is restored for ne)0 48 Q(wly-created re)-.25 E
(gular \214les, and)-.15 E(all other types of entries recei)0 60 Q .3
-.15(ve d)-.25 H(ef).15 E(ault permissions.)-.1 E(If)0 72 Q 0 Cg EP
%%Page: 69 69
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>tar</b>)0 12 Q(is being run by root, the def)
0 24 Q(ault is to restore the o)-.1 E(wner unless the)-.25 E
(<b>\255</b><b>o</b>)0 36 Q(option is also speci\214ed.)0 48 Q
(<p><dt><b>\255</b><b>q</b><b> \255</b>\(<b>-f)0 60 Q
(ast-read</b><dd>\))-.1 E(\(x and t mode only\))0 72 Q 0 Cg EP
%%Page: 70 70
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Extract or list only the \214rst archi)0 12 Q .3
-.15(ve e)-.25 H(ntry that matches each pattern).15 E
(or \214lename operand.)0 24 Q(Exit as soon as each speci\214ed pattern\
 or \214lename has been matched.)0 36 Q(By def)0 48 Q(ault, the archi)
-.1 E .3 -.15(ve i)-.25 H 2.5(sa).15 G -.1(lwa)-2.5 G(ys read to the v)
.1 E(ery end, since)-.15 E
(there can be multiple entries with the same name and, by con)0 60 Q
-.15(ve)-.4 G(ntion,).15 E(later entries o)0 72 Q -.15(ve)-.15 G
(rwrite earlier entries.).15 E 0 Cg EP
%%Page: 71 71
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(This option is pro)0 12 Q
(vided as a performance optimization.)-.15 E
(<p><dt><b>\255</b><b>S</b><dd>)0 24 Q(\(x mode only\))0 36 Q
(Extract \214les as sparse \214les.)0 48 Q -.15(Fo)0 60 S 2.5(re).15 G
-.15(ve)-2.75 G(ry block on disk, check \214rst if it contains only NUL\
L bytes and seek).15 E -.15(ove)0 72 S 2.5(ri).15 G 2.5(to)-2.5 G
(therwise.)-2.5 E 0 Cg EP
%%Page: 72 72
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(This w)0 12 Q(orks similiar to the con)-.1 E
(v=sparse option of dd.)-.4 E
(<p><dt><b>\255</b><b>-strip-components</b><i></i><i> count</i><dd>)0 24
Q(\(x mode only\))0 36 Q(Remo)0 48 Q .3 -.15(ve t)-.15 H
(he speci\214ed number of leading path elements.).15 E -.15(Pa)0 60 S
(thnames with fe).15 E(wer elements will be silently skipped.)-.25 E
(Note that the pathname is edited after checking inclusion/e)0 72 Q
(xclusion patterns)-.15 E 0 Cg EP
%%Page: 73 73
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.2(bu)0 12 S 2.5(tb).2 G
(efore security checks.)-2.5 E
(<p><dt><b>\255</b><b>s</b><i></i><i> pattern</i><dd>)0 24 Q
(Modify \214le or archi)0 36 Q .3 -.15(ve m)-.25 H
(ember names according to).15 E(<code></code><code>pattern</code>.)0 48
Q(The pattern has the format)0 60 Q(<i></i><i>/old/ne)0 72 Q
(w/</i>[gps])-.25 E 0 Cg EP
%%Page: 74 74
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(where)0 12 Q(<i></i><i>old</i>)0 24 Q
(is a basic re)0 36 Q(gular e)-.15 E(xpression,)-.15 E(<i></i><i>ne)0 48
Q(w</i>)-.25 E(is the replacement string of the matched part,)0 60 Q
(and the optional trailing letters modify)0 72 Q 0 Cg EP
%%Page: 75 75
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(ho)0 12 Q 2.5(wt)-.25 G
(he replacement is handled.)-2.5 E(If)0 24 Q(<i></i><i>old</i>)0 36 Q
(is not matched, the pattern is skipped.)0 48 Q -.4(Wi)0 60 S(thin).4 E
(<i></i><i>ne)0 72 Q(w</i>,)-.25 E 0 Cg EP
%%Page: 76 76
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 2.5(~i)0 12 S 2.5(ss)-2.5 G
(ubstituted with the match, 1 to 9 with the content of)-2.5 E
(the corresponding captured group.)0 24 Q
(The optional trailing g speci\214es that matching should continue)0 36
Q(after the matched part and stopped on the \214rst unmatched pattern.)0
48 Q
(The optional trailing s speci\214es that the pattern applies to the v)0
60 Q(alue)-.25 E(of symbolic links.)0 72 Q 0 Cg EP
%%Page: 77 77
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(The optional trailing p speci\214es that after \
a successful substitution)0 12 Q(the original path name and the ne)0 24
Q 2.5(wp)-.25 G(ath name should be printed to)-2.5 E(standard error)0 36
Q(.)-.55 E(<p><dt><b>\255</b><b>T</b><i></i><i> \214lename</i><dd>)0 48
Q(In x or t mode,)0 60 Q(<b>tar</b>)0 72 Q 0 Cg EP
%%Page: 78 78
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(will read the list of names to be e)0 12 Q
(xtracted from)-.15 E(<code></code><code>\214lename</code>.)0 24 Q
(In c mode,)0 36 Q(<b>tar</b>)0 48 Q(will read names to be archi)0 60 Q
-.15(ve)-.25 G 2.5(df).15 G(rom)-2.5 E
(<code></code><code>\214lename</code>.)0 72 Q 0 Cg EP
%%Page: 79 79
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(The special name)0 12 Q -.74(``)0 24 S(-C').74 E
(')-.74 E
(on a line by itself will cause the current directory to be changed to)0
36 Q(the directory speci\214ed on the follo)0 48 Q(wing line.)-.25 E
(Names are terminated by ne)0 60 Q(wlines unless)-.25 E
(<b>\255</b><b>-null</b>)0 72 Q 0 Cg EP
%%Page: 80 80
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(is speci\214ed.)0 12 Q(Note that)0 24 Q
(<b>\255</b><b>-null</b>)0 36 Q
(also disables the special handling of lines containing)0 48 Q -.74(``)0
60 S(-C').74 E('.)-.74 E(<p><dt><b>\255</b><b>U</b><dd>)0 72 Q 0 Cg EP
%%Page: 81 81
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\(x mode only\))0 12 Q
(Unlink \214les before creating them.)0 24 Q -.4(Wi)0 36 S
(thout this option,).4 E(<b>tar</b>)0 48 Q -.15(ove)0 60 S(rwrites e).15
E(xisting \214les, which preserv)-.15 E(es e)-.15 E(xisting hardlinks.)
-.15 E -.4(Wi)0 72 S(th this option, e).4 E
(xisting hardlinks will be brok)-.15 E(en, as will an)-.1 E(y)-.15 E 0
Cg EP
%%Page: 82 82
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(symlink that w)0 12 Q(ould af)-.1 E
(fect the location of an e)-.25 E(xtracted \214le.)-.15 E(<p><dt><b>\
\255</b><b>-use-compress-program</b><i></i><i> program</i><dd>)0 24 Q
(Pipe the input \(in x or t mode\) or the output \(in c mode\) through)0
36 Q(<code></code><code>program</code>)0 48 Q(instead of using the b)0
60 Q(uiltin compression support.)-.2 E(<p><dt><b>\255</b><b>v</b><dd>)0
72 Q 0 Cg EP
%%Page: 83 83
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Produce v)0 12 Q(erbose output.)-.15 E
(In create and e)0 24 Q(xtract modes,)-.15 E(<b>tar</b>)0 36 Q
(will list each \214le name as it is read from or written to)0 48 Q
(the archi)0 60 Q -.15(ve)-.25 G(.).15 E(In list mode,)0 72 Q 0 Cg EP
%%Page: 84 84
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>tar</b>)0 12 Q
(will produce output similar to that of)0 24 Q
(<a href="../html1/ls.html">ls\(1\)</a>.)0 36 Q(Additional)0 48 Q
(<b>\255</b><b>v</b>)0 60 Q(options will pro)0 72 Q
(vide additional detail.)-.15 E 0 Cg EP
%%Page: 85 85
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p><dt><b>\255</b><b>-v)0 12 Q(ersion</b><dd>)
-.15 E(Print v)0 24 Q(ersion of)-.15 E(<b>tar</b>)0 36 Q(and)0 48 Q
(<b>libarchi)0 60 Q -.15(ve)-.25 G(</b>,).15 E(and e)0 72 Q(xit.)-.15 E
0 Cg EP
%%Page: 86 86
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p><dt><b>\255</b><b>w</b><dd>)0 12 Q
(Ask for con\214rmation for e)0 24 Q -.15(ve)-.25 G(ry action.).15 E
(<p><dt><b>\255</b><b>X</b><i></i><i> \214lename</i><dd>)0 36 Q
(Read a list of e)0 48 Q(xclusion patterns from the speci\214ed \214le.)
-.15 E(See)0 60 Q(<b>\255</b><b>-e)0 72 Q(xclude</b>)-.15 E 0 Cg EP
%%Page: 87 87
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(for more information about the handling of e)0
12 Q(xclusions.)-.15 E(<p><dt><b>\255</b><b>y</b><dd>)0 24 Q
(\(c mode only\))0 36 Q(Compress the resulting archi)0 48 Q .3 -.15
(ve w)-.25 H(ith).15 E(<a href="../html1/bzip2.html">bzip2\(1\)</a>.)0
60 Q(In e)0 72 Q(xtract or list modes, this option is ignored.)-.15 E 0
Cg EP
%%Page: 88 88
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Note that, unlik)0 12 Q 2.5(eo)-.1 G(ther)-2.5 E
(<b>tar</b>)0 24 Q
(implementations, this implementation recognizes bzip2 compression)0 36
Q(automatically when reading archi)0 48 Q -.15(ve)-.25 G(s.).15 E
(<p><dt><b>\255</b><b>z</b><dd>)0 60 Q(\(c mode only\))0 72 Q 0 Cg EP
%%Page: 89 89
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Compress the resulting archi)0 12 Q .3 -.15
(ve w)-.25 H(ith).15 E(<a href="../html1/gzip.html">gzip\(1\)</a>.)0 24
Q(In e)0 36 Q(xtract or list modes, this option is ignored.)-.15 E
(Note that, unlik)0 48 Q 2.5(eo)-.1 G(ther)-2.5 E(<b>tar</b>)0 60 Q
(implementations, this implementation recognizes gzip compression)0 72 Q
0 Cg EP
%%Page: 90 90
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(automatically when reading archi)0 12 Q -.15(ve)
-.25 G(s.).15 E(<p><dt><b>\255</b><b>Z</b><dd>)0 24 Q(\(c mode only\))0
36 Q(Compress the resulting archi)0 48 Q .3 -.15(ve w)-.25 H(ith).15 E
(<a href="../html1/compress.html">compress\(1\)</a>.)0 60 Q(In e)0 72 Q
(xtract or list modes, this option is ignored.)-.15 E 0 Cg EP
%%Page: 91 91
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Note that, unlik)0 12 Q 2.5(eo)-.1 G(ther)-2.5 E
(<b>tar</b>)0 24 Q
(implementations, this implementation recognizes compress compression)0
36 Q(automatically when reading archi)0 48 Q -.15(ve)-.25 G(s.).15 E
(</dl>)0 60 Q(<h3 id="ENVIR)36 72 Q(ONMENT">)-.4 E 0 Cg EP
%%Page: 92 92
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(ENVIR)36 12 Q(ONMENT)-.4 E(</h3>)36 24 Q
(The follo)0 36 Q(wing en)-.25 E(vironment v)-.4 E(ariables af)-.25 E
(fect the e)-.25 E -.15(xe)-.15 G(cution of).15 E(<b>:</b>)0 48 Q
(<dl compact>)0 60 Q(<p><dt><code></code><code>LANG</code><dd>)0 72 Q 0
Cg EP
%%Page: 93 93
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(The locale to use.)0 12 Q(See)0 24 Q
(<a href="../html7/en)0 36 Q(viron.html">en)-.4 E(viron\(7\)</a>)-.4 E
(for more information.)0 48 Q(<p><dt><code></code><code>T)0 60 Q
(APE</code><dd>)-.93 E(The def)0 72 Q(ault tape de)-.1 E(vice.)-.25 E 0
Cg EP
%%Page: 94 94
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(The)0 12 Q(<b>\255</b><b>f</b>)0 24 Q(option o)0
36 Q -.15(ve)-.15 G(rrides this.).15 E
(<p><dt><code></code><code>TZ</code><dd>)0 48 Q
(The timezone to use when displaying dates.)0 60 Q(See)0 72 Q 0 Cg EP
%%Page: 95 95
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<a href="../html7/en)0 12 Q(viron.html">en)-.4 E
(viron\(7\)</a>)-.4 E(for more information.)0 24 Q(</dl>)0 36 Q
(<h3 id="FILES">)36 48 Q(FILES)36 60 Q(</h3>)36 72 Q 0 Cg EP
%%Page: 96 96
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<dl compact>)0 12 Q
(<p><dt><code></code><code>/de)0 24 Q(v/sa0</code><dd>)-.25 E(The def)0
36 Q(ault tape de)-.1 E(vice, if not o)-.25 E -.15(ve)-.15 G
(rridden by the).15 E(<code></code><code>T)0 48 Q(APE</code>)-.93 E(en)0
60 Q(vironment v)-.4 E(ariable or the)-.25 E(<b>\255</b><b>f</b>)0 72 Q
0 Cg EP
%%Page: 97 97
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(option.)0 12 Q(</dl>)0 24 Q(<h3 id="EXIT ST)36
36 Q -1.11(AT)-.93 G(US">)1.11 E(EXIT ST)36 48 Q -1.11(AT)-.93 G(US)1.11
E(</h3>)36 60 Q(<h3 id="EXAMPLES">)36 72 Q 0 Cg EP
%%Page: 98 98
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(EXAMPLES)36 12 Q(</h3>)36 24 Q(The follo)0 36 Q
(wing creates a ne)-.25 E 2.5(wa)-.25 G(rchi)-2.5 E -.15(ve)-.25 G
(called)0 48 Q(<i></i><i>\214le.tar)0 60 Q(.gz</i>)-.55 E
(that contains tw)0 72 Q 2.5<6f8c>-.1 G(les)-2.5 E 0 Cg EP
%%Page: 99 99
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<i></i><i>source.c</i>)0 12 Q(and)0 24 Q
(<i></i><i>source.h</i>:)0 36 Q(<br>)0 48 Q
(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 60 Q
(<code></code><b>Fl</b><b>czf</b><code></code><code> \214le.tar)0 72 Q(\
.gz</code><code></code><code> source.c</code><code></code><code> source\
.h</code>)-.55 E 0 Cg EP
%%Page: 100 100
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<br>)0 12 Q(<p>)36 24 Q 1.6 -.8(To v)0 36 T(ie)
.8 E 2.5(wad)-.25 G(etailed table of contents for this)-2.5 E(archi)0 48
Q -.15(ve)-.25 G(:).15 E(<br>)0 60 Q
(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 72 Q 0 Cg EP
%%Page: 101 101
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(<code></code><b>Fl</b><b>tvf</b><code></code><code> \214le.tar)0 12 Q
(.gz</code>)-.55 E(<br>)0 24 Q(<p>)36 36 Q 1.6 -.8(To e)0 48 T
(xtract all entries from the archi).65 E .3 -.15(ve o)-.25 H(n).15 E
(the def)0 60 Q(ault tape dri)-.1 E -.15(ve)-.25 G(:).15 E(<br>)0 72 Q 0
Cg EP
%%Page: 102 102
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 12 Q
(<code></code><b>Fl</b><b>x</b>)0 24 Q(<br>)0 36 Q(<p>)36 48 Q 1.6 -.8
(To e)0 60 T(xamine the contents of an ISO 9660 cdrom image:).65 E(<br>)
0 72 Q 0 Cg EP
%%Page: 103 103
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 12 Q
(<code></code><b>Fl</b><b>tf</b><code></code><code> image.iso</code>)0
24 Q(<br>)0 36 Q(<p>)36 48 Q 1.6 -.8(To m)0 60 T .3 -.15(ove \214).8 H
(le hierarchies, in).15 E -.2(vo)-.4 G -.1(ke).2 G(<b>tar</b>)0 72 Q 0
Cg EP
%%Page: 104 104
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(as)0 12 Q(<br>)0 24 Q
(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 36 Q(<code></code><b>Fl</b><b>c\
f</b><code></code><code> -</code><b> \255</b><b>C</b><code></code><code\
> srcdir .</code><code> |</code><b>Fl</b><b> xpf</b><code></code><code>\
 -</code><b> \255</b><b>C</b><code></code><code> destdir</code>)0 48 Q
(<br>)0 60 Q(or more traditionally)0 72 Q 0 Cg EP
%%Page: 105 105
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<br>)0 12 Q
(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 24 Q(<code></code><code>cd</cod\
e><code> srcdir</code><code> ;</code><b>Fl</b><b> cf</b><code></code><c\
ode> - .</code><code> |</code>\(<code> cd</code><code> destdir</code><c\
ode> ;</code><b>Fl</b><b> xpf</b><code></code><code> -</code>\))0 36 Q
(<br>)0 48 Q(<p>)36 60 Q
(In create mode, the list of \214les and directories to be archi)0 72 Q
-.15(ve)-.25 G(d).15 E 0 Cg EP
%%Page: 106 106
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(can also include directory change instructions of the form)0 12 Q
(<b></b><b>-C</b><code></code><code>foo/baz</code>)0 24 Q(and archi)0 36
Q .3 -.15(ve i)-.25 H(nclusions of the form).15 E
(<b></b><b>@</b><code></code><code>archi)0 48 Q -.15(ve)-.25 G
(-\214le</code>.).15 E -.15(Fo)0 60 S 2.5(re).15 G
(xample, the command line)-2.65 E(<br>)0 72 Q 0 Cg EP
%%Page: 107 107
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 12 Q(<co\
de></code><b>Fl</b><b>c</b><b> \255</b><b>f</b><code></code><code> ne)0
24 Q -.65(w.)-.25 G(tar</code><code></code><code> foo1</code><b></b><b>\
 @</b><code></code><code>old.tgz</code><b></b><b> -C</b><code></code><c\
ode>/tmp</code><code></code><code> foo2</code>).65 E(<br>)0 36 Q
(will create a ne)0 48 Q 2.5(wa)-.25 G(rchi)-2.5 E -.15(ve)-.25 G
(<code></code><code>ne)0 60 Q -.65(w.)-.25 G(tar</code>.).65 E
(<b>tar</b>)0 72 Q 0 Cg EP
%%Page: 108 108
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(will read the \214le)0 12 Q
(<code></code><code>foo1</code>)0 24 Q
(from the current directory and add it to the output archi)0 36 Q -.15
(ve)-.25 G(.).15 E(It will then read each entry from)0 48 Q
(<code></code><code>old.tgz</code>)0 60 Q
(and add those entries to the output archi)0 72 Q -.15(ve)-.25 G(.).15 E
0 Cg EP
%%Page: 109 109
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Finally)0 12 Q 2.5(,i)-.65 G 2.5(tw)-2.5 G
(ill switch to the)-2.5 E(<code></code><code>/tmp</code>)0 24 Q
(directory and add)0 36 Q(<code></code><code>foo2</code>)0 48 Q
(to the output archi)0 60 Q -.15(ve)-.25 G(.).15 E(<p>)36 72 Q 0 Cg EP
%%Page: 110 110
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(An input \214le in)0 12 Q
(<a href="../html5/mtree.html">mtree\(5\)</a>)0 24 Q
(format can be used to create an output archi)0 36 Q .3 -.15(ve w)-.25 H
(ith arbitrary o).15 E(wnership,)-.25 E(permissions, or names that dif)0
48 Q(fer from e)-.25 E(xisting data on disk:)-.15 E(<p>)36 60 Q(<br>)0
72 Q 0 Cg EP
%%Page: 111 111
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 12 Q
(<code></code><code>$</code><code> cat</code><code> input.mtree</code>)0
24 Q(<br>)0 36 Q(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 48 Q
(<code></code><code>#mtree</code>)0 60 Q(<br>)0 72 Q 0 Cg EP
%%Page: 112 112
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 12 Q(<co\
de></code><code>usr/bin</code><code> uid=0</code><code> gid=0</code><co\
de> mode=0755</code><code> type=dir</code>)0 24 Q(<br>)0 36 Q
(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 48 Q(<code></code><code>usr/bin\
/ls</code><code> uid=0</code><code> gid=0</code><code> mode=0755</code>\
<code> type=\214le</code><code> content=myls</code>)0 60 Q(<br>)0 72 Q 0
Cg EP
%%Page: 113 113
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 12 Q(<co\
de></code><code>$</code><code> tar</code><code> -cvf</code><code> outpu\
t.tar</code><code> @input.mtree</code>)0 24 Q(<br>)0 36 Q(<p>)36 48 Q
(The)0 60 Q(<b>\255</b><b>-ne)0 72 Q(wer</b>)-.25 E 0 Cg EP
%%Page: 114 114
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(and)0 12 Q(<b>\255</b><b>-ne)0 24 Q(wer)-.25 E
(-mtime</b>)-.2 E(switches accept a v)0 36 Q
(ariety of common date and time speci\214cations, including)-.25 E -.74
(``)0 48 S(12 Mar 2005 7:14:29pm').74 E(',)-.74 E -.74(``)0 60 S
(2005-03-12 19:14').74 E(',)-.74 E -.74(``)0 72 S 2.5(5m).74 G
(inutes ago')-2.5 E(',)-.74 E 0 Cg EP
%%Page: 115 115
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(and)0 12 Q -.74(``)0 24 S(19:14 PST May 1').74 E
('.)-.74 E(<p>)36 36 Q(The)0 48 Q(<b>\255</b><b>-options</b>)0 60 Q(ar)0
72 Q(gument can be used to control v)-.18 E(arious details of archi)-.25
E .3 -.15(ve g)-.25 H(eneration).15 E 0 Cg EP
%%Page: 116 116
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(or reading.)0 12 Q -.15(Fo)0 24 S 2.5(re).15 G
(xample, you can generate mtree output which only contains)-2.65 E
(<b></b><b>type</b><b></b>,<b> time</b>,)0 36 Q(and)0 48 Q
(<b></b><b>uid</b>)0 60 Q -.1(ke)0 72 S(yw)-.05 E(ords:)-.1 E 0 Cg EP
%%Page: 117 117
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<br>)0 12 Q
(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 24 Q(<code></code><b>Fl</b><b>c\
f</b><code></code><code> \214le.tar</code><b> \255</b><b>-format=mtree<\
/b><b> \255</b><b>-options='!all,type,time,uid'</b><code></code><code> \
dir</code>)0 36 Q(<br>)0 48 Q(or you can set the compression le)0 60 Q
-.15(ve)-.25 G 2.5(lu).15 G(sed by gzip or xz compression:)-2.5 E(<br>)0
72 Q 0 Cg EP
%%Page: 118 118
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 12 Q(<co\
de></code><b>Fl</b><b>czf</b><code></code><code> \214le.tar</code><b> \
\255</b><b>-options='compression-le)0 24 Q -.15(ve)-.25 G(l=9'</b>.).15
E(<br>)0 36 Q -.15(Fo)0 48 S 2.5(rm).15 G(ore details, see the e)-2.5 E
(xplanation of the)-.15 E(<b>archi)0 60 Q -.15(ve)-.25 G
(_read_set_options</b>\(<code></code>\)).15 E(and)0 72 Q 0 Cg EP
%%Page: 119 119
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>archi)0 12 Q -.15(ve)-.25 G
(_write_set_options</b>\(<code></code>\)).15 E
(API calls that are described in)0 24 Q(<a href="../html3/archi)0 36 Q
-.15(ve)-.25 G(_read.html">archi).15 E -.15(ve)-.25 G(_read\(3\)</a>).15
E(and)0 48 Q(<a href="../html3/archi)0 60 Q -.15(ve)-.25 G
(_write.html">archi).15 E -.15(ve)-.25 G(_write\(3\)</a>.).15 E
(<h3 id="COMP)36 72 Q -1.11(AT)-.92 G(IBILITY">)1.11 E 0 Cg EP
%%Page: 120 120
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(COMP)36 12 Q -1.11(AT)-.92 G(IBILITY)1.11 E
(</h3>)36 24 Q(The b)0 36 Q(undled-ar)-.2 E
(guments format is supported for compatibility)-.18 E
(with historic implementations.)0 48 Q(It consists of an initial w)0 60
Q(ord \(with no leading - character\) in which)-.1 E
(each character indicates an option.)0 72 Q 0 Cg EP
%%Page: 121 121
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Ar)0 12 Q(guments follo)-.18 E 2.5(wa)-.25 G 2.5
(ss)-2.5 G(eparate w)-2.5 E(ords.)-.1 E(The order of the ar)0 24 Q
(guments must match the order)-.18 E
(of the corresponding characters in the b)0 36 Q(undled command w)-.2 E
(ord.)-.1 E -.15(Fo)0 48 S 2.5(re).15 G(xample,)-2.65 E(<br>)0 60 Q
(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 72 Q 0 Cg EP
%%Page: 122 122
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<code></code><b>Cm</b><b>tbf</b><b> 32</b><code\
></code><code> \214le.tar</code>)0 12 Q(<br>)0 24 Q
(speci\214es three \215ags)0 36 Q(<b></b><b>t</b>,)0 48 Q
(<b></b><b>b</b>,)0 60 Q(and)0 72 Q 0 Cg EP
%%Page: 123 123
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b></b><b>f</b>.)0 12 Q(The)0 24 Q
(<b></b><b>b</b>)0 36 Q(and)0 48 Q(<b></b><b>f</b>)0 60 Q
(\215ags both require ar)0 72 Q(guments,)-.18 E 0 Cg EP
%%Page: 124 124
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(so there must be tw)0 12 Q 2.5(oa)-.1 G
(dditional items)-2.5 E(on the command line.)0 24 Q(The)0 36 Q
(<i></i><i>32</i>)0 48 Q(is the ar)0 60 Q(gument to the)-.18 E
(<b></b><b>b</b>)0 72 Q 0 Cg EP
%%Page: 125 125
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\215ag, and)0 12 Q(<i></i><i>\214le.tar</i>)0 24
Q(is the ar)0 36 Q(gument to the)-.18 E(<b></b><b>f</b>)0 48 Q(\215ag.)0
60 Q(<p>)36 72 Q 0 Cg EP
%%Page: 126 126
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(The mode options c, r)0 12 Q 2.5(,t)-.4 G 2.5
(,u)-2.5 G 2.5(,a)-2.5 G(nd x and the options)-2.5 E(b, f, l, m, o, v)0
24 Q 2.5(,a)-.65 G(nd w comply with SUSv2.)-2.5 E(<p>)36 36 Q -.15(Fo)0
48 S 2.5(rm).15 G(aximum portability)-2.5 E 2.5(,s)-.65 G
(cripts that in)-2.5 E -.2(vo)-.4 G -.1(ke).2 G(<b>tar</b>)0 60 Q
(should use the b)0 72 Q(undled-ar)-.2 E(gument format abo)-.18 E -.15
(ve)-.15 G 2.5(,s).15 G(hould limit)-2.5 E 0 Cg EP
%%Page: 127 127
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(themselv)0 12 Q(es to the)-.15 E
(<b></b><b>c</b>,)0 24 Q(<b></b><b>t</b>,)0 36 Q(and)0 48 Q
(<b></b><b>x</b>)0 60 Q(modes, and the)0 72 Q 0 Cg EP
%%Page: 128 128
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b></b><b>b</b>,)0 12 Q(<b></b><b>f</b>,)0 24 Q
(<b></b><b>m</b>,)0 36 Q(<b></b><b>v</b>,)0 48 Q(and)0 60 Q
(<b></b><b>w</b>)0 72 Q 0 Cg EP
%%Page: 129 129
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(options.)0 12 Q(<p>)36 24 Q
(Additional long options are pro)0 36 Q(vided to impro)-.15 E .3 -.15
(ve c)-.15 H(ompatibility with other).15 E(tar implementations.)0 48 Q
(<h3 id="SECURITY">)36 60 Q(SECURITY)36 72 Q 0 Cg EP
%%Page: 130 130
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(</h3>)36 12 Q
(Certain security issues are common to man)0 24 Q 2.5(ya)-.15 G(rchi)
-2.5 E(ving programs, including)-.25 E(<b>.</b>)0 36 Q(In particular)0
48 Q 2.5(,c)-.4 G(arefully-crafted archi)-2.5 E -.15(ve)-.25 G 2.5(sc)
.15 G(an request that)-2.5 E(<b>tar</b>)0 60 Q -.15(ex)0 72 S
(tract \214les to locations outside of the tar).15 E(get directory)-.18
E(.)-.65 E 0 Cg EP
%%Page: 131 131
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(This can potentially be used to cause unwitting users to o)0 12 Q -.15
(ve)-.15 G(rwrite).15 E(\214les the)0 24 Q 2.5(yd)-.15 G
(id not intend to o)-2.5 E -.15(ve)-.15 G(rwrite.).15 E(If the archi)0
36 Q .3 -.15(ve i)-.25 H 2.5(sb).15 G(eing e)-2.5 E
(xtracted by the superuser)-.15 E 2.5(,a)-.4 G .3 -.15(ny \214)-2.5 H
(le).15 E(on the system can potentially be o)0 48 Q -.15(ve)-.15 G
(rwritten.).15 E(There are three w)0 60 Q(ays this can happen.)-.1 E
(Although)0 72 Q 0 Cg EP
%%Page: 132 132
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>tar</b>)0 12 Q(has mechanisms to protect ag)0
24 Q(ainst each one,)-.05 E(sa)0 36 Q(vvy users should be a)-.2 E -.1
(wa)-.15 G(re of the implications:).1 E(<ul>)0 48 Q(<p><li>)0 60 Q
(Archi)0 72 Q .3 -.15(ve e)-.25 H(ntries can ha).15 E .3 -.15(ve a)-.2 H
(bsolute pathnames.).15 E 0 Cg EP
%%Page: 133 133
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(By def)0 12 Q(ault,)-.1 E(<b>tar</b>)0 24 Q
(remo)0 36 Q -.15(ve)-.15 G 2.5(st).15 G(he leading)-2.5 E
(<code></code><code>/</code>)0 48 Q
(character from \214lenames before restoring them to guard ag)0 60 Q
(ainst this problem.)-.05 E(<p><li>)0 72 Q 0 Cg EP
%%Page: 134 134
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Archi)0 12 Q .3 -.15(ve e)-.25 H(ntries can ha)
.15 E .3 -.15(ve p)-.2 H(athnames that include).15 E
(<code></code><code>..</code>)0 24 Q(components.)0 36 Q(By def)0 48 Q
(ault,)-.1 E(<b>tar</b>)0 60 Q(will not e)0 72 Q
(xtract \214les containing)-.15 E 0 Cg EP
%%Page: 135 135
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<code></code><code>..</code>)0 12 Q
(components in their pathname.)0 24 Q(<p><li>)0 36 Q(Archi)0 48 Q .3
-.15(ve e)-.25 H(ntries can e).15 E(xploit symbolic links to restore)
-.15 E(\214les to other directories.)0 60 Q(An archi)0 72 Q .3 -.15
(ve c)-.25 H(an restore a symbolic link to another directory).15 E(,)
-.65 E 0 Cg EP
%%Page: 136 136
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(then use that link to restore a \214le into that directory)0 12 Q(.)
-.65 E 1.6 -.8(To g)0 24 T(uard ag).8 E(ainst this,)-.05 E(<b>tar</b>)0
36 Q(checks each e)0 48 Q(xtracted path for symlinks.)-.15 E
(If the \214nal path element is a symlink, it will be remo)0 60 Q -.15
(ve)-.15 G(d).15 E(and replaced with the archi)0 72 Q .3 -.15(ve e)-.25
H(ntry).15 E(.)-.65 E 0 Cg EP
%%Page: 137 137
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(If)0 12 Q(<b>\255</b><b>U</b>)0 24 Q
(is speci\214ed, an)0 36 Q 2.5(yi)-.15 G
(ntermediate symlink will also be unconditionally remo)-2.5 E -.15(ve)
-.15 G(d.).15 E(If neither)0 48 Q(<b>\255</b><b>U</b>)0 60 Q(nor)0 72 Q
0 Cg EP
%%Page: 138 138
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>\255</b><b>P</b>)0 12 Q(is speci\214ed,)0 24
Q(<b>tar</b>)0 36 Q(will refuse to e)0 48 Q(xtract the entry)-.15 E(.)
-.65 E(</ul>)0 60 Q 1.6 -.8(To p)0 72 T
(rotect yourself, you should be w).8 E(ary of an)-.1 E 2.5(ya)-.15 G
(rchi)-2.5 E -.15(ve)-.25 G 2.5(st).15 G(hat)-2.5 E 0 Cg EP
%%Page: 139 139
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(come from untrusted sources.)0 12 Q -1.1(Yo)0 24
S 2.5(us)1.1 G(hould e)-2.5 E(xamine the contents of an archi)-.15 E .3
-.15(ve w)-.25 H(ith).15 E(<br>)0 36 Q
(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 48 Q
(<code></code><b>Fl</b><b>tf</b><code></code><code> \214lename</code>)0
60 Q(<br>)0 72 Q 0 Cg EP
%%Page: 140 140
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(before e)0 12 Q(xtraction.)-.15 E -1.1(Yo)0 24 S
2.5(us)1.1 G(hould use the)-2.5 E(<b>\255</b><b>k</b>)0 36 Q
(option to ensure that)0 48 Q(<b>tar</b>)0 60 Q(will not o)0 72 Q -.15
(ve)-.15 G(rwrite an).15 E 2.5(ye)-.15 G(xisting \214les or the)-2.65 E
0 Cg EP
%%Page: 141 141
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>\255</b><b>U</b>)0 12 Q(option to remo)0 24 Q
.3 -.15(ve a)-.15 H .3 -.15(ny p).15 H(re-e).15 E(xisting \214les.)-.15
E -1.1(Yo)0 36 S 2.5(us)1.1 G(hould generally not e)-2.5 E(xtract archi)
-.15 E -.15(ve)-.25 G 2.5(sw).15 G(hile running with super)-2.5 E(-user)
-.2 E(pri)0 48 Q(vile)-.25 E(ges.)-.15 E(Note that the)0 60 Q
(<b>\255</b><b>P</b>)0 72 Q 0 Cg EP
%%Page: 142 142
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(option to)0 12 Q(<b>tar</b>)0 24 Q
(disables the security checks abo)0 36 Q .3 -.15(ve a)-.15 H(nd allo).15
E(ws you to e)-.25 E(xtract)-.15 E(an archi)0 48 Q .3 -.15(ve w)-.25 H
(hile preserving an).15 E 2.5(ya)-.15 G(bsolute pathnames,)-2.5 E
(<code></code><code>..</code>)0 60 Q
(components, or symlinks to other directories.)0 72 Q 0 Cg EP
%%Page: 143 143
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<h3 id="SEE ALSO">)36 12 Q(SEE ALSO)36 24 Q
(</h3>)36 36 Q(<a href="../html1/bzip2.html">bzip2\(1\)</a>,)0 48 Q
(<a href="../html1/compress.html">compress\(1\)</a>,)0 60 Q
(<a href="../html1/cpio.html">cpio\(1\)</a>,)0 72 Q 0 Cg EP
%%Page: 144 144
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<a href="../html1/gzip.html">gzip\(1\)</a>,)0 12
Q(<a href="../html1/mt.html">mt\(1\)</a>,)0 24 Q
(<a href="../html1/pax.html">pax\(1\)</a>,)0 36 Q
(<a href="../html1/shar)0 48 Q(.html">shar\(1\)</a>,)-.55 E
(<a href="../html3/libarchi)0 60 Q -.15(ve)-.25 G(.html">libarchi).15 E
-.15(ve)-.25 G(\(3\)</a>,).15 E(<a href="../html5/libarchi)0 72 Q -.15
(ve)-.25 G(-formats.html">libarchi).15 E -.15(ve)-.25 G
(-formats\(5\)</a>,).15 E 0 Cg EP
%%Page: 145 145
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<a href="../html5/tar)0 12 Q
(.html">tar\(5\)</a>)-.55 E(<h3 id="ST)36 24 Q(AND)-.93 E(ARDS">)-.4 E
(ST)36 36 Q(AND)-.93 E(ARDS)-.4 E(</h3>)36 48 Q
(There is no current POSIX standard for the tar command; it appeared)0
60 Q(in)0 72 Q 0 Cg EP
%%Page: 146 146
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(ISO/IEC 9945-1:1996 \(`)2.5 12 Q
(`<font size="-1">POSIX</font>.1')-.74 E('\))-.74 E -.2(bu)0 24 S 2.5
(tw).2 G(as dropped from)-2.6 E(IEEE Std 1003.1-2001 \(`)2.5 36 Q
(`<font size="-1">POSIX</font>.1')-.74 E('\) .)-.74 E
(The options used by this implementation were de)0 48 Q -.15(ve)-.25 G
(loped by surv).15 E -.15(ey)-.15 G(ing a).15 E(number of e)0 60 Q
(xisting tar implementations as well as the old POSIX speci\214cation)
-.15 E(for tar and the current POSIX speci\214cation for pax.)0 72 Q 0
Cg EP
%%Page: 147 147
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p>)36 12 Q
(The ustar and pax interchange \214le formats are de\214ned by)0 24 Q
(IEEE Std 1003.1-2001 \(`)2.5 36 Q(`<font size="-1">POSIX</font>.1')-.74
E('\))-.74 E(for the pax command.)0 48 Q(<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: 148 148
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(</h3>)36 12 Q(A)0 24 Q(<b>tar</b>)0 36 Q
(command appeared in Se)0 48 Q -.15(ve)-.25 G(nth Edition Unix, which w)
.15 E(as released in January)-.1 E 2.5(,1)-.65 G(979.)-2.5 E(There ha)0
60 Q .3 -.15(ve b)-.2 H(een numerous other implementations,).15 E(man)0
72 Q 2.5(yo)-.15 G 2.5(fw)-2.5 G(hich e)-2.5 E
(xtended the \214le format.)-.15 E 0 Cg EP
%%Page: 149 149
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(John Gilmore')0 12 Q(s)-.55 E(<b>pdtar</b>)0 24
Q(public-domain implementation \(circa No)0 36 Q -.15(ve)-.15 G(mber).15
E 2.5(,1)-.4 G(987\))-2.5 E -.1(wa)0 48 S 2.5(sq).1 G
(uite in\215uential, and formed the basis of GNU tar)-2.5 E(.)-.55 E
(GNU tar w)0 60 Q(as included as the standard system tar)-.1 E(in)0 72 Q
0 Cg EP
%%Page: 150 150
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(FreeBSD)0 12 Q(be)0 24 Q(ginning with)-.15 E
(FreeBSD1.0.)0 36 Q(<p>)36 48 Q
(This is a complete re-implementation based on the)0 60 Q
(<a href="../html3/libarchi)0 72 Q -.15(ve)-.25 G(.html">libarchi).15 E
-.15(ve)-.25 G(\(3\)</a>).15 E 0 Cg EP
%%Page: 151 151
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(library)0 12 Q(.)-.65 E(<h3 id="B)36 24 Q(UGS">)
-.1 E -.1(BU)36 36 S(GS).1 E(</h3>)36 48 Q(This program follo)0 60 Q(ws)
-.25 E(ISO/IEC 9945-1:1996 \(`)2.5 72 Q
(`<font size="-1">POSIX</font>.1')-.74 E('\))-.74 E 0 Cg EP
%%Page: 152 152
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(for the de\214nition of the)0 12 Q
(<b>\255</b><b>l</b>)0 24 Q(option.)0 36 Q(Note that GNU tar prior to v)
0 48 Q(ersion 1.15 treated)-.15 E(<b>\255</b><b>l</b>)0 60 Q(as a synon)
0 72 Q(ym for the)-.15 E 0 Cg EP
%%Page: 153 153
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<b>\255</b><b>-one-\214le-system</b>)0 12 Q
(option.)0 24 Q(<p>)36 36 Q(The)0 48 Q
(<b>\255</b><b>C</b><code></code><code> dir</code>)0 60 Q
(option may dif)0 72 Q(fer from historic implementations.)-.25 E 0 Cg EP
%%Page: 154 154
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p>)36 12 Q(All archi)0 24 Q .3 -.15(ve o)-.25 H
(utput is written in correctly-sized blocks, e).15 E -.15(ve)-.25 G(n)
.15 E(if the output is being compressed.)0 36 Q
(Whether or not the last output block is padded to a full)0 48 Q
(block size v)0 60 Q(aries depending on the format and the)-.25 E
(output de)0 72 Q(vice.)-.25 E 0 Cg EP
%%Page: 155 155
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.15(Fo)0 12 S 2.5(rt).15 G
(ar and cpio formats, the last block of output is padded)-2.5 E
(to a full block size if the output is being)0 24 Q
(written to standard output or to a character or block de)0 36 Q
(vice such as)-.25 E 2.5(at)0 48 S(ape dri)-2.5 E -.15(ve)-.25 G(.).15 E
(If the output is being written to a re)0 60 Q
(gular \214le, the last block)-.15 E(will not be padded.)0 72 Q 0 Cg EP
%%Page: 156 156
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Man)0 12 Q 2.5(yc)-.15 G(ompressors, including)
-2.5 E(<a href="../html1/gzip.html">gzip\(1\)</a>)0 24 Q(and)0 36 Q
(<a href="../html1/bzip2.html">bzip2\(1\)</a>,)0 48 Q
(complain about the null padding when decompressing an archi)0 60 Q .3
-.15(ve c)-.25 H(reated by).15 E(<b>,</b>)0 72 Q 0 Cg EP
%%Page: 157 157
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(although the)0 12 Q 2.5(ys)-.15 G(till e)-2.5 E
(xtract it correctly)-.15 E(.)-.65 E(<p>)36 24 Q
(The compression and decompression is implemented internally)0 36 Q 2.5
(,s)-.65 G(o)-2.5 E(there may be insigni\214cant dif)0 48 Q
(ferences between the compressed output)-.25 E(generated by)0 60 Q(<br>)
0 72 Q 0 Cg EP
%%Page: 158 158
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 12 Q(<co\
de></code><b>Fl</b><b>czf</b><code></code><code> -</code><code> \214le<\
/code>)0 24 Q(<br>)0 36 Q(and that generated by)0 48 Q(<br>)0 60 Q
(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)0 72 Q 0 Cg EP
%%Page: 159 159
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<code></code><b>Fl</b><b>cf</b><code></code><co\
de> -</code><code> \214le</code><code> |</code><b>gzip</b>)0 12 Q(<br>)0
24 Q(<p>)36 36 Q(The def)0 48 Q(ault should be to read and write archi)
-.1 E -.15(ve)-.25 G 2.5(st).15 G 2.5(ot)-2.5 G(he standard I/O paths,)
-2.5 E -.2(bu)0 60 S 2.5(tt).2 G
(radition \(and POSIX\) dictates otherwise.)-2.5 E(<p>)36 72 Q 0 Cg EP
%%Page: 160 160
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(The)0 12 Q(<b></b><b>r</b>)0 24 Q(and)0 36 Q
(<b></b><b>u</b>)0 48 Q(modes require that the archi)0 60 Q .3 -.15
(ve b)-.25 H 2.5(eu).15 G(ncompressed)-2.5 E(and located in a re)0 72 Q
(gular \214le on disk.)-.15 E 0 Cg EP
%%Page: 161 161
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Other archi)0 12 Q -.15(ve)-.25 G 2.5(sc).15 G
(an be modi\214ed using)-2.5 E(<b></b><b>c</b>)0 24 Q(mode with the)0 36
Q(<code></code><code>@archi)0 48 Q -.15(ve)-.25 G(-\214le</code>).15 E
-.15(ex)0 60 S(tension.).15 E(<p>)36 72 Q 0 Cg EP
%%Page: 162 162
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 1.6 -.8(To a)0 12 T(rchi).8 E .3 -.15(ve a \214)
-.25 H(le called).15 E(<code></code><code>@foo</code>)0 24 Q(or)0 36 Q
(<code></code><code>-foo</code>)0 48 Q(you must specify it as)0 60 Q
(<code></code><code>./@foo</code>)0 72 Q 0 Cg EP
%%Page: 163 163
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(or)0 12 Q(<code></code><code>./-foo</code>,)0 24
Q(respecti)0 36 Q -.15(ve)-.25 G(ly).15 E(.)-.65 E(<p>)36 48 Q
(In create mode, a leading)0 60 Q(<code></code><code>./</code>)0 72 Q 0
Cg EP
%%Page: 164 164
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(is al)0 12 Q -.1(wa)-.1 G(ys remo).1 E -.15(ve)
-.15 G(d.).15 E 2.5(Al)0 24 S(eading)-2.5 E(<code></code><code>/</code>)
0 36 Q(is stripped unless the)0 48 Q(<b>\255</b><b>P</b>)0 60 Q
(option is speci\214ed.)0 72 Q 0 Cg EP
%%Page: 165 165
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p>)36 12 Q
(There needs to be better support for \214le selection on both create)0
24 Q(and e)0 36 Q(xtract.)-.15 E(<p>)36 48 Q(There is not yet an)0 60 Q
2.5(ys)-.15 G(upport for multi-v)-2.5 E(olume archi)-.2 E -.15(ve)-.25 G
2.5(so).15 G 2.5(rf)-2.5 G(or archi)-2.5 E(ving)-.25 E(sparse \214les.)0
72 Q 0 Cg EP
%%Page: 166 166
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p>)36 12 Q(Con)0 24 Q -.15(ve)-.4 G
(rting between dissimilar archi).15 E .3 -.15(ve f)-.25 H
(ormats \(such as tar and cpio\) using the).15 E
(<b></b><b>@</b><code></code><code>-</code>)0 36 Q(con)0 48 Q -.15(ve)
-.4 G(ntion can cause hard link information to be lost.).15 E
(\(This is a consequence of the incompatible w)0 60 Q(ays that dif)-.1 E
(ferent archi)-.25 E -.15(ve)-.25 G
(formats store hardlink information.\))0 72 Q 0 Cg EP
%%Page: 167 167
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(<p>)36 12 Q(There are alternati)0 24 Q .3 -.15
(ve l)-.25 H(ong options for man).15 E 2.5(yo)-.15 G 2.5(ft)-2.5 G
(he short options that)-2.5 E(are deliberately not documented.)0 36 Q
(</body>)0 48 Q(</html>)0 60 Q 0 Cg EP
%%Trailer
end
%%EOF