![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to hulp CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [MW Coherent from dump] / coherent / g / usr / bin / pax / doc|
Return to hulp CVS log | Up to [MW Coherent from dump] / coherent / g / usr / bin / pax / doc |
1.1 root 1:
2:
3:
4: CPIO(1) UNIX Programmer's Manual CPIO(1)
5:
6:
7:
8: NAME
9: cpio - copy file archives in and out
10:
11: SYNOPSIS
12: cpio -o[Bacv]
13: cpio -i[Bcdfmrtuv] [pattern...]
14: cpio -p[adlmruv] directory
15:
16: DESCRIPTION
17: The cpio utility produces and reads files in the format
18: specified by the cpio Archive/Interchange File Format speci-
19: fied in IEEE Std. 1003.1-1988.
20:
21: The cpio -i (copy in) utility extracts files from the stan-
22: dard input, which is assumed to be the product of a previous
23: cpio -o . Only files with names that match patterns are
24: selected. Multiple patterns may be specified and if no pat-
25: terns are specified, the default for patterns is selecting
26: all files. The extracted files are conditionally created
27: and copied into the current directory, and possibly any lev-
28: els below, based upon the options described below and the
29: permissions of the files will be those of the previous cpio
30: -o . The owner and group of the files will be that of the
31: current user unless the user has appropriate privileges,
32: which causes cpio to retains the owner and group of the
33: files of the previous cpio -o .
34:
35: The cpio -p (pass) utility reads the standard input to
36: obtain a list of path names of files that are conditionally
37: created and copied into the destination directory based upon
38: the options described below.
39:
40: If an error is detected, the cause is reported and the cpio
41: utility will continue to copy other files. cpio will skip
42: over any unrecognized files which it encounters in the
43: archive.
44:
45: The following restrictions apply to the cpio utility:
46:
47: 1 Pathnames are restricted to 256 characters.
48:
49: 2 Appropriate privileges are required to copy special
50: files.
51:
52: 3 Blocks are reported in 512-byte quantities.
53:
54: Options
55: The following options are available:
56:
57: -B Input/output is to be blocked 5120 bytes to the record.
58: Can only be used with cpio -o or cpio -i for data that
59: is directed to or from character special files.
60:
61:
62:
63: Printed 8/28/89 USENIX Association 1
64:
65:
66:
67:
68:
69:
70: CPIO(1) UNIX Programmer's Manual CPIO(1)
71:
72:
73:
74: -a Reset access times of input files after they have been
75: copied. When the -l option is also specified, the
76: linked files do not have their access times reset. Can
77: only be used with cpio -o or cpio -i .
78:
79: -c Write header information in ASCII character for for
80: portability. Can only be used with cpio -i or cpio -o
81: . Note that this option should always be used to write
82: portable files.
83:
84: -d Creates directories as needed. Can only be used with
85: cpio -i or cpio -p .
86:
87: -f Copy in all files except those in patterns . Can only
88: be used with cpio -i .
89:
90: -l Whenever possible, link files rather than copying them.
91: Can only be used with cpio -p .
92:
93: -m Retain previous modification times. This option is
94: ineffective on directories that are being copied. Can
95: only be used with cpio -i or cpio -p .
96:
97: -r Interactively rename files. The user is asked whether
98: to rename pattern each invocation. Read and write per-
99: missions for /dev/tty are required for this option. If
100: the user types a null line, the file is skipped.
101: Should only be used with cpio -i or cpio -o .
102:
103: -t Print a table of contents of the input. No files are
104: created. Can only be used with cpio -i .
105:
106: -u Copy files unconditionally; usually an older file will
107: not replace a new file with the same name. Can only be
108: used with cpio -i or cpio -p .
109:
110: -v Verbose: cause the names of the affected files to be
111: printed. Can only be used with cpio -i . Provides a
112: detailed listing when used with the -t option.
113:
114: Operands
115: The following operands are available:
116:
117: patterns Simple regular expressions given in the name-
118: generating notation of the shell.
119:
120: directory The destination directory.
121:
122: Exit Status
123: The cpio utility exits with one of the following values:
124:
125: 0 All input files were copied.
126:
127:
128:
129: Printed 8/28/89 USENIX Association 2
130:
131:
132:
133:
134:
135:
136: CPIO(1) UNIX Programmer's Manual CPIO(1)
137:
138:
139:
140: 2 The utility encountered errors in copying or accessing
141: files or directories. An error will be reported for
142: nonexistent files or directories, or permissions that
143: do not allow the user to access the source or target
144: files.
145:
146:
147: It is important to use the -depth option of the find utility
148: to generate pathnames for cpio . This eliminates problems
149: cpio could have trying to create files under read-only
150: directories.
151:
152: The following command:
153: ls | cpio -o > ../newfile
154: copies out the files listed by the ls utility and redirects
155: them to the file newfile .
156:
157: The following command:
158: cat newfile | cpio -id "memo/al" "memo/b*"
159: uses the output file newfile from the cpio -o utility, takes
160: those files that match the patterns memo/al and memo/b* ,
161: creates the directories below the current directory, and
162: places the files in the appropriate directories.
163:
164: The command
165: find . -depth -print | cpio -pdlmv newdir
166: takes the file names piped to it from the find utility and
167: copies or links those files to another directory named
168: newdir , while retaining the modification time.
169:
170: FILES
171: /dev/tty used to prompt the user for information when the
172: -i or -r options are specified.
173:
174: SEE ALSO
175: find(1), pax(1), tar(1), cpio(5), tar(5)
176:
177: COPYRIGHT
178: Copyright (c) 1989 Mark H. Colburn.
179: All rights reserved.
180:
181: Redistribution and use in source and binary forms are per-
182: mitted provided that the above copyright notice is dupli-
183: cated in all such forms and that any documentation,
184: advertising materials, and other materials related to such
185: distribution and use acknowledge that the software was
186: developed by Mark H. Colburn and sponsored by The USENIX
187: Association.
188:
189: THE SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS
190: OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE
191: IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
192:
193:
194:
195: Printed 8/28/89 USENIX Association 3
196:
197:
198:
199:
200:
201:
202: CPIO(1) UNIX Programmer's Manual CPIO(1)
203:
204:
205:
206: PARTICULAR PURPOSE.
207:
208: AUTHOR
209: Mark H. Colburn
210: NAPS International
211: 117 Mackubin Street, Suite 1
212: St. Paul, MN 55102
213: [email protected]
214:
215:
216: Sponsored by The USENIX Association for public distribution.
217:
218:
219:
220:
221:
222:
223:
224:
225:
226:
227:
228:
229:
230:
231:
232:
233:
234:
235:
236:
237:
238:
239:
240:
241:
242:
243:
244:
245:
246:
247:
248:
249:
250:
251:
252:
253:
254:
255:
256:
257:
258:
259:
260:
261: Printed 8/28/89 USENIX Association 4
262:
263:
264:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.