diff options
Diffstat (limited to 'archivers/libarchive/files/doc/html/bsdcpio.1.html')
-rw-r--r-- | archivers/libarchive/files/doc/html/bsdcpio.1.html | 1409 |
1 files changed, 519 insertions, 890 deletions
diff --git a/archivers/libarchive/files/doc/html/bsdcpio.1.html b/archivers/libarchive/files/doc/html/bsdcpio.1.html index 66d08c5e978..27c60219ec7 100644 --- a/archivers/libarchive/files/doc/html/bsdcpio.1.html +++ b/archivers/libarchive/files/doc/html/bsdcpio.1.html @@ -1,890 +1,519 @@ -%!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: 72 -%%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 -(December 21, 2007 BSDCPIO 1)74.5 48 Q(</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>cpio</b>)0 48 Q 2.5(-c)0 60 S(op)-2.5 E 2.5 -<798c>-.1 G(les to and from 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>cpio</b>)0 36 -Q({<b>\255</b><b>i</b>})0 48 Q([<i></i><i>options</i>])0 60 Q -([<i></i><i>pattern</i><i> ...</i>])0 72 Q 0 Cg EP -%%Page: 6 6 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF([<i></i><i><</i><i> archi)0 12 Q -.15(ve)-.25 G -(</i>]).15 E(<b>cpio</b>)0 24 Q({<b>\255</b><b>o</b>})0 36 Q -([<i></i><i>options</i>])0 48 Q(<i></i><i><</i><i> name-list</i>)0 60 Q -([<i></i><i>></i><i> archi)0 72 Q -.15(ve)-.25 G(</i>]).15 E 0 Cg EP -%%Page: 7 7 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<b>cpio</b>)0 12 Q({<b>\255</b><b>p</b>})0 24 Q -([<i></i><i>options</i>])0 36 Q(<i></i><i>dest-dir</i>)0 48 Q -(<i></i><i><</i><i> name-list</i>)0 60 Q(<h3 id="DESCRIPTION">)36 72 Q 0 -Cg EP -%%Page: 8 8 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(DESCRIPTION)36 12 Q(</h3>)36 24 Q(<b>cpio</b>)0 -36 Q(copies \214les between archi)0 48 Q -.15(ve)-.25 G 2.5(sa).15 G -(nd directories.)-2.5 E(This implementation can e)0 60 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(and ISO 9660 cdrom images and can create tar)0 72 Q -2.5(,p)-.4 G(ax, cpio, ar)-2.5 E(,)-.4 E 0 Cg EP -%%Page: 9 9 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(and shar archi)0 12 Q -.15(ve)-.25 G(s.).15 E -(<p>)36 24 Q(The \214rst option to)0 36 Q(<b>cpio</b>)0 48 Q -(is a mode indicator from the follo)0 60 Q(wing list:)-.25 E -(<dl compact>)0 72 Q 0 Cg EP -%%Page: 10 10 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<dt><b>\255</b><b>i</b><dd>)0 12 Q(Input.)0 24 Q -(Read an archi)0 36 Q .3 -.15(ve f)-.25 H(rom standard input \(unless o) -.15 E -.15(ve)-.15 G(rriden\) and e).15 E(xtract the)-.15 E -(contents to disk or \(if the)0 48 Q(<b>\255</b><b>t</b>)0 60 Q -(option is speci\214ed\))0 72 Q 0 Cg EP -%%Page: 11 11 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(list the contents to standard output.)0 12 Q -(If one or more \214le patterns are speci\214ed, only \214les matching)0 -24 Q(one of the patterns will be e)0 36 Q(xtracted.)-.15 E -(<dt><b>\255</b><b>o</b><dd>)0 48 Q(Output.)0 60 Q -(Read a list of \214lenames from standard input and produce a ne)0 72 Q -2.5(wa)-.25 G(rchi)-2.5 E -.15(ve)-.25 G 0 Cg EP -%%Page: 12 12 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(on standard output \(unless o)0 12 Q -.15(ve) --.15 G(rriden\) containing the speci\214ed items.).15 E -(<dt><b>\255</b><b>p</b><dd>)0 24 Q -.15(Pa)0 36 S(ss-through.).15 E -(Read a list of \214lenames from standard input and cop)0 48 Q 2.5(yt) --.1 G(he \214les to the)-2.5 E(speci\214ed directory)0 60 Q(.)-.65 E -(</dl>)0 72 Q 0 Cg EP -%%Page: 13 13 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<p>)36 12 Q(<h3 id="OPTIONS">)36 24 Q(OPTIONS)36 -36 Q(</h3>)36 48 Q -(Unless speci\214cally stated otherwise, options are applicable in)0 60 -Q(all operating modes.)0 72 Q 0 Cg EP -%%Page: 14 14 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<dl compact>)0 12 Q -(<p><dt><b>\255</b><b>0</b><dd>)0 24 Q -(Read \214lenames separated by NUL characters instead of ne)0 36 Q -(wlines.)-.25 E(This is necessary if an)0 48 Q 2.5(yo)-.15 G 2.5(ft)-2.5 -G(he \214lenames being read might contain ne)-2.5 E(wlines.)-.25 E -(<p><dt><b>\255</b><b>A</b><dd>)0 60 Q(\(o mode only\))0 72 Q 0 Cg EP -%%Page: 15 15 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(Append to the speci\214ed archi)0 12 Q -.15(ve) --.25 G(.).15 E(\(Not yet implemented.\))0 24 Q -(<p><dt><b>\255</b><b>a</b><dd>)0 36 Q(\(o and p modes\))0 48 Q -(Reset access times on \214les after the)0 60 Q 2.5(ya)-.15 G(re read.) --2.5 E(<p><dt><b>\255</b><b>B</b><dd>)0 72 Q 0 Cg EP -%%Page: 16 16 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(\(o mode only\))0 12 Q -(Block output to records of 5120 bytes.)0 24 Q -(<p><dt><b>\255</b><b>C</b><i></i><i> size</i><dd>)0 36 Q -(\(o mode only\))0 48 Q(Block output to records of)0 60 Q -(<i></i><i>size</i>)0 72 Q 0 Cg EP -%%Page: 17 17 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(bytes.)0 12 Q(<p><dt><b>\255</b><b>c</b><dd>)0 -24 Q(\(o mode only\))0 36 Q -(Use the old POSIX portable character format.)0 48 Q(Equi)0 60 Q -.25 -(va)-.25 G(lent to).25 E(<b>\255</b><b>-format</b><i></i><i> odc</i>.)0 -72 Q 0 Cg EP -%%Page: 18 18 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<p><dt><b>\255</b><b>d</b><dd>)0 12 Q -(\(i and p modes\))0 24 Q(Create directories as necessary)0 36 Q(.)-.65 -E(<p><dt><b>\255</b><b>E</b><i></i><i> \214le</i><dd>)0 48 Q -(\(i mode only\))0 60 Q(Read list of \214le name patterns from)0 72 Q 0 -Cg EP -%%Page: 19 19 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<i></i><i>\214le</i>)0 12 Q(to list and e)0 24 Q -(xtract.)-.15 E(<p><dt><b>\255</b><b>F</b><i></i><i> \214le</i><dd>)0 36 -Q(Read archi)0 48 Q .3 -.15(ve f)-.25 H(rom or write archi).15 E .3 -.15 -(ve t)-.25 H(o).15 E(<i></i><i>\214le</i>.)0 60 Q -(<p><dt><b>\255</b><b>f</b><i></i><i> pattern</i><dd>)0 72 Q 0 Cg EP -%%Page: 20 20 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(\(i mode only\))0 12 Q -(Ignore \214les that match)0 24 Q(<i></i><i>pattern</i>.)0 36 Q -(<p><dt><b>\255</b><b>-format</b><i></i><i> format</i><dd>)0 48 Q -(\(o mode only\))0 60 Q(Produce the output archi)0 72 Q .3 -.15(ve i) --.25 H 2.5(nt).15 G(he speci\214ed format.)-2.5 E 0 Cg EP -%%Page: 21 21 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(Supported formats include:)0 12 Q(<p>)36 24 Q -(<dl compact>)0 36 Q(<dt><i></i><i>cpio</i><dd>)0 48 Q(Synon)0 60 Q -(ym for)-.15 E(<i></i><i>odc</i>.)0 72 Q 0 Cg EP -%%Page: 22 22 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<dt><i></i><i>ne)0 12 Q(wc</i><dd>)-.25 E -(The SVR4 portable cpio format.)0 24 Q(<dt><i></i><i>odc</i><dd>)0 36 Q -(The old POSIX.1 portable octet-oriented cpio format.)0 48 Q -(<dt><i></i><i>pax</i><dd>)0 60 Q(The POSIX.1 pax format, an e)0 72 Q -(xtension of the ustar format.)-.15 E 0 Cg EP -%%Page: 23 23 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<dt><i></i><i>ustar</i><dd>)0 12 Q -(The POSIX.1 tar format.)0 24 Q(</dl>)0 36 Q(<p>)36 48 Q(The def)0 60 Q -(ault format is)-.1 E(<i></i><i>odc</i>.)0 72 Q 0 Cg EP -%%Page: 24 24 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(See)0 12 Q(<a href="../html5/libarchi)0 24 Q --.15(ve)-.25 G(_formats.html">libarchi).15 E -.15(ve)-.25 G -(_formats\(5\)</a>).15 E(for more complete information about the)0 36 Q -(formats currently supported by the underlying)0 48 Q -(<a href="../html3/libarchi)0 60 Q -.15(ve)-.25 G(.html">libarchi).15 E --.15(ve)-.25 G(\(3\)</a>).15 E(library)0 72 Q(.)-.65 E 0 Cg EP -%%Page: 25 25 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF -(<p><dt><b>\255</b><b>H</b><i></i><i> format</i><dd>)0 12 Q(Synon)0 24 Q -(ym for)-.15 E(<b>\255</b><b>-format</b>.)0 36 Q -(<p><dt><b>\255</b><b>h</b><b> \255</b>,<b>-help</b><dd>)0 48 Q -(Print usage information.)0 60 Q -(<p><dt><b>\255</b><b>I</b><i></i><i> \214le</i><dd>)0 72 Q 0 Cg EP -%%Page: 26 26 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(Read archi)0 12 Q .3 -.15(ve f)-.25 H(rom).15 E -(<i></i><i>\214le</i>.)0 24 Q(<p><dt><b>\255</b><b>i</b><dd>)0 36 Q -(Input mode.)0 48 Q(See abo)0 60 Q .3 -.15(ve f)-.15 H(or description.) -.15 E(<p><dt><b>\255</b><b>-insecure</b><dd>)0 72 Q 0 Cg EP -%%Page: 27 27 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(\(i and p mode only\))0 12 Q -(Disable security checks during e)0 24 Q(xtraction or cop)-.15 E(ying.) --.1 E(This allo)0 36 Q(ws e)-.25 E -(xtraction via symbolic links and path names containing)-.15 E(`..)0 48 -Q(')-.7 E(in the name.)0 60 Q(<p><dt><b>\255</b><b>J</b><dd>)0 72 Q 0 Cg -EP -%%Page: 28 28 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(\(o mode only\))0 12 Q -(Compress the \214le with xz-compatible compression before writing it.)0 -24 Q -(In input mode, this option is ignored; xz compression is recognized)0 -36 Q(automatically on input.)0 48 Q(<p><dt><b>\255</b><b>j</b><dd>)0 60 -Q(Synon)0 72 Q(ym for)-.15 E 0 Cg EP -%%Page: 29 29 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<b>\255</b><b>y</b>.)0 12 Q -(<p><dt><b>\255</b><b>L</b><dd>)0 24 Q(\(o and p modes\))0 36 Q -(All symbolic links will be follo)0 48 Q(wed.)-.25 E(Normally)0 60 Q 2.5 -(,s)-.65 G(ymbolic links are archi)-2.5 E -.15(ve)-.25 G 2.5(da).15 G -(nd copied as symbolic links.)-2.5 E -.4(Wi)0 72 S -(th this option, the tar).4 E(get of the link will be archi)-.18 E -.15 -(ve)-.25 G 2.5(do).15 G 2.5(rc)-2.5 G(opied instead.)-2.5 E 0 Cg EP -%%Page: 30 30 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<p><dt><b>\255</b><b>l</b><dd>)0 12 Q -(\(p mode only\))0 24 Q(Create links from the tar)0 36 Q -(get directory to the original \214les,)-.18 E(instead of cop)0 48 Q -(ying.)-.1 E(<p><dt><b>\255</b><b>lzma</b><dd>)0 60 Q(\(o mode only\))0 -72 Q 0 Cg EP -%%Page: 31 31 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(Compress the \214le with lzma-compatible compre\ -ssion before writing it.)0 12 Q -(In input mode, this option is ignored; lzma compression is recognized)0 -24 Q(automatically on input.)0 36 Q(<p><dt><b>\255</b><b>m</b><dd>)0 48 -Q(\(i and p modes\))0 60 Q -(Set \214le modi\214cation time on created \214les to match)0 72 Q 0 Cg -EP -%%Page: 32 32 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(those in the source.)0 12 Q -(<p><dt><b>\255</b><b>n</b><dd>)0 24 Q(\(i mode, only with)0 36 Q -(<b>\255</b><b>t</b>\))0 48 Q(Display numeric uid and gid.)0 60 Q -(By def)0 72 Q(ault,)-.1 E 0 Cg EP -%%Page: 33 33 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<b>cpio</b>)0 12 Q -(displays the user and group names when the)0 24 Q 2.5(ya)-.15 G(re pro) --2.5 E(vided in the)-.15 E(archi)0 36 Q -.15(ve)-.25 G 2.5(,o).15 G 2.5 -(rl)-2.5 G(ooks up the user and group names in the system)-2.5 E(passw)0 -48 Q(ord database.)-.1 E(<p><dt><b>\255</b><b>no-preserv)0 60 Q(e-o)-.15 -E(wner</b><dd>)-.25 E(\(i mode only\))0 72 Q 0 Cg EP -%%Page: 34 34 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(Do not attempt to restore \214le o)0 12 Q -(wnership.)-.25 E(This is the def)0 24 Q -(ault when run by non-root users.)-.1 E -(<p><dt><b>\255</b><b>O</b><i></i><i> \214le</i><dd>)0 36 Q(Write archi) -0 48 Q .3 -.15(ve t)-.25 H(o).15 E(<i></i><i>\214le</i>.)0 60 Q -(<p><dt><b>\255</b><b>o</b><dd>)0 72 Q 0 Cg EP -%%Page: 35 35 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(Output mode.)0 12 Q(See abo)0 24 Q .3 -.15(ve f) --.15 H(or description.).15 E(<p><dt><b>\255</b><b>p</b><dd>)0 36 Q -.15 -(Pa)0 48 S(ss-through mode.).15 E(See abo)0 60 Q .3 -.15(ve f)-.15 H -(or description.).15 E(<p><dt><b>\255</b><b>preserv)0 72 Q(e-o)-.15 E -(wner</b><dd>)-.25 E 0 Cg EP -%%Page: 36 36 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(\(i mode only\))0 12 Q(Restore \214le o)0 24 Q -(wnership.)-.25 E(This is the def)0 36 Q(ault when run by the root user) --.1 E(.)-.55 E(<p><dt><b>\255</b><b>-quiet</b><dd>)0 48 Q -(Suppress unnecessary messages.)0 60 Q(<p><dt><b>\255</b><b>R </b><b>us\ -er[.blm Pp</b>[.blm Pp:group[.blm Pp<dd>]]])0 72 Q 0 Cg EP -%%Page: 37 37 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(Set the o)0 12 Q -(wner and/or group on \214les in the output.)-.25 E -(If group is speci\214ed with no user)0 24 Q(\(for e)0 36 Q(xample,)-.15 -E(<b>\255</b><b>R</b><i></i><i> :wheel</i>\))0 48 Q -(then the group will be set b)0 60 Q(ut not the user)-.2 E(.)-.55 E -(If the user is speci\214ed with a trailing colon and no group)0 72 Q 0 -Cg EP -%%Page: 38 38 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(\(for e)0 12 Q(xample,)-.15 E -(<b>\255</b><b>R</b><i></i><i> root:</i>\))0 24 Q -(then the group will be set to the user')0 36 Q 2.5(sd)-.55 G(ef)-2.5 E -(ault group.)-.1 E -(If the user is speci\214ed with no trailing colon, then)0 48 Q -(the user will be set b)0 60 Q(ut not the group.)-.2 E(In)0 72 Q 0 Cg EP -%%Page: 39 39 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<b>\255</b><b>i</b>)0 12 Q(and)0 24 Q -(<b>\255</b><b>p</b>)0 36 Q -(modes, this option can only be used by the super)0 48 Q(-user)-.2 E(.) --.55 E(\(F)0 60 Q(or compatibility)-.15 E 2.5(,ap)-.65 G -(eriod can be used in place of the colon.\))-2.5 E -(<p><dt><b>\255</b><b>r</b><dd>)0 72 Q 0 Cg EP -%%Page: 40 40 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(\(All modes.\))0 12 Q(Rename \214les interacti)0 -24 Q -.15(ve)-.25 G(ly).15 E(.)-.65 E -.15(Fo)0 36 S 2.5(re).15 G -(ach \214le, a prompt is written to)-2.5 E(<code></code><code>/de)0 48 Q -(v/tty</code>)-.25 E -(containing the name of the \214le and a line is read from)0 60 Q -(<code></code><code>/de)0 72 Q(v/tty</code>.)-.25 E 0 Cg EP -%%Page: 41 41 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF -(If the line read is blank, the \214le is skipped.)0 12 Q -(If the line contains a single period, the \214le is processed normally) -0 24 Q(.)-.65 E(Otherwise, the line is tak)0 36 Q(en to be the ne)-.1 E -2.5(wn)-.25 G(ame of the \214le.)-2.5 E(<p><dt><b>\255</b><b>t</b><dd>)0 -48 Q(\(i mode only\))0 60 Q(List the contents of the archi)0 72 Q .3 --.15(ve t)-.25 H 2.5(os).15 G(tdout;)-2.5 E 0 Cg EP -%%Page: 42 42 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(do not restore the contents to disk.)0 12 Q -(<p><dt><b>\255</b><b>u</b><dd>)0 24 Q(\(i and p modes\))0 36 Q -(Unconditionally o)0 48 Q -.15(ve)-.15 G(rwrite e).15 E -(xisting \214les.)-.15 E(Ordinarily)0 60 Q 2.5(,a)-.65 G 2.5(no)-2.5 G -(lder \214le will not o)-2.5 E -.15(ve)-.15 G(rwrite a ne).15 E -(wer \214le on disk.)-.25 E(<p><dt><b>\255</b><b>v</b><dd>)0 72 Q 0 Cg -EP -%%Page: 43 43 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF -(Print the name of each \214le to stderr as it is processed.)0 12 Q -.4 -(Wi)0 24 S(th).4 E(<b>\255</b><b>t</b>,)0 36 Q(pro)0 48 Q -(vide a detailed listing of each \214le.)-.15 E(<p><dt><b>\255</b><b>-v) -0 60 Q(ersion</b><dd>)-.15 E(Print the program v)0 72 Q -(ersion information and e)-.15 E(xit.)-.15 E 0 Cg EP -%%Page: 44 44 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<p><dt><b>\255</b><b>y</b><dd>)0 12 Q -(\(o mode only\))0 24 Q(Compress the archi)0 36 Q .3 -.15(ve w)-.25 H -(ith bzip2-compatible compression before writing it.).15 E -(In input mode, this option is ignored;)0 48 Q -(bzip2 compression is recognized automatically on input.)0 60 Q -(<p><dt><b>\255</b><b>Z</b><dd>)0 72 Q 0 Cg EP -%%Page: 45 45 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(\(o mode only\))0 12 Q(Compress the archi)0 24 Q -.3 -.15(ve w)-.25 H -(ith compress-compatible compression before writing it.).15 E -(In input mode, this option is ignored;)0 36 Q -(compression is recognized automatically on input.)0 48 Q -(<p><dt><b>\255</b><b>z</b><dd>)0 60 Q(\(o mode only\))0 72 Q 0 Cg EP -%%Page: 46 46 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(Compress the archi)0 12 Q .3 -.15(ve w)-.25 H -(ith gzip-compatible compression before writing it.).15 E -(In input mode, this option is ignored;)0 24 Q -(gzip compression is recognized automatically on input.)0 36 Q(</dl>)0 -48 Q(<h3 id="ENVIR)36 60 Q(ONMENT">)-.4 E(ENVIR)36 72 Q(ONMENT)-.4 E 0 -Cg EP -%%Page: 47 47 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(</h3>)36 12 Q(The follo)0 24 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 36 Q(<dl compact>)0 48 Q -(<p><dt><code></code><code>LANG</code><dd>)0 60 Q(The locale to use.)0 -72 Q 0 Cg EP -%%Page: 48 48 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(See)0 12 Q(<a href="../html7/en)0 24 Q -(viron.html">en)-.4 E(viron\(7\)</a>)-.4 E(for more information.)0 36 Q -(<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: 49 49 -%%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="EXIT ST)36 48 Q -1.11(AT)-.93 G(US">)1.11 E(EXIT ST)36 60 Q --1.11(AT)-.93 G(US)1.11 E(</h3>)36 72 Q 0 Cg EP -%%Page: 50 50 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<h3 id="EXAMPLES">)36 12 Q(EXAMPLES)36 24 Q -(</h3>)36 36 Q(The)0 48 Q(<b>cpio</b>)0 60 Q -(command is traditionally used to cop)0 72 Q 2.5<798c>-.1 G -(le heirarchies in conjunction)-2.5 E 0 Cg EP -%%Page: 51 51 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(with the)0 12 Q -(<a href="../html1/\214nd.html">\214nd\(1\)</a>)0 24 Q(command.)0 36 Q -(The \214rst e)0 48 Q(xample here simply copies all \214les from)-.15 E -(<code></code><code>src</code>)0 60 Q(to)0 72 Q 0 Cg EP -%%Page: 52 52 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<code></code><code>dest</code>:)0 12 Q(<br>)0 24 -Q( )0 36 Q(<code></code><b>\214nd</b\ -><code></code><code>src</code><code> |</code><b>Fl</b><b> pmud</b><code\ -></code><code> dest</code>)0 48 Q(<br>)0 60 Q(<p>)36 72 Q 0 Cg EP -%%Page: 53 53 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(By carefully selecting options to the)0 12 Q -(<a href="../html1/\214nd.html">\214nd\(1\)</a>)0 24 Q -(command and combining it with other standard utilities,)0 36 Q -(it is possible to e)0 48 Q -.15(xe)-.15 G(rcise v).15 E -(ery \214ne control o)-.15 E -.15(ve)-.15 G 2.5(rw).15 G -(hich \214les are copied.)-2.5 E(This ne)0 60 Q(xt e)-.15 E -(xample copies \214les from)-.15 E(<code></code><code>src</code>)0 72 Q -0 Cg EP -%%Page: 54 54 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(to)0 12 Q(<code></code><code>dest</code>)0 24 Q -(that are more than 2 days old and whose names match a particular patte\ -rn:)0 36 Q(<br>)0 48 Q( )0 60 Q(<cod\ -e></code><b>\214nd</b><code></code><code>src</code><b> \255</b><b>mtime\ -</b><i></i><i> +2</i><i> |</i><b>grep</b><b> foo[bar]</b><b> |</b><b>Fl\ -</b><b> pdmu</b><code></code><code> dest</code>)0 72 Q 0 Cg EP -%%Page: 55 55 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<br>)0 12 Q(<p>)36 24 Q(This e)0 36 Q -(xample copies \214les from)-.15 E(<code></code><code>src</code>)0 48 Q -(to)0 60 Q(<code></code><code>dest</code>)0 72 Q 0 Cg EP -%%Page: 56 56 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF -(that are more than 2 days old and which contain the w)0 12 Q(ord)-.1 E -(foobar`)0 24 Q(`.blm Pp: ')-.74 E(')-.74 E(<br>)0 36 Q -( )0 48 Q(<code></code><b>\214nd</b>\ -<code></code><code>src</code><b> \255</b><b>mtime</b><i></i><i> +2</i><\ -i> |</i><b>xar)0 60 Q(gs</b><b>grep</b><b> -l</b><b> foobar</b><b> |</b\ -><b>Fl</b><b> pdmu</b><code></code><code> dest</code>)-.18 E(<br>)0 72 Q -0 Cg EP -%%Page: 57 57 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(<h3 id="COMP)36 12 Q -1.11(AT)-.92 G(IBILITY">) -1.11 E(COMP)36 24 Q -1.11(AT)-.92 G(IBILITY)1.11 E(</h3>)36 36 Q -(The mode options i, o, and p and the options)0 48 Q -(a, B, c, d, f, l, m, r)0 60 Q 2.5(,t)-.4 G 2.5(,u)-2.5 G 2.5(,a)-2.5 G -(nd v comply with SUSv2.)-2.5 E(<p>)36 72 Q 0 Cg EP -%%Page: 58 58 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(The old POSIX.1 standard speci\214ed that only)0 -12 Q(<b>\255</b><b>i</b>,)0 24 Q(<b>\255</b><b>o</b>,)0 36 Q(and)0 48 Q -(<b>\255</b><b>p</b>)0 60 Q(were interpreted as command-line options.)0 -72 Q 0 Cg EP -%%Page: 59 59 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(Each took a single ar)0 12 Q -(gument of a list of modi\214er)-.18 E(characters.)0 24 Q -.15(Fo)0 36 S -2.5(re).15 G(xample, the standard syntax allo)-2.65 E(ws)-.25 E -(<b>\255</b><b>imu</b>)0 48 Q -.2(bu)0 60 S 2.5(td).2 G(oes not support) --2.5 E(<b>\255</b><b>miu</b>)0 72 Q 0 Cg EP -%%Page: 60 60 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(or)0 12 Q -(<b>\255</b><b>i</b><b> \255</b><b>m</b><b> \255</b><b>u</b>,)0 24 Q -(since)0 36 Q(<i></i><i>m</i>)0 48 Q(and)0 60 Q(<i></i><i>u</i>)0 72 Q 0 -Cg EP -%%Page: 61 61 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(are only modi\214ers to)0 12 Q -(<b>\255</b><b>i</b>,)0 24 Q(the)0 36 Q 2.5(ya)-.15 G -(re not command-line options in their o)-2.5 E(wn right.)-.25 E -(The syntax supported by this implementation is backw)0 48 Q -(ards-compatible)-.1 E(with the standard.)0 60 Q -.15(Fo)0 72 S 2.5(rb) -.15 G(est compatibility)-2.5 E 2.5(,s)-.65 G -(cripts should limit themselv)-2.5 E(es to the)-.15 E 0 Cg EP -%%Page: 62 62 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(standard syntax.)0 12 Q(<h3 id="SEE ALSO">)36 24 -Q(SEE ALSO)36 36 Q(</h3>)36 48 Q -(<a href="../html1/bzip2.html">bzip2\(1\)</a>,)0 60 Q -(<a href="../html1/tar)0 72 Q(.html">tar\(1\)</a>,)-.55 E 0 Cg EP -%%Page: 63 63 -%%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="../html3/libarchi)0 48 Q -.15(ve)-.25 G(.html">libarchi).15 E --.15(ve)-.25 G(\(3\)</a>,).15 E -(<a href="../html5/cpio.html">cpio\(5\)</a>,)0 60 Q -(<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: 64 64 -%%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 cpio command; it appeared)0 -60 Q(in)0 72 Q 0 Cg EP -%%Page: 65 65 -%%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(<p>)36 48 Q -(The cpio, ustar)0 60 Q 2.5(,a)-.4 G -(nd pax interchange \214le formats are de\214ned by)-2.5 E -(IEEE Std 1003.1-2001 \(`)2.5 72 Q(`<font size="-1">POSIX</font>.1')-.74 -E('\))-.74 E 0 Cg EP -%%Page: 66 66 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(for the pax command.)0 12 Q(<h3 id="HIST)36 24 Q -(OR)-.18 E(Y">)-.65 E(HIST)36 36 Q(OR)-.18 E(Y)-.65 E(</h3>)36 48 Q -(The original)0 60 Q(<b>cpio</b>)0 72 Q 0 Cg EP -%%Page: 67 67 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(and)0 12 Q(<b>\214nd</b>)0 24 Q -(utilities were written by Dick Haight)0 36 Q(while w)0 48 Q -(orking in A)-.1 E(T&T')-1.11 E 2.5(sU)-.55 G(nix Support Group.)-2.5 E -(The)0 60 Q 2.5<798c>-.15 G(rst appeared in 1977 in PWB/UNIX 1.0, the) --2.5 E -.74(``)0 72 S(Programmer').74 E 2.5(sW)-.55 G(ork Bench')-3.3 E -(')-.74 E 0 Cg EP -%%Page: 68 68 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(system de)0 12 Q -.15(ve)-.25 G -(loped for use within A).15 E(T&T)-1.11 E(.)-.74 E(The)0 24 Q 2.5(yw) --.15 G(ere \214rst released outside of A)-2.5 E -(T&T as part of System III Unix in 1981.)-1.11 E(As a result,)0 36 Q -(<b>cpio</b>)0 48 Q(actually predates)0 60 Q(<b>tar</b>,)0 72 Q 0 Cg EP -%%Page: 69 69 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF -2.15 -.25(ev e)0 12 T 2.5(nt).25 G(hough it w) --2.5 E(as not well-kno)-.1 E(wn outside of A)-.25 E -(T&T until some time later)-1.11 E(.)-.55 E(<p>)36 24 Q -(This is a complete re-implementation based on the)0 36 Q -(<a href="../html3/libarchi)0 48 Q -.15(ve)-.25 G(.html">libarchi).15 E --.15(ve)-.25 G(\(3\)</a>).15 E(library)0 60 Q(.)-.65 E(<h3 id="B)36 72 Q -(UGS">)-.1 E 0 Cg EP -%%Page: 70 70 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF -.1(BU)36 12 S(GS).1 E(</h3>)36 24 Q -(The cpio archi)0 36 Q .3 -.15(ve f)-.25 H(ormat has se).15 E -.15(ve) --.25 G(ral basic limitations:).15 E -(It does not store user and group names, only numbers.)0 48 Q -(As a result, it cannot be reliably used to transfer)0 60 Q -(\214les between systems with dissimilar user and group numbering.)0 72 -Q 0 Cg EP -%%Page: 71 71 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF -(Older cpio formats limit the user and group numbers to)0 12 Q -(16 or 18 bits, which is insuf)0 24 Q(\214cient for modern systems.)-.25 -E(The cpio archi)0 36 Q .3 -.15(ve f)-.25 H -(ormats cannot support \214les o).15 E -.15(ve)-.15 G 2.5(r4g).15 G(ig) --2.5 E(abytes,)-.05 E -.15(ex)0 48 S(cept for the).15 E -.74(``)0 60 S -(odc').74 E(')-.74 E -.25(va)0 72 S -(riant, which can support \214les up to 8 gig).25 E(abytes.)-.05 E 0 Cg -EP -%%Page: 72 72 -%%BeginPageSetup -BP -%%EndPageSetup -/F0 10/Times-Roman@0 SF(</body>)0 12 Q(</html>)0 24 Q 0 Cg EP -%%Trailer -end -%%EOF +<!-- Creator : groff version 1.19.2 --> +<!-- CreationDate: Sun Mar 14 19:50:40 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">BSDCPIO(1) FreeBSD General Commands Manual +BSDCPIO(1)</p> + +<p style="margin-top: 1em" valign="top"><b>NAME</b></p> + +<p style="margin-left:8%;"><b>cpio</b> — copy files +to and from archives</p> + + +<p style="margin-top: 1em" valign="top"><b>SYNOPSIS</b></p> + +<p style="margin-left:15%;"><b>cpio</b> {<b>−i</b>} +[<i>options</i>] [<i>pattern ...</i>] +[<i>< archive</i>] <b><br> +cpio</b> {<b>−o</b>} [<i>options</i>] <i>< +name-list</i> [<i>> archive</i>] <b><br> +cpio</b> {<b>−p</b>} [<i>options</i>] <i>dest-dir < +name-list</i></p> + + +<p style="margin-top: 1em" valign="top"><b>DESCRIPTION</b></p> + +<p style="margin-left:8%;"><b>cpio</b> copies files between +archives and directories. 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 option +to <b>cpio</b> is a mode indicator from the following +list:</p> + +<p valign="top"><b>−i</b></p> + +<p style="margin-left:20%; margin-top: 1em">Input. Read an +archive from standard input (unless overriden) and extract +the contents to disk or (if the <b>−t</b> option is +specified) list the contents to standard output. If one or +more file patterns are specified, only files matching one of +the patterns will be extracted.</p> + +<p valign="top"><b>−o</b></p> + +<p style="margin-left:20%; margin-top: 1em">Output. Read a +list of filenames from standard input and produce a new +archive on standard output (unless overriden) containing the +specified items.</p> + +<p valign="top"><b>−p</b></p> + +<p style="margin-left:20%; margin-top: 1em">Pass-through. +Read a list of filenames from standard input and copy the +files to the specified directory.</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>−0</b></p> + +<p style="margin-left:20%; margin-top: 1em">Read filenames +separated by NUL characters instead of newlines. This is +necessary if any of the filenames being read might contain +newlines.</p> + + +<p style="margin-top: 1em" valign="top"><b>−A</b></p> + +<p style="margin-left:20%; margin-top: 1em">(o mode only) +Append to the specified archive. (Not yet implemented.)</p> + + +<p style="margin-top: 1em" valign="top"><b>−a</b></p> + +<p style="margin-left:20%; margin-top: 1em">(o and p modes) +Reset access times on files after they are read.</p> + + +<p style="margin-top: 1em" valign="top"><b>−B</b></p> + +<p style="margin-left:20%; margin-top: 1em">(o mode only) +Block output to records of 5120 bytes.</p> + +<p style="margin-top: 1em" valign="top"><b>−C</b> +<i>size</i></p> + +<p style="margin-left:20%;">(o mode only) Block output to +records of <i>size</i> bytes.</p> + + +<p style="margin-top: 1em" valign="top"><b>−c</b></p> + +<p style="margin-left:20%; margin-top: 1em">(o mode only) +Use the old POSIX portable character format. Equivalent to +<b>−-format</b> <i>odc</i>.</p> + + +<p style="margin-top: 1em" valign="top"><b>−d</b></p> + +<p style="margin-left:20%; margin-top: 1em">(i and p modes) +Create directories as necessary.</p> + +<p style="margin-top: 1em" valign="top"><b>−E</b> +<i>file</i></p> + +<p style="margin-left:20%;">(i mode only) Read list of file +name patterns from <i>file</i> to list and extract.</p> + +<p style="margin-top: 1em" valign="top"><b>−F</b> +<i>file</i></p> + +<p style="margin-left:20%;">Read archive from or write +archive to <i>file</i>.</p> + +<p style="margin-top: 1em" valign="top"><b>−f</b> +<i>pattern</i></p> + +<p style="margin-left:20%;">(i mode only) Ignore files that +match <i>pattern</i>.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-format</b> +<i>format</i></p> + +<p style="margin-left:20%;">(o mode only) Produce the +output archive in the specified format. Supported formats +include:</p> + +<p style="margin-top: 1em" valign="top"><i>cpio</i></p> + +<p style="margin-left:34%; margin-top: 1em">Synonym for +<i>odc</i>.</p> + +<p valign="top"><i>newc</i></p> + +<p style="margin-left:34%; margin-top: 1em">The SVR4 +portable cpio format.</p> + +<p valign="top"><i>odc</i></p> + +<p style="margin-left:34%; margin-top: 1em">The old POSIX.1 +portable octet-oriented cpio format.</p> + +<p valign="top"><i>pax</i></p> + +<p style="margin-left:34%; margin-top: 1em">The POSIX.1 pax +format, an extension of the ustar format.</p> + +<p valign="top"><i>ustar</i></p> + +<p style="margin-left:34%; margin-top: 1em">The POSIX.1 tar +format.</p> + +<p style="margin-left:20%; margin-top: 1em">The default +format is <i>odc</i>. See libarchive_formats(5) for more +complete information about the formats currently supported +by the underlying libarchive(3) library.</p> + +<p style="margin-top: 1em" valign="top"><b>−H</b> +<i>format</i></p> + +<p style="margin-left:20%;">Synonym for +<b>−-format</b>.</p> + +<p style="margin-top: 1em" valign="top"><b>−h</b>, +<b>−-help</b></p> + +<p style="margin-left:20%;">Print usage information.</p> + +<p style="margin-top: 1em" valign="top"><b>−I</b> +<i>file</i></p> + +<p style="margin-left:20%;">Read archive from +<i>file</i>.</p> + + +<p style="margin-top: 1em" valign="top"><b>−i</b></p> + +<p style="margin-left:20%; margin-top: 1em">Input mode. See +above for description.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-insecure</b></p> + +<p style="margin-left:20%;">(i and p mode only) Disable +security checks during extraction or copying. This allows +extraction via symbolic links and path names containing +‘..’ in the name.</p> + + +<p style="margin-top: 1em" valign="top"><b>−J</b></p> + +<p style="margin-left:20%; margin-top: 1em">(o mode only) +Compress the file with xz-compatible compression before +writing it. In input mode, this option is ignored; xz +compression is recognized automatically on input.</p> + + +<p style="margin-top: 1em" valign="top"><b>−j</b></p> + +<p style="margin-left:20%; margin-top: 1em">Synonym for +<b>−y</b>.</p> + + +<p style="margin-top: 1em" valign="top"><b>−L</b></p> + +<p style="margin-left:20%; margin-top: 1em">(o and p modes) +All symbolic links will be followed. Normally, symbolic +links are archived and copied as symbolic links. With this +option, the target of the link will be archived or copied +instead.</p> + + +<p style="margin-top: 1em" valign="top"><b>−l</b></p> + +<p style="margin-left:20%; margin-top: 1em">(p mode only) +Create links from the target directory to the original +files, instead of copying.</p> + + +<p style="margin-top: 1em" valign="top"><b>−lzma</b></p> + +<p style="margin-left:20%; margin-top: 1em">(o mode only) +Compress the file with lzma-compatible compression before +writing it. In input mode, this option is ignored; lzma +compression is recognized automatically on input.</p> + + +<p style="margin-top: 1em" valign="top"><b>−m</b></p> + +<p style="margin-left:20%; margin-top: 1em">(i and p modes) +Set file modification time on created files to match those +in the source.</p> + + +<p style="margin-top: 1em" valign="top"><b>−n</b></p> + +<p style="margin-left:20%; margin-top: 1em">(i mode, only +with <b>−t</b>) Display numeric uid and gid. By +default, <b>cpio</b> displays the user and group names when +they are provided in the archive, or looks up the user and +group names in the system password database.</p> + + +<p style="margin-top: 1em" valign="top"><b>−no-preserve-owner</b></p> + +<p style="margin-left:20%;">(i mode only) Do not attempt to +restore file ownership. This is the default when run by +non-root users.</p> + +<p style="margin-top: 1em" valign="top"><b>−O</b> +<i>file</i></p> + +<p style="margin-left:20%;">Write archive to +<i>file</i>.</p> + + +<p style="margin-top: 1em" valign="top"><b>−o</b></p> + +<p style="margin-left:20%; margin-top: 1em">Output mode. +See above for description.</p> + + +<p style="margin-top: 1em" valign="top"><b>−p</b></p> + +<p style="margin-left:20%; margin-top: 1em">Pass-through +mode. See above for description.</p> + + +<p style="margin-top: 1em" valign="top"><b>−preserve-owner</b></p> + +<p style="margin-left:20%;">(i mode only) Restore file +ownership. This is the default when run by the root +user.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-quiet</b></p> + +<p style="margin-left:20%;">Suppress unnecessary +messages.</p> + +<p style="margin-top: 1em" valign="top"><b>−R</b> [ +<br> +user][ <br> +:][ <br> +group]</p> + +<p style="margin-left:20%;">Set the owner and/or group on +files in the output. If group is specified with no user (for +example, <b>−R</b> <i>:wheel</i>) then the group will +be set but not the user. If the user is specified with a +trailing colon and no group (for example, <b>−R</b> +<i>root:</i>) then the group will be set to the user’s +default group. If the user is specified with no trailing +colon, then the user will be set but not the group. In +<b>−i</b> and <b>−p</b> modes, this option can +only be used by the super-user. (For compatibility, a period +can be used in place of the colon.)</p> + + +<p style="margin-top: 1em" valign="top"><b>−r</b></p> + +<p style="margin-left:20%; margin-top: 1em">(All modes.) +Rename files interactively. For each file, a prompt is +written to <i>/dev/tty</i> containing the name of the file +and a line is read from <i>/dev/tty</i>. If the line read is +blank, the file is skipped. If the line contains a single +period, the file is processed normally. Otherwise, the line +is taken to be the new name of the file.</p> + + +<p style="margin-top: 1em" valign="top"><b>−t</b></p> + +<p style="margin-left:20%; margin-top: 1em">(i mode only) +List the contents of the archive to stdout; do not restore +the contents to disk.</p> + + +<p style="margin-top: 1em" valign="top"><b>−u</b></p> + +<p style="margin-left:20%; margin-top: 1em">(i and p modes) +Unconditionally overwrite existing files. Ordinarily, an +older file will not overwrite a newer file on disk.</p> + + +<p style="margin-top: 1em" valign="top"><b>−v</b></p> + +<p style="margin-left:20%; margin-top: 1em">Print the name +of each file to stderr as it is processed. With +<b>−t</b>, provide a detailed listing of each +file.</p> + + +<p style="margin-top: 1em" valign="top"><b>−-version</b></p> + +<p style="margin-left:20%;">Print the program version +information and exit.</p> + + +<p style="margin-top: 1em" valign="top"><b>−y</b></p> + +<p style="margin-left:20%; margin-top: 1em">(o mode only) +Compress the archive with bzip2-compatible compression +before writing it. In input mode, this option is ignored; +bzip2 compression is recognized automatically on input.</p> + + +<p style="margin-top: 1em" valign="top"><b>−Z</b></p> + +<p style="margin-left:20%; margin-top: 1em">(o mode only) +Compress the archive with compress-compatible compression +before writing it. In input mode, this option is ignored; +compression is recognized automatically on input.</p> + + +<p style="margin-top: 1em" valign="top"><b>−z</b></p> + +<p style="margin-left:20%; margin-top: 1em">(o mode only) +Compress the archive with gzip-compatible compression before +writing it. In input mode, this option is ignored; gzip +compression is recognized automatically on input.</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>cpio</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">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>EXIT +STATUS</b></p> + +<p style="margin-left:8%;">The <b>cpio</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 <b>cpio</b> command is +traditionally used to copy file heirarchies in conjunction +with the find(1) command. The first example here simply +copies all files from <i>src</i> to <i>dest</i>:</p> + +<p style="margin-left:17%;"><b>find</b> <i>src</i> | +<b>cpio −pmud</b> <i>dest</i></p> + +<p style="margin-left:8%; margin-top: 1em">By carefully +selecting options to the find(1) command and combining it +with other standard utilities, it is possible to exercise +very fine control over which files are copied. This next +example copies files from <i>src</i> to <i>dest</i> that are +more than 2 days old and whose names match a particular +pattern:</p> + +<p style="margin-left:17%;"><b>find</b> <i>src</i> +<b>−mtime</b> <i>+2</i> | <b>grep foo[bar]</b> | +<b>cpio −pdmu</b> <i>dest</i></p> + +<p style="margin-left:8%; margin-top: 1em">This example +copies files from <i>src</i> to <i>dest</i> that are more +than 2 days old and which contain the word +‘‘</p> + +<p valign="top">foobar ’’:</p> + +<p style="margin-left:17%;"><b>find</b> <i>src</i> +<b>−mtime</b> <i>+2</i> | <b>xargs grep -l foobar</b> +| <b>cpio −pdmu</b> <i>dest</i></p> + + +<p style="margin-top: 1em" valign="top"><b>COMPATIBILITY</b></p> + +<p style="margin-left:8%;">The mode options i, o, and p and +the options a, B, c, d, f, l, m, r, t, u, and v comply with +SUSv2.</p> + +<p style="margin-left:8%; margin-top: 1em">The old POSIX.1 +standard specified that only <b>−i</b>, +<b>−o</b>, and <b>−p</b> were interpreted as +command-line options. Each took a single argument of a list +of modifier characters. For example, the standard syntax +allows <b>−imu</b> but does not support +<b>−miu</b> or <b>−i −m −u</b>, +since <i>m</i> and <i>u</i> are only modifiers to +<b>−i</b>, they are not command-line options in their +own right. The syntax supported by this implementation is +backwards-compatible with the standard. For best +compatibility, scripts should limit themselves to the +standard syntax.</p> + +<p style="margin-top: 1em" valign="top"><b>SEE ALSO</b></p> + +<p style="margin-left:8%;">bzip2(1), tar(1), gzip(1), +mt(1), pax(1), libarchive(3), cpio(5), +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 cpio command; it appeared in ISO/IEC +9945-1:1996 (‘‘POSIX.1’’) but was +dropped from IEEE Std 1003.1-2001 +(‘‘POSIX.1’’).</p> + +<p style="margin-left:8%; margin-top: 1em">The cpio, 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%;">The original <b>cpio</b> and +<b>find</b> utilities were written by Dick Haight while +working in AT&T’s Unix Support Group. They first +appeared in 1977 in PWB/UNIX 1.0, the +‘‘Programmer’s Work Bench’’ +system developed for use within AT&T. They were first +released outside of AT&T as part of System III Unix in +1981. As a result, <b>cpio</b> actually predates <b>tar</b>, +even though it was not well-known outside of AT&T until +some time later.</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%;">The cpio archive format has +several basic limitations: It does not store user and group +names, only numbers. As a result, it cannot be reliably used +to transfer files between systems with dissimilar user and +group numbering. Older cpio formats limit the user and group +numbers to 16 or 18 bits, which is insufficient for modern +systems. The cpio archive formats cannot support files over +4 gigabytes, except for the ‘‘odc’’ +variant, which can support files up to 8 gigabytes.</p> + + +<p style="margin-left:8%; margin-top: 1em">FreeBSD 9.0 +December 21, 2007 FreeBSD 9.0</p> +<hr> +</body> +</html> |