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