cpio: Copy-in mode

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