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.  Seeformat, 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'.  Seewarning, for a detailed discussion
      of these.