cpio
CPIO(1) GNU CPIO CPIO(1)
NAME
cpio - copy files to and from archives
SYNOPSIS
cpio {-o|--create} [-0acvABLV] [-C BYTES] [-H FORMAT] [-M MESSAGE] [-O
[[USER@]HOST:]ARCHIVE] [-F [[USER@]HOST:]ARCHIVE]
[--file=[[USER@]HOST:]ARCHIVE] [--format=FORMAT] [--message=MESSAGE]
[--null] [--reset-access-time] [--verbose] [--dot] [--append]
[--block-size=blocks] [--dereference] [--io-size=BYTES] [--quiet]
[--force-local] [--rsh-command=COMMAND] < name-list [> archive]
cpio {-i|--extract} [-bcdfmnrtsuvBSV] [-C BYTES] [-E FILE] [-H FORMAT]
[-M MESSAGE] [-R [USER][:.][GROUP]] [-I [[USER@]HOST:]ARCHIVE] [-F
[[USER@]HOST:]ARCHIVE] [--file=[[USER@]HOST:]ARCHIVE] [--make-directo-
ries] [--nonmatching] [--preserve-modification-time] [--nu-
meric-uid-gid] [--rename] [--list] [--swap-bytes] [--swap] [--dot]
[--unconditional] [--verbose] [--block-size=BLOCKS] [--swap-halfwords]
[--io-size=BYTES] [--pattern-file=FILE] [--format=FORMAT]
[--owner=[USER][:.][GROUP]] [--no-preserve-owner] [--message=MESSAGE]
[--force-local] [--no-absolute-filenames] [--sparse] [--only-ver-
ify-crc] [--to-stdout] [--quiet] [--rsh-command=COMMAND] [pattern...]
[< archive]
cpio {-p|--pass-through} [-0adlmuvLV] [-R [USER][:.][GROUP]] [--null]
[--reset-access-time] [--make-directories] [--link] [--quiet] [--pre-
serve-modification-time] [--unconditional] [--verbose] [--dot]
[--dereference] [--owner=[USER][:.][GROUP]] [--no-preserve-owner]
[--sparse] destination-directory < name-list
cpio {-?|--help|--usage|--version}
REPORTING BUGS
Report cpio bugs to bug-cpio@gnu.org
GNU cpio home page: <http://www.gnu.org/software/cpio/>
General help using GNU software: <http://www.gnu.org/gethelp/>
Report cpio translation bugs to <http://translationproject.org/team/>
SEE ALSO
cpio(5)
DESCRIPTION
GNU cpio copies files between archives and directories. It supports
the following archive formats: old binary cpio, old portable cpio, SVR4
cpio with and without checksum, HP cpio, and various tar formats.
The operation mode is requested by one of the following options:
-o, --create
Copy-out. Read a list of file names from the standard input and
create on the standard output (unless overridden by the --file
option) an archive containing these files.
-i, --extract
Copy-in. Read the archive from standard input (or from the file
supplied with the --file option) and extract files from it, or
(if the -t option is given) list its contents to the standard
output. If one or more patterns are supplied, read or list only
files matching these patterns. The -t option alone implies -i.
-p, --pass-through
Pass-through. Read a list of file names from the standard input
and copy them to the specified directory.
-?, --help
Give a short help summary and exit.
--usage
Print a short usage message and exit.
--version
Print program version and exit.
REPORTING BUGS
Report cpio bugs to bug-cpio@gnu.org
GNU cpio home page: <http://www.gnu.org/software/cpio/>
General help using GNU software: <http://www.gnu.org/gethelp/>
Report cpio translation bugs to <http://translationproject.org/team/>
OPTIONS
Operation modifiers valid in any mode
--block-size=BLOCK-SIZE
Set the I/O block size to BLOCK-SIZE * 512 bytes.
-B Set the I/O block size to 5120 bytes.
-c Use the old portable (ASCII) archive format. This is the same
as -H odc.
-C, --io-size=NUMBER
Set the I/O block size to the given NUMBER of bytes.
-D, --directory=DIR
Change to directory DIR.
--force-local
Archive file is local, even if its name contains colons.
-H, --format=FORMAT
Use given archive FORMAT. Valid formats are (the number in
parentheses gives maximum size for individual archive member):
bin The obsolete binary format. (2147483647 bytes)
odc The old (POSIX.1) portable format. (8589934591 bytes)
newc The new (SVR4) portable format, which supports file sys-
tems having more than 65536 i-nodes. (4294967295 bytes)
crc The new (SVR4) portable format with a checksum added.
tar The old tar format. (8589934591 bytes)
ustar The POSIX.1 tar format. Also recognizes GNU tar ar-
chives, which are similar but not identical. (8589934591
bytes)
hpbin The obsolete binary format used by HPUX's cpio (which
stores device files differently).
hpodc The portable format used by HPUX's cpio (which stores de-
vice files differently).
-R, --owner=[USER][:.][GROUP]
In copy-in and copy-pass mode, set the ownership of all files
created to the specified USER and/or GROUP. In copy-out mode,
store the supplied owner information in the archive.
USER and GROUP are first looked up in the system user and group
databases. If not found, cpio checks if they consist of decimal
digits only and, if so, treats them as numeric UID and GID, cor-
respondingly.
To avoid the lookup and ensure that arguments are treated as nu-
meric values, prefix them with a plus sign, e.g.: -R +0:+0.
--quiet
Do not print the number of blocks copied at the end of the run.
--rsh-command=COMMAND
Use remote COMMAND instead of rsh.
-v, --verbose
Verbosely list the files processed.
-V, --dot
Print a "." for each file processed.
-W, --warning=FLAG
Controls warning display. The FLAG is one of none, to disable
all warnings, all to enable them, truncate, to enable warnings
about field truncation, and no-truncate, to disable them.
Multiple -W options accumulate.
Operation modifiers valid in copy-in and copy-out modes
-F, --file=[[USER@]HOST:]ARCHIVE-FILE
Use this ARCHIVE-FILE instead of standard input (in copy-in
mode) or standard output (in copy-out mode). Optional USER and
HOST specify the user and host names in case of a remote ar-
chive.
-M, --message=STRING
Print STRING when the end of a volume of the backup media is
reached.
Operation modifiers valid only in copy-in mode
-b, --swap
Swap both halfwords of words and bytes of halfwords in the data.
Equivalent to -sS.
-f, --nonmatching
Only copy files that do not match any of the given patterns.
-n, --numeric-uid-gid
In the verbose table of contents listing, show numeric UID and
GID.
-r, --rename
Interactively rename 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.
-E, --pattern-file=FILE
Read additional patterns specifying filenames to extract or list
from FILE.
--only-verify-crc
When reading a CRC format archive, only verify the CRC's of each
file in the archive, without actually extracting the files.
Operation modifiers valid only in copy-out mode
-A, --append
Append to an existing archive.
--device-independent, --reproducible
Create reproducible archives. This is equivalent to --ig-
nore-devno --renumber-inodes.
--ignore-devno
Store 0 in the device number field of each archive member, in-
stead of the actual device number.
-O [[USER@]HOST:]ARCHIVE-NAME
Use ARCHIVE-NAME instead of standard output. Optional USER and
HOST specify the user and host names in case of a remote ar-
chive.
The output archive name can be specified wither using this op-
tion, or using -F (--file), but not both.
--renumber-inodes
Renumber inodes when storing them in the archive.
Operation modifiers valid only in copy-pass mode
-l, --link
Link files instead of copying them, when possible.
Operation modifiers valid in copy-in and copy-out modes
--absolute-filenames
Do not strip file system prefix components from the file names.
This is the default.
--no-absolute-filenames
Create all files relative to the current directory.
Operation modifiers valid in copy-out and copy-pass modes
-0, --null
Filenames in the list are delimited by null characters instead
of newlines.
-a, --reset-access-time
Reset the access times of files after reading them.
-I [[USER@]HOST:]ARCHIVE-NAME
Use ARCHIVE-NAME instead of standard input. Optional USER and
HOST specify the user and host names in case of a remote ar-
chive.
The input archive name can be specified wither using this op-
tion, or using -F (--file), but not both.
-L, --dereference
Dereference symbolic links (copy the files that they point to
instead of copying the links).
Operation modifiers valid in copy-in and copy-pass modes
-d, --make-directories
Create leading directories where needed.
-m, --preserve-modification-time
Retain previous file modification times when creating files.
--no-preserve-owner
Do not change the ownership of the files.
--sparse
Write files with large blocks of zeros as sparse files.
-u, --unconditional
Replace all files unconditionally.
RETURN VALUE
GNU cpio exits with code 0 if it was able to successfully complete the
requested operation. On errors, it exits with code 2.
SEE ALSO
tar(1), rmt(8), mt(1).
BUG REPORTS
Report bugs to <bug-cpio@gnu.org>.
COPYRIGHT
Copyright (C) 2014 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/li-
censes/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
CPIO June 21, 2018 CPIO(1)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2025
Hurricane Electric.
All Rights Reserved.