cpio: Copy-in mode
3.2 Copy-in mode
================
In copy-in mode, cpio copies files from an archive into the filesystem
or lists the archive contents. It reads the archive from the standard
input. Any non-option command line arguments are shell globbing
patterns; only files in the archive whose names match one or more of
those patterns are copied from the archive. Unlike in the shell, an
initial '.' in a filename does match a wildcard at the start of a
pattern, and a '/' in a filename can match wildcards. If no patterns
are given, all files are extracted.
The copy-in mode is requested by the '-i' ('--extract') command line
option.
The following options can be used in copy-in mode:
'--absolute-filenames'
Do not strip file system prefix components from the file names.
'--no-absolute-filenames'
Create all files relative to the current directory.
'--block-size=BLOCK-SIZE'
Sets the I/O block size to BLOCK-SIZE * 512 bytes.
'-b'
'--swap'
Swap both halfwords of words and bytes of halfwords in the data.
Equivalent to '-sS'.
'-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 NUMBER'
'--io-size=NUMBER'
Set the I/O block size to the given NUMBER of bytes.
'-D DIR'
'--directory=DIR'
Change to directory DIR
'-d'
'--make-directories'
Create leading directories where needed.
'-E FILE'
'--pattern-file=FILE'
Read additional patterns specifying filenames to extract or list
from FILE.
'-f'
'--nonmatching'
Only copy files that do not match any of the given patterns.
'--force-local'
Treat the archive file as local, even if its name contains colons.
'-F [[USER@]HOST:]ARCHIVE-FILE'
'-I [[USER@]HOST:]ARCHIVE-FILE'
'--file=[[USER@]HOST:]ARCHIVE-FILE'
Use the supplied ARCHIVE-FILE instead of standard input. Optional
USER and HOST specify the user and host names in case of a remote
archive.
'-H FORMAT'
'--format=FORMAT'
Use given archive format. format, for a list of available
formats.
'-m'
'--preserve-modification-time'
Retain previous file modification times when creating files.
'-M STRING'
'--message=STRING'
Print STRING when the end of a volume of the backup media is
reached.
'--no-preserve-owner'
Do not change the ownership of the files.
'-n'
'--numeric-uid-gid'
In the verbose table of contents listing, show numeric UID and GID
values.
'--only-verify-crc'
When reading a CRC format archive, only verify the CRC's of each
file in the archive, don't actually extract the files
'--quiet'
Do not print the number of blocks copied.
'--rsh-command=COMMAND'
Use COMMAND instead of 'rsh' to access remote archives.
'-r'
'--rename'
Interactively rename files
'--sparse'
Write files with large blocks of zeros as sparse 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.
'-u'
'--unconditional'
Replace all files unconditionally.
'-v'
'--verbose'
Verbosely list the files processed.
'-V'
'--dot'
Print a '.' for each file processed.
'-W'
'--warning=FLAG'
Control warning display. Argument is one of 'none', 'truncate',
'no-truncate' or 'all'. warning, for a detailed discussion
of these.