z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

Usage notes
–q Assumes all created files are text. This means that any \r (carriage return)
characters are stripped, and only the \n (newlines) are retained.
Do not use the –q option for converting text to a system-independent
format, because that would require all files to be read twice.
–r Lets you rename files as cpio works. When extracting, cpio displays the
name of the component it is about to extract and gives you the chance to
specify a name for the extracted file. If you enter . as the name, cpio
processes the file or directory with no modification to the name. If you just
press Enter, cpio skips the file.
–S For portability reasons, swaps pairs of 16-bit words within longwords (a
32-bit or 64-bit word) only when extracting files. This option does not affect
the headers.
–s For portability reasons, swaps pairs of bytes within each 16-bit word only
when extracting files. –s does not affect the headers.
–t Prevents files extraction, producing instead a table of filenames contained
in the archive. See the description of the –v option.
–u Copies an archive file to a target file even if the target is newer than the
archive. Normally, cpio does not copy the file.
–V volpat
Provides automatic multivolume support. cpio writes output to files, the
names of which are formatted using volpat. The current volume number
replaces any occurrence of # in volpat. When you invoke cpio with this
option, it asks for the first number in the archive set, and waits for you to
type the number and a carriage return before its precedes with the
operation. cpio issues the same sort of message when a write error or read
error occurs on the archive; the reasoning is that this kind of error means
that cpio has reached the end of the volume and should go on to a new
one.
–v Provides more verbose information than usual. cpio prints the names of
files as it extracts them from or adds them to archives. When you specify
both –v and –t, cpio prints a table of files in a format similar to that
produced by the ls –l command.
–y When used with –V, does not ask for a volume number to begin with, but
does ask if it gets a read or write error.
–z Performs Lempel-Ziv compression. Output is always a 16-bit compression.
On input, any compression up to 16-bit is acceptable.
1. Use the pax command if you need to use multibyte patterns when searching for
filenames.
2. The POSIX 1003.1 standard defines formats for cpio archives that limit the
UIDs and GIDs that can be stored to the maximum value of 262143. Values
larger than this will not be properly restored.
cpio
3. The byte and word swapping done by the –b, –S, and –s options is effective
only for the file data written. With or without the –c option, header information is
always written in a machine-invariant format.
Chapter 2. Shell command descriptions 167