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

%!PS-Adobe-3.0
%%Creator: groff version 1.19.2
%%CreationDate: Sun Mar 14 02:49:18 2010
%%DocumentNeededResources: font Times-Roman
%%DocumentSuppliedResources: procset grops 1.19 2
%%Pages: 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(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)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(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)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
(&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;)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