c

cpio(1)

cpio(1)

warn.

fCopy in all ®les except those selected by pattern....

hFollow symbolic links as though they were normal ®les or directories. Normally, cpio archives the link.

lWhenever possible, link ®les rather than copying them. This option does not destroy existing ®les. Use only with -p.

mRetain previous ®le modi®cation time. This option does not affect directories that are being copied.

rRename ®les interactively. If the user types a null line, the ®le is skipped.

sSwap all bytes of the ®le. Use only with -i. See the P option for details; see also the s and S options.

tPrint only a table of contents of the input. No ®les are created, read, or copied.

uCopy unconditionally (normally, an older ®le does not replace a newer ®le with the same name).

vPrint a list of ®le names as they are processed. When used with the t option, the table of contents has the format:

numeric-mode owner-name blocks date-time ®lename

where numeric-modeis the ®le privileges in numeric format, owner-nameis the name of the ®le owner, blocks is the size of the ®le in 512-byte blocks, date-timeis the date and time the ®le was last modi®ed, and ®lename is the path name of the ®le as recorded in the archive.

xSave or restore device special ®les. Since mknod() is used to recreate these ®les on a restore, -ixand -pxcan be used only by users with appropriate privileges (see mknod(2)). This option is intended for intrasystem (backup) use only. Restoring device ®les from previ- ous versions of the OS, or from different systems can be very dangerous. cpio may prevent the restoration of certain device ®les from the archive.

ASuppress warning messages regarding optional access control list entries. cpio does not back up optional access control list entries in a ®le's access control list (see acl(5)). Normally, a warning message is printed for each ®le that has optional access control list entries.

B

Block input/output at 5120 bytes to the record (does not apply to cpio -p). This option is

 

meaningful only with data directed to or from devices that support variable-length records

 

such as magnetic tape.

CHave cpio checkpoint itself at the start of each volume. If cpio is writing to a streaming tape drive with immediate-report mode enabled and a write error occurs, it normally aborts and exits with return code 2. With this option speci®ed, cpio instead automatically restarts itself from the checkpoint and rewrites the current volume. Alternatively, if cpio is not writing to such a device and a write error occurs, cpio normally continues with the next volume. With this option speci®ed, however, the user can choose to either ignore the error or rewrite the current volume.

PRead a ®le written on a PDP-11or VAX system (with byte-swapping) that did not use the c option. Use only with -i. Files copied in this mode are not changed. Non-ASCII®les are likely to need further processing to be readable. This processing often requires knowledge of ®le contents, and thus cannot always be done by this program. The b, s, and S options can be used when swapping all the bytes on the tape (rather than just in the headers) is appropri- ate. In general, text is best processed with P and binary data with one of the other options.

(PDP-11and VAX are registered trademarks of Digital Equipment Corporation.)

RResynchronize automatically when cpio goes "out of phase", (see DIAGNOSTICS).

SSwap all half-words in the ®le. Use only with -i. See the P option for details; see also the b and s options.

UUse the process's ®le-mode creation mask (see umask(2)) to modify the mode of ®les created, in the same manner as creat(2).

6Process a UNIX Sixth-Edition-format ®le. Use only with -i.

Section 1118

− 2 −

HP-UX Release 11i: December 2000