Print this page
1154 cpio needs a quiet option
   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.