CoPy In Out
Usage: cpio [OPTION…] [destination-directory]
GNU `cpio’ copies files to and from archives
Examples:
# Copy files named in name-list to the archive
cpio -o < name-list [> archive]
# Extract files from the archive
cpio -i [< archive]
# Copy files named in name-list to destination-directory
cpio -p destination-directory < name-list
Main operation mode:
-i, –extract
Extract files from an archive (run in copy-in
mode) -o, –create Create the archive (run in copy-out mode) -p, –pass-through Run in copy-pass mode
-t, –list Print a table of contents of the input
Operation modifiers valid in any mode:
–block-size=BLOCK-SIZE Set the I/O block size to BLOCK-SIZE * 512
bytes
-B Set the I/O block size to 5120 bytes
-c Identical to “-H newc”, use the new (SVR4)
portable format.If you wish the old portable
(ASCII) archive format, use “-H odc” instead.
-C, –io-size=NUMBER Set the I/O block size to the given NUMBER of
bytes
–force-local Archive file is local, even if its name contains
colons
-f, –nonmatching Only copy files that do not match any of the given patterns
-F, –file=[[USER@]HOST:]FILE-NAME
Use this FILE-NAME instead of standard input or output. Optional USER and HOST specify the user and host names in case of a remote archive
-H, –format=FORMAT Use given archive FORMAT
-M, –message=STRING Print STRING when the end of a volume of the
backup media is reached
-n, –numeric-uid-gid In the verbose table of contents listing, show
numeric UID and GID
–quiet Do not print the number of blocks copied
–rsh-command=COMMAND Use remote COMMAND instead of rsh
-v, –verbose Verbosely list the files processed
-V, –dot Print a “.” for each file processed
-W, –warning=FLAG Control warning display. Currently FLAG is one of
‘none’, ‘truncate’, ‘all’. Multiple options
accumulate.
Operation modifiers valid only in copy-in mode:
-b, –swap Swap both halfwords of words and bytes of
halfwords in the data. Equivalent to -sS
-r, –rename Interactively rename files
-s, –swap–bytes Swap the bytes of each halfword in the files
-S, –swap-halfwords Swap the halfwords of each word (4 bytes) in the
files
–to-stdout Extract files to standard output
-E, –pattern-file=FILE Read additional patterns specifying filenames to
extract or list from FILE
–only-verify-crc When reading a CRC format archive, only verify the
checksum of each file in the archive, don’t
actually extract the files
Operation modifiers valid only in copy-out mode:
-A, –append Append to an existing archive.
-O [[USER@]HOST:]FILE-NAME Archive filename to use instead of standard output. Optional USER and HOST specify the user and host names in case of a remote archive
Operation modifiers valid only in copy-pass mode:
-l, –link Link files instead of copying them, when
possible
Operation modifiers valid in copy-in and copy-out modes:
–absolute-filenames Do not strip file system prefix components from
the file names
–no-absolute-filenames Create all files relative to the current
directory
Operation modifiers valid in copy-out and copy-pass modes:
-0, –null A list of filenames is terminated by a null
character instead of a newline
-a, –reset-access-time Reset the access times of files after reading
them
-I [[USER@]HOST:]FILE-NAME Archive filename to use instead of standard input. Optional USER and HOST specify the user and host
names in case of a remote archive
-L, –dereference Dereference symbolic links (copy the files
that they point to instead of copying the links).
-R, –owner=[USER][:.][GROUP] Set the ownership of all files created to the specified USER and/or GROUP
Operation modifiers valid in copy-in and copy-pass modes:
-d, –make-directories Create leading directories where needed
-m, –preserve-modification-time
Retain previous file modification times when creating files
–no-preserve-owner Do not change the ownership of the files
–sparse Write files with large blocks of zeros as sparse
files
-u, –unconditional Replace all files unconditionally
-?, –help give this help list
–usage give a short usage message
–version print program version
Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.
Report bugs to <bug-cpio@gnu.org>.