%!PS-Adobe-3.0 %%Creator: groff version 1.19.2 %%CreationDate: Wed Jun 30 11:55:54 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()0 12 Q()0 24 Q()36 36 Q (Oct 12, 2009 BSDT)74.5 48 Q(AR 1)-.93 E()36 72 Q 0 Cg EP %%Page: 2 2 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF()36 48 Q()0 60 Q ()-.15 E 0 Cg EP %%Page: 4 4 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(

)-.35 E -.35(NA)36 24 S (ME).35 E(

)36 36 Q(tar)0 48 Q 2.5(-m)0 60 S (anipulate tape archi)-2.5 E -.15(ve)-.25 G(s).15 E(

) 36 72 Q 0 Cg EP %%Page: 5 5 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(SYNOPSIS)36 12 Q(

)36 24 Q(tar)0 36 Q ([b)0 48 Q(undled-\215ags ar)-.2 E (gs<.blm Pp >])-.18 E([\214le<.blm Pp\ | pattern<.blm Pp ... > &g\ t;])0 60 Q(tar)0 72 Q 0 Cg EP %%Page: 6 6 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF({\255c})0 12 Q ([options])0 24 Q ([\214les | directories])0 36 Q (tar)0 48 Q({\255r | \255u})0 60 Q(\255f archi)0 72 Q -.15(ve)-.25 G (-\214le).15 E 0 Cg EP %%Page: 7 7 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF([options])0 12 Q ([\214les | directories])0 24 Q (tar)0 36 Q({\255t | \255x})0 48 Q([options])0 60 Q([patterns])0 72 Q 0 Cg EP %%Page: 8 8 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(

)36 12 Q(DESCRIPTION)36 24 Q(

)36 36 Q(tar)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(

)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(

)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 (tar)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(

)0 24 Q(
\255c
)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(
\255r
)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(\255c,)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 (\255f)0 60 Q(option is required.)0 72 Q 0 Cg EP %%Page: 13 13 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(
\255t
)0 12 Q(List archi)0 24 Q .3 -.15(ve c)-.25 H(ontents to stdout.).15 E (
\255u
)0 36 Q(Lik)0 48 Q(e)-.1 E (\255r,)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(\255f)0 48 Q(option is required.)0 60 Q (
\255x
)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(
)0 60 Q(

)36 72 Q 0 Cg EP %%Page: 16 16 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(In)0 12 Q(\255c,)0 24 Q (\255r,)0 36 Q(or)0 48 Q(\255u)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(

)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 (tcsh\(1\).)0 48 Q(

)36 60 Q(OPTIONS)36 72 Q 0 Cg EP %%Page: 19 19 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(

)36 12 Q (Unless speci\214cally stated otherwise, options are applicable in)0 24 Q(all operating modes.)0 36 Q(
)0 48 Q (

@archi)0 60 Q -.15(ve)-.25 G (
).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(
)0 48 Q (      )0 60 Q(Flc\ \255f -\ ne)0 72 Q (w\214le @original.tar) -.25 E 0 Cg EP %%Page: 21 21 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(
)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(ne)0 36 Q (w\214le)-.25 E(and all of the entries from)0 48 Q (original.tar.)0 60 Q(In contrast,)0 72 Q 0 Cg EP %%Page: 22 22 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(
)0 12 Q (      )0 24 Q(Flc\ \255f -\ ne)0 36 Q(w\214le original.tar)-.25 E (
)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(
)0 12 Q (      )0 24 Q(Flc\ zf - \255-format \ pax @-)0 36 Q(
)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(tar)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 (

\255b blocksize
)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 (

\255C directory
)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 (

\255-check-links
)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(

\255-chroot
)0 72 Q 0 Cg EP %%Page: 27 27 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(\(x mode only\))0 12 Q (chroot\(\))0 24 Q (to the current directory after processing an)0 36 Q(y)-.15 E (\255C)0 48 Q(options and before e)0 60 Q(xtracting an) -.15 E 2.5<798c>-.15 G(les.)-2.5 E(

\255-e)0 72 Q (xclude pattern
)-.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 (

\255-format format
)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 (libarchi).15 E -.15(ve)-.25 G(-formats\(5\)).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 (

\255f \214le
)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(-)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(/de)0 48 Q (v/sa0.\))-.25 E(

\255H
)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(

\255h
)0 36 Q (\(c and r mode only\))0 48 Q(Synon)0 60 Q(ym for)-.15 E (\255L.)0 72 Q 0 Cg EP %%Page: 34 34 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(

\255I
)0 12 Q(Synon)0 24 Q(ym for)-.15 E(\255T.)0 36 Q (

\255-include pattern
)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(\255-e)0 12 Q(xclude)-.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(\255-include)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(
) 0 36 Q(      )0 48 Q(Flc \255f ne)0 60 Q -.65(w.)-.25 G(tar \255-include='*foo*' @old.tgz).65 E(
)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(ne)0 24 Q -.65(w.)-.25 G(tar) .65 E(containing only the entries from)0 36 Q (old.tgz)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(

\255j
)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(bzip2\(1\).)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(tar)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 (

\255k
)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(

\255-k)0 36 Q(eep-ne)-.1 E(wer)-.25 E (-\214les
)-.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(

\255L
)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(

\255l
)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 (\255-check-links)0 24 Q(option.)0 36 Q (

\255m
)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(

\255n
)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(

\255-ne)0 60 Q (wer date
)-.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(

\255-ne)0 36 Q(wer)-.25 E (-mtime date
)-.2 E(\(c, r)0 48 Q 2.5(,um)-.4 G (odes only\))-2.5 E(Lik)0 60 Q(e)-.1 E(\255-ne)0 72 Q (wer,)-.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 (

\255-ne)0 24 Q(wer)-.25 E (-than \214le
)-.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(

\255-ne)0 72 Q (wer)-.25 E(-mtime-than \214le
)-.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(\255-ne)0 36 Q(wer)-.25 E(-than,)-.2 E -.15(ex)0 48 S(cept it compares mtime entries instead of ctime entries.) .15 E(

\255-nodump
)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 (

\255-null
)0 24 Q(\(use with)0 36 Q (\255I,)0 48 Q(\255T,)0 60 Q(or)0 72 Q 0 Cg EP %%Page: 48 48 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(\255X\))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 (\255print0)0 60 Q(option to)0 72 Q 0 Cg EP %%Page: 49 49 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(\214nd\(1\).) 0 12 Q(

\255-numeric-o)0 24 Q(wner
)-.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 (

\255O
)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(

\255o
)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(\255p) 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 (

\255o
)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(\255-format ustar)0 12 Q(

\255-one-\214le-system
)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 (

\255-options options
)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(
)0 72 Q 0 Cg EP %%Page: 55 55 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(
k)0 12 Q -.15(ey)-.1 G(=v).15 E (alue
)-.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(
k)0 48 Q -.15 (ey)-.1 G(
).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(k)0 12 Q -.15(ey)-.1 G (=1.).15 E(
!k)0 24 Q -.15(ey)-.1 G (
).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 (
module:k)0 48 Q -.15(ey)-.1 G(=v).15 E (alue, module:k)-.25 E -.15(ey)-.1 G (, module:!k).15 E -.15(ey)-.1 G(
).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(module.)0 12 Q(
)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(
)0 48 Q(
iso9660:joliet
)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 (!joliet)0 24 Q(or)0 36 Q(iso9660:!joliet)0 48 Q(to disable.)0 60 Q(
iso9660:rockridge
)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(!rockridge) 0 36 Q(or)0 48 Q(iso9660:!rockridge)0 60 Q(to disable.)0 72 Q 0 Cg EP %%Page: 60 60 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(
gzip:compression-le)0 12 Q -.15 (ve)-.25 G(l
).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(
xz:compression-le)0 36 Q -.15(ve)-.25 G (l
).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(
mtree:k)0 60 Q -.15(ey)-.1 G -.1 (wo).15 G(rd
).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 (cksum, de)0 36 Q(vice, \215ags, gid, gname, indent,)-.25 E (link, md5, mode, n\ link, rmd160, sha1, sha256,)0 48 Q(sha384, sha512, size, time, uid, uname.)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 (
mtree:all
)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(mtree:!all)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(
mtree:use-set
)0 12 Q (Enable generation of)0 24 Q(/set)0 36 Q (lines in the output.)0 48 Q(
mtree:indent
)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 (
zip:compression=type
)0 24 Q(Use)0 36 Q(type)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(
)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 (

\255P
)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(tar)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(..)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(

\255p
)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(,)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(tar)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 (\255o)0 36 Q(option is also speci\214ed.)0 48 Q (

\255q \255\(-f)0 60 Q (ast-read
\))-.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 (

\255S
)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 (

\255-strip-components count
)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 (

\255s pattern
)0 24 Q (Modify \214le or archi)0 36 Q .3 -.15(ve m)-.25 H (ember names according to).15 E(pattern.)0 48 Q(The pattern has the format)0 60 Q(/old/ne)0 72 Q (w/[gps])-.25 E 0 Cg EP %%Page: 74 74 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(where)0 12 Q(old)0 24 Q (is a basic re)0 36 Q(gular e)-.15 E(xpression,)-.15 E(ne)0 48 Q(w)-.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(old)0 36 Q (is not matched, the pattern is skipped.)0 48 Q -.4(Wi)0 60 S(thin).4 E (ne)0 72 Q(w,)-.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(

\255T \214lename
)0 48 Q(In x or t mode,)0 60 Q(tar)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(\214lename.)0 24 Q (In c mode,)0 36 Q(tar)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 (\214lename.)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 (\255-null)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 (\255-null)0 36 Q (also disables the special handling of lines containing)0 48 Q -.74(``)0 60 S(-C').74 E('.)-.74 E(

\255U
)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(tar)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(

\ \255-use-compress-program program
)0 24 Q (Pipe the input \(in x or t mode\) or the output \(in c mode\) through)0 36 Q(program)0 48 Q(instead of using the b)0 60 Q(uiltin compression support.)-.2 E(

\255v
)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(tar)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(tar)0 12 Q (will produce output similar to that of)0 24 Q (ls\(1\).)0 36 Q(Additional)0 48 Q (\255v)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(

\255-v)0 12 Q(ersion
) -.15 E(Print v)0 24 Q(ersion of)-.15 E(tar)0 36 Q(and)0 48 Q (libarchi)0 60 Q -.15(ve)-.25 G(,).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(

\255w
)0 12 Q (Ask for con\214rmation for e)0 24 Q -.15(ve)-.25 G(ry action.).15 E (

\255X \214lename
)0 36 Q (Read a list of e)0 48 Q(xclusion patterns from the speci\214ed \214le.) -.15 E(See)0 60 Q(\255-e)0 72 Q(xclude)-.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(

\255y
)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(bzip2\(1\).)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 (tar)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 (

\255z
)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(gzip\(1\).)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(tar)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(

\255Z
)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 (compress\(1\).)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 (tar)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 (
)0 60 Q(

)1.11 E 0 Cg EP %%Page: 92 92 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(EXIT ST)36 12 Q -1.11(AT)-.93 G(US)1.11 E(

) 36 24 Q(

)-.4 E(ENVIR)36 48 Q(ONMENT)-.4 E (

)36 60 Q(The follo)0 72 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 0 Cg EP %%Page: 93 93 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(:)0 12 Q(
)0 24 Q (

LANG
)0 36 Q(The locale to use.)0 48 Q(See)0 60 Q(en)-.4 E (viron\(7\))-.4 E 0 Cg EP %%Page: 94 94 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(for more information.)0 12 Q (

T)0 24 Q(APE
)-.93 E(The def)0 36 Q (ault tape de)-.1 E(vice.)-.25 E(The)0 48 Q(\255f)0 60 Q (option o)0 72 Q -.15(ve)-.15 G(rrides this.).15 E 0 Cg EP %%Page: 95 95 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(

TZ
)0 12 Q (The timezone to use when displaying dates.)0 24 Q(See)0 36 Q (en)-.4 E(viron\(7\))-.4 E (for more information.)0 60 Q(
)0 72 Q 0 Cg EP %%Page: 96 96 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(

)36 12 Q(FILES)36 24 Q(

)36 36 Q(
)0 48 Q(

/de)0 60 Q (v/sa0
)-.25 E(The def)0 72 Q(ault tape de)-.1 E (vice, if not o)-.25 E -.15(ve)-.15 G(rridden by the).15 E 0 Cg EP %%Page: 97 97 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(T)0 12 Q(APE)-.93 E (en)0 24 Q(vironment v)-.4 E(ariable or the)-.25 E(\255f)0 36 Q(option.)0 48 Q(
)0 60 Q(

)36 72 Q 0 Cg EP %%Page: 98 98 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(EXAMPLES)36 12 Q(

)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(\214le.tar)0 60 Q(.gz)-.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(source.c)0 12 Q(and)0 24 Q (source.h:)0 36 Q(
)0 48 Q (      )0 60 Q (Flczf \214le.tar)0 72 Q(\ .gz source.c source\ .h)-.55 E 0 Cg EP %%Page: 100 100 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(
)0 12 Q(

)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(
)0 60 Q (      )0 72 Q 0 Cg EP %%Page: 101 101 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF (Fltvf \214le.tar)0 12 Q (.gz)-.55 E(
)0 24 Q(

)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(
)0 72 Q 0 Cg EP %%Page: 102 102 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(      )0 12 Q (Flx)0 24 Q(
)0 36 Q(

)36 48 Q 1.6 -.8 (To e)0 60 T(xamine the contents of an ISO 9660 cdrom image:).65 E(
) 0 72 Q 0 Cg EP %%Page: 103 103 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(      )0 12 Q (Fltf image.iso)0 24 Q(
)0 36 Q(

)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(tar)0 72 Q 0 Cg EP %%Page: 104 104 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(as)0 12 Q(
)0 24 Q (      )0 36 Q(Flc\ f - \255C srcdir .
|Fl xpf\ - \255C destdir)0 48 Q (
)0 60 Q(or more traditionally)0 72 Q 0 Cg EP %%Page: 105 105 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(
)0 12 Q (      )0 24 Q(cd srcdir ;Fl cf - . |\( cd destdir ;Fl xpf -\))0 36 Q (
)0 48 Q(

)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 (-Cfoo/baz)0 24 Q(and archi)0 36 Q .3 -.15(ve i)-.25 H(nclusions of the form).15 E (@archi)0 48 Q -.15(ve)-.25 G (-\214le.).15 E -.15(Fo)0 60 S 2.5(re).15 G (xample, the command line)-2.65 E(
)0 72 Q 0 Cg EP %%Page: 107 107 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(      )0 12 Q(Flc \255f ne)0 24 Q -.65(w.)-.25 G(tar foo1\ @old.tgz -C/tmp foo2).65 E(
)0 36 Q (will create a ne)0 48 Q 2.5(wa)-.25 G(rchi)-2.5 E -.15(ve)-.25 G (ne)0 60 Q -.65(w.)-.25 G(tar.).65 E (tar)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 (foo1)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 (old.tgz)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(/tmp)0 24 Q (directory and add)0 36 Q(foo2)0 48 Q (to the output archi)0 60 Q -.15(ve)-.25 G(.).15 E(

)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 (mtree\(5\))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(

)36 60 Q(
)0 72 Q 0 Cg EP %%Page: 111 111 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(      )0 12 Q ($ cat input.mtree)0 24 Q(
)0 36 Q(      )0 48 Q (#mtree)0 60 Q(
)0 72 Q 0 Cg EP %%Page: 112 112 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(      )0 12 Q(usr/bin uid=0 gid=0 mode=0755 type=dir)0 24 Q(
)0 36 Q (      )0 48 Q(usr/bin\ /ls uid=0 gid=0 mode=0755\ type=\214le content=myls)0 60 Q(
)0 72 Q 0 Cg EP %%Page: 113 113 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(      )0 12 Q($ tar -cvf outpu\ t.tar @input.mtree)0 24 Q(
)0 36 Q(

)36 48 Q (The)0 60 Q(\255-ne)0 72 Q(wer)-.25 E 0 Cg EP %%Page: 114 114 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(and)0 12 Q(\255-ne)0 24 Q(wer)-.25 E (-mtime)-.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(

)36 36 Q(The)0 48 Q(\255-options)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 (type, time,)0 36 Q(and)0 48 Q (uid)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(
)0 12 Q (      )0 24 Q(Flc\ f \214le.tar \255-format=mtree<\ /b> \255-options='!all,type,time,uid' \ dir)0 36 Q(
)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(
)0 72 Q 0 Cg EP %%Page: 118 118 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(      )0 12 Q(Flczf \214le.tar \ \255-options='compression-le)0 24 Q -.15(ve)-.25 G(l=9'.).15 E(
)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(archi)0 60 Q -.15(ve)-.25 G (_read_set_options\(\)).15 E(and)0 72 Q 0 Cg EP %%Page: 119 119 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(archi)0 12 Q -.15(ve)-.25 G (_write_set_options\(\)).15 E (API calls that are described in)0 24 Q(archi).15 E -.15(ve)-.25 G(_read\(3\)).15 E(and)0 48 Q(archi).15 E -.15(ve)-.25 G(_write\(3\).).15 E (

)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 (

)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(
)0 60 Q (      )0 72 Q 0 Cg EP %%Page: 122 122 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(Cmtbf 32 \214le.tar)0 12 Q(
)0 24 Q (speci\214es three \215ags)0 36 Q(t,)0 48 Q (b,)0 60 Q(and)0 72 Q 0 Cg EP %%Page: 123 123 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(f.)0 12 Q(The)0 24 Q (b)0 36 Q(and)0 48 Q(f)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 (32)0 48 Q(is the ar)0 60 Q(gument to the)-.18 E (b)0 72 Q 0 Cg EP %%Page: 125 125 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(\215ag, and)0 12 Q(\214le.tar)0 24 Q(is the ar)0 36 Q(gument to the)-.18 E(f)0 48 Q(\215ag.)0 60 Q(

)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(

)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(tar)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 (c,)0 24 Q(t,)0 36 Q(and)0 48 Q (x)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,)0 12 Q(f,)0 24 Q (m,)0 36 Q(v,)0 48 Q(and)0 60 Q (w)0 72 Q 0 Cg EP %%Page: 129 129 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(options.)0 12 Q(

)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 (

)36 60 Q(SECURITY)36 72 Q 0 Cg EP %%Page: 130 130 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(

)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(.)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(tar)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(tar)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(
    )0 48 Q(

  • )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(tar)0 24 Q (remo)0 36 Q -.15(ve)-.15 G 2.5(st).15 G(he leading)-2.5 E (/)0 48 Q (character from \214lenames before restoring them to guard ag)0 60 Q (ainst this problem.)-.05 E(

  • )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 (..)0 24 Q(components.)0 36 Q(By def)0 48 Q (ault,)-.1 E(tar)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(..)0 12 Q (components in their pathname.)0 24 Q(

  • )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(tar)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(\255U)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(\255U)0 60 Q(nor)0 72 Q 0 Cg EP %%Page: 138 138 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(\255P)0 12 Q(is speci\214ed,)0 24 Q(tar)0 36 Q(will refuse to e)0 48 Q(xtract the entry)-.15 E(.) -.65 E(
)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(
)0 36 Q (      )0 48 Q (Fltf \214lename)0 60 Q(
)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(\255k)0 36 Q (option to ensure that)0 48 Q(tar)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(\255U)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 (\255P)0 72 Q 0 Cg EP %%Page: 142 142 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(option to)0 12 Q(tar)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 (..)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(

)36 12 Q(SEE ALSO)36 24 Q (

)36 36 Q(bzip2\(1\),)0 48 Q (compress\(1\),)0 60 Q (cpio\(1\),)0 72 Q 0 Cg EP %%Page: 144 144 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(gzip\(1\),)0 12 Q(mt\(1\),)0 24 Q (pax\(1\),)0 36 Q (shar\(1\),)-.55 E (libarchi).15 E -.15(ve)-.25 G(\(3\),).15 E(libarchi).15 E -.15(ve)-.25 G (-formats\(5\),).15 E 0 Cg EP %%Page: 145 145 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(tar\(5\))-.55 E(

)-.4 E (ST)36 36 Q(AND)-.93 E(ARDS)-.4 E(

)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 (`POSIX.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 (`POSIX.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(

)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(`POSIX.1')-.74 E('\))-.74 E(for the pax command.)0 48 Q(

)-.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(

)36 12 Q(A)0 24 Q(tar)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(pdtar)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(

)36 48 Q (This is a complete re-implementation based on the)0 60 Q (libarchi).15 E -.15(ve)-.25 G(\(3\)).15 E 0 Cg EP %%Page: 151 151 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(library)0 12 Q(.)-.65 E(

) -.1 E -.1(BU)36 36 S(GS).1 E(

)36 48 Q(This program follo)0 60 Q(ws) -.25 E(ISO/IEC 9945-1:1996 \(`)2.5 72 Q (`POSIX.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 (\255l)0 24 Q(option.)0 36 Q(Note that GNU tar prior to v) 0 48 Q(ersion 1.15 treated)-.15 E(\255l)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(\255-one-\214le-system)0 12 Q (option.)0 24 Q(

)36 36 Q(The)0 48 Q (\255C dir)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(

)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(gzip\(1\))0 24 Q(and)0 36 Q (bzip2\(1\),)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(,)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(

)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(
) 0 72 Q 0 Cg EP %%Page: 158 158 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(      )0 12 Q(Flczf - \214le<\ /code>)0 24 Q(
)0 36 Q(and that generated by)0 48 Q(
)0 60 Q (      )0 72 Q 0 Cg EP %%Page: 159 159 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(Flcf -
\214le |gzip)0 12 Q(
)0 24 Q(

)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(

)36 72 Q 0 Cg EP %%Page: 160 160 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(The)0 12 Q(r)0 24 Q(and)0 36 Q (u)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(c)0 24 Q(mode with the)0 36 Q(@archi)0 48 Q -.15(ve)-.25 G(-\214le).15 E -.15(ex)0 60 S(tension.).15 E(

)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(@foo)0 24 Q(or)0 36 Q (-foo)0 48 Q(you must specify it as)0 60 Q (./@foo)0 72 Q 0 Cg EP %%Page: 163 163 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(or)0 12 Q(./-foo,)0 24 Q(respecti)0 36 Q -.15(ve)-.25 G(ly).15 E(.)-.65 E(

)36 48 Q (In create mode, a leading)0 60 Q(./)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(/) 0 36 Q(is stripped unless the)0 48 Q(\255P)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(

)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(

)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(

)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 (@-)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(

)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 ()0 48 Q()0 60 Q 0 Cg EP %%Trailer end %%EOF