cpio: Copy-out mode
3.1 Copy-out mode
=================
In copy-out mode, cpio copies files into an archive. It reads a list of
filenames, one per line, on the standard input, and writes the archive
onto the standard output. A typical way to generate the list of
filenames is with the find command; you should give 'find' the '-depth'
option to minimize problems with permissions on directories that are
unreadable.
Copy-out mode is requested by the '-o' ('--create') command line
option, e.g.:
% find | cpio -o > directory.cpio
The following options can be used in copy-out mode:
'-0'
'--null'
Filenames in the list are delimited by ASCII null characters
instead of newlines.
'-A'
'--append'
Append to an existing archive.
'-a'
'--reset-access-time'
Reset the access times of files after reading them.
'--absolute-filenames'
Do not strip file system prefix components from the file names.
'--no-absolute-filenames'
Strip file system prefix components from the file names before
storing them to the archive.
'--block-size=BLOCK-SIZE'
Sets 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 NUMBER'
'--io-size=NUMBER'
Set the I/O block size to the given NUMBER of bytes.
'-D DIR'
'--directory=DIR'
Change to directory DIR
'--force-local'
Treat the archive file as local, even if its name contains colons.
'-F [[USER@]HOST:]ARCHIVE-FILE'
'-O [[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.
'-L'
'--dereference'
Dereference symbolic links (copy the files that they point to
instead of copying the links).
'-M STRING'
'--message=STRING'
Print STRING when the end of a volume of the backup media is
reached.
'--quiet'
Do not print the number of blocks copied.
'--rsh-command=COMMAND'
Use COMMAND instead of 'rsh' to access remote archives.
'-R'
'--owner=[USER][:.][GROUP]'
Set the ownership of all files created to the specified USER and/or
GROUP. owner.
'-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.