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