1 '\" te
2 .\" Copyright 1989 AT&T
3 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
4 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
5 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at http://www.opengroup.org/bookstore/.
6 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text
7 .\" are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical
8 .\" and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
9 .\" This notice shall appear on any product containing this material.
10 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
11 .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
12 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
13 .TH CPIO 1 "Aug 3, 2009"
14 .SH NAME
15 cpio \- copy file archives in and out
16 .SH SYNOPSIS
17 .LP
18 .nf
19 \fBcpio\fR \fB-i\fR [\fB-bBcdfkmPrsStuvV6@/\fR] [\fB-C\fR \fIbufsize\fR] [\fB-E\fR \fIfile\fR]
20 [\fB-H\fR \fIheader\fR] [\fB-I\fR \fI\fR [\fB-M\fR \fImessage\fR]] [\fB-R\fR \fIid\fR] [\fIpattern\fR]...
21 .fi
22
23 .LP
24 .nf
25 \fBcpio\fR \fB-o\fR [\fB-aABcLPvV@/\fR] [\fB-C\fR \fIbufsize\fR] [\fB-H\fR \fIheader\fR]
26 [\fB-O\fR \fIfile\fR [\fB-M\fR \fImessage\fR]]
27 .fi
28
29 .LP
30 .nf
31 \fBcpio\fR \fB-p\fR [\fB-adlLmPuvV@/\fR] [\fB-R\fR \fIid\fR] \fIdirectory\fR
32 .fi
33
34 .SH DESCRIPTION
35 .sp
36 .LP
37 The \fBcpio\fR command copies files into and out of a \fBcpio\fR archive. The
38 \fBcpio\fR archive can span multiple volumes. The \fB-i\fR, \fB-o\fR, and
39 \fB-p\fR options select the action to be performed. The following list
40 describes each of the actions. These actions are mutually exclusive.
41 .SS "Copy In Mode"
42 .sp
43 .LP
44 \fBcpio\fR \fB-i\fR (copy in) extracts files from the standard input, which is
45 assumed to be the product of a previous \fBcpio\fR \fB-o\fR command. Only files
46 with names that match one of the \fIpattern\fRs are selected. See \fBsh\fR(1)
47 and OPERANDS for more information about \fIpattern\fR. Extracted files are
48 conditionally copied into the current directory tree, based on the options
49 described below. The permissions of the files are those of the previous \fBcpio
50 -o\fR command. The owner and group are the same as the current user, unless the
51 current user has the \fB{PRIV_FILE_CHOWN_SELF}\fR privilege. See
405 Use only with the \fB-o\fR option.
406 .RE
407
408 .sp
409 .ne 2
410 .na
411 \fB\fB-P\fR\fR
412 .ad
413 .RS 14n
414 Preserves \fBACL\fRs. If the option is used for output, existing \fBACL\fRs are
415 written along with other attributes, except for extended attributes, to the
416 standard output. \fBACL\fRs are created as special files with a special file
417 type. If the option is used for input, existing \fBACL\fRs are extracted along
418 with other attributes from standard input. The option recognizes the special
419 file type. Notice that errors occurs if a \fBcpio\fR archive with \fBACL\fRs is
420 extracted by previous versions of \fBcpio\fR. This option should not be used
421 with the \fB-c\fR option, as \fBACL\fR support might not be present on all
422 systems, and hence is not portable. Use \fBASCII\fR headers for portability.
423 .RE
424
425 .sp
426 .ne 2
427 .na
428 \fB\fB-r\fR\fR
429 .ad
430 .RS 14n
431 Interactively renames files. If the user types a carriage return alone, the
432 file is skipped. If the user types a ``.'', the original pathname is retained.
433 Not available with \fBcpio\fR \fB-p\fR.
434 .RE
435
436 .sp
437 .ne 2
438 .na
439 \fB\fB-R\fR \fIid\fR\fR
440 .ad
441 .RS 14n
442 Reassigns ownership and group information for each file to user ID. (ID must be
443 a valid login ID from the \fBpasswd\fR database.) This option is valid only
444 when id is the invoking user or the super-user. See \fBNOTES\fR.
|
1 '\" te
2 .\" Copyright 1989 AT&T
3 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
4 .\" Copyright (c) 2012 Gary Mills
5 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
6 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at http://www.opengroup.org/bookstore/.
7 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text
8 .\" are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical
9 .\" and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
10 .\" This notice shall appear on any product containing this material.
11 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
12 .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
13 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
14 .TH CPIO 1 "Aug 3, 2009"
15 .SH NAME
16 cpio \- copy file archives in and out
17 .SH SYNOPSIS
18 .LP
19 .nf
20 \fBcpio\fR \fB-i\fR [\fB-bBcdfkmPqrsStuvV6@/\fR] [\fB-C\fR \fIbufsize\fR] [\fB-E\fR \fIfile\fR]
21 [\fB-H\fR \fIheader\fR] [\fB-I\fR \fI\fR [\fB-M\fR \fImessage\fR]] [\fB-R\fR \fIid\fR] [\fIpattern\fR]...
22 .fi
23
24 .LP
25 .nf
26 \fBcpio\fR \fB-o\fR [\fB-aABcLPqvV@/\fR] [\fB-C\fR \fIbufsize\fR] [\fB-H\fR \fIheader\fR]
27 [\fB-O\fR \fIfile\fR [\fB-M\fR \fImessage\fR]]
28 .fi
29
30 .LP
31 .nf
32 \fBcpio\fR \fB-p\fR [\fB-adlLmPquvV@/\fR] [\fB-R\fR \fIid\fR] \fIdirectory\fR
33 .fi
34
35 .SH DESCRIPTION
36 .sp
37 .LP
38 The \fBcpio\fR command copies files into and out of a \fBcpio\fR archive. The
39 \fBcpio\fR archive can span multiple volumes. The \fB-i\fR, \fB-o\fR, and
40 \fB-p\fR options select the action to be performed. The following list
41 describes each of the actions. These actions are mutually exclusive.
42 .SS "Copy In Mode"
43 .sp
44 .LP
45 \fBcpio\fR \fB-i\fR (copy in) extracts files from the standard input, which is
46 assumed to be the product of a previous \fBcpio\fR \fB-o\fR command. Only files
47 with names that match one of the \fIpattern\fRs are selected. See \fBsh\fR(1)
48 and OPERANDS for more information about \fIpattern\fR. Extracted files are
49 conditionally copied into the current directory tree, based on the options
50 described below. The permissions of the files are those of the previous \fBcpio
51 -o\fR command. The owner and group are the same as the current user, unless the
52 current user has the \fB{PRIV_FILE_CHOWN_SELF}\fR privilege. See
406 Use only with the \fB-o\fR option.
407 .RE
408
409 .sp
410 .ne 2
411 .na
412 \fB\fB-P\fR\fR
413 .ad
414 .RS 14n
415 Preserves \fBACL\fRs. If the option is used for output, existing \fBACL\fRs are
416 written along with other attributes, except for extended attributes, to the
417 standard output. \fBACL\fRs are created as special files with a special file
418 type. If the option is used for input, existing \fBACL\fRs are extracted along
419 with other attributes from standard input. The option recognizes the special
420 file type. Notice that errors occurs if a \fBcpio\fR archive with \fBACL\fRs is
421 extracted by previous versions of \fBcpio\fR. This option should not be used
422 with the \fB-c\fR option, as \fBACL\fR support might not be present on all
423 systems, and hence is not portable. Use \fBASCII\fR headers for portability.
424 .RE
425
426 .sp
427 .ne 2
428 .na
429 \fB\fB-q\fR\fR
430 .ad
431 .RS 14n
432 Quiet. Suppresses the number of blocks message that normally is printed
433 after the copy is completed.
434 .RE
435
436 .sp
437 .ne 2
438 .na
439 \fB\fB-r\fR\fR
440 .ad
441 .RS 14n
442 Interactively renames files. If the user types a carriage return alone, the
443 file is skipped. If the user types a ``.'', the original pathname is retained.
444 Not available with \fBcpio\fR \fB-p\fR.
445 .RE
446
447 .sp
448 .ne 2
449 .na
450 \fB\fB-R\fR \fIid\fR\fR
451 .ad
452 .RS 14n
453 Reassigns ownership and group information for each file to user ID. (ID must be
454 a valid login ID from the \fBpasswd\fR database.) This option is valid only
455 when id is the invoking user or the super-user. See \fBNOTES\fR.
|