CPIO(1) General Commands Manual CPIO(1)
NAME
cpio — copy files to and from archives
SYNOPSIS
cpio -i [options]
[pattern ...] [< archive]
cpio -o [options] < name-list
[> archive]
cpio -p [options] dest-dir <
name-list
DESCRIPTION
cpio copies files between archives and directories. This implementation can extract from tar, pax, cpio, zip, jar, ar, and ISO 9660 cdrom images and can create tar, pax, cpio, ar, and shar archives.
The first option to cpio is a mode indicator from the following list:
-i
Input. Read an archive from standard input (unless overridden) and extract the contents to disk or (if the -t option is specified) list the contents to standard output. If one or more file patterns are specified, only files matching one of the patterns will be extracted.
-o
Output. Read a list of filenames from standard input and produce a new archive on standard output (unless overridden) containing the specified items.
-p
Pass-through. Read a list of filenames from standard input and copy the files to the specified directory.
OPTIONS
Unless specifically stated otherwise, options are applicable in all operating modes.
-0, --null
Read filenames separated by NUL characters instead of newlines. This is necessary if any of the filenames being read might contain newlines.
-6, --pwb
When reading a binary format archive, assume it’s the earlier one, from the PWB variant of 6th Edition UNIX. When writing a cpio archive, use the PWB format.
-7, --binary
(o mode only) When writing a cpio archive, use the (newer, non-PWB) binary format.
-A
(o mode only) Append to the specified archive. (Not yet implemented.)
-a
(o and p modes) Reset access times on files after they are read.
-B
(o mode only) Block output to records of 5120 bytes.
-C size
(o mode only) Block output to records of size bytes.
-c
(o mode only) Use the old POSIX portable character format. Equivalent to --format odc.
-d, --make-directories
(i and p modes) Create directories as necessary.
-E file
(i mode only) Read list of file name patterns from file to list and extract.
-F file, --file file
Read archive from or write archive to file.
-f pattern
(i mode only) Ignore files that match pattern.
-H format, --format format
(o mode only) Produce the output archive in the specified format. Supported formats include:
cpio
Synonym for odc.
newc
The SVR4 portable cpio format.
odc
The old POSIX.1 portable octet-oriented cpio format.
pax
The POSIX.1 pax format, an extension of the ustar format.
ustar
The POSIX.1 tar format.
The default format is odc. See libarchive-formats(5) for more complete information about the formats currently supported by the underlying libarchive(3) library.
-h, --help
Print usage information.
-I file
Read archive from file.
-i, --extract
Input mode. See above for description.
--insecure
(i and p mode only) Disable security checks during extraction or copying. This allows extraction via symbolic links, absolute paths, and path names containing ‘..’ in the name.
-J, --xz
(o mode only) Compress the file with xz-compatible compression before writing it. In input mode, this option is ignored; xz compression is recognized automatically on input.
-j
Synonym for -y.
-L
(o and p modes) All symbolic links will be followed. Normally, symbolic links are archived and copied as symbolic links. With this option, the target of the link will be archived or copied instead.
-l, --link
(p mode only) Create links from the target directory to the original files, instead of copying.
--lrzip
(o mode only) Compress the resulting archive with lrzip(1). In input mode, this option is ignored.
--lz4
(o mode only) Compress the archive with lz4-compatible compression before writing it. In input mode, this option is ignored; lz4 compression is recognized automatically on input.
--zstd
(o mode only) Compress the archive with zstd-compatible compression before writing it. In input mode, this option is ignored; zstd compression is recognized automatically on input.
--lzma
(o mode only) Compress the file with lzma-compatible compression before writing it. In input mode, this option is ignored; lzma compression is recognized automatically on input.
--lzop
(o mode only) Compress the resulting archive with lzop(1). In input mode, this option is ignored.
--passphrase passphrase
The passphrase is used to extract or create an encrypted archive. Currently, zip is only a format that cpio can handle encrypted archives. You shouldn’t use this option unless you realize how insecure use of this option is.
-m, --preserve-modification-time
(i and p modes) Set file modification time on created files to match those in the source.
-n, --numeric-uid-gid
(i mode, only with -t) Display numeric uid and gid. By default, cpio displays the user and group names when they are provided in the archive, or looks up the user and group names in the system password database.
--no-preserve-owner
(i mode only) Do not attempt to restore file ownership. This is the default when run by non-root users.
-O file
Write archive to file.
-o, --create
Output mode. See above for description.
-p, --pass-through
Pass-through mode. See above for description.
--preserve-owner
(i mode only) Restore file ownership. This is the default when run by the root user.
--quiet
Suppress unnecessary messages.
-R [
user][
:][
group], --owner [
user][
:][
group]
Set the owner and/or group on files in the output. If group is specified with no user (for example, -R :wheel) then the group will be set but not the user. If the user is specified with a trailing colon and no group (for example, -R root:) then the group will be set to the user’s default group. If the user is specified with no trailing colon, then the user will be set but not the group. In -i and -p modes, this option can only be used by the super-user. (For compatibility, a period can be used in place of the colon.)
-r
(All modes.) Rename files interactively. For each file, a prompt is written to /dev/tty containing the name of the file and a line is read from /dev/tty. If the line read is blank, the file is skipped. If the line contains a single period, the file is processed normally. Otherwise, the line is taken to be the new name of the file.
-t, --list
(i mode only) List the contents of the archive to stdout; do not restore the contents to disk.
-u, --unconditional
(i and p modes) Unconditionally overwrite existing files. Ordinarily, an older file will not overwrite a newer file on disk.
-V, --dot
Print a dot to stderr for each file as it is processed. Superseded by -v.
-v, --verbose
Print the name of each file to stderr as it is processed. With -t, provide a detailed listing of each file.
--version
Print the program version information and exit.
-y
(o mode only) Compress the archive with bzip2-compatible compression before writing it. In input mode, this option is ignored; bzip2 compression is recognized automatically on input.
-Z
(o mode only) Compress the archive with compress-compatible compression before writing it. In input mode, this option is ignored; compression is recognized automatically on input.
-z
(o mode only) Compress the archive with gzip-compatible compression before writing it. In input mode, this option is ignored; gzip compression is recognized automatically on input.
EXIT STATUS
The cpio utility exits 0 on success, and >0 if an error occurs.
ENVIRONMENT
The following environment variables affect the execution of cpio:
LANG
The locale to use. See environ(7) for more information.
TZ
The timezone to use when displaying dates. See environ(7) for more information.
EXAMPLES
The cpio command is traditionally used to copy file hierarchies in conjunction with the find(1) command. The first example here simply copies all files from src to dest:
find src | cpio -pmud dest
By carefully selecting options to the find(1) command and combining it with other standard utilities, it is possible to exercise very fine control over which files are copied. This next example copies files from src to dest that are more than 2 days old and whose names match a particular pattern:
find src -mtime +2 | grep foo[bar] | cpio -pdmu dest
This example copies files from src to dest that are more than 2 days old and which contain the word “
foobar ”:
find src -mtime +2 | xargs grep -l foobar | cpio -pdmu dest
COMPATIBILITY
The mode options i, o, and p and the options a, B, c, d, f, l, m, r, t, u, and v comply with SUSv2.
The old POSIX.1 standard specified that only -i, -o, and -p were interpreted as command-line options. Each took a single argument of a list of modifier characters. For example, the standard syntax allows -imu but does not support -miu or -i -m -u, since m and u are only modifiers to -i, they are not command-line options in their own right. The syntax supported by this implementation is backwards-compatible with the standard. For best compatibility, scripts should limit themselves to the standard syntax.
SEE ALSO
bzip2(1), gzip(1), mt(1), pax(1), tar(1), libarchive(3), cpio(5), libarchive-formats(5), tar(5)
STANDARDS
There is no current POSIX standard for the cpio command; it appeared in ISO/IEC 9945-1:1996 (“POSIX.1”) but was dropped from IEEE Std 1003.1-2001 (“POSIX.1”).
The cpio, ustar, and pax interchange file formats are defined by IEEE Std 1003.1-2001 (“POSIX.1”) for the pax command.
HISTORY
The original cpio and find utilities were written by Dick Haight while working in AT&T’s Unix Support Group. They first appeared in 1977 in PWB/UNIX 1.0, the “Programmer’s Work Bench” system developed for use within AT&T. They were first released outside of AT&T as part of System III Unix in 1981. As a result, cpio actually predates tar, even though it was not well-known outside of AT&T until some time later.
This is a complete re-implementation based on the libarchive(3) library.
BUGS
The cpio archive format has several basic limitations: It does not store user and group names, only numbers. As a result, it cannot be reliably used to transfer files between systems with dissimilar user and group numbering. Older cpio formats limit the user and group numbers to 16 or 18 bits, which is insufficient for modern systems. The cpio archive formats cannot support files over 4 gigabytes, except for the “odc” variant, which can support files up to 8 gigabytes. Debian September 16, 2014 CPIO(1)
CPIO(1) BSD General Commands Manual CPIO(1)
d28 2 a29 2cpio — copy files to and from archives
d33 1 a33 1cpio -i [options] d42 1 a42 1
cpio copies files between d47 1 a47 1
The first option d53 1 a53 1
Input. Read an d62 1 a62 1
Output. Read a d69 1 a69 1
Pass-through. d75 1 a75 1
Unless specifically stated d81 1 a81 1
Read filenames separated by NUL d87 1 a87 1
When reading a binary format d94 1 a94 1
(o mode only) When writing a d99 1 a99 1
(o mode only) d104 1 a104 1
(o and p modes) d109 1 a109 1
(o mode only) d114 1 a114 1
(o mode only) Block output to d119 1 a119 1
(o mode only) d126 1 a126 1
(i and p modes) Create d131 1 a131 1
(i mode only) Read list of file d137 1 a137 1
Read archive from or write d142 1 a142 1
(i mode only) Ignore files that d148 1 a148 1
(o mode only) Produce the d154 1 a154 1
Synonym for d159 1 a159 1
The SVR4 d164 1 a164 1
The old POSIX.1 d169 1 a169 1
The POSIX.1 pax d174 1 a174 1
The POSIX.1 tar d177 5 a181 4
The default format is odc. See libarchive-formats(5) for more complete information about the formats currently supported by the underlying libarchive(3) library.
d185 1 a185 1Print usage information.
d189 1 a189 1Read archive from d194 1 a194 1
Input mode. See above for d199 1 a199 1
(i and p mode only) Disable d202 1 a202 1 names containing ’..’ in the name.
d206 1 a206 1(o mode only) Compress the file d213 1 a213 1
Synonym for d218 1 a218 1
(o and p modes) d226 1 a226 1
(p mode only) Create links from d232 3 a234 3
(o mode only) Compress the resulting archive with lrzip(1). In input mode, this option is ignored.
d238 1 a238 1(o mode only) d245 1 a245 1
(o mode only) d252 1 a252 1
(o mode only) d259 3 a261 3
(o mode only) Compress the resulting archive with lzop(1). In input mode, this option is ignored.
d266 1 a266 1The passphrase is used d275 1 a275 1
(i and p modes) Set file d282 1 a282 1
(i mode, only with -t) d290 1 a290 1
(i mode only) Do not attempt to d296 1 a296 1
Write archive to d301 1 a301 1
Output mode. See above for d307 1 a307 1
Pass-through mode. See above d312 1 a312 1
(i mode only) Restore file d318 1 a318 1
Suppress unnecessary d329 1 a329 1
Set the owner and/or group on d343 1 a343 1
(All modes.) d353 1 a353 1
(i mode only) List the contents d360 1 a360 1
(i and p modes) Unconditionally d366 1 a366 1
Print a dot to stderr for each d371 1 a371 1
Print the name of each file to d377 1 a377 1
Print the program version d382 1 a382 1
(o mode only) d389 1 a389 1
(o mode only) d396 1 a396 1
(o mode only) d403 1 a403 1
The cpio utility d409 1 a409 1
The following environment d414 2 a415 2
The locale to use. See environ(7) for more information.
d419 2 a420 2The timezone to use when displaying dates. See environ(7) for more d425 1 a425 1
The cpio command is d427 2 a428 2 with the find(1) command. The first example here simply copies all files from src to dest:
d430 1 a430 1find src | d433 7 a439 7
By carefully selecting options to the find(1) command and combining it with other standard utilities, it is possible to exercise very fine control over which files are copied. This next example copies files from src to dest that are more than 2 days old and whose names match a particular pattern:
d441 1 a441 1find src d445 1 a445 1
This example d451 1 a451 1
find src d457 1 a457 1
The mode options i, o, and p and d461 1 a461 1
The old POSIX.1 d475 4 a478 3
bzip2(1), gzip(1), mt(1), pax(1), tar(1), libarchive(3), cpio(5), libarchive-formats(5), tar(5)
d482 1 a482 1There is no current POSIX d487 1 a487 1
The cpio, ustar, d493 1 a493 1
The original cpio and d504 2 a505 2
This is a complete re-implementation based on the libarchive(3) d510 1 a510 1
The cpio archive format has d518 2 a519 4 can support files up to 8 gigabytes.
BSD September 16, 2014 BSD
@ 1.11 log @libarchive: updated to 3.7.4 Libarchive 3.7.4 is a bugfix and security release Security fixes: rar: Fix OOB in rar e8 filter (CVE-2024-26256) zip: Fix out of boundary access Important bugfixes: 7zip: Limit amount of properties bsdtar: Fix error handling around strtol() usages passphrase: Improve newline handling on Windows passphrase: Never allow empty passwords rar: Fix "File CRC Error" when extracting specific rar4 archives xar: Avoid infinite link loop zip: Update AppleDouble support for directories zstd: Implement core detection @ text @d2 1 a2 1 @ 1.10 log @libarchive: updated to 3.7.3 Libarchive 3.7.3 is a feature, security and bugfix release. New features: PCRE2 support add trailing letter b to bsdtar(1) substitute pattern add support for long options "--group" and "--owner" to tar(1) Security fixes: Fix possible vulnerability in tar error reporting introduced in f27c173 Important bugfixes: ISO9660: preserve the natural order of links rar5: fix decoding unicode filenames on Windows rar5: fix infinite loop if during rar5 decompression the last block produced no data xz filter: fix incorrect eof at the end of an lzip member zip: fix end-of-data marker processing when decompressing zip archives multiple bsdunzip(1) fixes filetime truncation fix on Windows @ text @d2 1 a2 1 @ 1.9 log @libarchive: updated to 3.7.2 Libarchive 3.7.2 is a security, bugfix and feature release. Security fixes: Multiple vulnerabilities have been fixed in the PAX writer (1b4e0d0) Important bugfixes: bsdunzip(1) now correctly handles arguments following an -x after the zipfile New features: bsdunzip(1) now supports the "--version" flag 7-zip reader now translates Windows permissions into UNIX permissions uudecode filter in raw mode now supports file name and file mode zstd filter now supports the "long" write option Libarchive 3.7.1 is a security, feature and bugfix release. Security fixes: SEGV and stack buffer overflow in verbose mode of cpio Feature updates: bsdunzip updated to match latest upstream code Important bugfixes: miscellaneous functional bugfixes build fixes on multiple platforms Libarchive 3.7.0 is a feature and bugfix release. New features: bsdunzip: new tool ported from FreeBSD drop-in replacement for Info-ZIP unzip, not yet ported for Windows 7zip reader: support for Zstandard compression 7zip reader: support for ARM64 filter zstd filter: support for multi-frame zstd archives Other notable bugfixes and improvements: pax: fix year 2038 problem on platforms with 64-bit time_t Windows: Universal Windows Platform (UWP) fixes and improvements Windows: bcrypt usage fixes and improvements Windows: time function usage fixes and improvements @ text @d2 1 a2 1 @ 1.8 log @libarchive: Update to 3.4.3 Libarchive 3.4.3 is a feature and bugfix release. New features: support for pzstd compressed files (#1357) support for RHT.security.selinux tar extended attribute (#1348) Important bugfixes: various zstd fixes and improvements (#1342 #1352 #1359) child process handling fixes (#1372) Libarchive 3.4.2 is a feature and security release. New features: support for atomic file extraction (bsdtar -x --safe-writes) (#1289) support for mbed TLS (PolarSSL) (#1301) Important bugfixes: security fixes in RAR5 reader (#1280 #1326) compression buffer fix in XAR writer (#1317) fix uname and gname longer than 32 characters in PAX writer (#1319) fix segfault when archiving hard links in ISO9660 and XAR writers (#1325) fix support for extracting 7z archive entries with Delta filter (#987) Libarchive 3.4.1 is a feature and security release. New features: Unicode filename support for reading lha/lzh archives New pax write option "xattrhdr" Important bugfixes: security fixes in wide string processing (#1276 #1298) security fixes in RAR5 reader (#1212 #1217 #1296) security fixes and optimizations to write filter logic (#351) security fix related to use of readlink(2) (1dae5a5) sparse file handling fixes (#1218 #1260) Thanks to all contributors and bug reporters. Special thanks to Christos Zoulas (@@zoulasc) from NetBSD for the atomic file extraction feature. @ text @d1 2 a2 2 d84 12 d445 1 a445 2 than 2 days old and which contain the word ’’ d447 1 a447 1foobar ’’:
d481 2 a482 3 9945-1:1996 (’’POSIX.1’’) but was dropped from IEEE Std 1003.1-2001 (’’POSIX.1’’). d486 1 a486 2 1003.1-2001 (’’POSIX.1’’) for the pax command. d494 6 a499 6 ’’Programmer’s Work Bench’’ system developed for use within AT&T. They were first released outside of AT&T as part of System III Unix in 1981. As a result, cpio actually predates tar, even though it was not well-known outside of AT&T until some time later. d514 2 a515 2 4 gigabytes, except for the ’’odc’’ variant, which can support files up to 8 gigabytes. @ 1.7 log @Update for libarchive-3.4.0: - improvements for Android APK and JAR archives - better support for non-recursive list and extract - tar --exclude-vcs support - fixes for file attributes and flags handling - zipx support - rar 5.0 reader @ text @d1 2 a2 2 d433 2 a434 1 than 2 days old and which contain the word “ d436 1 a436 1foobar ”:
d462 2 a463 2bzip2(1), tar(1), gzip(1), mt(1), pax(1), libarchive(3), cpio(5), d470 3 a472 2 9945-1:1996 (“POSIX.1”) but was dropped from IEEE Std 1003.1-2001 (“POSIX.1”).
d476 2 a477 1 1003.1-2001 (“POSIX.1”) for the pax command. d485 6 a490 6 “Programmer’s Work Bench” system developed for use within AT&T. They were first released outside of AT&T as part of System III Unix in 1981. As a result, cpio actually predates tar, even though it was not well-known outside of AT&T until some time later. d505 2 a506 2 4 gigabytes, except for the “odc” variant, which can support files up to 8 gigabytes. @ 1.6 log @libarchive: updated to 3.3.3 libarchive 3.3.3: Avoid super-linear slowdown on malformed mtree files Many fixes for building with Visual Studio NO_OVERWRITE doesn't change existing directory attributes New support for Zstandard read and write filters @ text @d1 2 a2 2 d433 1 a433 2 than 2 days old and which contain the word ’’ d435 1 a435 1foobar ’’:
d469 2 a470 3 9945-1:1996 (’’POSIX.1’’) but was dropped from IEEE Std 1003.1-2001 (’’POSIX.1’’). d474 1 a474 2 1003.1-2001 (’’POSIX.1’’) for the pax command. d482 6 a487 6 ’’Programmer’s Work Bench’’ system developed for use within AT&T. They were first released outside of AT&T as part of System III Unix in 1981. As a result, cpio actually predates tar, even though it was not well-known outside of AT&T until some time later. d502 2 a503 2 4 gigabytes, except for the ’’odc’’ variant, which can support files up to 8 gigabytes. @ 1.5 log @Merge for libarchive-3.3.2. @ text @d2 1 a2 1 d229 7 @ 1.4 log @Merge libarchive-3.3.1. @ text @d2 1 a2 1 d32 3 a34 4cpio −i
[options] [pattern ...]
[< archive]
cpio −o [options] < name-list
d36 1
a36 1
cpio −p [options] dest-dir <
d50 1
a50 1
−i
d54 1 a54 1 the contents to disk or (if the −t option is d59 1 a59 1−o
d66 1 a66 1−p
d78 1 a78 2−0, −−null
d84 1 a84 1−A
d89 1 a89 1−a
d94 1 a94 1−B
d99 1 a99 1−C size
d104 1 a104 1−c
d108 1 a108 1 −−format odc. d110 2 a111 2−d, −−make-directories
d116 1 a116 1−E file
d121 2 a122 2−F file, −−file file
d127 1 a127 2−f pattern
d132 2 a133 2−H format, −−format format
d169 1 a169 2−h, −−help
d173 1 a173 1−I file
d178 1 a178 2−i, −−extract
d183 1 a183 2−−insecure
d188 1 a188 1 names containing ‘..’ in the name. d190 1 a190 2−J, −−xz
d197 1 a197 1−j
d200 1 a200 1 −y. d202 1 a202 1−L
d210 1 a210 2−l, −−link
d216 1 a216 1−−lrzip
d222 1 a222 1−−lz4
d229 1 a229 1−−lzma
d236 1 a236 1−−lzop
d242 1 a242 1−−passphrase d251 2 a252 2
−m, −−preserve-modification-time
d258 2 a259 8−n, −−numeric-uid-gid
(i mode, only with −t) Display numeric uid and gid. By default, cpio displays the user and group names when they are provided in the archive, or looks up the user and group names in the system password database.
d261 5 d267 1 a267 1−−no-preserve-owner
d273 1 a273 1−O file
d278 1 a278 2−o, −−create
d283 2 a284 2−p, −−pass-through
d289 1 a289 2−−preserve-owner
d295 1 a295 1−−quiet
d300 1 a300 1−R [
d303 1
a303 1
group], −−owner [
d310 9
a318 9
example, −R :wheel) then the group will
be set but not the user. If the user is specified with a
trailing colon and no group (for example, −R
root:) then the group will be set to the user’s
default group. If the user is specified with no trailing
colon, then the user will be set but not the group. In
−i and −p modes, this option can
only be used by the super-user. (For compatibility, a period
can be used in place of the colon.)
−r
d330 1 a330 2−t, −−list
d336 2 a337 2−u, −−unconditional
d343 1 a343 2−V, −−dot
d346 1 a346 1 file as it is processed. Superseded by −v. d348 1 a348 2−v, −−verbose
d351 1 a351 1 stderr as it is processed. With −t, provide a d354 1 a354 2−−version
d359 1 a359 1−y
d366 1 a366 1−Z
d373 1 a373 1−z
d410 1 a410 1 cpio −pmud dest d421 2 a422 2 −mtime +2 | grep foo[bar] | cpio −pdmu dest d427 1 a427 1 ‘‘ d432 2 a433 2 −mtime +2 | xargs grep -l foobar | cpio −pdmu dest d442 10 a451 12 standard specified that only −i, −o, and −p were interpreted as command-line options. Each took a single argument of a list of modifier characters. For example, the standard syntax allows −imu but does not support −miu or −i −m −u, since m and u are only modifiers to −i, they are not command-line options in their own right. The syntax supported by this implementation is backwards-compatible with the standard. For best compatibility, scripts should limit themselves to the standard syntax. d463 1 a463 1 9945-1:1996 (‘‘POSIX.1’’) but was d465 1 a465 1 (‘‘POSIX.1’’). d469 1 a469 1 1003.1-2001 (‘‘POSIX.1’’) for the d478 1 a478 1 ‘‘Programmer’s Work Bench’’ d498 1 a498 1 4 gigabytes, except for the ‘‘odc’’ @ 1.3 log @Update for libarchive 3.2.1. @ text @d2 1 a2 1 d194 1 a194 1 names containing ’..’ in the name. d442 1 a442 1 ’’ d480 1 a480 1 9945-1:1996 (’’POSIX.1’’) but was d482 1 a482 1 (’’POSIX.1’’). d486 1 a486 1 1003.1-2001 (’’POSIX.1’’) for the d495 1 a495 1 ’’Programmer’s Work Bench’’ d515 1 a515 1 4 gigabytes, except for the ’’odc’’ @ 1.2 log @Changes 3.1.2: This is a maintenance update to fix issues with the new RAR seeking feature. This new release also contains fixes for build failures when building libarchive using Visual Studio 2012 and MinGW. @ text @d1 2 a2 2 d32 1 a32 1cpio {−i}
d35 3
a37 3
cpio {−o} [options] <
name-list [> archive]
cpio {−p} [options] dest-dir <
d193 2
a194 2
extraction via symbolic links and path names containing
’..’ in the name.
BSDCPIO(1) FreeBSD General Commands Manual BSDCPIO(1)
d25 1 a25 1NAME
d27 1 a27 1cpio — copy files d30 1 d32 1 a32 3
SYNOPSIS
cpio {−i} d40 1 d42 1 a42 3
DESCRIPTION
cpio copies files between d47 1 a47 1
The first option d51 1 a51 1
−i
d53 2 a54 2Input. Read an archive from standard input (unless overriden) and extract d60 1 a60 1
−o
d62 1 a62 1Output. Read a d64 2 a65 2 archive on standard output (unless overriden) containing the specified items.
d67 1 a67 1−p
d69 1 a69 1Pass-through. d73 1 a73 1
OPTIONS
d75 1 a75 1Unless specifically stated d79 2 d82 3 a84 6
−0
Read filenames separated by NUL characters instead of newlines. This is necessary if any of the filenames being read might contain newlines.
d86 1 d88 1 a88 3−A
(o mode only) d91 1 d93 1 a93 3
−a
(o and p modes) d96 1 d98 1 a98 3
−B
(o mode only) d101 1 a101 2
−C size
d103 1 a103 1(o mode only) Block output to d106 1 d108 1 a108 3
−c
(o mode only) d110 1 a110 2 −-format odc.
d112 2 a113 1−d
d115 2 a116 2(i and p modes) Create directories as necessary.
d118 1 a118 2−E file
d120 1 a120 1(i mode only) Read list of file d123 2 a124 2
−F file
d126 1 a126 1Read archive from or write d129 1 a129 1
−f d132 1 a132 1
(i mode only) Ignore files that d135 2 d138 1 a138 4
−-format format
(o mode only) Produce the d142 1 a142 1
cpio
d144 1 a144 1Synonym for d147 1 a147 1
newc
d149 1 a149 1The SVR4 d152 1 a152 1
odc
d154 1 a154 1The old POSIX.1 d157 1 a157 1
pax
d159 1 a159 1The POSIX.1 pax d162 1 a162 1
ustar
d164 1 a164 1The POSIX.1 tar d167 2 a168 2
The default format is odc. See libarchive_formats(5) for more d172 2 a173 5
−H format
Synonym for −-format.
d175 1 a175 2−h, −-help
d177 1 a177 1Print usage information.
d179 1 a179 4−I file
Read archive from d182 2 d185 2 a186 4
−i
Input mode. See above for description.
d189 1 a189 1−-insecure
d191 1 a191 1(i and p mode only) Disable d194 1 a194 2 ‘..’ in the name.
d196 2 a197 6−J
(o mode only) Compress the file with xz-compatible compression before writing it. In input mode, this option is ignored; xz compression is recognized automatically on input.
d199 4 d204 1 a204 1−j
d206 1 a206 1Synonym for d209 1 d211 1 a211 3
−L
(o and p modes) d217 2 d220 3 a222 1
−l
d224 1 a224 3(p mode only) Create links from the target directory to the original files, instead of copying.
d226 3 d230 1 a230 1−lzma
d232 1 a232 1(o mode only) d237 1 d239 3 a241 1
−m
d243 2 a244 3(i and p modes) Set file modification time on created files to match those in the source.
d246 3 d250 2 a251 1−n
d253 5 a257 5(i mode, only with −t) Display numeric uid and gid. By default, cpio displays the user and group names when they are provided in the archive, or looks up the user and group names in the system password database.
d260 1 a260 1−no-preserve-owner
d262 1 a262 1(i mode only) Do not attempt to d266 1 a266 2
−O file
d268 1 a268 1Write archive to d271 2 d274 2 a275 4
−o
Output mode. See above for description.
d277 2 d280 2 a281 1−p
a282 2Pass-through mode. See above for description.
d284 1 d286 1 a286 3−preserve-owner
(i mode only) Restore file d290 1 d292 1 a292 3
−-quiet
Suppress unnecessary d295 4 a298 2
−R [
d303 1
a303 1
Set the owner and/or group on d315 1 d317 1 a317 3
−r
(All modes.) d325 2 d328 3 a330 1
−t
d332 2 a333 3(i mode only) List the contents of the archive to stdout; do not restore the contents to disk.
d335 3 d339 2 a340 1−u
d342 2 a343 3(i and p modes) Unconditionally overwrite existing files. Ordinarily, an older file will not overwrite a newer file on disk.
d345 2 d348 3 a350 1−v
a351 4Print the name of each file to stderr as it is processed. With −t, provide a detailed listing of each file.
d353 1 d355 1 a355 3−-version
Print the program version d358 1 d360 1 a360 3
−y
(o mode only) d365 1 d367 1 a367 3
−Z
(o mode only) d372 1 d374 1 a374 3
−z
(o mode only) d379 5 d385 1 a385 1
ENVIRONMENT
d387 1 a387 1The following environment d390 1 a390 1
LANG
d392 1 a392 1The locale to d395 1 a395 1
TZ
d397 1 a397 1The timezone to d401 1 a401 7
EXIT STATUS
The cpio utility exits 0 on success, and >0 if an error occurs.
d403 2 a404 4EXAMPLES
The cpio command is traditionally used to copy file heirarchies in conjunction d408 1 a408 1
find src | d411 1 a411 1
By carefully d419 1 a419 1
find src d423 1 a423 1
This example d426 1 a426 1 ‘‘
d428 1 a428 1foobar ’’:
d430 1 a430 1find src d434 1 d436 1 a436 3
COMPATIBILITY
The mode options i, o, and p and d440 1 a440 1
The old POSIX.1 d454 1 a454 1
SEE ALSO
d456 1 a456 1bzip2(1), tar(1), gzip(1), d460 1 d462 1 a462 3
STANDARDS
There is no current POSIX d464 1 a464 1 9945-1:1996 (‘‘POSIX.1’’) but was d466 1 a466 1 (‘‘POSIX.1’’).
d468 1 a468 1The cpio, ustar, d470 1 a470 1 1003.1-2001 (‘‘POSIX.1’’) for the d473 1 a473 1
HISTORY
d475 1 a475 1The original cpio and d479 1 a479 1 ‘‘Programmer’s Work Bench’’ d486 1 a486 1
This is a d490 1 a490 1
BUGS
d492 1 a492 1The cpio archive format has d499 1 a499 1 4 gigabytes, except for the ‘‘odc’’ d502 2 a503 3
FreeBSD 8.0 December 21, 2007 FreeBSD 8.0
@ 1.1.1.1 log @Import libarchive 2.8.0: - Infrastructure: - Allow command line tools as fallback for missing compression libraries. If compiled without gzip for example, gunzip will be used automatically. - Improved support for a number of platforms like high-resolution timestamps and Extended Attributes on various Unix systems - New convience interface for creating archives based on disk content, complement of the archive_write_disk interface. - Frontends: - bsdcpio ready for public consumption - hand-written date parser replaces the yacc code - Filter system: - Simplified read filter chains - Option support for filters - LZMA, XZ, uudecode handled - Format support: - Write support for mtree files based on file system or archive content - Basic read support for Joliet - Write support for zip files - Write support for shar archives, both text-only and binary-safe @ text @@ 1.1.1.2 log @libarchive-2.8.2: - Fix NULL deference for short self-extracting zip archives - Don't dereference symlinks on Linux when reading ACLs - Better detection of SHA2 support for old OpenSSL versions - Fix parsing of input files for bsdtar -T - Do not leak setup_xattr into the global namespace - Fix build when an older libarchive is already installed - Use O_BINARY opening files in bsdtar - Include missing archive_crc32.h - Correctly include iconv.h required by libxml2 @ text @d1 519 a519 890 %!PS-Adobe-3.0 %%Creator: groff version 1.19.2 %%CreationDate: Sun Mar 14 02:49:18 2010 %%DocumentNeededResources: font Times-Roman %%DocumentSuppliedResources: procset grops 1.19 2 %%Pages: 72 %%PageOrder: Ascend %%DocumentMedia: Default 612 792 0 () () %%Orientation: Portrait %%EndComments %%BeginDefaults %%PageMedia: Default %%EndDefaults %%BeginProlog %%BeginResource: procset grops 1.19 2 %!PS-Adobe-3.0 Resource-ProcSet /setpacking where{ pop currentpacking true setpacking }if /grops 120 dict dup begin /SC 32 def /A/show load def /B{0 SC 3 -1 roll widthshow}bind def /C{0 exch ashow}bind def /D{0 exch 0 SC 5 2 roll awidthshow}bind def /E{0 rmoveto show}bind def /F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def /G{0 rmoveto 0 exch ashow}bind def /H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def /I{0 exch rmoveto show}bind def /J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def /K{0 exch rmoveto 0 exch ashow}bind def /L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def /M{rmoveto show}bind def /N{rmoveto 0 SC 3 -1 roll widthshow}bind def /O{rmoveto 0 exch ashow}bind def /P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def /Q{moveto show}bind def /R{moveto 0 SC 3 -1 roll widthshow}bind def /S{moveto 0 exch ashow}bind def /T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def /SF{ findfont exch [exch dup 0 exch 0 exch neg 0 0]makefont dup setfont [exch/setfont cvx]cvx bind def }bind def /MF{ findfont [5 2 roll 0 3 1 roll neg 0 0]makefont dup setfont [exch/setfont cvx]cvx bind def }bind def /level0 0 def /RES 0 def /PL 0 def /LS 0 def /MANUAL{ statusdict begin/manualfeed true store end }bind def /PLG{ gsave newpath clippath pathbbox grestore exch pop add exch pop }bind def /BP{ /level0 save def 1 setlinecap 1 setlinejoin 72 RES div dup scale LS{ 90 rotate }{ 0 PL translate }ifelse 1 -1 scale }bind def /EP{ level0 restore showpage }def /DA{ newpath arcn stroke }bind def /SN{ transform .25 sub exch .25 sub exch round .25 add exch round .25 add exch itransform }bind def /DL{ SN moveto SN lineto stroke }bind def /DC{ newpath 0 360 arc closepath }bind def /TM matrix def /DE{ TM currentmatrix pop translate scale newpath 0 0 .5 0 360 arc closepath TM setmatrix }bind def /RC/rcurveto load def /RL/rlineto load def /ST/stroke load def /MT/moveto load def /CL/closepath load def /Fr{ setrgbcolor fill }bind def /setcmykcolor where{ pop /Fk{ setcmykcolor fill }bind def }if /Fg{ setgray fill }bind def /FL/fill load def /LW/setlinewidth load def /Cr/setrgbcolor load def /setcmykcolor where{ pop /Ck/setcmykcolor load def }if /Cg/setgray load def /RE{ findfont dup maxlength 1 index/FontName known not{1 add}if dict begin { 1 index/FID ne{def}{pop pop}ifelse }forall /Encoding exch def dup/FontName exch def currentdict end definefont pop }bind def /DEFS 0 def /EBEGIN{ moveto DEFS begin }bind def /EEND/end load def /CNT 0 def /level1 0 def /PBEGIN{ /level1 save def translate div 3 1 roll div exch scale neg exch neg exch translate 0 setgray 0 setlinecap 1 setlinewidth 0 setlinejoin 10 setmiterlimit []0 setdash /setstrokeadjust where{ pop false setstrokeadjust }if /setoverprint where{ pop false setoverprint }if newpath /CNT countdictstack def userdict begin /showpage{}def /setpagedevice{}def }bind def /PEND{ countdictstack CNT sub{end}repeat level1 restore }bind def end def /setpacking where{ pop setpacking }if %%EndResource %%EndProlog %%BeginSetup %%BeginFeature: *PageSize Default << /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice %%EndFeature %%IncludeResource: font Times-Roman grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron /scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent /ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen /period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon /semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O /P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex /underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y /z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft /guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl /endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut /dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash /quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen /brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft /logicalnot/minus/registered/macron/degree/plusminus/twosuperior /threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior /ordmasculine/guilsinglright/onequarter/onehalf/threequarters /questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE /Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex /Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis /multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn /germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla /egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis /eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash /ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def /Times-Roman@@0 ENC0/Times-Roman RE %%EndSetup %%Page: 1 1 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@@0 SF()0 12 Q()0 24 Q()36 24 Q(The \214rst option to)0 36 Q(cpio)0 48 Q (is a mode indicator from the follo)0 60 Q(wing list:)-.25 E (
)36 12 Q(
)36 24 Q (
)36 48 Q(The def)0 60 Q (ault format is)-.1 E(odc.)0 72 Q 0 Cg EP %%Page: 24 24 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@@0 SF(See)0 12 Q(libarchi).15 E -.15(ve)-.25 G (_formats\(5\)).15 E(for more complete information about the)0 36 Q (formats currently supported by the underlying)0 48 Q (libarchi).15 E -.15(ve)-.25 G(\(3\)).15 E(library)0 72 Q(.)-.65 E 0 Cg EP %%Page: 25 25 %%BeginPageSetup BP %%EndPageSetup /F0 10/Times-Roman@@0 SF (
/de)0 48 Q
(v/tty)-.25 E
(containing the name of the \214le and a line is read from)0 60 Q
(/de)0 72 Q(v/tty.)-.25 E 0 Cg EP
%%Page: 41 41
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF
(If the line read is blank, the \214le is skipped.)0 12 Q
(If the line contains a single period, the \214le is processed normally)
0 24 Q(.)-.65 E(Otherwise, the line is tak)0 36 Q(en to be the ne)-.1 E
2.5(wn)-.25 G(ame of the \214le.)-2.5 E(LANGTZsrc)0 60 Q(to)0 72 Q 0 Cg EP
%%Page: 52 52
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(dest:)0 12 Q(src |Fl pmud dest)0 48 Q()36 72 Q 0 Cg EP
%%Page: 53 53
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(By carefully selecting options to the)0 12 Q
(\214nd\(1\))0 24 Q
(command and combining it with other standard utilities,)0 36 Q
(it is possible to e)0 48 Q -.15(xe)-.15 G(rcise v).15 E
(ery \214ne control o)-.15 E -.15(ve)-.15 G 2.5(rw).15 G
(hich \214les are copied.)-2.5 E(This ne)0 60 Q(xt e)-.15 E
(xample copies \214les from)-.15 E( )36 24 Q(This e)0 36 Q
(xample copies \214les from)-.15 E( )36 72 Q 0 Cg EP
%%Page: 58 58
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(The old POSIX.1 standard speci\214ed that only)0
12 Q(\255i,)0 24 Q(\255o,)0 36 Q(and)0 48 Q
(\255p)0 60 Q(were interpreted as command-line options.)0
72 Q 0 Cg EP
%%Page: 59 59
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(Each took a single ar)0 12 Q
(gument of a list of modi\214er)-.18 E(characters.)0 24 Q -.15(Fo)0 36 S
2.5(re).15 G(xample, the standard syntax allo)-2.65 E(ws)-.25 E
(\255imu)0 48 Q -.2(bu)0 60 S 2.5(td).2 G(oes not support)
-2.5 E(\255miu)0 72 Q 0 Cg EP
%%Page: 60 60
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(or)0 12 Q
(\255i \255m \255u,)0 24 Q
(since)0 36 Q(m)0 48 Q(and)0 60 Q(u)0 72 Q 0
Cg EP
%%Page: 61 61
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(are only modi\214ers to)0 12 Q
(\255i,)0 24 Q(the)0 36 Q 2.5(ya)-.15 G
(re not command-line options in their o)-2.5 E(wn right.)-.25 E
(The syntax supported by this implementation is backw)0 48 Q
(ards-compatible)-.1 E(with the standard.)0 60 Q -.15(Fo)0 72 S 2.5(rb)
.15 G(est compatibility)-2.5 E 2.5(,s)-.65 G
(cripts should limit themselv)-2.5 E(es to the)-.15 E 0 Cg EP
%%Page: 62 62
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(standard syntax.)0 12 Q( )36 48 Q
(The cpio, ustar)0 60 Q 2.5(,a)-.4 G
(nd pax interchange \214le formats are de\214ned by)-2.5 E
(IEEE Std 1003.1-2001 \(`)2.5 72 Q(`POSIX.1')-.74
E('\))-.74 E 0 Cg EP
%%Page: 66 66
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(for the pax command.)0 12 Q( )36 24 Q
(This is a complete re-implementation based on the)0 36 Q
(libarchi).15 E
-.15(ve)-.25 G(\(3\)).15 E(library)0 60 Q(.)-.65 E( BSDCPIO(1) FreeBSD General Commands Manual
BSDCPIO(1) NAME cpio — copy files
to and from archives SYNOPSIS cpio {−i}
[options] [pattern ...]
[< archive] DESCRIPTION cpio copies files between
archives and directories. This implementation can extract
from tar, pax, cpio, zip, jar, ar, and ISO 9660 cdrom images
and can create tar, pax, cpio, ar, and shar archives. The first option
to cpio is a mode indicator from the following
list: −i Input. Read an
archive from standard input (unless overriden) and extract
the contents to disk or (if the −t option is
specified) list the contents to standard output. If one or
more file patterns are specified, only files matching one of
the patterns will be extracted. −o Output. Read a
list of filenames from standard input and produce a new
archive on standard output (unless overriden) containing the
specified items. −p Pass-through.
Read a list of filenames from standard input and copy the
files to the specified directory. OPTIONS Unless specifically stated
otherwise, options are applicable in all operating
modes. −0 Read filenames
separated by NUL characters instead of newlines. This is
necessary if any of the filenames being read might contain
newlines. −A (o mode only)
Append to the specified archive. (Not yet implemented.) −a (o and p modes)
Reset access times on files after they are read. −B (o mode only)
Block output to records of 5120 bytes. −C
size (o mode only) Block output to
records of size bytes. −c (o mode only)
Use the old POSIX portable character format. Equivalent to
−-format odc. −d (i and p modes)
Create directories as necessary. −E
file (i mode only) Read list of file
name patterns from file to list and extract. −F
file Read archive from or write
archive to file. −f
pattern (i mode only) Ignore files that
match pattern. −-format
format (o mode only) Produce the
output archive in the specified format. Supported formats
include: cpio Synonym for
odc. newc The SVR4
portable cpio format. odc The old POSIX.1
portable octet-oriented cpio format. pax The POSIX.1 pax
format, an extension of the ustar format. ustar The POSIX.1 tar
format. The default
format is odc. See libarchive_formats(5) for more
complete information about the formats currently supported
by the underlying libarchive(3) library. −H
format Synonym for
−-format. −h,
−-help Print usage information. −I
file Read archive from
file. −i Input mode. See
above for description. −-insecure (i and p mode only) Disable
security checks during extraction or copying. This allows
extraction via symbolic links and path names containing
‘..’ in the name. −J (o mode only)
Compress the file with xz-compatible compression before
writing it. In input mode, this option is ignored; xz
compression is recognized automatically on input. −j Synonym for
−y. −L (o and p modes)
All symbolic links will be followed. Normally, symbolic
links are archived and copied as symbolic links. With this
option, the target of the link will be archived or copied
instead. −l (p mode only)
Create links from the target directory to the original
files, instead of copying. −lzma (o mode only)
Compress the file with lzma-compatible compression before
writing it. In input mode, this option is ignored; lzma
compression is recognized automatically on input. −m (i and p modes)
Set file modification time on created files to match those
in the source. −n (i mode, only
with −t) Display numeric uid and gid. By
default, cpio displays the user and group names when
they are provided in the archive, or looks up the user and
group names in the system password database. −no-preserve-owner (i mode only) Do not attempt to
restore file ownership. This is the default when run by
non-root users. −O
file Write archive to
file. −o Output mode.
See above for description. −p Pass-through
mode. See above for description. −preserve-owner (i mode only) Restore file
ownership. This is the default when run by the root
user. −-quiet Suppress unnecessary
messages. −R [
Set the owner and/or group on
files in the output. If group is specified with no user (for
example, −R :wheel) then the group will
be set but not the user. If the user is specified with a
trailing colon and no group (for example, −R
root:) then the group will be set to the user’s
default group. If the user is specified with no trailing
colon, then the user will be set but not the group. In
−i and −p modes, this option can
only be used by the super-user. (For compatibility, a period
can be used in place of the colon.) −r (All modes.)
Rename files interactively. For each file, a prompt is
written to /dev/tty containing the name of the file
and a line is read from /dev/tty. If the line read is
blank, the file is skipped. If the line contains a single
period, the file is processed normally. Otherwise, the line
is taken to be the new name of the file. −t (i mode only)
List the contents of the archive to stdout; do not restore
the contents to disk. −u (i and p modes)
Unconditionally overwrite existing files. Ordinarily, an
older file will not overwrite a newer file on disk. −v Print the name
of each file to stderr as it is processed. With
−t, provide a detailed listing of each
file. −-version Print the program version
information and exit. −y (o mode only)
Compress the archive with bzip2-compatible compression
before writing it. In input mode, this option is ignored;
bzip2 compression is recognized automatically on input. −Z (o mode only)
Compress the archive with compress-compatible compression
before writing it. In input mode, this option is ignored;
compression is recognized automatically on input. −z (o mode only)
Compress the archive with gzip-compatible compression before
writing it. In input mode, this option is ignored; gzip
compression is recognized automatically on input. ENVIRONMENT The following environment
variables affect the execution of cpio: LANG The locale to
use. See environ(7) for more information. TZ The timezone to
use when displaying dates. See environ(7) for more
information. EXIT
STATUS The cpio utility
exits 0 on success, and >0 if an error
occurs. EXAMPLES The cpio command is
traditionally used to copy file heirarchies in conjunction
with the find(1) command. The first example here simply
copies all files from src to dest: find src |
cpio −pmud dest By carefully
selecting options to the find(1) command and combining it
with other standard utilities, it is possible to exercise
very fine control over which files are copied. This next
example copies files from src to dest that are
more than 2 days old and whose names match a particular
pattern: find src
−mtime +2 | grep foo[bar] |
cpio −pdmu dest This example
copies files from src to dest that are more
than 2 days old and which contain the word
‘‘ foobar ’’: find src
−mtime +2 | xargs grep -l foobar
| cpio −pdmu dest COMPATIBILITY The mode options i, o, and p and
the options a, B, c, d, f, l, m, r, t, u, and v comply with
SUSv2. The old POSIX.1
standard specified that only −i,
−o, and −p were interpreted as
command-line options. Each took a single argument of a list
of modifier characters. For example, the standard syntax
allows −imu but does not support
−miu or −i −m −u,
since m and u are only modifiers to
−i, they are not command-line options in their
own right. The syntax supported by this implementation is
backwards-compatible with the standard. For best
compatibility, scripts should limit themselves to the
standard syntax. SEE ALSO bzip2(1), tar(1), gzip(1),
mt(1), pax(1), libarchive(3), cpio(5),
libarchive-formats(5), tar(5) STANDARDS There is no current POSIX
standard for the cpio command; it appeared in ISO/IEC
9945-1:1996 (‘‘POSIX.1’’) but was
dropped from IEEE Std 1003.1-2001
(‘‘POSIX.1’’). The cpio, ustar,
and pax interchange file formats are defined by IEEE Std
1003.1-2001 (‘‘POSIX.1’’) for the
pax command. HISTORY The original cpio and
find utilities were written by Dick Haight while
working in AT&T’s Unix Support Group. They first
appeared in 1977 in PWB/UNIX 1.0, the
‘‘Programmer’s Work Bench’’
system developed for use within AT&T. They were first
released outside of AT&T as part of System III Unix in
1981. As a result, cpio actually predates tar,
even though it was not well-known outside of AT&T until
some time later. This is a
complete re-implementation based on the libarchive(3)
library. BUGS The cpio archive format has
several basic limitations: It does not store user and group
names, only numbers. As a result, it cannot be reliably used
to transfer files between systems with dissimilar user and
group numbering. Older cpio formats limit the user and group
numbers to 16 or 18 bits, which is insufficient for modern
systems. The cpio archive formats cannot support files over
4 gigabytes, except for the ‘‘odc’’
variant, which can support files up to 8 gigabytes. FreeBSD 9.0
December 21, 2007 FreeBSD 9.0 )36 24 Q(The \214rst option to)0 36 Q(cpio)0 48 Q
(is a mode indicator from the follo)0 60 Q(wing list:)-.25 E
( )36 12 Q( )36 24 Q
( )36 48 Q(The def)0 60 Q
(ault format is)-.1 E(odc.)0 72 Q 0 Cg EP
%%Page: 24 24
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(See)0 12 Q(libarchi).15 E -.15(ve)-.25 G
(_formats\(5\)).15 E(for more complete information about the)0 36 Q
(formats currently supported by the underlying)0 48 Q
(libarchi).15 E
-.15(ve)-.25 G(\(3\)).15 E(library)0 72 Q(.)-.65 E 0 Cg EP
%%Page: 25 25
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF
( )36 72 Q 0 Cg EP
%%Page: 53 53
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(By carefully selecting options to the)0 12 Q
(\214nd\(1\))0 24 Q
(command and combining it with other standard utilities,)0 36 Q
(it is possible to e)0 48 Q -.15(xe)-.15 G(rcise v).15 E
(ery \214ne control o)-.15 E -.15(ve)-.15 G 2.5(rw).15 G
(hich \214les are copied.)-2.5 E(This ne)0 60 Q(xt e)-.15 E
(xample copies \214les from)-.15 E( )36 24 Q(This e)0 36 Q
(xample copies \214les from)-.15 E( )36 72 Q 0 Cg EP
%%Page: 58 58
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(The old POSIX.1 standard speci\214ed that only)0
12 Q(\255i,)0 24 Q(\255o,)0 36 Q(and)0 48 Q
(\255p)0 60 Q(were interpreted as command-line options.)0
72 Q 0 Cg EP
%%Page: 59 59
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(Each took a single ar)0 12 Q
(gument of a list of modi\214er)-.18 E(characters.)0 24 Q -.15(Fo)0 36 S
2.5(re).15 G(xample, the standard syntax allo)-2.65 E(ws)-.25 E
(\255imu)0 48 Q -.2(bu)0 60 S 2.5(td).2 G(oes not support)
-2.5 E(\255miu)0 72 Q 0 Cg EP
%%Page: 60 60
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(or)0 12 Q
(\255i \255m \255u,)0 24 Q
(since)0 36 Q(m)0 48 Q(and)0 60 Q(u)0 72 Q 0
Cg EP
%%Page: 61 61
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(are only modi\214ers to)0 12 Q
(\255i,)0 24 Q(the)0 36 Q 2.5(ya)-.15 G
(re not command-line options in their o)-2.5 E(wn right.)-.25 E
(The syntax supported by this implementation is backw)0 48 Q
(ards-compatible)-.1 E(with the standard.)0 60 Q -.15(Fo)0 72 S 2.5(rb)
.15 G(est compatibility)-2.5 E 2.5(,s)-.65 G
(cripts should limit themselv)-2.5 E(es to the)-.15 E 0 Cg EP
%%Page: 62 62
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(standard syntax.)0 12 Q( )36 48 Q
(The cpio, ustar)0 60 Q 2.5(,a)-.4 G
(nd pax interchange \214le formats are de\214ned by)-2.5 E
(IEEE Std 1003.1-2001 \(`)2.5 72 Q(`POSIX.1')-.74
E('\))-.74 E 0 Cg EP
%%Page: 66 66
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(for the pax command.)0 12 Q( )36 24 Q
(This is a complete re-implementation based on the)0 36 Q
(libarchi).15 E
-.15(ve)-.25 G(\(3\)).15 E(library)0 60 Q(.)-.65 E( CPIO(1) BSD General Commands Manual CPIO(1) NAME cpio — copy files
to and from archives SYNOPSIS cpio −i
[options] [pattern ...]
[< archive] DESCRIPTION cpio copies files between
archives and directories. This implementation can extract
from tar, pax, cpio, zip, jar, ar, and ISO 9660 cdrom images
and can create tar, pax, cpio, ar, and shar archives. The first option
to cpio is a mode indicator from the following
list: −i Input. Read an
archive from standard input (unless overridden) and extract
the contents to disk or (if the −t option is
specified) list the contents to standard output. If one or
more file patterns are specified, only files matching one of
the patterns will be extracted. −o Output. Read a
list of filenames from standard input and produce a new
archive on standard output (unless overridden) containing
the specified items. −p Pass-through.
Read a list of filenames from standard input and copy the
files to the specified directory. OPTIONS Unless specifically stated
otherwise, options are applicable in all operating
modes. −0,
−−null Read filenames separated by NUL
characters instead of newlines. This is necessary if any of
the filenames being read might contain newlines. −A (o mode only)
Append to the specified archive. (Not yet implemented.) −a (o and p modes)
Reset access times on files after they are read. −B (o mode only)
Block output to records of 5120 bytes. −C size (o mode only) Block output to
records of size bytes. −c (o mode only)
Use the old POSIX portable character format. Equivalent to
−−format odc. −d,
−−make-directories (i and p modes) Create
directories as necessary. −E file (i mode only) Read list of file
name patterns from file to list and extract. −F file,
−−file file Read archive from or write
archive to file. −f
pattern (i mode only) Ignore files that
match pattern. −H format,
−−format format (o mode only) Produce the
output archive in the specified format. Supported formats
include: cpio Synonym for
odc. newc The SVR4
portable cpio format. odc The old POSIX.1
portable octet-oriented cpio format. pax The POSIX.1 pax
format, an extension of the ustar format. ustar The POSIX.1 tar
format. The default
format is odc. See libarchive-formats(5) for more
complete information about the formats currently supported
by the underlying libarchive(3) library. −h,
−−help Print usage information. −I file Read archive from
file. −i,
−−extract Input mode. See above for
description. −−insecure (i and p mode only) Disable
security checks during extraction or copying. This allows
extraction via symbolic links, absolute paths, and path
names containing ’..’ in the name. −J,
−−xz (o mode only) Compress the file
with xz-compatible compression before writing it. In input
mode, this option is ignored; xz compression is recognized
automatically on input. −j Synonym for
−y. −L (o and p modes)
All symbolic links will be followed. Normally, symbolic
links are archived and copied as symbolic links. With this
option, the target of the link will be archived or copied
instead. −l,
−−link (p mode only) Create links from
the target directory to the original files, instead of
copying. −−lrzip (o mode only) Compress the
resulting archive with lrzip(1). In input mode, this option
is ignored. −−lz4 (o mode only)
Compress the archive with lz4-compatible compression before
writing it. In input mode, this option is ignored; lz4
compression is recognized automatically on input. −−lzma (o mode only)
Compress the file with lzma-compatible compression before
writing it. In input mode, this option is ignored; lzma
compression is recognized automatically on input. −−lzop (o mode only)
Compress the resulting archive with lzop(1). In input mode,
this option is ignored. −−passphrase
passphrase The passphrase is used
to extract or create an encrypted archive. Currently, zip is
only a format that cpio can handle encrypted
archives. You shouldn’t use this option unless you
realize how insecure use of this option is. −m,
−−preserve-modification-time (i and p modes) Set file
modification time on created files to match those in the
source. −n,
−−numeric-uid-gid (i mode, only with
−t) Display numeric uid and gid. By default,
cpio displays the user and group names when they are
provided in the archive, or looks up the user and group
names in the system password database. −−no-preserve-owner (i mode only) Do not attempt to
restore file ownership. This is the default when run by
non-root users. −O file Write archive to
file. −o,
−−create Output mode. See above for
description. −p,
−−pass-through Pass-through mode. See above
for description. −−preserve-owner (i mode only) Restore file
ownership. This is the default when run by the root
user. −−quiet Suppress unnecessary
messages. −R [ Set the owner and/or group on
files in the output. If group is specified with no user (for
example, −R :wheel) then the group will
be set but not the user. If the user is specified with a
trailing colon and no group (for example, −R
root:) then the group will be set to the user’s
default group. If the user is specified with no trailing
colon, then the user will be set but not the group. In
−i and −p modes, this option can
only be used by the super-user. (For compatibility, a period
can be used in place of the colon.) −r (All modes.)
Rename files interactively. For each file, a prompt is
written to /dev/tty containing the name of the file
and a line is read from /dev/tty. If the line read is
blank, the file is skipped. If the line contains a single
period, the file is processed normally. Otherwise, the line
is taken to be the new name of the file. −t,
−−list (i mode only) List the contents
of the archive to stdout; do not restore the contents to
disk. −u,
−−unconditional (i and p modes) Unconditionally
overwrite existing files. Ordinarily, an older file will not
overwrite a newer file on disk. −V,
−−dot Print a dot to stderr for each
file as it is processed. Superseded by −v. −v,
−−verbose Print the name of each file to
stderr as it is processed. With −t, provide a
detailed listing of each file. −−version Print the program version
information and exit. −y (o mode only)
Compress the archive with bzip2-compatible compression
before writing it. In input mode, this option is ignored;
bzip2 compression is recognized automatically on input. −Z (o mode only)
Compress the archive with compress-compatible compression
before writing it. In input mode, this option is ignored;
compression is recognized automatically on input. −z (o mode only)
Compress the archive with gzip-compatible compression before
writing it. In input mode, this option is ignored; gzip
compression is recognized automatically on input. EXIT STATUS The cpio utility
exits 0 on success, and >0 if an error
occurs. ENVIRONMENT The following environment
variables affect the execution of cpio: LANG The locale to
use. See environ(7) for more information. TZ The timezone to
use when displaying dates. See environ(7) for more
information. EXAMPLES The cpio command is
traditionally used to copy file hierarchies in conjunction
with the find(1) command. The first example here simply
copies all files from src to dest: find src |
cpio −pmud dest By carefully
selecting options to the find(1) command and combining it
with other standard utilities, it is possible to exercise
very fine control over which files are copied. This next
example copies files from src to dest that are
more than 2 days old and whose names match a particular
pattern: find src
−mtime +2 | grep foo[bar] |
cpio −pdmu dest This example
copies files from src to dest that are more
than 2 days old and which contain the word
’’ foobar ’’: find src
−mtime +2 | xargs grep -l foobar
| cpio −pdmu dest COMPATIBILITY The mode options i, o, and p and
the options a, B, c, d, f, l, m, r, t, u, and v comply with
SUSv2. The old POSIX.1
standard specified that only −i,
−o, and −p were interpreted as
command-line options. Each took a single argument of a list
of modifier characters. For example, the standard syntax
allows −imu but does not support
−miu or −i −m −u,
since m and u are only modifiers to
−i, they are not command-line options in their
own right. The syntax supported by this implementation is
backwards-compatible with the standard. For best
compatibility, scripts should limit themselves to the
standard syntax. SEE ALSO bzip2(1), tar(1), gzip(1),
mt(1), pax(1), libarchive(3), cpio(5),
libarchive-formats(5), tar(5) STANDARDS There is no current POSIX
standard for the cpio command; it appeared in ISO/IEC
9945-1:1996 (’’POSIX.1’’) but was
dropped from IEEE Std 1003.1-2001
(’’POSIX.1’’). The cpio, ustar,
and pax interchange file formats are defined by IEEE Std
1003.1-2001 (’’POSIX.1’’) for the
pax command. HISTORY The original cpio and
find utilities were written by Dick Haight while
working in AT&T’s Unix Support Group. They first
appeared in 1977 in PWB/UNIX 1.0, the
’’Programmer’s Work Bench’’
system developed for use within AT&T. They were first
released outside of AT&T as part of System III Unix in
1981. As a result, cpio actually predates tar,
even though it was not well-known outside of AT&T until
some time later. This is a
complete re-implementation based on the libarchive(3)
library. BUGS The cpio archive format has
several basic limitations: It does not store user and group
names, only numbers. As a result, it cannot be reliably used
to transfer files between systems with dissimilar user and
group numbering. Older cpio formats limit the user and group
numbers to 16 or 18 bits, which is insufficient for modern
systems. The cpio archive formats cannot support files over
4 gigabytes, except for the ’’odc’’
variant, which can support files up to 8 gigabytes. BSD
September 16, 2014 BSDsrc)0 72 Q
0 Cg EP
%%Page: 54 54
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(to)0 12 Q(dest)0 24 Q
(that are more than 2 days old and whose names match a particular patte\
rn:)0 36 Q(
)0 48 Q( )0 60 Q(src \255mtime\
+2 |grep foo[bar] |Fl\
pdmu dest)0 72 Q 0 Cg EP
%%Page: 55 55
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(
)0 12 Q(src)0 48 Q
(to)0 60 Q(dest)0 72 Q 0 Cg EP
%%Page: 56 56
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF
(that are more than 2 days old and which contain the w)0 12 Q(ord)-.1 E
(foobar`)0 24 Q(`.blm Pp: ')-.74 E(')-.74 E(
)0 36 Q
( )0 48 Q(\214nd\
src \255mtime +2<\
i> |xar)0 60 Q(gsgrep -l foobar |Fl pdmu dest)-.18 E(
)0 72 Q
0 Cg EP
%%Page: 57 57
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF()
1.11 E(COMP)36 24 Q -1.11(AT)-.92 G(IBILITY)1.11 E(
)36 36 Q
(The mode options i, o, and p and the options)0 48 Q
(a, B, c, d, f, l, m, r)0 60 Q 2.5(,t)-.4 G 2.5(,u)-2.5 G 2.5(,a)-2.5 G
(nd v comply with SUSv2.)-2.5 E()36 24
Q(SEE ALSO)36 36 Q(
)36 48 Q
(bzip2\(1\),)0 60 Q
(tar\(1\),)-.55 E 0 Cg EP
%%Page: 63 63
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(gzip\(1\),)0 12
Q(mt\(1\),)0 24 Q
(pax\(1\),)0 36 Q
(libarchi).15 E
-.15(ve)-.25 G(\(3\),).15 E
(cpio\(5\),)0 60 Q
(libarchi).15 E -.15(ve)-.25 G(-formats\(5\),).15 E 0
Cg EP
%%Page: 64 64
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(tar\(5\))-.55 E()-.4 E
(ST)36 36 Q(AND)-.93 E(ARDS)-.4 E(
)36 48 Q
(There is no current POSIX standard for the cpio command; it appeared)0
60 Q(in)0 72 Q 0 Cg EP
%%Page: 65 65
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(ISO/IEC 9945-1:1996 \(`)2.5 12 Q
(`POSIX.1')-.74 E('\))-.74 E -.2(bu)0 24 S 2.5
(tw).2 G(as dropped from)-2.6 E(IEEE Std 1003.1-2001 \(`)2.5 36 Q
(`POSIX.1')-.74 E('\) .)-.74 E()-.65 E(HIST)36 36 Q(OR)-.18 E(Y)-.65 E(
)36 48 Q
(The original)0 60 Q(cpio)0 72 Q 0 Cg EP
%%Page: 67 67
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(and)0 12 Q(\214nd)0 24 Q
(utilities were written by Dick Haight)0 36 Q(while w)0 48 Q
(orking in A)-.1 E(T&T')-1.11 E 2.5(sU)-.55 G(nix Support Group.)-2.5 E
(The)0 60 Q 2.5<798c>-.15 G(rst appeared in 1977 in PWB/UNIX 1.0, the)
-2.5 E -.74(``)0 72 S(Programmer').74 E 2.5(sW)-.55 G(ork Bench')-3.3 E
(')-.74 E 0 Cg EP
%%Page: 68 68
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(system de)0 12 Q -.15(ve)-.25 G
(loped for use within A).15 E(T&T)-1.11 E(.)-.74 E(The)0 24 Q 2.5(yw)
-.15 G(ere \214rst released outside of A)-2.5 E
(T&T as part of System III Unix in 1981.)-1.11 E(As a result,)0 36 Q
(cpio)0 48 Q(actually predates)0 60 Q(tar,)0 72 Q 0 Cg EP
%%Page: 69 69
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF -2.15 -.25(ev e)0 12 T 2.5(nt).25 G(hough it w)
-2.5 E(as not well-kno)-.1 E(wn outside of A)-.25 E
(T&T until some time later)-1.11 E(.)-.55 E()-.1 E 0 Cg EP
%%Page: 70 70
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF -.1(BU)36 12 S(GS).1 E(
)36 24 Q
(The cpio archi)0 36 Q .3 -.15(ve f)-.25 H(ormat has se).15 E -.15(ve)
-.25 G(ral basic limitations:).15 E
(It does not store user and group names, only numbers.)0 48 Q
(As a result, it cannot be reliably used to transfer)0 60 Q
(\214les between systems with dissimilar user and group numbering.)0 72
Q 0 Cg EP
%%Page: 71 71
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF
(Older cpio formats limit the user and group numbers to)0 12 Q
(16 or 18 bits, which is insuf)0 24 Q(\214cient for modern systems.)-.25
E(The cpio archi)0 36 Q .3 -.15(ve f)-.25 H
(ormats cannot support \214les o).15 E -.15(ve)-.15 G 2.5(r4g).15 G(ig)
-2.5 E(abytes,)-.05 E -.15(ex)0 48 S(cept for the).15 E -.74(``)0 60 S
(odc').74 E(')-.74 E -.25(va)0 72 S
(riant, which can support \214les up to 8 gig).25 E(abytes.)-.05 E 0 Cg
EP
%%Page: 72 72
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF()0 12 Q()0 24 Q 0 Cg EP
%%Trailer
end
%%EOF
@
1.1.1.3
log
@libarchive-2.8.3: Build fix for Linux
@
text
@d1 890
a890 519
cpio {−o} [options] <
name-list [> archive]
cpio {−p} [options] dest-dir <
name-list
user][
:][
group]
@
1.1.1.4
log
@Import libarchive-2.8.4:
- Improved reliability of hash function detection
- Fix issues on ancient FreeBSD, QNX, ancient NetBSD and Minix
@
text
@d1 519
a519 890
%!PS-Adobe-3.0
%%Creator: groff version 1.19.2
%%CreationDate: Wed Jun 30 11:55:54 2010
%%DocumentNeededResources: font Times-Roman
%%DocumentSuppliedResources: procset grops 1.19 2
%%Pages: 72
%%PageOrder: Ascend
%%DocumentMedia: Default 612 792 0 () ()
%%Orientation: Portrait
%%EndComments
%%BeginDefaults
%%PageMedia: Default
%%EndDefaults
%%BeginProlog
%%BeginResource: procset grops 1.19 2
%!PS-Adobe-3.0 Resource-ProcSet
/setpacking where{
pop
currentpacking
true setpacking
}if
/grops 120 dict dup begin
/SC 32 def
/A/show load def
/B{0 SC 3 -1 roll widthshow}bind def
/C{0 exch ashow}bind def
/D{0 exch 0 SC 5 2 roll awidthshow}bind def
/E{0 rmoveto show}bind def
/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
/G{0 rmoveto 0 exch ashow}bind def
/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/I{0 exch rmoveto show}bind def
/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
/K{0 exch rmoveto 0 exch ashow}bind def
/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/M{rmoveto show}bind def
/N{rmoveto 0 SC 3 -1 roll widthshow}bind def
/O{rmoveto 0 exch ashow}bind def
/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/Q{moveto show}bind def
/R{moveto 0 SC 3 -1 roll widthshow}bind def
/S{moveto 0 exch ashow}bind def
/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/SF{
findfont exch
[exch dup 0 exch 0 exch neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/MF{
findfont
[5 2 roll
0 3 1 roll
neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/level0 0 def
/RES 0 def
/PL 0 def
/LS 0 def
/MANUAL{
statusdict begin/manualfeed true store end
}bind def
/PLG{
gsave newpath clippath pathbbox grestore
exch pop add exch pop
}bind def
/BP{
/level0 save def
1 setlinecap
1 setlinejoin
72 RES div dup scale
LS{
90 rotate
}{
0 PL translate
}ifelse
1 -1 scale
}bind def
/EP{
level0 restore
showpage
}def
/DA{
newpath arcn stroke
}bind def
/SN{
transform
.25 sub exch .25 sub exch
round .25 add exch round .25 add exch
itransform
}bind def
/DL{
SN
moveto
SN
lineto stroke
}bind def
/DC{
newpath 0 360 arc closepath
}bind def
/TM matrix def
/DE{
TM currentmatrix pop
translate scale newpath 0 0 .5 0 360 arc closepath
TM setmatrix
}bind def
/RC/rcurveto load def
/RL/rlineto load def
/ST/stroke load def
/MT/moveto load def
/CL/closepath load def
/Fr{
setrgbcolor fill
}bind def
/setcmykcolor where{
pop
/Fk{
setcmykcolor fill
}bind def
}if
/Fg{
setgray fill
}bind def
/FL/fill load def
/LW/setlinewidth load def
/Cr/setrgbcolor load def
/setcmykcolor where{
pop
/Ck/setcmykcolor load def
}if
/Cg/setgray load def
/RE{
findfont
dup maxlength 1 index/FontName known not{1 add}if dict begin
{
1 index/FID ne{def}{pop pop}ifelse
}forall
/Encoding exch def
dup/FontName exch def
currentdict end definefont pop
}bind def
/DEFS 0 def
/EBEGIN{
moveto
DEFS begin
}bind def
/EEND/end load def
/CNT 0 def
/level1 0 def
/PBEGIN{
/level1 save def
translate
div 3 1 roll div exch scale
neg exch neg exch translate
0 setgray
0 setlinecap
1 setlinewidth
0 setlinejoin
10 setmiterlimit
[]0 setdash
/setstrokeadjust where{
pop
false setstrokeadjust
}if
/setoverprint where{
pop
false setoverprint
}if
newpath
/CNT countdictstack def
userdict begin
/showpage{}def
/setpagedevice{}def
}bind def
/PEND{
countdictstack CNT sub{end}repeat
level1 restore
}bind def
end def
/setpacking where{
pop
setpacking
}if
%%EndResource
%%EndProlog
%%BeginSetup
%%BeginFeature: *PageSize Default
<< /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice
%%EndFeature
%%IncludeResource: font Times-Roman
grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
def/PL 792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron
/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent
/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen
/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon
/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O
/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex
/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y
/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft
/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl
/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen
/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft
/logicalnot/minus/registered/macron/degree/plusminus/twosuperior
/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior
/ordmasculine/guilsinglright/onequarter/onehalf/threequarters
/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE
/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex
/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn
/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla
/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis
/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash
/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def
/Times-Roman@@0 ENC0/Times-Roman RE
%%EndSetup
%%Page: 1 1
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF()0 12 Q()0 24 Q()-.35 E -.35(NA)36 24 S
(ME).35 E(
)36 36 Q(cpio)0 48 Q 2.5(-c)0 60 S(op)-2.5 E 2.5
<798c>-.1 G(les to and from archi)-2.5 E -.15(ve)-.25 G(s).15 E
()36 72 Q 0 Cg EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(SYNOPSIS)36 12 Q(
)36 24 Q(cpio)0 36
Q({\255i})0 48 Q([options])0 60 Q
([pattern ...])0 72 Q 0 Cg EP
%%Page: 6 6
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF([< archi)0 12 Q -.15(ve)-.25 G
(]).15 E(cpio)0 24 Q({\255o})0 36 Q
([options])0 48 Q(< name-list)0 60 Q
([> archi)0 72 Q -.15(ve)-.25 G(]).15 E 0 Cg EP
%%Page: 7 7
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(cpio)0 12 Q({\255p})0 24 Q
([options])0 36 Q(dest-dir)0 48 Q
(< name-list)0 60 Q()36 72 Q 0
Cg EP
%%Page: 8 8
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(DESCRIPTION)36 12 Q(
)36 24 Q(cpio)0
36 Q(copies \214les between archi)0 48 Q -.15(ve)-.25 G 2.5(sa).15 G
(nd directories.)-2.5 E(This implementation can e)0 60 Q
(xtract from tar)-.15 E 2.5(,p)-.4 G(ax, cpio, zip, jar)-2.5 E 2.5(,a)
-.4 G -.4(r,)-2.5 G(and ISO 9660 cdrom images and can create tar)0 72 Q
2.5(,p)-.4 G(ax, cpio, ar)-2.5 E(,)-.4 E 0 Cg EP
%%Page: 9 9
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(and shar archi)0 12 Q -.15(ve)-.25 G(s.).15 E
()0 72 Q 0 Cg EP
%%Page: 10 10
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(
)0 72 Q 0 Cg EP
%%Page: 13 13
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF()36 24 Q(OPTIONS)36
36 Q(
)36 48 Q
(Unless speci\214cally stated otherwise, options are applicable in)0 60
Q(all operating modes.)0 72 Q 0 Cg EP
%%Page: 14 14
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF()0 12 Q
(
)0
48 Q()0 36 Q(
)0 36 Q(/de)0 48 Q
(v/tty)-.25 E
(containing the name of the \214le and a line is read from)0 60 Q
(/de)0 72 Q(v/tty.)-.25 E 0 Cg EP
%%Page: 41 41
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF
(If the line read is blank, the \214le is skipped.)0 12 Q
(If the line contains a single period, the \214le is processed normally)
0 24 Q(.)-.65 E(Otherwise, the line is tak)0 36 Q(en to be the ne)-.1 E
2.5(wn)-.25 G(ame of the \214le.)-2.5 E()-.4 E(ENVIR)36 72 Q(ONMENT)-.4 E 0
Cg EP
%%Page: 47 47
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(
)36 12 Q(The follo)0 24 Q(wing en)-.25 E
(vironment v)-.4 E(ariables af)-.25 E(fect the e)-.25 E -.15(xe)-.15 G
(cution of).15 E(:)0 36 Q()0 48 Q
(
)0 36 Q
(LANGTZ)1.11 E(EXIT ST)36 60 Q
-1.11(AT)-.93 G(US)1.11 E(
)36 72 Q 0 Cg EP
%%Page: 50 50
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF()36 12 Q(EXAMPLES)36 24 Q
(
)36 36 Q(The)0 48 Q(cpio)0 60 Q
(command is traditionally used to cop)0 72 Q 2.5<798c>-.1 G
(le heirarchies in conjunction)-2.5 E 0 Cg EP
%%Page: 51 51
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(with the)0 12 Q
(\214nd\(1\))0 24 Q(command.)0 36 Q
(The \214rst e)0 48 Q(xample here simply copies all \214les from)-.15 E
(src)0 60 Q(to)0 72 Q 0 Cg EP
%%Page: 52 52
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(dest:)0 12 Q(
)0 24
Q( )0 36 Q(\214ndsrc |Fl pmud dest)0 48 Q(
)0 60 Q(src)0 72 Q
0 Cg EP
%%Page: 54 54
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(to)0 12 Q(dest)0 24 Q
(that are more than 2 days old and whose names match a particular patte\
rn:)0 36 Q(
)0 48 Q( )0 60 Q(src \255mtime\
+2 |grep foo[bar] |Fl\
pdmu dest)0 72 Q 0 Cg EP
%%Page: 55 55
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(
)0 12 Q(src)0 48 Q
(to)0 60 Q(dest)0 72 Q 0 Cg EP
%%Page: 56 56
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF
(that are more than 2 days old and which contain the w)0 12 Q(ord)-.1 E
(foobar`)0 24 Q(`.blm Pp: ')-.74 E(')-.74 E(
)0 36 Q
( )0 48 Q(\214nd\
src \255mtime +2<\
i> |xar)0 60 Q(gsgrep -l foobar |Fl pdmu dest)-.18 E(
)0 72 Q
0 Cg EP
%%Page: 57 57
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF()
1.11 E(COMP)36 24 Q -1.11(AT)-.92 G(IBILITY)1.11 E(
)36 36 Q
(The mode options i, o, and p and the options)0 48 Q
(a, B, c, d, f, l, m, r)0 60 Q 2.5(,t)-.4 G 2.5(,u)-2.5 G 2.5(,a)-2.5 G
(nd v comply with SUSv2.)-2.5 E()36 24
Q(SEE ALSO)36 36 Q(
)36 48 Q
(bzip2\(1\),)0 60 Q
(tar\(1\),)-.55 E 0 Cg EP
%%Page: 63 63
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(gzip\(1\),)0 12
Q(mt\(1\),)0 24 Q
(pax\(1\),)0 36 Q
(libarchi).15 E
-.15(ve)-.25 G(\(3\),).15 E
(cpio\(5\),)0 60 Q
(libarchi).15 E -.15(ve)-.25 G(-formats\(5\),).15 E 0
Cg EP
%%Page: 64 64
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(tar\(5\))-.55 E()-.4 E
(ST)36 36 Q(AND)-.93 E(ARDS)-.4 E(
)36 48 Q
(There is no current POSIX standard for the cpio command; it appeared)0
60 Q(in)0 72 Q 0 Cg EP
%%Page: 65 65
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(ISO/IEC 9945-1:1996 \(`)2.5 12 Q
(`POSIX.1')-.74 E('\))-.74 E -.2(bu)0 24 S 2.5
(tw).2 G(as dropped from)-2.6 E(IEEE Std 1003.1-2001 \(`)2.5 36 Q
(`POSIX.1')-.74 E('\) .)-.74 E()-.65 E(HIST)36 36 Q(OR)-.18 E(Y)-.65 E(
)36 48 Q
(The original)0 60 Q(cpio)0 72 Q 0 Cg EP
%%Page: 67 67
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(and)0 12 Q(\214nd)0 24 Q
(utilities were written by Dick Haight)0 36 Q(while w)0 48 Q
(orking in A)-.1 E(T&T')-1.11 E 2.5(sU)-.55 G(nix Support Group.)-2.5 E
(The)0 60 Q 2.5<798c>-.15 G(rst appeared in 1977 in PWB/UNIX 1.0, the)
-2.5 E -.74(``)0 72 S(Programmer').74 E 2.5(sW)-.55 G(ork Bench')-3.3 E
(')-.74 E 0 Cg EP
%%Page: 68 68
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF(system de)0 12 Q -.15(ve)-.25 G
(loped for use within A).15 E(T&T)-1.11 E(.)-.74 E(The)0 24 Q 2.5(yw)
-.15 G(ere \214rst released outside of A)-2.5 E
(T&T as part of System III Unix in 1981.)-1.11 E(As a result,)0 36 Q
(cpio)0 48 Q(actually predates)0 60 Q(tar,)0 72 Q 0 Cg EP
%%Page: 69 69
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF -2.15 -.25(ev e)0 12 T 2.5(nt).25 G(hough it w)
-2.5 E(as not well-kno)-.1 E(wn outside of A)-.25 E
(T&T until some time later)-1.11 E(.)-.55 E()-.1 E 0 Cg EP
%%Page: 70 70
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF -.1(BU)36 12 S(GS).1 E(
)36 24 Q
(The cpio archi)0 36 Q .3 -.15(ve f)-.25 H(ormat has se).15 E -.15(ve)
-.25 G(ral basic limitations:).15 E
(It does not store user and group names, only numbers.)0 48 Q
(As a result, it cannot be reliably used to transfer)0 60 Q
(\214les between systems with dissimilar user and group numbering.)0 72
Q 0 Cg EP
%%Page: 71 71
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF
(Older cpio formats limit the user and group numbers to)0 12 Q
(16 or 18 bits, which is insuf)0 24 Q(\214cient for modern systems.)-.25
E(The cpio archi)0 36 Q .3 -.15(ve f)-.25 H
(ormats cannot support \214les o).15 E -.15(ve)-.15 G 2.5(r4g).15 G(ig)
-2.5 E(abytes,)-.05 E -.15(ex)0 48 S(cept for the).15 E -.74(``)0 60 S
(odc').74 E(')-.74 E -.25(va)0 72 S
(riant, which can support \214les up to 8 gig).25 E(abytes.)-.05 E 0 Cg
EP
%%Page: 72 72
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@@0 SF()0 12 Q()0 24 Q 0 Cg EP
%%Trailer
end
%%EOF
@
1.1.1.5
log
@Import libarchive-3.2.1:
- security fixes and other bugfixes
- support for multhreading in xz 5.2+
@
text
@d1 890
a890 522
cpio −o [options] < name-list
[> archive]
cpio −p [options] dest-dir <
name-list
user][
:][
group], −−owner [
user][
:][
group]
@
1.1.1.6
log
@Import libarchive-3.3.1.
@
text
@d2 1
a2 1
d194 1
a194 1
names containing ‘..’ in the name.
cpio -i [options]
[pattern ...] [< archive]
cpio -o [options] < name-list
d37 1
a37 1
cpio -p
-i
d55 1 a55 1 the contents to disk or (if the -t option is d60 1 a60 1-o
d67 1 a67 1-p
d79 2 a80 1-0, --null
d86 1 a86 1-A
d91 1 a91 1-a
d96 1 a96 1-B
d101 1 a101 1-C size
d106 1 a106 1-c
d110 1 a110 1 --format odc. d112 2 a113 2-d, --make-directories
d118 1 a118 1-E file
d123 2 a124 2-F file, --file file
d129 2 a130 1-f pattern
d135 2 a136 2-H format, --format format
d172 2 a173 1-h, --help
d177 1 a177 1-I file
d182 2 a183 1-i, --extract
d188 2 a189 1--insecure
d194 1 a194 1 names containing ’..’ in the name. d196 2 a197 1-J, --xz
d204 1 a204 1-j
d207 1 a207 1 -y. d209 1 a209 1-L
d217 2 a218 1-l, --link
d224 1 a224 1--lrzip
d230 1 a230 1--lz4
d237 1 a237 1--lzma
d244 1 a244 1--lzop
d250 1 a250 1--passphrase d259 2 a260 2
-m, --preserve-modification-time
d266 8 a273 2-n, --numeric-uid-gid
a274 5(i mode, only with -t) Display numeric uid and gid. By default, cpio displays the user and group names when they are provided in the archive, or looks up the user and group names in the system password database.
d276 1 a276 1--no-preserve-owner
d282 1 a282 1-O file
d287 2 a288 1-o, --create
d293 2 a294 2-p, --pass-through
d299 2 a300 1--preserve-owner
d306 1 a306 1--quiet
d311 1 a311 1-R [
d314 1
a314 1
group], --owner [
d321 9
a329 9
example, -R :wheel) then the group will be set
but not the user. If the user is specified with a trailing
colon and no group (for example, -R root:)
then the group will be set to the user’s default
group. If the user is specified with no trailing colon, then
the user will be set but not the group. In -i and
-p modes, this option can only be used by the
super-user. (For compatibility, a period can be used in
place of the colon.)
-r
d341 2 a342 1-t, --list
d348 2 a349 2-u, --unconditional
d355 2 a356 1-V, --dot
d359 1 a359 1 file as it is processed. Superseded by -v. d361 2 a362 1-v, --verbose
d365 1 a365 1 stderr as it is processed. With -t, provide a d368 2 a369 1--version
d374 1 a374 1-y
d381 1 a381 1-Z
d388 1 a388 1-z
d425 1 a425 1 cpio -pmud dest d436 2 a437 2 -mtime +2 | grep foo[bar] | cpio -pdmu dest d442 1 a442 1 ’’ d447 2 a448 2 -mtime +2 | xargs grep -l foobar | cpio -pdmu dest d457 12 a468 10 standard specified that only -i, -o, and -p were interpreted as command-line options. Each took a single argument of a list of modifier characters. For example, the standard syntax allows -imu but does not support -miu or -i -m -u, since m and u are only modifiers to -i, they are not command-line options in their own right. The syntax supported by this implementation is backwards-compatible with the standard. For best compatibility, scripts should limit themselves to the standard syntax. d480 1 a480 1 9945-1:1996 (’’POSIX.1’’) but was d482 1 a482 1 (’’POSIX.1’’). d486 1 a486 1 1003.1-2001 (’’POSIX.1’’) for the d495 1 a495 1 ’’Programmer’s Work Bench’’ d515 1 a515 1 4 gigabytes, except for the ’’odc’’ @ 1.1.1.8 log @Import libarchive-3.3.3 as should have done originally. @ text @d2 1 a2 1 a228 7--zstd
(o mode only) Compress the archive with zstd-compatible compression before writing it. In input mode, this option is ignored; zstd compression is recognized automatically on input.
@ 1.1.1.9 log @Import libarchive 3.4.0 @ text @d1 2 a2 2 d433 2 a434 1 than 2 days old and which contain the word “ d436 1 a436 1foobar ”:
d470 3 a472 2 9945-1:1996 (“POSIX.1”) but was dropped from IEEE Std 1003.1-2001 (“POSIX.1”). d476 2 a477 1 1003.1-2001 (“POSIX.1”) for the pax command. d485 6 a490 6 “Programmer’s Work Bench” system developed for use within AT&T. They were first released outside of AT&T as part of System III Unix in 1981. As a result, cpio actually predates tar, even though it was not well-known outside of AT&T until some time later. d505 2 a506 2 4 gigabytes, except for the “odc” variant, which can support files up to 8 gigabytes. @ 1.1.1.10 log @Import libarchive 3.7.2 @ text @d2 1 a2 1 a83 12-6, --pwb
When reading a binary format archive, assume it’s the earlier one, from the PWB variant of 6th Edition UNIX. When writing a cpio archive, use the PWB format.
-7, --binary
(o mode only) When writing a cpio archive, use the (newer, non-PWB) binary format.
d461 2 a462 2bzip2(1), gzip(1), mt(1), pax(1), tar(1), libarchive(3), cpio(5), @ 1.1.1.11 log @libarchive: import version 3.7.3 @ text @d2 1 a2 1 @ 1.1.1.12 log @Libarchive 3.7.4 is a bugfix and security release Security fixes: rar: Fix OOB in rar e8 filter (CVE-2024-26256) zip: Fix out of boundary access Important bugfixes: 7zip: Limit amount of properties bsdtar: Fix error handling around strtol() usages passphrase: Improve newline handling on Windows passphrase: Never allow empty passwords rar: Fix "File CRC Error" when extracting specific rar4 archives xar: Avoid infinite link loop zip: Update AppleDouble support for directories zstd: Implement core detection @ text @d2 1 a2 1 @ 1.1.1.13 log @libarchive: imported version 3.7.5 Libarchive 3.7.5 Security fixes: fix multiple vulnerabilities identified by SAST cpio: ignore out-of-range gid/uid/size/ino and harden AFIO parsing lzop: prevent integer overflow rar4: protect copy_from_lzss_window_to_unp() rar4: fix CVE-2024-26256 rar4: fix OOB in delta and audio filter rar4: fix out of boundary access with large files rar4: add boundary checks to rgb filter rar4: fix OOB access with unicode filenames rar5: clear 'data ready' cache on window buffer reallocs rpm: calculate huge header sizes correctly unzip: unify EOF handling util: fix out of boundary access in mktemp functions uu: stop processing if lines are too long Important bugfixes: 7zip: fix issue when skipping first file in 7zip archive that is a multiple of 65536 bytes ar: fix archive entries having no type lha: do not allow negative file sizes lha: fix integer truncation on 32-bit systems shar: check strdup return value rar5: don't try to read rediculously long names xar: fix another infinite loop and expat error handling many Windows fixes, cleanups and improvements @ text @d2 1 a2 1 @ 1.1.1.14 log @libarchove: import version 3.7.7 @ text @d1 2 a2 2 d23 1 a23 2
CPIO(1) General Commands Manual CPIO(1)
d27 2 a28 2cpio — copy files to and from archives
d32 1 a32 1cpio -i [options] d41 1 a41 1
cpio copies files between d46 1 a46 1
The first option d52 1 a52 1
Input. Read an d61 1 a61 1
Output. Read a d68 1 a68 1
Pass-through. d74 1 a74 1
Unless specifically stated d80 1 a80 1
Read filenames separated by NUL d86 1 a86 1
When reading a binary format d93 1 a93 1
(o mode only) When writing a d98 1 a98 1
(o mode only) d103 1 a103 1
(o and p modes) d108 1 a108 1
(o mode only) d113 1 a113 1
(o mode only) Block output to d118 1 a118 1
(o mode only) d125 1 a125 1
(i and p modes) Create d130 1 a130 1
(i mode only) Read list of file d136 1 a136 1
Read archive from or write d141 1 a141 1
(i mode only) Ignore files that d147 1 a147 1
(o mode only) Produce the d153 1 a153 1
Synonym for d158 1 a158 1
The SVR4 d163 1 a163 1
The old POSIX.1 d168 1 a168 1
The POSIX.1 pax d173 1 a173 1
The POSIX.1 tar d176 4 a179 5
The default format is odc. See libarchive-formats(5) for more complete information about the formats currently supported by the underlying libarchive(3) library.
d183 1 a183 1Print usage information.
d187 1 a187 1Read archive from d192 1 a192 1
Input mode. See above for d197 1 a197 1
(i and p mode only) Disable d200 1 a200 1 names containing ‘..’ in the name.
d204 1 a204 1(o mode only) Compress the file d211 1 a211 1
Synonym for d216 1 a216 1
(o and p modes) d224 1 a224 1
(p mode only) Create links from d230 3 a232 3
(o mode only) Compress the resulting archive with lrzip(1). In input mode, this option is ignored.
d236 1 a236 1(o mode only) d243 1 a243 1
(o mode only) d250 1 a250 1
(o mode only) d257 3 a259 3
(o mode only) Compress the resulting archive with lzop(1). In input mode, this option is ignored.
d264 1 a264 1The passphrase is used d273 1 a273 1
(i and p modes) Set file d280 1 a280 1
(i mode, only with -t) d288 1 a288 1
(i mode only) Do not attempt to d294 1 a294 1
Write archive to d299 1 a299 1
Output mode. See above for d305 1 a305 1
Pass-through mode. See above d310 1 a310 1
(i mode only) Restore file d316 1 a316 1
Suppress unnecessary d327 1 a327 1
Set the owner and/or group on d341 1 a341 1
(All modes.) d351 1 a351 1
(i mode only) List the contents d358 1 a358 1
(i and p modes) Unconditionally d364 1 a364 1
Print a dot to stderr for each d369 1 a369 1
Print the name of each file to d375 1 a375 1
Print the program version d380 1 a380 1
(o mode only) d387 1 a387 1
(o mode only) d394 1 a394 1
(o mode only) d401 1 a401 1
The cpio utility d407 1 a407 1
The following environment d412 2 a413 2
The locale to use. See environ(7) for more information.
d417 2 a418 2The timezone to use when displaying dates. See environ(7) for more d423 1 a423 1
The cpio command is d425 2 a426 2 with the find(1) command. The first example here simply copies all files from src to dest:
d428 1 a428 1find src | d431 7 a437 7
By carefully selecting options to the find(1) command and combining it with other standard utilities, it is possible to exercise very fine control over which files are copied. This next example copies files from src to dest that are more than 2 days old and whose names match a particular pattern:
d439 1 a439 1find src d443 1 a443 1
This example d449 1 a449 1
find src d455 1 a455 1
The mode options i, o, and p and d459 1 a459 1
The old POSIX.1 d473 3 a475 4
bzip2(1), gzip(1), mt(1), pax(1), tar(1), libarchive(3), cpio(5), libarchive-formats(5), tar(5)
d479 1 a479 1There is no current POSIX d484 1 a484 1
The cpio, ustar, d490 1 a490 1
The original cpio and d501 2 a502 2
This is a complete re-implementation based on the libarchive(3) d507 1 a507 1
The cpio archive format has d515 4 a518 2 can support files up to 8 gigabytes. Debian September 16, 2014 CPIO(1)
@ 1.1.1.15 log @libarchive: imported version 3.7.9 @ text @d2 1 a2 1 @ 1.1.1.16 log @libarchive: import version 3.8.0 Libarchive 3.8.0 is a feature and bugfix release. New features: bsdtar: support --mtime and --clamp-mtime lib: mbedtls 3.x compatibility 7-zip reader: improve self-extracting archive detection xar: xmllite support for the XAR reader and writer zip writer: added XZ, LZMA, ZSTD and BZIP2 support zip writer: added LZMA + RISCV BCJ filter Notable security fixes: rar: do not skip past EOF while reading rar: fix double free with over 4 billion nodes rar: fix heap-buffer-overflow warc: prevent signed integer overflow tar: fix overflow in build_ustar_entry Notable bugfixes: bsdtar: don't hardlink negative inode files together gz: allow setting the original filename for gzip compressed files lib: improve lseek handling lib: support @@-prefixed Unix epoch timestamps as date strings rar: support large headers on 32 bit systems tar reader: Improve LFS support on 32 bit systems @ text @d2 1 a2 1 @ 1.1.1.17 log @libarchive: import version 3.8.1 @ text @d2 1 a2 1 @ 1.1.1.18 log @libarchive: imported version 3.8.2 @ text @d2 1 a2 1 @ 1.1.1.19 log @libarchive: import version 3.8.3 @ text @d2 1 a2 1 @ 1.1.1.20 log @libarchive: import 3.8.4 @ text @d2 1 a2 1 @ 1.1.1.21 log @libarchive: import version 3.8.5 @ text @d2 1 a2 1 @ 1.1.1.22 log @libarchive: imported version 3.8.6 @ text @d2 1 a2 1 @ 1.1.1.23 log @libarchive: imported version 3.8.7 @ text @d2 1 a2 1 @ 1.1.1.24 log @libarchive: import 3.8.8 @ text @d2 1 a2 1 @