diff options
Diffstat (limited to 'archivers/libarchive/files/doc/html/bsdtar.1.html')
-rw-r--r-- | archivers/libarchive/files/doc/html/bsdtar.1.html | 2853 |
1 files changed, 1014 insertions, 1839 deletions
diff --git a/archivers/libarchive/files/doc/html/bsdtar.1.html b/archivers/libarchive/files/doc/html/bsdtar.1.html index 5e530104e2a..b26c43627de 100644 --- a/archivers/libarchive/files/doc/html/bsdtar.1.html +++ b/archivers/libarchive/files/doc/html/bsdtar.1.html @@ -1,1839 +1,1014 @@ -%!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<.blm Pp</i><i> ></i>])-.18 E([<i></i><i>\214le<.blm Pp</i>\ -<i> | </i><i></i><i>pattern<.blm Pp</i><i> ...</i><i> ></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 -( )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 -( )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 -( )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( )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 -( )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 -( )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( )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( )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 -( )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 -( )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( )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( )0 12 Q -(<code></code><code>$</code><code> cat</code><code> input.mtree</code>)0 -24 Q(<br>)0 36 Q( )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( )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 -( )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( )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 -( )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( )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 -( )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 -( )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( )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 -( )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 +<!-- Creator : groff version 1.19.2 --> +<!-- CreationDate: Sun Mar 14 19:50:38 2010 --> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" +"http://www.w3.org/TR/html4/loose.dtd"> +<html> +<head> +<meta name="generator" content="groff -Thtml, see www.gnu.org"> +<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> +<meta name="Content-Style" content="text/css"> +<style type="text/css"> + p { margin-top: 0; margin-bottom: 0; } + pre { margin-top: 0; margin-bottom: 0; } + table { margin-top: 0; margin-bottom: 0; } +</style> +<title></title> +</head> +<body> + +<hr> + + +<p valign="top">BSDTAR(1) FreeBSD General Commands Manual +BSDTAR(1)</p> + +<p style="margin-top: 1em" valign="top"><b>NAME</b></p> + +<p style="margin-left:8%;"><b>tar</b> — manipulate +tape archives</p> + + +<p style="margin-top: 1em" valign="top"><b>SYNOPSIS</b></p> + +<p style="margin-left:14%;"><b>tar</b> +[<i>bundled-flags </i>⟨</p> + +<p valign="top">args ⟩] [⟨ <i><br> +file</i> ⟩ | ⟨ <i><br> +pattern</i> ⟩ ...]</p> + +<p style="margin-left:14%;"><b>tar</b> {<b>−c</b>} +[<i>options</i>] +[<i>files </i>| <i>directories</i>] <b><br> +tar</b> {<b>−r </b>| <b>−u</b>} +<b>−f</b> <i>archive-file</i> [<i>options</i>] +[<i>files </i>| <i>directories</i>] <b><br> +tar</b> {<b>−t </b>| <b>−x</b>} +[<i>options</i>] [<i>patterns</i>]</p> + + +<p style="margin-top: 1em" valign="top"><b>DESCRIPTION</b></p> + +<p style="margin-left:8%;"><b>tar</b> creates and +manipulates streaming archive files. This implementation can +extract from tar, pax, cpio, zip, jar, ar, and ISO 9660 +cdrom images and can create tar, pax, cpio, ar, and shar +archives.</p> + +<p style="margin-left:8%; margin-top: 1em">The first +synopsis form shows a ‘‘bundled’’ +option word. This usage is provided for compatibility with +historical implementations. See COMPATIBILITY below for +details.</p> + +<p style="margin-left:8%; margin-top: 1em">The other +synopsis forms show the preferred usage. The first option to +<b>tar</b> is a mode indicator from the following list:</p> + +<p valign="top"><b>−c</b></p> + +<p style="margin-left:20%; margin-top: 1em">Create a new +archive containing the specified items.</p> + +<p valign="top"><b>−r</b></p> + +<p style="margin-left:20%; margin-top: 1em">Like +<b>−c</b>, but new entries are appended to the +archive. Note that this only works on uncompressed archives +stored in regular files. The <b>−f</b> option is +required.</p> + +<p valign="top"><b>−t</b></p> + +<p style="margin-left:20%; margin-top: 1em">List archive +contents to stdout.</p> + +<p valign="top"><b>−u</b></p> + +<p style="margin-left:20%; margin-top: 1em">Like +<b>−r</b>, but new entries are added only if they have +a modification date newer than the corresponding entry in +the archive. Note that this only works on uncompressed +archives stored in regular files. The <b>−f</b> option +is required.</p> + +<p valign="top"><b>−x</b></p> + +<p style="margin-left:20%; margin-top: 1em">Extract to disk +from the archive. If a file with the same name appears more +than once in the archive, each copy will be extracted, with +later copies overwriting (replacing) earlier copies.</p> + +<p style="margin-left:8%; margin-top: 1em">In +<b>−c</b>, <b>−r</b>, or <b>−u</b> mode, +each specified file or directory is added to the archive in +the order specified on the command line. By default, the +contents of each directory are also archived.</p> + +<p style="margin-left:8%; margin-top: 1em">In extract or +list mode, the entire command line is read and parsed before +the archive is opened. The pathnames or patterns on the +command line indicate which items in the archive should be +processed. Patterns are shell-style globbing patterns as +documented in tcsh(1).</p> + +<p style="margin-top: 1em" valign="top"><b>OPTIONS</b></p> + +<p style="margin-left:8%;">Unless specifically stated +otherwise, options are applicable in all operating +modes.</p> + + +<p style="margin-top: 1em" valign="top"><b>@</b><i>archive</i></p> + +<p style="margin-left:20%;">(c and r mode only) The +specified archive is opened and the entries in it will be +appended to the current archive. As a simple example,</p> + +<p style="margin-left:29%;"><b>tar −c −f</b> +<i>- newfile</i> <b>@</b><i>original.tar</i></p> + +<p style="margin-left:20%;">writes a new archive to +standard output containing a file <i>newfile</i> and all of +the entries from <i>original.tar</i>. In contrast,</p> + +<p style="margin-left:29%;"><b>tar −c −f</b> +<i>- newfile original.tar</i></p> + +<p style="margin-left:20%;">creates a new archive with only +two entries. Similarly,</p> + +<p style="margin-left:29%;"><b>tar −czf</b> <i>-</i> +<b>−-format pax @</b><i>-</i></p> + +<p style="margin-left:20%;">reads an archive from standard +input (whose format will be determined automatically) and +converts it into a gzip-compressed pax-format archive on +stdout. In this way, <b>tar</b> can be used to convert +archives from one format to another.</p> + +<p style="margin-top: 1em" valign="top"><b>−b</b> +<i>blocksize</i></p> + +<p style="margin-left:20%;">Specify the block size, in +512-byte records, for tape drive I/O. As a rule, this +argument is only needed when reading from or writing to tape +drives, and usually not even then as the default block size +of 20 records (10240 bytes) is very common.</p> + +<p style="margin-top: 1em" valign="top"><b>−C</b> +<i>directory</i></p> + +<p style="margin-left:20%;">In c and r mode, this changes +the directory before adding the following files. In x mode, +change directories after opening the archive but before +extracting entries from the archive.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-check-links</b></p> + +<p style="margin-left:20%;">(c and r modes only) Issue a +warning message unless all links to each file are +archived.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-chroot</b></p> + +<p style="margin-left:20%;">(x mode only) <b>chroot</b>() +to the current directory after processing any +<b>−C</b> options and before extracting any files.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-exclude</b> +<i>pattern</i></p> + +<p style="margin-left:20%;">Do not process files or +directories that match the specified pattern. Note that +exclusions take precedence over patterns or filenames +specified on the command line.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-format</b> +<i>format</i></p> + +<p style="margin-left:20%;">(c, r, u mode only) Use the +specified format for the created archive. Supported formats +include ‘‘cpio’’, +‘‘pax’’, +‘‘shar’’, and +‘‘ustar’’. Other formats may also be +supported; see libarchive-formats(5) for more information +about currently-supported formats. In r and u modes, when +extending an existing archive, the format specified here +must be compatible with the format of the existing archive +on disk.</p> + +<p style="margin-top: 1em" valign="top"><b>−f</b> +<i>file</i></p> + +<p style="margin-left:20%;">Read the archive from or write +the archive to the specified file. The filename can be +<i>-</i> for standard input or standard output. If not +specified, the default tape device will be used. (On +FreeBSD, the default tape device is <i>/dev/sa0</i>.)</p> + + +<p style="margin-top: 1em" valign="top"><b>−H</b></p> + +<p style="margin-left:20%; margin-top: 1em">(c and r mode +only) Symbolic links named on the command line will be +followed; the target of the link will be archived, not the +link itself.</p> + + +<p style="margin-top: 1em" valign="top"><b>−h</b></p> + +<p style="margin-left:20%; margin-top: 1em">(c and r mode +only) Synonym for <b>−L</b>.</p> + + +<p style="margin-top: 1em" valign="top"><b>−I</b></p> + +<p style="margin-left:20%; margin-top: 1em">Synonym for +<b>−T</b>.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-include</b> +<i>pattern</i></p> + +<p style="margin-left:20%;">Process only files or +directories that match the specified pattern. Note that +exclusions specified with <b>−-exclude</b> take +precedence over inclusions. If no inclusions are explicitly +specified, all entries are processed by default. The +<b>−-include</b> option is especially useful when +filtering archives. For example, the command</p> + +<p style="margin-left:29%;"><b>tar −c −f</b> +<i>new.tar</i> <b>−-include=’*foo*’ +@</b><i>old.tgz</i></p> + +<p style="margin-left:20%;">creates a new archive +<i>new.tar</i> containing only the entries from +<i>old.tgz</i> containing the string ‘foo’.</p> + + +<p style="margin-top: 1em" valign="top"><b>−j</b></p> + +<p style="margin-left:20%; margin-top: 1em">(c mode only) +Compress the resulting archive with bzip2(1). In extract or +list modes, this option is ignored. Note that, unlike other +<b>tar</b> implementations, this implementation recognizes +bzip2 compression automatically when reading archives.</p> + + +<p style="margin-top: 1em" valign="top"><b>−k</b></p> + +<p style="margin-left:20%; margin-top: 1em">(x mode only) +Do not overwrite existing files. In particular, if a file +appears more than once in an archive, later copies will not +overwrite earlier copies.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-keep-newer-files</b></p> + +<p style="margin-left:20%;">(x mode only) Do not overwrite +existing files that are newer than the versions appearing in +the archive being extracted.</p> + + +<p style="margin-top: 1em" valign="top"><b>−L</b></p> + +<p style="margin-left:20%; margin-top: 1em">(c and r mode +only) All symbolic links will be followed. Normally, +symbolic links are archived as such. With this option, the +target of the link will be archived instead.</p> + + +<p style="margin-top: 1em" valign="top"><b>−l</b></p> + +<p style="margin-left:20%; margin-top: 1em">This is a +synonym for the <b>−-check-links</b> option.</p> + + +<p style="margin-top: 1em" valign="top"><b>−m</b></p> + +<p style="margin-left:20%; margin-top: 1em">(x mode only) +Do not extract modification time. By default, the +modification time is set to the time stored in the +archive.</p> + + +<p style="margin-top: 1em" valign="top"><b>−n</b></p> + +<p style="margin-left:20%; margin-top: 1em">(c, r, u modes +only) Do not recursively archive the contents of +directories.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-newer</b> +<i>date</i></p> + +<p style="margin-left:20%;">(c, r, u modes only) Only +include files and directories newer than the specified date. +This compares ctime entries.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-newer-mtime</b> +<i>date</i></p> + +<p style="margin-left:20%;">(c, r, u modes only) Like +<b>−-newer</b>, except it compares mtime entries +instead of ctime entries.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-newer-than</b> +<i>file</i></p> + +<p style="margin-left:20%;">(c, r, u modes only) Only +include files and directories newer than the specified file. +This compares ctime entries.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-newer-mtime-than</b> +<i>file</i></p> + +<p style="margin-left:20%;">(c, r, u modes only) Like +<b>−-newer-than</b>, except it compares mtime entries +instead of ctime entries.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-nodump</b></p> + +<p style="margin-left:20%;">(c and r modes only) Honor the +nodump file flag by skipping this file.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-null</b></p> + +<p style="margin-left:20%; margin-top: 1em">(use with +<b>−I</b>, <b>−T</b>, or <b>−X</b>) +Filenames or patterns are separated by null characters, not +by newlines. This is often used to read filenames output by +the <b>−print0</b> option to find(1).</p> + + +<p style="margin-top: 1em" valign="top"><b>−-numeric-owner</b></p> + +<p style="margin-left:20%;">(x mode only) Ignore symbolic +user and group names when restoring archives to disk, only +numeric uid and gid values will be obeyed.</p> + + +<p style="margin-top: 1em" valign="top"><b>−O</b></p> + +<p style="margin-left:20%; margin-top: 1em">(x, t modes +only) In extract (-x) mode, files will be written to +standard out rather than being extracted to disk. In list +(-t) mode, the file listing will be written to stderr rather +than the usual stdout.</p> + + +<p style="margin-top: 1em" valign="top"><b>−o</b></p> + +<p style="margin-left:20%; margin-top: 1em">(x mode) Use +the user and group of the user running the program rather +than those specified in the archive. Note that this has no +significance unless <b>−p</b> is specified, and the +program is being run by the root user. In this case, the +file modes and flags from the archive will be restored, but +ACLs or owner information in the archive will be +discarded.</p> + + +<p style="margin-top: 1em" valign="top"><b>−o</b></p> + +<p style="margin-left:20%; margin-top: 1em">(c, r, u mode) +A synonym for <b>−-format</b> <i>ustar</i></p> + + +<p style="margin-top: 1em" valign="top"><b>−-one-file-system</b></p> + +<p style="margin-left:20%;">(c, r, and u modes) Do not +cross mount points.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-options</b> +<i>options</i></p> + +<p style="margin-left:20%;">Select optional behaviors for +particular modules. The argument is a text string containing +comma-separated keywords and values. These are passed to the +modules that handle particular formats to control how those +formats will behave. Each option has one of the following +forms:</p> + +<p valign="top"><i>key=value</i></p> + +<p style="margin-left:32%;">The key will be set to the +specified value in every module that supports it. Modules +that do not support this key will ignore it.</p> + +<p valign="top"><i>key</i></p> + +<p style="margin-left:32%; margin-top: 1em">The key will be +enabled in every module that supports it. This is equivalent +to <i>key</i><b>=1</b>.</p> + +<p valign="top"><i>!key</i></p> + +<p style="margin-left:32%; margin-top: 1em">The key will be +disabled in every module that supports it.</p> + +<p valign="top"><i>module:key=value</i>, <i>module:key</i>, +<i>module:!key</i></p> + +<p style="margin-left:32%;">As above, but the corresponding +key and value will be provided only to modules whose name +matches <i>module</i>.</p> + +<p style="margin-left:20%;">The currently supported modules +and keys are:</p> + +<p valign="top"><b>iso9660:joliet</b></p> + +<p style="margin-left:32%;">Support Joliet extensions. This +is enabled by default, use <b>!joliet</b> or +<b>iso9660:!joliet</b> to disable.</p> + +<p valign="top"><b>iso9660:rockridge</b></p> + +<p style="margin-left:32%;">Support Rock Ridge extensions. +This is enabled by default, use <b>!rockridge</b> or +<b>iso9660:!rockridge</b> to disable.</p> + +<p valign="top"><b>gzip:compression-level</b></p> + +<p style="margin-left:32%;">A decimal integer from 0 to 9 +specifying the gzip compression level.</p> + +<p valign="top"><b>xz:compression-level</b></p> + +<p style="margin-left:32%;">A decimal integer from 0 to 9 +specifying the xz compression level.</p> + +<p valign="top"><b>mtree:</b><i>keyword</i></p> + +<p style="margin-left:32%;">The mtree writer module allows +you to specify which mtree keywords will be included in the +output. Supported keywords include: <b>cksum</b>, +<b>device</b>, <b>flags</b>, <b>gid</b>, <b>gname</b>, +<b>indent</b>, <b>link</b>, <b>md5</b>, <b>mode</b>, +<b>nlink</b>, <b>rmd160</b>, <b>sha1</b>, <b>sha256</b>, +<b>sha384</b>, <b>sha512</b>, <b>size</b>, <b>time</b>, +<b>uid</b>, <b>uname</b>. The default is equivalent to: +‘‘device, flags, gid, gname, link, mode, nlink, +size, time, type, uid, uname’’.</p> + +<p valign="top"><b>mtree:all</b></p> + +<p style="margin-left:32%;">Enables all of the above +keywords. You can also use <b>mtree:!all</b> to disable all +keywords.</p> + +<p valign="top"><b>mtree:use-set</b></p> + +<p style="margin-left:32%;">Enable generation of +<b>/set</b> lines in the output.</p> + +<p valign="top"><b>mtree:indent</b></p> + +<p style="margin-left:32%;">Produce human-readable output +by indenting options and splitting lines to fit into 80 +columns.</p> + +<p valign="top"><b>zip:compression</b>=<i>type</i></p> + +<p style="margin-left:32%;">Use <i>type</i> as compression +method. Supported values are store (uncompressed) and +deflate (gzip algorithm).</p> + +<p style="margin-left:20%;">If a provided option is not +supported by any module, that is a fatal error.</p> + + +<p style="margin-top: 1em" valign="top"><b>−P</b></p> + +<p style="margin-left:20%; margin-top: 1em">Preserve +pathnames. By default, absolute pathnames (those that begin +with a / character) have the leading slash removed both when +creating archives and extracting from them. Also, <b>tar</b> +will refuse to extract archive entries whose pathnames +contain <i>..</i> or whose target directory would be altered +by a symlink. This option suppresses these behaviors.</p> + + +<p style="margin-top: 1em" valign="top"><b>−p</b></p> + +<p style="margin-left:20%; margin-top: 1em">(x mode only) +Preserve file permissions. Attempt to restore the full +permissions, including owner, file modes, file flags and +ACLs, if available, for each item extracted from the +archive. By default, newly-created files are owned by the +user running <b>tar</b>, the file mode is restored for +newly-created regular files, and all other types of entries +receive default permissions. If <b>tar</b> is being run by +root, the default is to restore the owner unless the +<b>−o</b> option is also specified.</p> + +<p style="margin-top: 1em" valign="top"><b>−q</b> +(<b>−-fast-read</b>)</p> + +<p style="margin-left:20%;">(x and t mode only) Extract or +list only the first archive entry that matches each pattern +or filename operand. Exit as soon as each specified pattern +or filename has been matched. By default, the archive is +always read to the very end, since there can be multiple +entries with the same name and, by convention, later entries +overwrite earlier entries. This option is provided as a +performance optimization.</p> + + +<p style="margin-top: 1em" valign="top"><b>−S</b></p> + +<p style="margin-left:20%; margin-top: 1em">(x mode only) +Extract files as sparse files. For every block on disk, +check first if it contains only NULL bytes and seek over it +otherwise. This works similiar to the conv=sparse option of +dd.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-strip-components</b> +<i>count</i></p> + +<p style="margin-left:20%;">(x mode only) Remove the +specified number of leading path elements. Pathnames with +fewer elements will be silently skipped. Note that the +pathname is edited after checking inclusion/exclusion +patterns but before security checks.</p> + +<p style="margin-top: 1em" valign="top"><b>−s</b> +<i>pattern</i></p> + +<p style="margin-left:20%;">Modify file or archive member +names according to <i>pattern</i>. The pattern has the +format <i>/old/new/</i>[gps] where <i>old</i> is a basic +regular expression, <i>new</i> is the replacement string of +the matched part, and the optional trailing letters modify +how the replacement is handled. If <i>old</i> is not +matched, the pattern is skipped. Within <i>new</i>, ~ is +substituted with the match, 1 to 9 with the content of the +corresponding captured group. The optional trailing g +specifies that matching should continue after the matched +part and stopped on the first unmatched pattern. The +optional trailing s specifies that the pattern applies to +the value of symbolic links. The optional trailing p +specifies that after a successful substitution the original +path name and the new path name should be printed to +standard error.</p> + +<p style="margin-top: 1em" valign="top"><b>−T</b> +<i>filename</i></p> + +<p style="margin-left:20%;">In x or t mode, <b>tar</b> will +read the list of names to be extracted from <i>filename</i>. +In c mode, <b>tar</b> will read names to be archived from +<i>filename</i>. The special name +‘‘-C’’ on a line by itself will +cause the current directory to be changed to the directory +specified on the following line. Names are terminated by +newlines unless <b>−-null</b> is specified. Note that +<b>−-null</b> also disables the special handling of +lines containing ‘‘-C’’.</p> + + +<p style="margin-top: 1em" valign="top"><b>−U</b></p> + +<p style="margin-left:20%; margin-top: 1em">(x mode only) +Unlink files before creating them. Without this option, +<b>tar</b> overwrites existing files, which preserves +existing hardlinks. With this option, existing hardlinks +will be broken, as will any symlink that would affect the +location of an extracted file.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-use-compress-program</b> +<i>program</i></p> + +<p style="margin-left:20%;">Pipe the input (in x or t mode) +or the output (in c mode) through <i>program</i> instead of +using the builtin compression support.</p> + + +<p style="margin-top: 1em" valign="top"><b>−v</b></p> + +<p style="margin-left:20%; margin-top: 1em">Produce verbose +output. In create and extract modes, <b>tar</b> will list +each file name as it is read from or written to the archive. +In list mode, <b>tar</b> will produce output similar to that +of ls(1). Additional <b>−v</b> options will provide +additional detail.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-version</b></p> + +<p style="margin-left:20%;">Print version of <b>tar</b> and +<b>libarchive</b>, and exit.</p> + + +<p style="margin-top: 1em" valign="top"><b>−w</b></p> + +<p style="margin-left:20%; margin-top: 1em">Ask for +confirmation for every action.</p> + +<p style="margin-top: 1em" valign="top"><b>−X</b> +<i>filename</i></p> + +<p style="margin-left:20%;">Read a list of exclusion +patterns from the specified file. See <b>−-exclude</b> +for more information about the handling of exclusions.</p> + + +<p style="margin-top: 1em" valign="top"><b>−y</b></p> + +<p style="margin-left:20%; margin-top: 1em">(c mode only) +Compress the resulting archive with bzip2(1). In extract or +list modes, this option is ignored. Note that, unlike other +<b>tar</b> implementations, this implementation recognizes +bzip2 compression automatically when reading archives.</p> + + +<p style="margin-top: 1em" valign="top"><b>−z</b></p> + +<p style="margin-left:20%; margin-top: 1em">(c mode only) +Compress the resulting archive with gzip(1). In extract or +list modes, this option is ignored. Note that, unlike other +<b>tar</b> implementations, this implementation recognizes +gzip compression automatically when reading archives.</p> + + +<p style="margin-top: 1em" valign="top"><b>−Z</b></p> + +<p style="margin-left:20%; margin-top: 1em">(c mode only) +Compress the resulting archive with compress(1). In extract +or list modes, this option is ignored. Note that, unlike +other <b>tar</b> implementations, this implementation +recognizes compress compression automatically when reading +archives.</p> + + +<p style="margin-top: 1em" valign="top"><b>ENVIRONMENT</b></p> + +<p style="margin-left:8%;">The following environment +variables affect the execution of <b>tar</b>:</p> + +<p style="margin-top: 1em" valign="top">LANG</p> + +<p style="margin-left:25%; margin-top: 1em">The locale to +use. See environ(7) for more information.</p> + +<p style="margin-top: 1em" valign="top">TAPE</p> + +<p style="margin-left:25%; margin-top: 1em">The default +tape device. The <b>−f</b> option overrides this.</p> + +<p style="margin-top: 1em" valign="top">TZ</p> + +<p style="margin-left:25%; margin-top: 1em">The timezone to +use when displaying dates. See environ(7) for more +information.</p> + +<p style="margin-top: 1em" valign="top"><b>FILES</b> <br> +/dev/sa0</p> + +<p style="margin-left:25%; margin-top: 1em">The default +tape device, if not overridden by the TAPE environment +variable or the <b>−f</b> option.</p> + +<p style="margin-top: 1em" valign="top"><b>EXIT +STATUS</b></p> + +<p style="margin-left:8%;">The <b>tar</b> utility +exits 0 on success, and >0 if an error +occurs.</p> + + +<p style="margin-top: 1em" valign="top"><b>EXAMPLES</b></p> + +<p style="margin-left:8%;">The following creates a new +archive called <i>file.tar.gz</i> that contains two files +<i>source.c</i> and <i>source.h</i>:</p> + +<p style="margin-left:17%;"><b>tar −czf</b> +<i>file.tar.gz source.c source.h</i></p> + +<p style="margin-left:8%; margin-top: 1em">To view a +detailed table of contents for this archive:</p> + +<p style="margin-left:17%;"><b>tar −tvf</b> +<i>file.tar.gz</i></p> + +<p style="margin-left:8%; margin-top: 1em">To extract all +entries from the archive on the default tape drive:</p> + +<p style="margin-left:17%;"><b>tar −x</b></p> + +<p style="margin-left:8%; margin-top: 1em">To examine the +contents of an ISO 9660 cdrom image:</p> + +<p style="margin-left:17%;"><b>tar −tf</b> +<i>image.iso</i></p> + +<p style="margin-left:8%; margin-top: 1em">To move file +hierarchies, invoke <b>tar</b> as</p> + +<p style="margin-left:17%;"><b>tar −cf</b> <i>-</i> +<b>−C</b> <i>srcdir .</i> | <b>tar −xpf</b> +<i>-</i> <b>−C</b> <i>destdir</i></p> + +<p style="margin-left:8%;">or more traditionally</p> + +<p style="margin-left:17%;">cd srcdir ; <b>tar +−cf</b> <i>- .</i> | (<i>cd destdir ;</i> <b>tar +−xpf</b> <i>-</i>)</p> + +<p style="margin-left:8%; margin-top: 1em">In create mode, +the list of files and directories to be archived can also +include directory change instructions of the form +<b>-C</b><i>foo/baz</i> and archive inclusions of the form +<b>@</b><i>archive-file</i>. For example, the command +line</p> + +<p style="margin-left:17%;"><b>tar −c −f</b> +<i>new.tar foo1</i> <b>@</b><i>old.tgz</i> <b>-C</b><i>/tmp +foo2</i></p> + +<p style="margin-left:8%;">will create a new archive +<i>new.tar</i>. <b>tar</b> will read the file <i>foo1</i> +from the current directory and add it to the output archive. +It will then read each entry from <i>old.tgz</i> and add +those entries to the output archive. Finally, it will switch +to the <i>/tmp</i> directory and add <i>foo2</i> to the +output archive.</p> + +<p style="margin-left:8%; margin-top: 1em">An input file in +mtree(5) format can be used to create an output archive with +arbitrary ownership, permissions, or names that differ from +existing data on disk:</p> + +<p style="margin-left:17%; margin-top: 1em">$ cat +input.mtree <br> +#mtree <br> +usr/bin uid=0 gid=0 mode=0755 type=dir <br> +usr/bin/ls uid=0 gid=0 mode=0755 type=file content=myls <br> +$ tar -cvf output.tar @input.mtree</p> + +<p style="margin-left:8%; margin-top: 1em">The +<b>−-newer</b> and <b>−-newer-mtime</b> switches +accept a variety of common date and time specifications, +including ‘‘12 Mar 2005 7:14:29pm’’, +‘‘2005-03-12 19:14’’, +‘‘5 minutes ago’’, and +‘‘19:14 PST May 1’’.</p> + +<p style="margin-left:8%; margin-top: 1em">The +<b>−-options</b> argument can be used to control +various details of archive generation or reading. For +example, you can generate mtree output which only contains +<b>type</b>, <b>time</b>, and <b>uid</b> keywords:</p> + +<p style="margin-left:17%;"><b>tar −cf</b> +<i>file.tar</i> <b>−-format=mtree +−-options=’!all,type,time,uid’</b> +<i>dir</i></p> + +<p style="margin-left:8%;">or you can set the compression +level used by gzip or xz compression:</p> + +<p style="margin-left:17%;"><b>tar −czf</b> +<i>file.tar</i> +<b>−-options=’compression-level=9’</b>.</p> + +<p style="margin-left:8%;">For more details, see the +explanation of the <b>archive_read_set_options</b>() and +<b>archive_write_set_options</b>() API calls that are +described in archive_read(3) and archive_write(3).</p> + + +<p style="margin-top: 1em" valign="top"><b>COMPATIBILITY</b></p> + +<p style="margin-left:8%;">The bundled-arguments format is +supported for compatibility with historic implementations. +It consists of an initial word (with no leading - character) +in which each character indicates an option. Arguments +follow as separate words. The order of the arguments must +match the order of the corresponding characters in the +bundled command word. For example,</p> + +<p style="margin-left:17%;"><b>tar tbf 32</b> +<i>file.tar</i></p> + +<p style="margin-left:8%;">specifies three flags <b>t</b>, +<b>b</b>, and <b>f</b>. The <b>b</b> and <b>f</b> flags both +require arguments, so there must be two additional items on +the command line. The <i>32</i> is the argument to the +<b>b</b> flag, and <i>file.tar</i> is the argument to the +<b>f</b> flag.</p> + +<p style="margin-left:8%; margin-top: 1em">The mode options +c, r, t, u, and x and the options b, f, l, m, o, v, and w +comply with SUSv2.</p> + +<p style="margin-left:8%; margin-top: 1em">For maximum +portability, scripts that invoke <b>tar</b> should use the +bundled-argument format above, should limit themselves to +the <b>c</b>, <b>t</b>, and <b>x</b> modes, and the +<b>b</b>, <b>f</b>, <b>m</b>, <b>v</b>, and <b>w</b> +options.</p> + +<p style="margin-left:8%; margin-top: 1em">Additional long +options are provided to improve compatibility with other tar +implementations.</p> + + +<p style="margin-top: 1em" valign="top"><b>SECURITY</b></p> + +<p style="margin-left:8%;">Certain security issues are +common to many archiving programs, including <b>tar</b>. In +particular, carefully-crafted archives can request that +<b>tar</b> extract files to locations outside of the target +directory. This can potentially be used to cause unwitting +users to overwrite files they did not intend to overwrite. +If the archive is being extracted by the superuser, any file +on the system can potentially be overwritten. There are +three ways this can happen. Although <b>tar</b> has +mechanisms to protect against each one, savvy users should +be aware of the implications:</p> + +<p style="margin-top: 1em" valign="top"><b>•</b></p> + +<p style="margin-left:20%;">Archive entries can have +absolute pathnames. By default, <b>tar</b> removes the +leading <i>/</i> character from filenames before restoring +them to guard against this problem.</p> + +<p style="margin-top: 1em" valign="top"><b>•</b></p> + +<p style="margin-left:20%;">Archive entries can have +pathnames that include <i>..</i> components. By default, +<b>tar</b> will not extract files containing <i>..</i> +components in their pathname.</p> + +<p style="margin-top: 1em" valign="top"><b>•</b></p> + +<p style="margin-left:20%;">Archive entries can exploit +symbolic links to restore files to other directories. An +archive can restore a symbolic link to another directory, +then use that link to restore a file into that directory. To +guard against this, <b>tar</b> checks each extracted path +for symlinks. If the final path element is a symlink, it +will be removed and replaced with the archive entry. If +<b>−U</b> is specified, any intermediate symlink will +also be unconditionally removed. If neither <b>−U</b> +nor <b>−P</b> is specified, <b>tar</b> will refuse to +extract the entry.</p> + +<p style="margin-left:8%;">To protect yourself, you should +be wary of any archives that come from untrusted sources. +You should examine the contents of an archive with</p> + +<p style="margin-left:17%;"><b>tar −tf</b> +<i>filename</i></p> + +<p style="margin-left:8%;">before extraction. You should +use the <b>−k</b> option to ensure that <b>tar</b> +will not overwrite any existing files or the <b>−U</b> +option to remove any pre-existing files. You should +generally not extract archives while running with super-user +privileges. Note that the <b>−P</b> option to +<b>tar</b> disables the security checks above and allows you +to extract an archive while preserving any absolute +pathnames, <i>..</i> components, or symlinks to other +directories.</p> + +<p style="margin-top: 1em" valign="top"><b>SEE ALSO</b></p> + +<p style="margin-left:8%;">bzip2(1), compress(1), cpio(1), +gzip(1), mt(1), pax(1), shar(1), libarchive(3), +libarchive-formats(5), tar(5)</p> + + +<p style="margin-top: 1em" valign="top"><b>STANDARDS</b></p> + +<p style="margin-left:8%;">There is no current POSIX +standard for the tar command; it appeared in ISO/IEC +9945-1:1996 (‘‘POSIX.1’’) but was +dropped from IEEE Std 1003.1-2001 +(‘‘POSIX.1’’). The options used by +this implementation were developed by surveying a number of +existing tar implementations as well as the old POSIX +specification for tar and the current POSIX specification +for pax.</p> + +<p style="margin-left:8%; margin-top: 1em">The ustar and +pax interchange file formats are defined by IEEE Std +1003.1-2001 (‘‘POSIX.1’’) for the +pax command.</p> + +<p style="margin-top: 1em" valign="top"><b>HISTORY</b></p> + +<p style="margin-left:8%;">A <b>tar</b> command appeared in +Seventh Edition Unix, which was released in January, 1979. +There have been numerous other implementations, many of +which extended the file format. John Gilmore’s +<b>pdtar</b> public-domain implementation (circa November, +1987) was quite influential, and formed the basis of GNU +tar. GNU tar was included as the standard system tar in +FreeBSD beginning with FreeBSD 1.0.</p> + +<p style="margin-left:8%; margin-top: 1em">This is a +complete re-implementation based on the libarchive(3) +library.</p> + +<p style="margin-top: 1em" valign="top"><b>BUGS</b></p> + +<p style="margin-left:8%;">This program follows ISO/IEC +9945-1:1996 (‘‘POSIX.1’’) for the +definition of the <b>−l</b> option. Note that GNU tar +prior to version 1.15 treated <b>−l</b> as a synonym +for the <b>−-one-file-system</b> option.</p> + +<p style="margin-left:8%; margin-top: 1em">The +<b>−C</b> <i>dir</i> option may differ from historic +implementations.</p> + +<p style="margin-left:8%; margin-top: 1em">All archive +output is written in correctly-sized blocks, even if the +output is being compressed. Whether or not the last output +block is padded to a full block size varies depending on the +format and the output device. For tar and cpio formats, the +last block of output is padded to a full block size if the +output is being written to standard output or to a character +or block device such as a tape drive. If the output is being +written to a regular file, the last block will not be +padded. Many compressors, including gzip(1) and bzip2(1), +complain about the null padding when decompressing an +archive created by <b>tar</b>, although they still extract +it correctly.</p> + +<p style="margin-left:8%; margin-top: 1em">The compression +and decompression is implemented internally, so there may be +insignificant differences between the compressed output +generated by</p> + +<p style="margin-left:17%;"><b>tar −czf</b> <i>- +file</i></p> + +<p style="margin-left:8%;">and that generated by</p> + +<p style="margin-left:17%;"><b>tar −cf</b> <i>- +file</i> | <b>gzip</b></p> + +<p style="margin-left:8%; margin-top: 1em">The default +should be to read and write archives to the standard I/O +paths, but tradition (and POSIX) dictates otherwise.</p> + +<p style="margin-left:8%; margin-top: 1em">The <b>r</b> and +<b>u</b> modes require that the archive be uncompressed and +located in a regular file on disk. Other archives can be +modified using <b>c</b> mode with the <i>@archive-file</i> +extension.</p> + +<p style="margin-left:8%; margin-top: 1em">To archive a +file called <i>@foo</i> or <i>-foo</i> you must specify it +as <i>./@foo</i> or <i>./-foo</i>, respectively.</p> + +<p style="margin-left:8%; margin-top: 1em">In create mode, +a leading <i>./</i> is always removed. A leading <i>/</i> is +stripped unless the <b>−P</b> option is specified.</p> + +<p style="margin-left:8%; margin-top: 1em">There needs to +be better support for file selection on both create and +extract.</p> + +<p style="margin-left:8%; margin-top: 1em">There is not yet +any support for multi-volume archives or for archiving +sparse files.</p> + +<p style="margin-left:8%; margin-top: 1em">Converting +between dissimilar archive formats (such as tar and cpio) +using the <b>@</b><i>-</i> convention can cause hard link +information to be lost. (This is a consequence of the +incompatible ways that different archive formats store +hardlink information.)</p> + +<p style="margin-left:8%; margin-top: 1em">There are +alternative long options for many of the short options that +are deliberately not documented.</p> + + +<p style="margin-left:8%; margin-top: 1em">FreeBSD 9.0 +Oct 12, 2009 FreeBSD 9.0</p> +<hr> +</body> +</html> |