%!PS-Adobe-3.0 %%Creator: groff version 1.19.2 %%CreationDate: Wed Jun 30 11:55:54 2010 %%DocumentNeededResources: font Times-Roman %%DocumentSuppliedResources: procset grops 1.19 2 %%Pages: 167 %%PageOrder: Ascend %%DocumentMedia: Default 612 792 0 () () %%Orientation: Portrait %%EndComments %%BeginDefaults %%PageMedia: Default %%EndDefaults %%BeginProlog %%BeginResource: procset grops 1.19 2 %!PS-Adobe-3.0 Resource-ProcSet /setpacking where{ pop currentpacking true setpacking }if /grops 120 dict dup begin /SC 32 def /A/show load def /B{0 SC 3 -1 roll widthshow}bind def /C{0 exch ashow}bind def /D{0 exch 0 SC 5 2 roll awidthshow}bind def /E{0 rmoveto show}bind def /F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def /G{0 rmoveto 0 exch ashow}bind def /H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def /I{0 exch rmoveto show}bind def /J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def /K{0 exch rmoveto 0 exch ashow}bind def /L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def /M{rmoveto show}bind def /N{rmoveto 0 SC 3 -1 roll widthshow}bind def /O{rmoveto 0 exch ashow}bind def /P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def /Q{moveto show}bind def /R{moveto 0 SC 3 -1 roll widthshow}bind def /S{moveto 0 exch ashow}bind def /T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def /SF{ findfont exch [exch dup 0 exch 0 exch neg 0 0]makefont dup setfont [exch/setfont cvx]cvx bind def }bind def /MF{ findfont [5 2 roll 0 3 1 roll neg 0 0]makefont dup setfont [exch/setfont cvx]cvx bind def }bind def /level0 0 def /RES 0 def /PL 0 def /LS 0 def /MANUAL{ statusdict begin/manualfeed true store end }bind def /PLG{ gsave newpath clippath pathbbox grestore exch pop add exch pop }bind def /BP{ /level0 save def 1 setlinecap 1 setlinejoin 72 RES div dup scale LS{ 90 rotate }{ 0 PL translate }ifelse 1 -1 scale }bind def /EP{ level0 restore showpage }def /DA{ newpath arcn stroke }bind def /SN{ transform .25 sub exch .25 sub exch round .25 add exch round .25 add exch itransform }bind def /DL{ SN moveto SN lineto stroke }bind def /DC{ newpath 0 360 arc closepath }bind def /TM matrix def /DE{ TM currentmatrix pop translate scale newpath 0 0 .5 0 360 arc closepath TM setmatrix }bind def /RC/rcurveto load def /RL/rlineto load def /ST/stroke load def /MT/moveto load def /CL/closepath load def /Fr{ setrgbcolor fill }bind def /setcmykcolor where{ pop /Fk{ setcmykcolor fill }bind def }if /Fg{ setgray fill }bind def /FL/fill load def /LW/setlinewidth load def /Cr/setrgbcolor load def /setcmykcolor where{ pop /Ck/setcmykcolor load def }if /Cg/setgray load def /RE{ findfont dup maxlength 1 index/FontName known not{1 add}if dict begin { 1 index/FID ne{def}{pop pop}ifelse }forall /Encoding exch def dup/FontName exch def currentdict end definefont pop }bind def /DEFS 0 def /EBEGIN{ moveto DEFS begin }bind def /EEND/end load def /CNT 0 def /level1 0 def /PBEGIN{ /level1 save def translate div 3 1 roll div exch scale neg exch neg exch translate 0 setgray 0 setlinecap 1 setlinewidth 0 setlinejoin 10 setmiterlimit []0 setdash /setstrokeadjust where{ pop false setstrokeadjust }if /setoverprint where{ pop false setoverprint }if newpath /CNT countdictstack def userdict begin /showpage{}def /setpagedevice{}def }bind def /PEND{ countdictstack CNT sub{end}repeat level1 restore }bind def end def /setpacking where{ pop setpacking }if %%EndResource %%EndProlog %%BeginSetup %%BeginFeature: *PageSize Default << /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice %%EndFeature %%IncludeResource: font Times-Roman grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron /scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent /ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen /period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon /semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O /P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex /underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y /z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft /guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl /endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut /dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash /quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen /brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft /logicalnot/minus/registered/macron/degree/plusminus/twosuperior /threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior /ordmasculine/guilsinglright/onequarter/onehalf/threequarters /questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE /Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex /Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis /multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn /germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla /egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis /eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash /ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def /Times-Roman@0 ENC0/Times-Roman RE %%EndSetup %%Page: 1 1 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF()0 12 Q(
)0 24 Q()36 36 Q(The \214rst synopsis form sho)0 48 Q (ws a)-.25 E -.74(``)0 60 S -.2(bu).74 G(ndled').2 E(')-.74 E(option w)0 72 Q(ord.)-.1 E 0 Cg EP %%Page: 10 10 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(This usage is pro)0 12 Q (vided for compatibility with historical implementations.)-.15 E (See COMP)0 24 Q -1.11(AT)-.92 G(IBILITY belo)1.11 E 2.5(wf)-.25 G (or details.)-2.5 E(
)36 36 Q(The other synopsis forms sho)0 48 Q 2.5 (wt)-.25 G(he preferred usage.)-2.5 E(The \214rst option to)0 60 Q (tar)0 72 Q 0 Cg EP %%Page: 11 11 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(is a mode indicator from the follo)0 12 Q (wing list:)-.25 E(
)36 72 Q 0 Cg EP %%Page: 16 16 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(In)0 12 Q(\255c,)0 24 Q (\255r,)0 36 Q(or)0 48 Q(\255u)0 60 Q (mode, each speci\214ed \214le or directory is added to the)0 72 Q 0 Cg EP %%Page: 17 17 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(archi)0 12 Q .3 -.15(ve i)-.25 H 2.5(nt).15 G (he order speci\214ed on the command line.)-2.5 E(By def)0 24 Q (ault, the contents of each directory are also archi)-.1 E -.15(ve)-.25 G(d.).15 E(
)36 36 Q(In e)0 48 Q (xtract or list mode, the entire command line)-.15 E (is read and parsed before the archi)0 60 Q .3 -.15(ve i)-.25 H 2.5(so) .15 G(pened.)-2.5 E (The pathnames or patterns on the command line indicate)0 72 Q 0 Cg EP %%Page: 18 18 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@0 SF(which items in the archi)0 12 Q .3 -.15(ve s) -.25 H(hould be processed.).15 E -.15(Pa)0 24 S (tterns are shell-style globbing patterns as).15 E(documented in)0 36 Q (tcsh\(1\).)0 48 Q(
archi)0 60 Q -.15(ve)-.25 G
(
Flc\
\255f
-
\
ne)0 72 Q
(w\214le
@
original.tar
)
-.25 E 0 Cg EP
%%Page: 21 21
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(
ne)0 36 Q
(w\214le
)-.25 E(and all of the entries from)0 48 Q
(
original.tar
.)0 60 Q(In contrast,)0 72 Q 0 Cg
EP
%%Page: 22 22
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(
Flc\
\255f
-
\
ne)0 36 Q(w\214le
original.tar
)-.25 E
(
Flc\
zf
-
\255-format \
pax @
-
)0 36 Q(
\))0 24 Q
(to the current directory after processing an)0 36 Q(y)-.15 E
(\255C)0 48 Q(options and before e)0 60 Q(xtracting an)
-.15 E 2.5<798c>-.15 G(les.)-2.5 E(
-
)0 48 Q
(for standard input or standard output.)0 60 Q
(If not speci\214ed, the def)0 72 Q(ault tape de)-.1 E
(vice will be used.)-.25 E 0 Cg EP
%%Page: 32 32
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\(On)0 12 Q(FreeBSD,)0 24 Q(the def)0 36 Q
(ault tape de)-.1 E(vice is)-.25 E(
/de)0 48 Q
(v/sa0
.\))-.25 E(
Fl\
b>c \255f
ne)0 60 Q -.65(w.)-.25
G(tar
\255-include='*foo*' @\
code>old.tgz
).65 E(
)0 72 Q 0 Cg EP
%%Page: 37 37
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(creates a ne)0 12 Q 2.5(wa)-.25 G(rchi)-2.5 E
-.15(ve)-.25 G(
ne)0 24 Q -.65(w.)-.25 G(tar
)
.65 E(containing only the entries from)0 36 Q
(
old.tgz
)0 48 Q(containing the string)0 60 Q
(`foo'.)0 72 Q 0 Cg EP
%%Page: 38 38
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(- \255j
- )0 12 Q
(\(c mode only\))0 24 Q(Compress the resulting archi)0 36 Q .3 -.15
(ve w)-.25 H(ith).15 E(bzip2\(1\).)0
48 Q(In e)0 60 Q(xtract or list modes, this option is ignored.)-.15 E
(Note that, unlik)0 72 Q 2.5(eo)-.1 G(ther)-2.5 E 0 Cg EP
%%Page: 39 39
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(tar)0 12 Q
(implementations, this implementation recognizes bzip2 compression)0 24
Q(automatically when reading archi)0 36 Q -.15(ve)-.25 G(s.).15 E
(
- \255k
- )0 48 Q(\(x mode only\))0 60 Q(Do not o)0
72 Q -.15(ve)-.15 G(rwrite e).15 E(xisting \214les.)-.15 E 0 Cg EP
%%Page: 40 40
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(In particular)0 12 Q 2.5(,i)-.4 G 2.5(fa\214)
-2.5 G(le appears more than once in an archi)-2.5 E -.15(ve)-.25 G(,).15
E(later copies will not o)0 24 Q -.15(ve)-.15 G(rwrite earlier copies.)
.15 E(
- \255-k)0 36 Q(eep-ne)-.1 E(wer)-.25 E
(-\214les
- )-.2 E(\(x mode only\))0 48 Q(Do not o)0 60 Q -.15(ve)
-.15 G(rwrite e).15 E(xisting \214les that are ne)-.15 E(wer than the)
-.25 E -.15(ve)0 72 S(rsions appearing in the archi).15 E .3 -.15(ve b)
-.25 H(eing e).15 E(xtracted.)-.15 E 0 Cg EP
%%Page: 41 41
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(
- \255L
- )0 12 Q
(\(c and r mode only\))0 24 Q(All symbolic links will be follo)0 36 Q
(wed.)-.25 E(Normally)0 48 Q 2.5(,s)-.65 G(ymbolic links are archi)-2.5
E -.15(ve)-.25 G 2.5(da).15 G 2.5(ss)-2.5 G(uch.)-2.5 E -.4(Wi)0 60 S
(th this option, the tar).4 E(get of the link will be archi)-.18 E -.15
(ve)-.25 G 2.5(di).15 G(nstead.)-2.5 E(
- \255l
- )0
72 Q 0 Cg EP
%%Page: 42 42
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(This is a synon)0 12 Q(ym for the)-.15 E
(\255-check-links)0 24 Q(option.)0 36 Q
(
- \255m
- )0 48 Q(\(x mode only\))0 60 Q(Do not e)0
72 Q(xtract modi\214cation time.)-.15 E 0 Cg EP
%%Page: 43 43
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(By def)0 12 Q
(ault, the modi\214cation time is set to the time stored in the archi)
-.1 E -.15(ve)-.25 G(.).15 E(
- \255n
- )0 24 Q
(\(c, r)0 36 Q 2.5(,um)-.4 G(odes only\))-2.5 E(Do not recursi)0 48 Q
-.15(ve)-.25 G(ly archi).15 E .3 -.15(ve t)-.25 H
(he contents of directories.).15 E(
- \255-ne)0 60 Q
(wer date
- )-.25 E(\(c, r)0 72 Q 2.5(,um)-.4 G
(odes only\))-2.5 E 0 Cg EP
%%Page: 44 44
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Only include \214les and directories ne)0 12 Q
(wer than the speci\214ed date.)-.25 E(This compares ctime entries.)0 24
Q(
- \255-ne)0 36 Q(wer)-.25 E
(-mtime date
- )-.2 E(\(c, r)0 48 Q 2.5(,um)-.4 G
(odes only\))-2.5 E(Lik)0 60 Q(e)-.1 E(\255-ne)0 72 Q
(wer,)-.25 E 0 Cg EP
%%Page: 45 45
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.15(ex)0 12 S
(cept it compares mtime entries instead of ctime entries.).15 E
(
- \255-ne)0 24 Q(wer)-.25 E
(-than
\214le
- )-.2 E(\(c, r)0 36 Q 2.5
(,um)-.4 G(odes only\))-2.5 E(Only include \214les and directories ne)0
48 Q(wer than the speci\214ed \214le.)-.25 E
(This compares ctime entries.)0 60 Q(
- \255-ne)0 72 Q
(wer)-.25 E(-mtime-than
\214le
- )-.2 E 0
Cg EP
%%Page: 46 46
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\(c, r)0 12 Q 2.5(,um)-.4 G(odes only\))-2.5 E
(Lik)0 24 Q(e)-.1 E(\255-ne)0 36 Q(wer)-.25 E(-than,)-.2 E
-.15(ex)0 48 S(cept it compares mtime entries instead of ctime entries.)
.15 E(
- \255-nodump
- )0 60 Q
(\(c and r modes only\))0 72 Q 0 Cg EP
%%Page: 47 47
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(Honor the nodump \214le \215ag by skipping this \214le.)0 12 Q
(
- \255-null
- )0 24 Q(\(use with)0 36 Q
(\255I,)0 48 Q(\255T,)0 60 Q(or)0 72 Q 0 Cg
EP
%%Page: 48 48
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\255X\))0 12 Q
(Filenames or patterns are separated by null characters,)0 24 Q
(not by ne)0 36 Q(wlines.)-.25 E
(This is often used to read \214lenames output by the)0 48 Q
(\255print0)0 60 Q(option to)0 72 Q 0 Cg EP
%%Page: 49 49
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\214nd\(1\).)
0 12 Q(
- \255-numeric-o)0 24 Q(wner
- )-.25 E
(\(x mode only\))0 36 Q
(Ignore symbolic user and group names when restoring archi)0 48 Q -.15
(ve)-.25 G 2.5(st).15 G 2.5(od)-2.5 G(isk,)-2.5 E
(only numeric uid and gid v)0 60 Q(alues will be obe)-.25 E(yed.)-.15 E
(
- \255O
- )0 72 Q 0 Cg EP
%%Page: 50 50
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\(x, t modes only\))0 12 Q(In e)0 24 Q(xtract \
\(-x\) mode, \214les will be written to standard out rather than)-.15 E
(being e)0 36 Q(xtracted to disk.)-.15 E(In list \(-t\) mode, the \214l\
e listing will be written to stderr rather than)0 48 Q
(the usual stdout.)0 60 Q(
- \255o
- )0 72 Q 0 Cg EP
%%Page: 51 51
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\(x mode\))0 12 Q
(Use the user and group of the user running the program rather)0 24 Q
(than those speci\214ed in the archi)0 36 Q -.15(ve)-.25 G(.).15 E
(Note that this has no signi\214cance unless)0 48 Q(\255p)
0 60 Q(is speci\214ed, and the program is being run by the root user)0
72 Q(.)-.55 E 0 Cg EP
%%Page: 52 52
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(In this case, the \214le modes and \215ags from)
0 12 Q(the archi)0 24 Q .3 -.15(ve w)-.25 H(ill be restored, b).15 E
(ut A)-.2 E(CLs or o)-.4 E(wner information in)-.25 E(the archi)0 36 Q
.3 -.15(ve w)-.25 H(ill be discarded.).15 E
(
- \255o
- )0 48 Q(\(c, r)0 60 Q 2.5(,um)-.4 G
(ode\))-2.5 E 2.5(As)0 72 S(ynon)-2.5 E(ym for)-.15 E 0 Cg EP
%%Page: 53 53
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\255-format ustar)0
12 Q(
- \255-one-\214le-system
- )0 24 Q(\(c, r)0 36
Q 2.5(,a)-.4 G(nd u modes\))-2.5 E(Do not cross mount points.)0 48 Q
(
- \255-options options
- )0 60 Q
(Select optional beha)0 72 Q(viors for particular modules.)-.2 E 0 Cg EP
%%Page: 54 54
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(The ar)0 12 Q(gument is a te)-.18 E
(xt string containing comma-separated)-.15 E -.1(ke)0 24 S(yw)-.05 E
(ords and v)-.1 E(alues.)-.25 E
(These are passed to the modules that handle particular)0 36 Q
(formats to control ho)0 48 Q 2.5(wt)-.25 G(hose formats will beha)-2.5
E -.15(ve)-.2 G(.).15 E(Each option has one of the follo)0 60 Q
(wing forms:)-.25 E(
)0 72 Q 0 Cg EP
%%Page: 55 55
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(- k)0 12 Q -.15(ey)-.1 G(=v).15 E
(alue
- )-.25 E(The k)0 24 Q .3 -.15(ey w)-.1 H
(ill be set to the speci\214ed v).15 E(alue in e)-.25 E -.15(ve)-.25 G
(ry module that supports it.).15 E(Modules that do not support this k)0
36 Q .3 -.15(ey w)-.1 H(ill ignore it.).15 E(
- k)0 48 Q -.15
(ey)-.1 G(
- ).15 E(The k)0 60 Q .3 -.15(ey w)-.1 H
(ill be enabled in e).15 E -.15(ve)-.25 G(ry module that supports it.)
.15 E(This is equi)0 72 Q -.25(va)-.25 G(lent to).25 E 0 Cg EP
%%Page: 56 56
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(k)0 12 Q -.15(ey)-.1 G
(=1.).15 E(
- !k)0 24 Q -.15(ey)-.1 G
(
- ).15 E(The k)0 36 Q .3 -.15(ey w)-.1 H(ill be disabled in e).15
E -.15(ve)-.25 G(ry module that supports it.).15 E
(
- module:k)0 48 Q -.15(ey)-.1 G(=v).15 E
(alue, module:k)-.25 E -.15(ey)-.1 G
(, module:!k).15 E -.15(ey)-.1 G(
- ).15 E(As abo)0
60 Q -.15(ve)-.15 G 2.5(,b).15 G(ut the corresponding k)-2.7 E .3 -.15
(ey a)-.1 H(nd v).15 E(alue will be pro)-.25 E(vided)-.15 E
(only to modules whose name matches)0 72 Q 0 Cg EP
%%Page: 57 57
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(module.)0 12 Q(
)0 24 Q
(The currently supported modules and k)0 36 Q -.15(ey)-.1 G 2.5(sa).15 G
(re:)-2.5 E()0 48 Q(- iso9660:joliet
- )0
60 Q(Support Joliet e)0 72 Q(xtensions.)-.15 E 0 Cg EP
%%Page: 58 58
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(This is enabled by def)0 12 Q(ault, use)-.1 E
(!joliet)0 24 Q(or)0 36 Q(iso9660:!joliet)0
48 Q(to disable.)0 60 Q(
- iso9660:rockridge
- )0 72 Q 0
Cg EP
%%Page: 59 59
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Support Rock Ridge e)0 12 Q(xtensions.)-.15 E
(This is enabled by def)0 24 Q(ault, use)-.1 E(!rockridge)
0 36 Q(or)0 48 Q(iso9660:!rockridge)0 60 Q(to disable.)0
72 Q 0 Cg EP
%%Page: 60 60
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(
- gzip:compression-le)0 12 Q -.15
(ve)-.25 G(l
- ).15 E 2.5(Ad)0 24 S(ecimal inte)-2.5 E
(ger from 0 to 9 specifying the gzip compression le)-.15 E -.15(ve)-.25
G(l.).15 E(
- xz:compression-le)0 36 Q -.15(ve)-.25 G
(l
- ).15 E 2.5(Ad)0 48 S(ecimal inte)-2.5 E
(ger from 0 to 9 specifying the xz compression le)-.15 E -.15(ve)-.25 G
(l.).15 E(
- mtree:k)0 60 Q -.15(ey)-.1 G -.1
(wo).15 G(rd
- ).1 E(The mtree writer module allo)0 72 Q
(ws you to specify which mtree k)-.25 E -.15(ey)-.1 G -.1(wo).15 G(rds)
.1 E 0 Cg EP
%%Page: 61 61
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(will be included in the output.)0 12 Q
(Supported k)0 24 Q -.15(ey)-.1 G -.1(wo).15 G(rds include:).1 E
(cksum, de)0 36 Q(vice, \215ags\
b>, gid, gname, indent,)-.25 E
(link, md5, mode, n\
link, rmd160, sha1, sha256,)0 48 Q(sha384, sha512, size, time, uid, uname.)0 60 Q
(The def)0 72 Q(ault is equi)-.1 E -.25(va)-.25 G(lent to:).25 E 0 Cg EP
%%Page: 62 62
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.74(``)0 12 S(de).74 E(vice, \215ags, gid, gna\
me, link, mode, nlink, size, time, type, uid, uname')-.25 E('.)-.74 E
(
- mtree:all
- )0 24 Q(Enables all of the abo)0 36 Q .3
-.15(ve k)-.15 H -.15(ey).05 G -.1(wo).15 G(rds.).1 E -1.1(Yo)0 48 S 2.5
(uc)1.1 G(an also use)-2.5 E(mtree:!all)0 60 Q
(to disable all k)0 72 Q -.15(ey)-.1 G -.1(wo).15 G(rds.).1 E 0 Cg EP
%%Page: 63 63
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(
- mtree:use-set
- )0 12 Q
(Enable generation of)0 24 Q(/set)0 36 Q
(lines in the output.)0 48 Q(
- mtree:indent
- )0 60 Q
(Produce human-readable output by indenting options and splitting lines)
0 72 Q 0 Cg EP
%%Page: 64 64
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(to \214t into 80 columns.)0 12 Q
(
- zip:compression=type
- )0 24 Q(Use)0
36 Q(type)0 48 Q(as compression method.)0 60 Q
(Supported v)0 72 Q
(alues are store \(uncompressed\) and de\215ate \(gzip algorithm\).)-.25
E 0 Cg EP
%%Page: 65 65
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(
)0 12 Q(If a pro)0 24 Q
(vided option is not supported by an)-.15 E 2.5(ym)-.15 G(odule, that)
-2.5 E(is a f)0 36 Q(atal error)-.1 E(.)-.55 E
( - \255P
- )0 48 Q(Preserv)0 60 Q 2.5(ep)-.15 G
(athnames.)-2.5 E(By def)0 72 Q
(ault, absolute pathnames \(those that be)-.1 E(gin with a /)-.15 E 0 Cg
EP
%%Page: 66 66
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(character\) ha)0 12 Q .3 -.15(ve t)-.2 H
(he leading slash remo).15 E -.15(ve)-.15 G 2.5(db).15 G
(oth when creating archi)-2.5 E -.15(ve)-.25 G(s).15 E(and e)0 24 Q
(xtracting from them.)-.15 E(Also,)0 36 Q(tar)0 48 Q
(will refuse to e)0 60 Q(xtract archi)-.15 E .3 -.15(ve e)-.25 H
(ntries whose pathnames contain).15 E(
..
)0 72
Q 0 Cg EP
%%Page: 67 67
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(or whose tar)0 12 Q(get directory w)-.18 E
(ould be altered by a symlink.)-.1 E(This option suppresses these beha)0
24 Q(viors.)-.2 E( - \255p
- )0 36 Q(\(x mode only\))
0 48 Q(Preserv)0 60 Q 2.5<658c>-.15 G(le permissions.)-2.5 E
(Attempt to restore the full permissions, including o)0 72 Q(wner)-.25 E
2.5<2c8c>-.4 G(le modes, \214le)-2.5 E 0 Cg EP
%%Page: 68 68
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\215ags and A)0 12 Q(CLs, if a)-.4 E -.25(va)-.2
G(ilable, for each item e).25 E(xtracted from the archi)-.15 E -.15(ve)
-.25 G(.).15 E(By def)0 24 Q(ault, ne)-.1 E(wly-created \214les are o)
-.25 E(wned by the user running)-.25 E(,)0 36 Q
(the \214le mode is restored for ne)0 48 Q(wly-created re)-.25 E
(gular \214les, and)-.15 E(all other types of entries recei)0 60 Q .3
-.15(ve d)-.25 H(ef).15 E(ault permissions.)-.1 E(If)0 72 Q 0 Cg EP
%%Page: 69 69
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(tar)0 12 Q(is being run by root, the def)
0 24 Q(ault is to restore the o)-.1 E(wner unless the)-.25 E
(\255o)0 36 Q(option is also speci\214ed.)0 48 Q
(
- \255q \255\(-f)0 60 Q
(ast-read
- \))-.1 E(\(x and t mode only\))0 72 Q 0 Cg EP
%%Page: 70 70
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Extract or list only the \214rst archi)0 12 Q .3
-.15(ve e)-.25 H(ntry that matches each pattern).15 E
(or \214lename operand.)0 24 Q(Exit as soon as each speci\214ed pattern\
or \214lename has been matched.)0 36 Q(By def)0 48 Q(ault, the archi)
-.1 E .3 -.15(ve i)-.25 H 2.5(sa).15 G -.1(lwa)-2.5 G(ys read to the v)
.1 E(ery end, since)-.15 E
(there can be multiple entries with the same name and, by con)0 60 Q
-.15(ve)-.4 G(ntion,).15 E(later entries o)0 72 Q -.15(ve)-.15 G
(rwrite earlier entries.).15 E 0 Cg EP
%%Page: 71 71
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(This option is pro)0 12 Q
(vided as a performance optimization.)-.15 E
(
- \255S
- )0 24 Q(\(x mode only\))0 36 Q
(Extract \214les as sparse \214les.)0 48 Q -.15(Fo)0 60 S 2.5(re).15 G
-.15(ve)-2.75 G(ry block on disk, check \214rst if it contains only NUL\
L bytes and seek).15 E -.15(ove)0 72 S 2.5(ri).15 G 2.5(to)-2.5 G
(therwise.)-2.5 E 0 Cg EP
%%Page: 72 72
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(This w)0 12 Q(orks similiar to the con)-.1 E
(v=sparse option of dd.)-.4 E
(
- \255-strip-components count
- )0 24
Q(\(x mode only\))0 36 Q(Remo)0 48 Q .3 -.15(ve t)-.15 H
(he speci\214ed number of leading path elements.).15 E -.15(Pa)0 60 S
(thnames with fe).15 E(wer elements will be silently skipped.)-.25 E
(Note that the pathname is edited after checking inclusion/e)0 72 Q
(xclusion patterns)-.15 E 0 Cg EP
%%Page: 73 73
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.2(bu)0 12 S 2.5(tb).2 G
(efore security checks.)-2.5 E
(
- \255s pattern
- )0 24 Q
(Modify \214le or archi)0 36 Q .3 -.15(ve m)-.25 H
(ember names according to).15 E(
pattern
.)0 48
Q(The pattern has the format)0 60 Q(/old/ne)0 72 Q
(w/[gps])-.25 E 0 Cg EP
%%Page: 74 74
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(where)0 12 Q(old)0 24 Q
(is a basic re)0 36 Q(gular e)-.15 E(xpression,)-.15 E(ne)0 48
Q(w)-.25 E(is the replacement string of the matched part,)0 60 Q
(and the optional trailing letters modify)0 72 Q 0 Cg EP
%%Page: 75 75
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(ho)0 12 Q 2.5(wt)-.25 G
(he replacement is handled.)-2.5 E(If)0 24 Q(old)0 36 Q
(is not matched, the pattern is skipped.)0 48 Q -.4(Wi)0 60 S(thin).4 E
(ne)0 72 Q(w,)-.25 E 0 Cg EP
%%Page: 76 76
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 2.5(~i)0 12 S 2.5(ss)-2.5 G
(ubstituted with the match, \\1 to \\9 with the content of)-2.5 E
(the corresponding captured group.)0 24 Q
(The optional trailing g speci\214es that matching should continue)0 36
Q(after the matched part and stopped on the \214rst unmatched pattern.)0
48 Q
(The optional trailing s speci\214es that the pattern applies to the v)0
60 Q(alue)-.25 E(of symbolic links.)0 72 Q 0 Cg EP
%%Page: 77 77
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(The optional trailing p speci\214es that after \
a successful substitution)0 12 Q(the original path name and the ne)0 24
Q 2.5(wp)-.25 G(ath name should be printed to)-2.5 E(standard error)0 36
Q(.)-.55 E( - \255T \214lename
- )0 48
Q(In x or t mode,)0 60 Q(tar)0 72 Q 0 Cg EP
%%Page: 78 78
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(will read the list of names to be e)0 12 Q
(xtracted from)-.15 E(
\214lename
.)0 24 Q
(In c mode,)0 36 Q(tar)0 48 Q(will read names to be archi)0 60 Q
-.15(ve)-.25 G 2.5(df).15 G(rom)-2.5 E
(
\214lename
.)0 72 Q 0 Cg EP
%%Page: 79 79
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(The special name)0 12 Q -.74(``)0 24 S(-C').74 E
(')-.74 E
(on a line by itself will cause the current directory to be changed to)0
36 Q(the directory speci\214ed on the follo)0 48 Q(wing line.)-.25 E
(Names are terminated by ne)0 60 Q(wlines unless)-.25 E
(\255-null)0 72 Q 0 Cg EP
%%Page: 80 80
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(is speci\214ed.)0 12 Q(Note that)0 24 Q
(\255-null)0 36 Q
(also disables the special handling of lines containing)0 48 Q -.74(``)0
60 S(-C').74 E('.)-.74 E( - \255U
- )0 72 Q 0 Cg EP
%%Page: 81 81
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\(x mode only\))0 12 Q
(Unlink \214les before creating them.)0 24 Q -.4(Wi)0 36 S
(thout this option,).4 E(tar)0 48 Q -.15(ove)0 60 S(rwrites e).15
E(xisting \214les, which preserv)-.15 E(es e)-.15 E(xisting hardlinks.)
-.15 E -.4(Wi)0 72 S(th this option, e).4 E
(xisting hardlinks will be brok)-.15 E(en, as will an)-.1 E(y)-.15 E 0
Cg EP
%%Page: 82 82
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(symlink that w)0 12 Q(ould af)-.1 E
(fect the location of an e)-.25 E(xtracted \214le.)-.15 E(
- \
\255-use-compress-program program
- )0 24 Q
(Pipe the input \(in x or t mode\) or the output \(in c mode\) through)0
36 Q(
program
)0 48 Q(instead of using the b)0
60 Q(uiltin compression support.)-.2 E( - \255v
- )0
72 Q 0 Cg EP
%%Page: 83 83
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Produce v)0 12 Q(erbose output.)-.15 E
(In create and e)0 24 Q(xtract modes,)-.15 E(tar)0 36 Q
(will list each \214le name as it is read from or written to)0 48 Q
(the archi)0 60 Q -.15(ve)-.25 G(.).15 E(In list mode,)0 72 Q 0 Cg EP
%%Page: 84 84
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(tar)0 12 Q
(will produce output similar to that of)0 24 Q
(ls\(1\).)0 36 Q(Additional)0 48 Q
(\255v)0 60 Q(options will pro)0 72 Q
(vide additional detail.)-.15 E 0 Cg EP
%%Page: 85 85
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(
- \255-v)0 12 Q(ersion
- )
-.15 E(Print v)0 24 Q(ersion of)-.15 E(tar)0 36 Q(and)0 48 Q
(libarchi)0 60 Q -.15(ve)-.25 G(,).15 E(and e)0 72 Q(xit.)-.15 E
0 Cg EP
%%Page: 86 86
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(
- \255w
- )0 12 Q
(Ask for con\214rmation for e)0 24 Q -.15(ve)-.25 G(ry action.).15 E
(
- \255X \214lename
- )0 36 Q
(Read a list of e)0 48 Q(xclusion patterns from the speci\214ed \214le.)
-.15 E(See)0 60 Q(\255-e)0 72 Q(xclude)-.15 E 0 Cg EP
%%Page: 87 87
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(for more information about the handling of e)0
12 Q(xclusions.)-.15 E(
- \255y
- )0 24 Q
(\(c mode only\))0 36 Q(Compress the resulting archi)0 48 Q .3 -.15
(ve w)-.25 H(ith).15 E(bzip2\(1\).)0
60 Q(In e)0 72 Q(xtract or list modes, this option is ignored.)-.15 E 0
Cg EP
%%Page: 88 88
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Note that, unlik)0 12 Q 2.5(eo)-.1 G(ther)-2.5 E
(tar)0 24 Q
(implementations, this implementation recognizes bzip2 compression)0 36
Q(automatically when reading archi)0 48 Q -.15(ve)-.25 G(s.).15 E
(
- \255z
- )0 60 Q(\(c mode only\))0 72 Q 0 Cg EP
%%Page: 89 89
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Compress the resulting archi)0 12 Q .3 -.15
(ve w)-.25 H(ith).15 E(gzip\(1\).)0 24
Q(In e)0 36 Q(xtract or list modes, this option is ignored.)-.15 E
(Note that, unlik)0 48 Q 2.5(eo)-.1 G(ther)-2.5 E(tar)0 60 Q
(implementations, this implementation recognizes gzip compression)0 72 Q
0 Cg EP
%%Page: 90 90
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(automatically when reading archi)0 12 Q -.15(ve)
-.25 G(s.).15 E(
- \255Z
- )0 24 Q(\(c mode only\))0
36 Q(Compress the resulting archi)0 48 Q .3 -.15(ve w)-.25 H(ith).15 E
(compress\(1\).)0 60 Q(In e)0 72 Q
(xtract or list modes, this option is ignored.)-.15 E 0 Cg EP
%%Page: 91 91
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Note that, unlik)0 12 Q 2.5(eo)-.1 G(ther)-2.5 E
(tar)0 24 Q
(implementations, this implementation recognizes compress compression)0
36 Q(automatically when reading archi)0 48 Q -.15(ve)-.25 G(s.).15 E
(
LANG
T)0 24 Q(APE
TZ
/de)0 60 Q
(v/sa0
T)0 12 Q(APE
)-.93 E
(en)0 24 Q(vironment v)-.4 E(ariable or the)-.25 E(\255f)0
36 Q(option.)0 48 Q(
Flczf
\214le.tar)0 72 Q(\
.gz
source.c
source\
.h
)-.55 E 0 Cg EP
%%Page: 100 100
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF()36 24 Q 1.6 -.8(To v)0 36 T(ie)
.8 E 2.5(wad)-.25 G(etailed table of contents for this)-2.5 E(archi)0 48
Q -.15(ve)-.25 G(:).15 E(
)0 60 Q
( )0 72 Q 0 Cg EP
%%Page: 101 101
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(Fltvf
\214le.tar)0 12 Q
(.gz
)-.55 E(
)0 24 Q(
)36 36 Q 1.6 -.8(To e)0 48 T
(xtract all entries from the archi).65 E .3 -.15(ve o)-.25 H(n).15 E
(the def)0 60 Q(ault tape dri)-.1 E -.15(ve)-.25 G(:).15 E(
)0 72 Q 0
Cg EP
%%Page: 102 102
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF( )0 12 Q
(Flx)0 24 Q(
)0 36 Q(
)36 48 Q 1.6 -.8
(To e)0 60 T(xamine the contents of an ISO 9660 cdrom image:).65 E(
)
0 72 Q 0 Cg EP
%%Page: 103 103
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF( )0 12 Q
(Fltf
image.iso
)0
24 Q(
)0 36 Q(
)36 48 Q 1.6 -.8(To m)0 60 T .3 -.15(ove \214).8 H
(le hierarchies, in).15 E -.2(vo)-.4 G -.1(ke).2 G(tar)0 72 Q 0
Cg EP
%%Page: 104 104
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(as)0 12 Q( )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
(-C )36 72 Q 0 Cg EP
%%Page: 110 110
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(An input \214le in)0 12 Q
(mtree\(5\))0 24 Q
(format can be used to create an output archi)0 36 Q .3 -.15(ve w)-.25 H
(ith arbitrary o).15 E(wnership,)-.25 E(permissions, or names that dif)0
48 Q(fer from e)-.25 E(xisting data on disk:)-.15 E( )36 60 Q( )36 48 Q
(The)0 60 Q(\255-ne)0 72 Q(wer)-.25 E 0 Cg EP
%%Page: 114 114
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(and)0 12 Q(\255-ne)0 24 Q(wer)-.25 E
(-mtime)-.2 E(switches accept a v)0 36 Q
(ariety of common date and time speci\214cations, including)-.25 E -.74
(``)0 48 S(12 Mar 2005 7:14:29pm').74 E(',)-.74 E -.74(``)0 60 S
(2005-03-12 19:14').74 E(',)-.74 E -.74(``)0 72 S 2.5(5m).74 G
(inutes ago')-2.5 E(',)-.74 E 0 Cg EP
%%Page: 115 115
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(and)0 12 Q -.74(``)0 24 S(19:14 PST May 1').74 E
('.)-.74 E( )36 36 Q(The)0 48 Q(\255-options)0 60 Q(ar)0
72 Q(gument can be used to control v)-.18 E(arious details of archi)-.25
E .3 -.15(ve g)-.25 H(eneration).15 E 0 Cg EP
%%Page: 116 116
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(or reading.)0 12 Q -.15(Fo)0 24 S 2.5(re).15 G
(xample, you can generate mtree output which only contains)-2.65 E
(type, time,)0 36 Q(and)0 48 Q
(uid)0 60 Q -.1(ke)0 72 S(yw)-.05 E(ords:)-.1 E 0 Cg EP
%%Page: 117 117
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF( )36 72 Q 0 Cg EP
%%Page: 126 126
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(The mode options c, r)0 12 Q 2.5(,t)-.4 G 2.5
(,u)-2.5 G 2.5(,a)-2.5 G(nd x and the options)-2.5 E(b, f, l, m, o, v)0
24 Q 2.5(,a)-.65 G(nd w comply with SUSv2.)-2.5 E( )36 36 Q -.15(Fo)0
48 S 2.5(rm).15 G(aximum portability)-2.5 E 2.5(,s)-.65 G
(cripts that in)-2.5 E -.2(vo)-.4 G -.1(ke).2 G(tar)0 60 Q
(should use the b)0 72 Q(undled-ar)-.2 E(gument format abo)-.18 E -.15
(ve)-.15 G 2.5(,s).15 G(hould limit)-2.5 E 0 Cg EP
%%Page: 127 127
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(themselv)0 12 Q(es to the)-.15 E
(c,)0 24 Q(t,)0 36 Q(and)0 48 Q
(x)0 60 Q(modes, and the)0 72 Q 0 Cg EP
%%Page: 128 128
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(b,)0 12 Q(f,)0 24 Q
(m,)0 36 Q(v,)0 48 Q(and)0 60 Q
(w)0 72 Q 0 Cg EP
%%Page: 129 129
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(options.)0 12 Q( )36 24 Q
(Additional long options are pro)0 36 Q(vided to impro)-.15 E .3 -.15
(ve c)-.15 H(ompatibility with other).15 E(tar implementations.)0 48 Q
( )36 12 Q
(The ustar and pax interchange \214le formats are de\214ned by)0 24 Q
(IEEE Std 1003.1-2001 \(`)2.5 36 Q(`POSIX.1')-.74
E('\))-.74 E(for the pax command.)0 48 Q( )36 48 Q
(This is a complete re-implementation based on the)0 60 Q
(libarchi).15 E
-.15(ve)-.25 G(\(3\)).15 E 0 Cg EP
%%Page: 151 151
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(library)0 12 Q(.)-.65 E( )36 36 Q(The)0 48 Q
(\255C )36 12 Q(All archi)0 24 Q .3 -.15(ve o)-.25 H
(utput is written in correctly-sized blocks, e).15 E -.15(ve)-.25 G(n)
.15 E(if the output is being compressed.)0 36 Q
(Whether or not the last output block is padded to a full)0 48 Q
(block size v)0 60 Q(aries depending on the format and the)-.25 E
(output de)0 72 Q(vice.)-.25 E 0 Cg EP
%%Page: 155 155
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.15(Fo)0 12 S 2.5(rt).15 G
(ar and cpio formats, the last block of output is padded)-2.5 E
(to a full block size if the output is being)0 24 Q
(written to standard output or to a character or block de)0 36 Q
(vice such as)-.25 E 2.5(at)0 48 S(ape dri)-2.5 E -.15(ve)-.25 G(.).15 E
(If the output is being written to a re)0 60 Q
(gular \214le, the last block)-.15 E(will not be padded.)0 72 Q 0 Cg EP
%%Page: 156 156
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Man)0 12 Q 2.5(yc)-.15 G(ompressors, including)
-2.5 E(gzip\(1\))0 24 Q(and)0 36 Q
(bzip2\(1\),)0 48 Q
(complain about the null padding when decompressing an archi)0 60 Q .3
-.15(ve c)-.25 H(reated by).15 E(,)0 72 Q 0 Cg EP
%%Page: 157 157
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(although the)0 12 Q 2.5(ys)-.15 G(till e)-2.5 E
(xtract it correctly)-.15 E(.)-.65 E( )36 24 Q
(The compression and decompression is implemented internally)0 36 Q 2.5
(,s)-.65 G(o)-2.5 E(there may be insigni\214cant dif)0 48 Q
(ferences between the compressed output)-.25 E(generated by)0 60 Q( )36 36 Q(The def)0 48 Q(ault should be to read and write archi)
-.1 E -.15(ve)-.25 G 2.5(st).15 G 2.5(ot)-2.5 G(he standard I/O paths,)
-2.5 E -.2(bu)0 60 S 2.5(tt).2 G
(radition \(and POSIX\) dictates otherwise.)-2.5 E( )36 72 Q 0 Cg EP
%%Page: 160 160
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(The)0 12 Q(r)0 24 Q(and)0 36 Q
(u)0 48 Q(modes require that the archi)0 60 Q .3 -.15
(ve b)-.25 H 2.5(eu).15 G(ncompressed)-2.5 E(and located in a re)0 72 Q
(gular \214le on disk.)-.15 E 0 Cg EP
%%Page: 161 161
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Other archi)0 12 Q -.15(ve)-.25 G 2.5(sc).15 G
(an be modi\214ed using)-2.5 E(c)0 24 Q(mode with the)0 36
Q( )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( )36 48 Q
(In create mode, a leading)0 60 Q( )36 12 Q
(There needs to be better support for \214le selection on both create)0
24 Q(and e)0 36 Q(xtract.)-.15 E( )36 48 Q(There is not yet an)0 60 Q
2.5(ys)-.15 G(upport for multi-v)-2.5 E(olume archi)-.2 E -.15(ve)-.25 G
2.5(so).15 G 2.5(rf)-2.5 G(or archi)-2.5 E(ving)-.25 E(sparse \214les.)0
72 Q 0 Cg EP
%%Page: 166 166
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF( )36 12 Q(Con)0 24 Q -.15(ve)-.4 G
(rting between dissimilar archi).15 E .3 -.15(ve f)-.25 H
(ormats \(such as tar and cpio\) using the).15 E
(@ )36 12 Q(There are alternati)0 24 Q .3 -.15
(ve l)-.25 H(ong options for man).15 E 2.5(yo)-.15 G 2.5(ft)-2.5 G
(he short options that)-2.5 E(are deliberately not documented.)0 36 Q
()0 48 Q()0 60 Q 0 Cg EP
%%Trailer
end
%%EOF
)0 24 Q
( )0 36 Q(Flc\
f
-
\255C srcdir .
|
Fl xpf\
-
\255C destdir
)0 48 Q
(
)0 60 Q(or more traditionally)0 72 Q 0 Cg EP
%%Page: 105 105
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(
)0 12 Q
( )0 24 Q(cd
srcdir
;
Fl cf |
\( cd
destdir
-
\))0 36 Q
(
)0 48 Q(foo/baz
)0 24 Q(and archi)0 36
Q .3 -.15(ve i)-.25 H(nclusions of the form).15 E
(@archi)0 48 Q -.15(ve)-.25 G
(-\214le
.).15 E -.15(Fo)0 60 S 2.5(re).15 G
(xample, the command line)-2.65 E(
)0 72 Q 0 Cg EP
%%Page: 107 107
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF( )0 12 Q( ne)0
24 Q -.65(w.)-.25 G(tar
foo1
\
@old.tgz
-C foo2
).65 E(
)0 36 Q
(will create a ne)0 48 Q 2.5(wa)-.25 G(rchi)-2.5 E -.15(ve)-.25 G
(ne)0 60 Q -.65(w.)-.25 G(tar
.).65 E
(tar)0 72 Q 0 Cg EP
%%Page: 108 108
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(will read the \214le)0 12 Q
(foo1
)0 24 Q
(from the current directory and add it to the output archi)0 36 Q -.15
(ve)-.25 G(.).15 E(It will then read each entry from)0 48 Q
(old.tgz
)0 60 Q
(and add those entries to the output archi)0 72 Q -.15(ve)-.25 G(.).15 E
0 Cg EP
%%Page: 109 109
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Finally)0 12 Q 2.5(,i)-.65 G 2.5(tw)-2.5 G
(ill switch to the)-2.5 E(/tmp
)0 24 Q
(directory and add)0 36 Q(foo2
)0 48 Q
(to the output archi)0 60 Q -.15(ve)-.25 G(.).15 E(
)0
72 Q 0 Cg EP
%%Page: 111 111
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF( )0 12 Q
($
cat
input.mtree
)0
24 Q(
)0 36 Q( )0 48 Q
(#mtree
)0 60 Q(
)0 72 Q 0 Cg EP
%%Page: 112 112
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF( )0 12 Q(usr/bin
uid=0
gid=0
type=dir
)0 24 Q(
)0 36 Q
( )0 48 Q(usr/bin\
/ls
uid=0
gid=0
mode=0755
\
type=\214le
content=myls
)0 60 Q(
)0 72 Q 0
Cg EP
%%Page: 113 113
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF( )0 12 Q($
tar
-cvf
outpu\
t.tar
@input.mtree
)0 24 Q(
)0 36 Q(
)0 12 Q
( )0 24 Q(Flc\
f
\214le.tar
\255-format=mtree<\
/b> \255-options='!all,type,time,uid' \
dir
)0 36 Q(
)0 48 Q(or you can set the compression le)0 60 Q
-.15(ve)-.25 G 2.5(lu).15 G(sed by gzip or xz compression:)-2.5 E(
)0
72 Q 0 Cg EP
%%Page: 118 118
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF( )0 12 Q( \214le.tar
\
\255-options='compression-le)0 24 Q -.15(ve)-.25 G(l=9'.).15
E(
)0 36 Q -.15(Fo)0 48 S 2.5(rm).15 G(ore details, see the e)-2.5 E
(xplanation of the)-.15 E(archi)0 60 Q -.15(ve)-.25 G
(_read_set_options\(\)).15 E(and)0 72 Q 0 Cg EP
%%Page: 119 119
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(archi)0 12 Q -.15(ve)-.25 G
(_write_set_options\(
\)).15 E
(API calls that are described in)0 24 Q(archi).15 E -.15(ve)-.25 G(_read\(3\)).15
E(and)0 48 Q(archi).15 E -.15(ve)-.25 G(_write\(3\).).15 E
(
)1.11 E 0 Cg EP
%%Page: 120 120
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(COMP)36 12 Q -1.11(AT)-.92 G(IBILITY)1.11 E
(
)36 24 Q(The b)0 36 Q(undled-ar)-.2 E
(guments format is supported for compatibility)-.18 E
(with historic implementations.)0 48 Q(It consists of an initial w)0 60
Q(ord \(with no leading - character\) in which)-.1 E
(each character indicates an option.)0 72 Q 0 Cg EP
%%Page: 121 121
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Ar)0 12 Q(guments follo)-.18 E 2.5(wa)-.25 G 2.5
(ss)-2.5 G(eparate w)-2.5 E(ords.)-.1 E(The order of the ar)0 24 Q
(guments must match the order)-.18 E
(of the corresponding characters in the b)0 36 Q(undled command w)-.2 E
(ord.)-.1 E -.15(Fo)0 48 S 2.5(re).15 G(xample,)-2.65 E(
)0 60 Q
( )0 72 Q 0 Cg EP
%%Page: 122 122
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Cmtbf 32
\214le.tar
)0 12 Q(
)0 24 Q
(speci\214es three \215ags)0 36 Q(t,)0 48 Q
(b,)0 60 Q(and)0 72 Q 0 Cg EP
%%Page: 123 123
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(f.)0 12 Q(The)0 24 Q
(b)0 36 Q(and)0 48 Q(f)0 60 Q
(\215ags both require ar)0 72 Q(guments,)-.18 E 0 Cg EP
%%Page: 124 124
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(so there must be tw)0 12 Q 2.5(oa)-.1 G
(dditional items)-2.5 E(on the command line.)0 24 Q(The)0 36 Q
(32)0 48 Q(is the ar)0 60 Q(gument to the)-.18 E
(b)0 72 Q 0 Cg EP
%%Page: 125 125
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\215ag, and)0 12 Q(\214le.tar)0 24
Q(is the ar)0 36 Q(gument to the)-.18 E(f)0 48 Q(\215ag.)0
60 Q()36 60 Q(SECURITY)36 72 Q 0 Cg EP
%%Page: 130 130
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(
)36 12 Q
(Certain security issues are common to man)0 24 Q 2.5(ya)-.15 G(rchi)
-2.5 E(ving programs, including)-.25 E(.)0 36 Q(In particular)0
48 Q 2.5(,c)-.4 G(arefully-crafted archi)-2.5 E -.15(ve)-.25 G 2.5(sc)
.15 G(an request that)-2.5 E(tar)0 60 Q -.15(ex)0 72 S
(tract \214les to locations outside of the tar).15 E(get directory)-.18
E(.)-.65 E 0 Cg EP
%%Page: 131 131
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF
(This can potentially be used to cause unwitting users to o)0 12 Q -.15
(ve)-.15 G(rwrite).15 E(\214les the)0 24 Q 2.5(yd)-.15 G
(id not intend to o)-2.5 E -.15(ve)-.15 G(rwrite.).15 E(If the archi)0
36 Q .3 -.15(ve i)-.25 H 2.5(sb).15 G(eing e)-2.5 E
(xtracted by the superuser)-.15 E 2.5(,a)-.4 G .3 -.15(ny \214)-2.5 H
(le).15 E(on the system can potentially be o)0 48 Q -.15(ve)-.15 G
(rwritten.).15 E(There are three w)0 60 Q(ays this can happen.)-.1 E
(Although)0 72 Q 0 Cg EP
%%Page: 132 132
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(tar)0 12 Q(has mechanisms to protect ag)0
24 Q(ainst each one,)-.05 E(sa)0 36 Q(vvy users should be a)-.2 E -.1
(wa)-.15 G(re of the implications:).1 E()0 48 Q(
)0 60 Q 1.6 -.8(To p)0 72 T
(rotect yourself, you should be w).8 E(ary of an)-.1 E 2.5(ya)-.15 G
(rchi)-2.5 E -.15(ve)-.25 G 2.5(st).15 G(hat)-2.5 E 0 Cg EP
%%Page: 139 139
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(come from untrusted sources.)0 12 Q -1.1(Yo)0 24
S 2.5(us)1.1 G(hould e)-2.5 E(xamine the contents of an archi)-.15 E .3
-.15(ve w)-.25 H(ith).15 E(/
)0 48 Q
(character from \214lenames before restoring them to guard ag)0 60 Q
(ainst this problem.)-.05 E(..
)0 24 Q(components.)0 36 Q(By def)0 48 Q
(ault,)-.1 E(tar)0 60 Q(will not e)0 72 Q
(xtract \214les containing)-.15 E 0 Cg EP
%%Page: 135 135
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(..
)0 12 Q
(components in their pathname.)0 24 Q(
)0 36 Q
( )0 48 Q
(Fltf
\214lename
)0
60 Q(
)0 72 Q 0 Cg EP
%%Page: 140 140
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(before e)0 12 Q(xtraction.)-.15 E -1.1(Yo)0 24 S
2.5(us)1.1 G(hould use the)-2.5 E(\255k)0 36 Q
(option to ensure that)0 48 Q(tar)0 60 Q(will not o)0 72 Q -.15
(ve)-.15 G(rwrite an).15 E 2.5(ye)-.15 G(xisting \214les or the)-2.65 E
0 Cg EP
%%Page: 141 141
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\255U)0 12 Q(option to remo)0 24 Q
.3 -.15(ve a)-.15 H .3 -.15(ny p).15 H(re-e).15 E(xisting \214les.)-.15
E -1.1(Yo)0 36 S 2.5(us)1.1 G(hould generally not e)-2.5 E(xtract archi)
-.15 E -.15(ve)-.25 G 2.5(sw).15 G(hile running with super)-2.5 E(-user)
-.2 E(pri)0 48 Q(vile)-.25 E(ges.)-.15 E(Note that the)0 60 Q
(\255P)0 72 Q 0 Cg EP
%%Page: 142 142
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(option to)0 12 Q(tar)0 24 Q
(disables the security checks abo)0 36 Q .3 -.15(ve a)-.15 H(nd allo).15
E(ws you to e)-.25 E(xtract)-.15 E(an archi)0 48 Q .3 -.15(ve w)-.25 H
(hile preserving an).15 E 2.5(ya)-.15 G(bsolute pathnames,)-2.5 E
(..
)0 60 Q
(components, or symlinks to other directories.)0 72 Q 0 Cg EP
%%Page: 143 143
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF()36 12 Q(SEE ALSO)36 24 Q
(
)36 36 Q(bzip2\(1\),)0 48 Q
(compress\(1\),)0 60 Q
(cpio\(1\),)0 72 Q 0 Cg EP
%%Page: 144 144
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(gzip\(1\),)0 12
Q(mt\(1\),)0 24 Q
(pax\(1\),)0 36 Q
(shar\(1\),)-.55 E
(libarchi).15 E
-.15(ve)-.25 G(\(3\),).15 E(libarchi).15 E -.15(ve)-.25 G
(-formats\(5\),).15 E 0 Cg EP
%%Page: 145 145
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(tar\(5\))-.55 E()-.4 E
(ST)36 36 Q(AND)-.93 E(ARDS)-.4 E(
)36 48 Q
(There is no current POSIX standard for the tar command; it appeared)0
60 Q(in)0 72 Q 0 Cg EP
%%Page: 146 146
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(ISO/IEC 9945-1:1996 \(`)2.5 12 Q
(`POSIX.1')-.74 E('\))-.74 E -.2(bu)0 24 S 2.5
(tw).2 G(as dropped from)-2.6 E(IEEE Std 1003.1-2001 \(`)2.5 36 Q
(`POSIX.1')-.74 E('\) .)-.74 E
(The options used by this implementation were de)0 48 Q -.15(ve)-.25 G
(loped by surv).15 E -.15(ey)-.15 G(ing a).15 E(number of e)0 60 Q
(xisting tar implementations as well as the old POSIX speci\214cation)
-.15 E(for tar and the current POSIX speci\214cation for pax.)0 72 Q 0
Cg EP
%%Page: 147 147
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF()-.65 E(HIST)36 72 Q(OR)-.18 E(Y)-.65 E 0 Cg EP
%%Page: 148 148
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(
)36 12 Q(A)0 24 Q(tar)0 36 Q
(command appeared in Se)0 48 Q -.15(ve)-.25 G(nth Edition Unix, which w)
.15 E(as released in January)-.1 E 2.5(,1)-.65 G(979.)-2.5 E(There ha)0
60 Q .3 -.15(ve b)-.2 H(een numerous other implementations,).15 E(man)0
72 Q 2.5(yo)-.15 G 2.5(fw)-2.5 G(hich e)-2.5 E
(xtended the \214le format.)-.15 E 0 Cg EP
%%Page: 149 149
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(John Gilmore')0 12 Q(s)-.55 E(pdtar)0 24
Q(public-domain implementation \(circa No)0 36 Q -.15(ve)-.15 G(mber).15
E 2.5(,1)-.4 G(987\))-2.5 E -.1(wa)0 48 S 2.5(sq).1 G
(uite in\215uential, and formed the basis of GNU tar)-2.5 E(.)-.55 E
(GNU tar w)0 60 Q(as included as the standard system tar)-.1 E(in)0 72 Q
0 Cg EP
%%Page: 150 150
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(FreeBSD)0 12 Q(be)0 24 Q(ginning with)-.15 E
(FreeBSD1.0.)0 36 Q()
-.1 E -.1(BU)36 36 S(GS).1 E(
)36 48 Q(This program follo)0 60 Q(ws)
-.25 E(ISO/IEC 9945-1:1996 \(`)2.5 72 Q
(`POSIX.1')-.74 E('\))-.74 E 0 Cg EP
%%Page: 152 152
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(for the de\214nition of the)0 12 Q
(\255l)0 24 Q(option.)0 36 Q(Note that GNU tar prior to v)
0 48 Q(ersion 1.15 treated)-.15 E(\255l)0 60 Q(as a synon)
0 72 Q(ym for the)-.15 E 0 Cg EP
%%Page: 153 153
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(\255-one-\214le-system)0 12 Q
(option.)0 24 Q( dir
)0 60 Q
(option may dif)0 72 Q(fer from historic implementations.)-.25 E 0 Cg EP
%%Page: 154 154
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(
)
0 72 Q 0 Cg EP
%%Page: 158 158
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF( )0 12 Q( -
\214le<\
/code>)0 24 Q(
)0 36 Q(and that generated by)0 48 Q(
)0 60 Q
( )0 72 Q 0 Cg EP
%%Page: 159 159
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(Flcf
\214le
|
gzip)0 12 Q(
)0
24 Q(@archi)0 48 Q -.15(ve)-.25 G(-\214le
).15 E
-.15(ex)0 60 S(tension.).15 E(@foo
)0 24 Q(or)0 36 Q
(-foo
)0 48 Q(you must specify it as)0 60 Q
(./@foo
)0 72 Q 0 Cg EP
%%Page: 163 163
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(or)0 12 Q(./-foo
,)0 24
Q(respecti)0 36 Q -.15(ve)-.25 G(ly).15 E(.)-.65 E(./
)0 72 Q 0
Cg EP
%%Page: 164 164
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(is al)0 12 Q -.1(wa)-.1 G(ys remo).1 E -.15(ve)
-.15 G(d.).15 E 2.5(Al)0 24 S(eading)-2.5 E(/
)
0 36 Q(is stripped unless the)0 48 Q(\255P)0 60 Q
(option is speci\214ed.)0 72 Q 0 Cg EP
%%Page: 165 165
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF(-
)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(