cpio: Copy-out mode
1
1 3.1 Copy-out mode
1 =================
1
1 In copy-out mode, cpio copies files into an archive. It reads a list of
1 filenames, one per line, on the standard input, and writes the archive
1 onto the standard output. A typical way to generate the list of
1 filenames is with the find command; you should give 'find' the '-depth'
1 option to minimize problems with permissions on directories that are
1 unreadable.
1
1 Copy-out mode is requested by the '-o' ('--create') command line
1 option, e.g.:
1
1 % find | cpio -o > directory.cpio
1
1 The following options can be used in copy-out mode:
1
1 '-0'
1 '--null'
1 Filenames in the list are delimited by ASCII null characters
1 instead of newlines.
1 '-A'
1 '--append'
1 Append to an existing archive.
1 '-a'
1 '--reset-access-time'
1 Reset the access times of files after reading them.
1 '--absolute-filenames'
1 Do not strip file system prefix components from the file names.
1 '--no-absolute-filenames'
1 Strip file system prefix components from the file names before
1 storing them to the archive.
1 '--block-size=BLOCK-SIZE'
1 Sets the I/O block size to BLOCK-SIZE * 512 bytes.
1 '-B'
1 Set the I/O block size to 5120 bytes.
1 '-c'
1 Identical to "-H newc", use the new (SVR4) portable format. If you
1 wish the old portable (ASCII) archive format, use "-H odc" instead.
1 '-C NUMBER'
1 '--io-size=NUMBER'
1 Set the I/O block size to the given NUMBER of bytes.
1 '-D DIR'
1 '--directory=DIR'
1 Change to directory DIR
1 '--force-local'
1 Treat the archive file as local, even if its name contains colons.
1 '-F [[USER@]HOST:]ARCHIVE-FILE'
1 '-O [[USER@]HOST:]ARCHIVE-FILE'
1 '--file=[[USER@]HOST:]ARCHIVE-FILE'
1 Use the supplied ARCHIVE-FILE instead of standard input. Optional
1 USER and HOST specify the user and host names in case of a remote
1 archive.
1 '-H FORMAT'
1 '--format=FORMAT'
1 Use given archive format. ⇒format, for a list of available
1 formats.
1 '-L'
1 '--dereference'
1 Dereference symbolic links (copy the files that they point to
1 instead of copying the links).
1 '-M STRING'
1 '--message=STRING'
1 Print STRING when the end of a volume of the backup media is
1 reached.
1 '--quiet'
1 Do not print the number of blocks copied.
1 '--rsh-command=COMMAND'
1 Use COMMAND instead of 'rsh' to access remote archives.
1 '-R'
1 '--owner=[USER][:.][GROUP]'
1 Set the ownership of all files created to the specified USER and/or
1 GROUP. ⇒owner.
1 '-v'
1 '--verbose'
1 Verbosely list the files processed.
1 '-V'
1 '--dot'
1 Print a '.' for each file processed.
1 '-W'
1 '--warning=FLAG'
1 Control warning display. Argument is one of 'none', 'truncate',
1 'no-truncate' or 'all'. ⇒warning, for a detailed discussion
1 of these.
1