rpms/cpio
7
0
Fork 0
Code Issues Pull Requests Releases Activity

man: (re)generate by help2man

Browse Source 
For more info see ./man/README file, it is done this way because
it is very easy to miss some new option to be documented.

Version: 2.12-2
This commit is contained in:
Pavel Raiskup 2015-09-14 13:53:34 +02:00
parent fe198e6d04
commit 2a3bb6a8a4
7 changed files with 906 additions and 187 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

393
cpio.1
View File

@ -1,3 +1,6 @@
.\" DO NOT MODIFY THIS FILE! It was (partly) generated by help2man from
.\" cpio --help/cpio --version output and partly patched by downstream
.\" package maintainers.
.TH CPIO 1L \" -*- nroff -*- .TH CPIO 1L \" -*- nroff -*-
.SH NAME .SH NAME
cpio \- copy files to and from archives cpio \- copy files to and from archives
@ -30,7 +33,7 @@ option to minimize problems with permissions on directories that are
unreadable. see \*(lqOptions\*(rq. unreadable. see \*(lqOptions\*(rq.
.PP .PP
.B cpio .B cpio
{\-o|\-\-create} [\-0acvABLV] [\-C bytes] [\-H format] {\-o|\-\-create} [\-0acvABLV] [\-C bytes] [\-H format] [\-D DIR]
[\-M message] [\-O [[user@]host:]archive] [\-F [[user@]host:]archive] [\-M message] [\-O [[user@]host:]archive] [\-F [[user@]host:]archive]
[\-\-file=[[user@]host:]archive] [\-\-format=format] [\-\-warning=FLAG] [\-\-file=[[user@]host:]archive] [\-\-format=format] [\-\-warning=FLAG]
[\-\-message=message][\-\-null] [\-\-reset\-access\-time] [\-\-verbose] [\-\-message=message][\-\-null] [\-\-reset\-access\-time] [\-\-verbose]
@ -52,6 +55,7 @@ extracted. see \*(lqOptions\*(rq.
.PP .PP
.B cpio .B cpio
{\-i|\-\-extract} [\-bcdfmnrtsuvBSV] [\-C bytes] [\-E file] [\-H format] {\-i|\-\-extract} [\-bcdfmnrtsuvBSV] [\-C bytes] [\-E file] [\-H format]
[\-D DIR]
[\-M message] [\-R [user][:.][group]] [\-I [[user@]host:]archive] [\-M message] [\-R [user][:.][group]] [\-I [[user@]host:]archive]
[\-F [[user@]host:]archive] [\-\-file=[[user@]host:]archive] [\-F [[user@]host:]archive] [\-\-file=[[user@]host:]archive]
[\-\-make-directories] [\-\-nonmatching] [\-\-preserve-modification-time] [\-\-make-directories] [\-\-nonmatching] [\-\-preserve-modification-time]
@ -62,6 +66,8 @@ extracted. see \*(lqOptions\*(rq.
[\-\-no-preserve-owner] [\-\-message=message] [\-\-no-preserve-owner] [\-\-message=message]
[\-\-force\-local] [\-\-no\-absolute\-filenames] [\-\-absolute\-filenames] [\-\-force\-local] [\-\-no\-absolute\-filenames] [\-\-absolute\-filenames]
[\-\-sparse] [\-\-only\-verify\-crc] [\-\-to\-stdout] [\-\-quiet] [\-\-sparse] [\-\-only\-verify\-crc] [\-\-to\-stdout] [\-\-quiet]
[\-\-ignore\-devno] [\-\-renumber\-inodes] [\-\-device\-independent]
[\-\-reproducible]
[\-\-rsh-command=command] [\-\-license] [\-\-usage] [\-\-help] [\-\-rsh-command=command] [\-\-license] [\-\-usage] [\-\-help]
[\-\-version] [pattern...] [< archive] [\-\-version] [pattern...] [< archive]
.PP .PP
@ -74,7 +80,7 @@ input; the directory into which it will copy them is given as a
non-option argument. see \*(lqOptions\*(rq. non-option argument. see \*(lqOptions\*(rq.
.PP .PP
.B cpio .B cpio
{\-p|\-\-pass-through} [\-0adlmuvLV] [\-R [user][:.][group]] {\-p|\-\-pass-through} [\-0adlmuvLV] [\-R [user][:.][group]] [\-D DIR]
[\-\-null] [\-\-reset-access-time] [\-\-make-directories] [\-\-link] [\-\-quiet] [\-\-null] [\-\-reset-access-time] [\-\-make-directories] [\-\-link] [\-\-quiet]
[\-\-preserve-modification-time] [\-\-unconditional] [\-\-verbose] [\-\-dot] [\-\-preserve-modification-time] [\-\-unconditional] [\-\-verbose] [\-\-dot]
[\-\-warning=FLAG] [\-\-dereference] [\-\-owner=[user][:.][group]] [\-\-warning=FLAG] [\-\-dereference] [\-\-owner=[user][:.][group]]
@ -92,73 +98,52 @@ default, cpio creates binary format archives, for compatibility with older cpio
from archives, cpio automatically recognizes which kind of archive it is reading and can read archives created from archives, cpio automatically recognizes which kind of archive it is reading and can read archives created
on machines with a different byte-order. on machines with a different byte-order.
.PP .PP
.SH OPTIONS .SS "Main operation mode:"
.TP .TP
`\fB\-0, \-\-null\fR' \fB\-i\fR, \fB\-\-extract\fR
Read a list of filenames terminated by a null character, instead Extract files from an archive (run in copy\-in
of a newline, so that files whose names contain newlines can be mode)
archived. \s-1GNU\s0 find is one way to produce a list of
null-terminated filenames. This option may be used in copy-out
and copy-pass modes.
.TP .TP
`\fB\-a, \-\-reset\-access\-time\fR' \fB\-o\fR, \fB\-\-create\fR
Reset the access times of files after reading them, so that it Create the archive (run in copy\-out mode)
does not look like they have just been read.
.TP .TP
`\fB\-A, \-\-append\fR' \fB\-p\fR, \fB\-\-pass\-through\fR
Append to an existing archive. Only works in copy-out mode. The Run in copy\-pass mode
archive must be a disk file specified with the \-O or \-F (\-file)
option.
.TP .TP
`\fB\-b, \-\-swap\fR' \fB\-t\fR, \fB\-\-list\fR
Swap both halfwords of words and bytes of halfwords in the data. Print a table of contents of the input
Equivalent to \-sS. This option may be used in copy-in mode. Use .SS "Operation modifiers valid in any mode:"
this option to convert 32\-bit integers between big-endian and
little-endian machines.
.TP .TP
`\fB\-B\fR' \fB\-\-block\-size\fR=\fI\,BLOCK\-SIZE\/\fR
Set the I/O block size to 5120 bytes. Initially the block size is Set the I/O block size to BLOCK\-SIZE * 512
512 bytes. bytes
.TP .TP
`\fB\-\-block\-size=BLOCK\-SIZE\fR' \fB\-B\fR
Set the I/O block size to BLOCK-SIZE * 512 bytes. Set the I/O block size to 5120 bytes.
Initially the block size is 512 bytes.
.TP .TP
`\fB\-c\fR' \fB\-c\fR
Identical to \*(lq\-H newc\*(rq, use the new (\s-1SVR4\s0) portable format. Identical to "\-H newc", use the new (SVR4)
If you wish the old portable (\s-1ASCII\s0) archive format, use \*(lq\-H odc\*(rq instead. portable format. If you wish the old portable
(ASCII) archive format, use "\-H odc" instead.
.TP .TP
`\fB\-C \s-1IO\-SIZE\s0, \-\-io\-size=IO\-SIZE\fR' \fB\-C\fR, \fB\-\-io\-size\fR=\fI\,NUMBER\/\fR
Set the I/O block size to IO-SIZE bytes. Set the I/O block size to the given NUMBER of
bytes
.TP .TP
`\fB\-d, \-\-make\-directories\fR' \fB\-D\fR, \fB\-\-directory\fR=\fI\,DIR\/\fR
Create leading directories where needed. Change to directory DIR
.TP .TP
`\fB\-E \s-1FILE\s0, \-\-pattern\-file=FILE\fR' \fB\-\-force\-local\fR
Read additional patterns specifying filenames to extract or list
from \s-1FILE\s0. The lines of \s-1FILE\s0 are treated as if they had been
non-option arguments to cpio. This option is used in copy-in mode,
.TP
`\fB\-f, \-\-nonmatching\fR'
Only copy files that do not match any of the given patterns.
.TP
`\fB\-F, \-\-file=archive\fR'
Archive filename to use instead of standard input or output. To
use a tape drive on another machine as the archive, use a filename
that starts with `\fB\s-1HOSTNAME:\s0\fR'. The hostname can be preceded by a
username and an `\fB@\fR' to access the remote tape drive as that user,
if you have permission to do so (typically an entry in that user's
`\fB~/.rhosts\fR' file).
.TP
`\fB\-\-force\-local\fR'
With \-F, \-I, or \-O, take the archive file name to be a local file With \-F, \-I, or \-O, take the archive file name to be a local file
even if it contains a colon, which would ordinarily indicate a even if it contains a colon, which would ordinarily indicate a
remote host name. remote host name.
.TP .TP
`\fB\-H \s-1FORMAT\s0, \-\-format=FORMAT\fR' \fB\-H\fR, \fB\-\-format\fR=\fI\,FORMAT\/\fR
Use archive format \s-1FORMAT\s0. The valid formats are listed below; Use given archive FORMAT.
the same names are also recognized in all\-caps. The default in The valid formats are listed below; the same names are also recognized in
copy-in mode is to automatically detect the archive format, and in all\-caps. The default in copy-in mode is to automatically detect the archive
copy-out mode is `\fBbin\fR'. format, and in copy-out mode is `\fBbin\fR'.
.TP .TP
`bin' `bin'
The obsolete binary format. The obsolete binary format.
@ -188,113 +173,17 @@ device files differently).
The portable format used by \s-1HPUX\s0's cpio (which stores device The portable format used by \s-1HPUX\s0's cpio (which stores device
files differently). files differently).
.TP .TP
`\fB\-i, \-\-extract\fR' \fB\-\-quiet\fR
Run in copy-in mode. see \*(lqCopy\-in mode\*(rq. Do not print the number of blocks copied
.TP .TP
`\fB\-I archive\fR' \fB\-R\fR, \fB\-\-owner\fR=\fI\,[USER][\/\fR:.][GROUP]
Archive filename to use instead of standard input. To use a tape Set the ownership of all files created to the
drive on another machine as the archive, use a filename that specified USER and/or GROUP.
starts with `\fB\s-1HOSTNAME:\s0\fR'. The hostname can be preceded by a Either the user, the group, or both, must be present. If the group is omitted
username and an `\fB@\fR' to access the remote tape drive as that user, but the \&\*(lq:\*(rq or \*(lq.\*(rq separator is given, use the given user's
if you have permission to do so (typically an entry in that user's login group. Only the super-user can change files' ownership in copy\-in mode.
`\fB~/.rhosts\fR' file).
.TP .TP
`\fB\-k\fR' \fB\-v\fR, \fB\-\-verbose\fR
Ignored; for compatibility with other versions of cpio.
.TP
`\fB\-l, \-\-link\fR'
Link files instead of copying them, when possible.
.TP
`\fB\-L, \-\-dereference\fR'
Copy the file that a symbolic link points to, rather than the
symbolic link itself.
.TP
`\fB\-m, \-\-preserve\-modification\-time\fR'
Retain previous file modification times when creating files.
.TP
`\fB\-M \s-1MESSAGE\s0, \-\-message=MESSAGE\fR'
Print \s-1MESSAGE\s0 when the end of a volume of the backup media (such
as a tape or a floppy disk) is reached, to prompt the user to
insert a new volume. If \s-1MESSAGE\s0 contains the string \*(lq%d\*(rq, it is
replaced by the current volume number (starting at 1).
.TP
`\fB\-n, \-\-numeric\-uid\-gid\fR'
Show numeric \s-1UID\s0 and \s-1GID\s0 instead of translating them into names
when using the `\fB\-\-verbose option\fR'.
.TP
`\fB\-\-no\-absolute\-filenames\fR'
Create all files relative to the current directory in copy-in
mode, even if they have an absolute file name in the archive.
.TP
`\fB\-\-absolute\-filenames\fR' (default)
Do not strip leading file name components that contain \*(lq..\*(rq
and leading slashes from file names in copy-in mode
.TP
`\fB\-\-no\-preserve\-owner\fR'
Do not change the ownership of the files; leave them owned by the
user extracting them. This is the default for non-root users, so
that users on System V don't inadvertently give away files. This
option can be used in copy-in mode and copy-pass mode
.TP
`\fB\-o, \-\-create\fR'
Run in copy-out mode. see \*(lqCopy\-out mode\*(rq.
.TP
`\fB\-O archive\fR'
Archive filename to use instead of standard output. To use a tape
drive on another machine as the archive, use a filename that
starts with `\fB\s-1HOSTNAME:\s0\fR'. The hostname can be preceded by a
username and an `\fB@\fR' to access the remote tape drive as that user,
if you have permission to do so (typically an entry in that user's
`\fB~/.rhosts\fR' file).
.TP
`\fB\-\-only\-verify\-crc\fR'
Verify the \s-1Sum32 checksum\s0's of each file in the archive, when reading a
\s-1crc\s0 format archive. Don't actually extract the files.
.TP
`\fB\-p, \-\-pass\-through\fR'
Run in copy-pass mode. see \*(lqCopy\-pass mode\*(rq.
.TP
`\fB\-\-quiet\fR'
Do not print the number of blocks copied.
.TP
`\fB\-r, \-\-rename\fR'
Interactively rename files.
.TP
`\fB\-R [user][:.][group], \-\-owner [user][:.][group]\fR'
Set the ownership of all files created to the specified user and/or
group in copy-out and copy-pass modes. Either the user, the
group, or both, must be present. If the group is omitted but the
\&\*(lq:\*(rq or \*(lq.\*(rq separator is given, use the given user's login group.
Only the super-user can change files' ownership.
.TP
`\fB\-\-rsh\-command=COMMAND\fR'
Notifies cpio that is should use \s-1COMMAND\s0 to communicate with remote
devices.
.TP
`\fB\-s, \-\-swap\-bytes\fR'
Swap the bytes of each halfword (pair of bytes) in the files.This
option can be used in copy-in mode.
.TP
`\fB\-S, \-\-swap\-halfwords\fR'
Swap the halfwords of each word (4 bytes) in the files. This
option may be used in copy-in mode.
.TP
`\fB\-\-sparse\fR'
Write files with large blocks of zeros as sparse files. This
option is used in copy-in and copy-pass modes.
.TP
`\fB\-t, \-\-list\fR'
Print a table of contents of the input.
.TP
`\fB\-\-to\-stdout\fR'
Extract files to standard output. This option may be used in
copy-in mode.
.TP
`\fB\-u, \-\-unconditional\fR'
Replace all files, without asking whether to replace existing
newer files with older files.
.TP
`\fB\-v, \-\-verbose\fR'
List the files processed, or with `\fB\-t\fR', give an `\fBls \-l\fR' style List the files processed, or with `\fB\-t\fR', give an `\fBls \-l\fR' style
table of contents listing. In a verbose table of contents of a table of contents listing. In a verbose table of contents of a
ustar archive, user and group names in the archive that do not ustar archive, user and group names in the archive that do not
@ -302,23 +191,152 @@ exist on the local system are replaced by the names that
correspond locally to the numeric \s-1UID\s0 and \s-1GID\s0 stored in the correspond locally to the numeric \s-1UID\s0 and \s-1GID\s0 stored in the
archive. archive.
.TP .TP
`\fB\-V, \-\-dot\fR' \fB\-V\fR, \fB\-\-dot\fR
Print a `\fB.\fR' for each file processed. Print a "." for each file processed
.TP .TP
`\fB\-W, \-\-warning\fR' \fB\-W\fR, \fB\-\-warning\fR=\fI\,FLAG\/\fR
Control warning display. Currently FLAG is one of 'none', 'truncate', 'all'. Multiple options accumulate. Control warning display. Currently FLAG is one of
\&'none', 'truncate', 'all'. Multiple options
accumulate.
.SS "Operation modifiers valid in copy-in and copy-out modes:"
.TP .TP
`\fB\-\-license\fR' \fB\-F\fR, \fB\-\-file\fR=\fI\,[[USER\/\fR@]HOST:]FILE\-NAME
Print license and exit. Use this FILE\-NAME instead of standard input or
output. Optional USER and HOST specify the user
and host names in case of a remote archive
.TP .TP
`\fB?, \-\-help\fR' \fB\-M\fR, \fB\-\-message\fR=\fI\,STRING\/\fR
Give a help page similar to this manpage. Print \s-1STRING\s0 when the end of a volume of the backup media (such
as a tape or a floppy disk) is reached, to prompt the user to
insert a new volume. If \s-1STRING\s0 contains the string \*(lq%d\*(rq, it is
replaced by the current volume number (starting at 1).
.TP .TP
`\fB\-\-usage\fR' \fB\-\-rsh\-command\fR=\fI\,COMMAND\/\fR
Give a short usage message. Use COMMAND instead of rsh
(typically /usr/bin/ssh)
.SS "Operation modifiers valid only in copy-in mode:"
.TP .TP
`\fB\-\-version\fR' \fB\-b\fR, \fB\-\-swap\fR
Print the cpio program version number and exit. Swap both halfwords of words and bytes of
halfwords in the data. Equivalent to \fB\-sS\fR
Use this option to convert 32\-bit integers between big-endian and little-endian
machines.
.TP
\fB\-f\fR, \fB\-\-nonmatching\fR
Only copy files that do not match any of the given
patterns
.TP
\fB\-I\fR [[USER@]HOST:]FILE\-NAME
Archive filename to use instead of standard input.
Optional USER and HOST specify the user and host
names in case of a remote archive
.TP
\fB\-n\fR, \fB\-\-numeric\-uid\-gid\fR
In the verbose table of contents listing, show
numeric UID and GID
.TP
\fB\-r\fR, \fB\-\-rename\fR
Interactively rename files
.TP
\fB\-s\fR, \fB\-\-swap\-bytes\fR
Swap the bytes of each halfword in the files
.TP
\fB\-S\fR, \fB\-\-swap\-halfwords\fR
Swap the halfwords of each word (4 bytes) in the
files
.TP
\fB\-\-to\-stdout\fR
Extract files to standard output
.TP
\fB\-E\fR, \fB\-\-pattern\-file\fR=\fI\,FILE\/\fR
Read additional patterns specifying filenames to
extract or list from FILE
.TP
\fB\-\-only\-verify\-crc\fR
When reading a CRC format archive, only verify the
checksum of each file in the archive, don't
actually extract the files
.SS "Operation modifiers valid only in copy-out mode:"
.TP
\fB\-A\fR, \fB\-\-append\fR
Append to an existing archive.
The archive must be a disk file specified with the \-O or \-F (\-file) option.
.TP
\fB\-\-device\-independent\fR, \fB\-\-reproducible\fR
Create device\-independent (reproducible) archives
.TP
\fB\-\-ignore\-devno\fR
Don't store device numbers
.TP
\fB\-O\fR [[USER@]HOST:]FILE\-NAME
Archive filename to use instead of standard
output. Optional USER and HOST specify the user
and host names in case of a remote archive
.TP
\fB\-\-renumber\-inodes\fR
Renumber inodes
.SS "Operation modifiers valid only in copy-pass mode:"
.TP
\fB\-l\fR, \fB\-\-link\fR
Link files instead of copying them, when
possible
.SS "Operation modifiers valid in copy-in and copy-out modes:"
.TP
\fB\-\-absolute\-filenames\fR
Do not strip file system prefix components from
the file names
.TP
\fB\-\-no\-absolute\-filenames\fR
Create all files relative to the current
directory
.SS "Operation modifiers valid in copy-out and copy-pass modes:"
.TP
\fB\-0\fR, \fB\-\-null\fR
Filenames in the list are delimited by null
characters instead of newlines, so that files whose names contain newlines can
be archived. \s-1GNU\s0 find is one way to produce a list of null-terminated
filenames.
.TP
\fB\-a\fR, \fB\-\-reset\-access\-time\fR
Reset the access times of files after reading them, so that it
does not look like they have just been read.
.TP
\fB\-L\fR, \fB\-\-dereference\fR
Dereference symbolic links (copy the files
that they point to instead of copying the links).
.SS "Operation modifiers valid in copy-in and copy-pass modes:"
.TP
\fB\-d\fR, \fB\-\-make\-directories\fR
Create leading directories where needed
.TP
\fB\-m\fR, \fB\-\-preserve\-modification\-time\fR
Retain previous file modification times when
creating files
.TP
\fB\-\-no\-preserve\-owner\fR
Do not change the ownership of the files; leave them owned by the
user extracting them. This is the default for non-root users, so
that users on System V don't inadvertently give away files. This
option can be used in copy-in mode and copy-pass mode
.TP
\fB\-\-sparse\fR
Write files with large blocks of zeros as sparse
files
.TP
\fB\-u\fR, \fB\-\-unconditional\fR
Replace all files unconditionally
.TP
\-?, \fB\-\-help\fR
give this help list
.TP
\fB\-\-usage\fR
give a short usage message
.TP
\fB\-\-version\fR
print program version
.PP
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
.PP .PP
.SH EXAMPLES .SH EXAMPLES
@ -389,17 +407,20 @@ between find and cpio, even if special characters are embedded in the
file names. Another is `\fB\-p\fR', which tells cpio to pass the files it file names. Another is `\fB\-p\fR', which tells cpio to pass the files it
finds to the directory `\fBnew-dir\fR'. finds to the directory `\fBnew-dir\fR'.
.SH BUGS
The GNU folks, in general, abhor man pages, and create info documents instead. The maintainer of .SH AUTHOR
.B cpio Written by Phil Nelson, David MacKenzie, John Oleynick,
falls and Sergey Poznyakoff.
into this category. Thus this man page may not be complete, nor current, and was included in the Red Hat .SH "REPORTING BUGS"
CVS tree because man is a great tool :). Report bugs to <bug\-cpio@gnu.org>.
.PP Report bugs in this manual page via https://bugzilla.redhat.com.
.SH REPORTING BUGS .SH COPYRIGHT
Please report bugs via https://bugzilla.redhat.com. Copyright \(co 2015 Free Software Foundation, Inc.
.PP License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
.SH SEE ALSO .br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for The full documentation for
.B cpio .B cpio
is maintained as a Texinfo manual. If the is maintained as a Texinfo manual. If the
@ -410,8 +431,8 @@ programs are properly installed at your site, the command
.IP .IP
.B info cpio .B info cpio
.PP .PP
should give you access to the complete manual. The online copy of the documentation should give you access to the complete manual.
is available at the following address:
The online copy of the documentation is available at the following address:
.PP .PP
http://www.gnu.org/software/cpio/manual http://www.gnu.org/software/cpio/manual

5
cpio.spec
View File

@ -1,7 +1,7 @@
Summary: A GNU archiving program Summary: A GNU archiving program
Name: cpio Name: cpio
Version: 2.12 Version: 2.12
Release: 1%{?dist} Release: 2%{?dist}
License: GPLv3+ License: GPLv3+
Group: Applications/Archiving Group: Applications/Archiving
URL: http://www.gnu.org/software/cpio/ URL: http://www.gnu.org/software/cpio/
@ -114,6 +114,9 @@ fi
%{_infodir}/*.info* %{_infodir}/*.info*
%changelog %changelog
* Mon Sep 14 2015 Pavel Raiskup <praiskup@redhat.com> - 2.12-2
- (re)generate manual page for new options
* Mon Sep 14 2015 Pavel Raiskup <praiskup@redhat.com> - 2.12-1 * Mon Sep 14 2015 Pavel Raiskup <praiskup@redhat.com> - 2.12-1
- rebase, per release notes - rebase, per release notes
http://lists.gnu.org/archive/html/bug-cpio/2015-09/msg00004.html http://lists.gnu.org/archive/html/bug-cpio/2015-09/msg00004.html

19
man/README Normal file
View File

@ -0,0 +1,19 @@
How to (re)generate manual page:
--------------------------------
1. apply the `help.patch` to cpio sources and then re-build sources
2. run help2man on cpio shell wrapper:
`cpio_binary=../cpio-2.12/src/cpio help2man ./cpio > latest-output`
3. note the changes in `git diff latest-output`, those will probably need
manual tweaking in resulting manual page.
4. move the generated file on place:
`cp latest-output ../cpio.1`
5. apply `downstream.patch`
`cd .. ; patch -p1 cpio.1 < man/downstream.patch`
6. fix collisions and regenerate `downstream.patch`
`diff -u man/latest-output cpio.1 > man/downstream.patch`

16
man/cpio Executable file
View File

@ -0,0 +1,16 @@
#!/bin/bash
test -z "$cpio_binary" && {
echo >&2 "no \$cpio_binary set"
exit 1
}
case "$1" in
-h|--help)
$cpio_binary --help | sed 's/^ \([^[:space:]][^:]*\):\?$/\1:/'
;;
*)
$cpio_binary "$@"
;;
esac

357
man/downstream.patch Normal file
View File

@ -0,0 +1,357 @@
--- man/latest-output 2015-09-14 13:51:18.454800210 +0200
+++ cpio.1 2015-09-14 13:51:48.741061959 +0200
@@ -1,11 +1,103 @@
-.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.1.
-.TH CPIO "1" "September 2015" "cpio 2.12" "User Commands"
+.\" DO NOT MODIFY THIS FILE! It was (partly) generated by help2man from
+.\" cpio --help/cpio --version output and partly patched by downstream
+.\" package maintainers.
+.TH CPIO 1L \" -*- nroff -*-
.SH NAME
-cpio \- manual page for cpio 2.12
+cpio \- copy files to and from archives
+.SH __WARNING__
+.PP
+The cpio utility is considered LEGACY based on POSIX specification. Users are
+encouraged to use other archiving tools for archive creation.
+
+If you decided to use cpio, you should almost always force cpio to use the
+ustar format in copy-out mode by the -H option (cpio -o -H ustar). This is
+because the ustar format is well defined in POSIX specification and thus
+readable by wide range of other archiving tools (including tar e.g.).
+
+By default, GNU cpio uses (for historical reasons) the very old binary format
+('bin') which has significant problems nowadays, e.g. with storing big inode
+numbers (see the Red Hat bug #952313).
+
+Note also that these days the modern 'pax' archive format should be considered
+as the default -- but this format is not implemented in GNU cpio. You should,
+again, consider using other archivers (e.g. 'tar --format=pax').
+
.SH SYNOPSIS
+\&\fBCopy-out mode\fR
+.PP
+In copy-out mode, cpio copies files into an archive. It reads a list
+of filenames, one per line, on the standard input, and writes the
+archive onto the standard output. A typical way to generate the list
+of filenames is with the find command; you should give find the \-depth
+option to minimize problems with permissions on directories that are
+unreadable. see \*(lqOptions\*(rq.
+.PP
+.B cpio
+{\-o|\-\-create} [\-0acvABLV] [\-C bytes] [\-H format] [\-D DIR]
+[\-M message] [\-O [[user@]host:]archive] [\-F [[user@]host:]archive]
+[\-\-file=[[user@]host:]archive] [\-\-format=format] [\-\-warning=FLAG]
+[\-\-message=message][\-\-null] [\-\-reset\-access\-time] [\-\-verbose]
+[\-\-dot] [\-\-append] [\-\-block\-size=blocks] [\-\-dereference]
+[\-\-io\-size=bytes] [\-\-rsh\-command=command] [\-\-license] [\-\-usage]
+[\-\-help] [\-\-version]
+< name-list [> archive]
+.PP
+\&\fBCopy-in mode\fR
+.PP
+In copy-in mode, cpio copies files out of an archive or lists the
+archive contents. It reads the archive from the standard input. Any
+non-option command line arguments are shell globbing patterns; only
+files in the archive whose names match one or more of those patterns are
+copied from the archive. Unlike in the shell, an initial `\fB.\fR' in a
+filename does match a wildcard at the start of a pattern, and a `\fB/\fR' in a
+filename can match wildcards. If no patterns are given, all files are
+extracted. see \*(lqOptions\*(rq.
+.PP
.B cpio
-[\fI\,OPTION\/\fR...] [\fI\,destination-directory\/\fR]
+{\-i|\-\-extract} [\-bcdfmnrtsuvBSV] [\-C bytes] [\-E file] [\-H format]
+[\-D DIR]
+[\-M message] [\-R [user][:.][group]] [\-I [[user@]host:]archive]
+[\-F [[user@]host:]archive] [\-\-file=[[user@]host:]archive]
+[\-\-make-directories] [\-\-nonmatching] [\-\-preserve-modification-time]
+[\-\-numeric-uid-gid] [\-\-rename] [\-t|\-\-list] [\-\-swap-bytes] [\-\-swap]
+[\-\-dot] [\-\-warning=FLAG] [\-\-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] [\-\-absolute\-filenames]
+[\-\-sparse] [\-\-only\-verify\-crc] [\-\-to\-stdout] [\-\-quiet]
+[\-\-ignore\-devno] [\-\-renumber\-inodes] [\-\-device\-independent]
+[\-\-reproducible]
+[\-\-rsh-command=command] [\-\-license] [\-\-usage] [\-\-help]
+[\-\-version] [pattern...] [< archive]
+.PP
+\&\fBCopy-pass mode\fR
+.PP
+In copy-pass mode, cpio copies files from one directory tree to
+another, combining the copy-out and copy-in steps without actually
+using an archive. It reads the list of files to copy from the standard
+input; the directory into which it will copy them is given as a
+non-option argument. see \*(lqOptions\*(rq.
+.PP
+.B cpio
+{\-p|\-\-pass-through} [\-0adlmuvLV] [\-R [user][:.][group]] [\-D DIR]
+[\-\-null] [\-\-reset-access-time] [\-\-make-directories] [\-\-link] [\-\-quiet]
+[\-\-preserve-modification-time] [\-\-unconditional] [\-\-verbose] [\-\-dot]
+[\-\-warning=FLAG] [\-\-dereference] [\-\-owner=[user][:.][group]]
+[\-\-no-preserve-owner] [\-\-sparse] [\-\-license] [\-\-usage] [\-\-help]
+[\-\-version] destination-directory < name-list
+.PP
.SH DESCRIPTION
+GNU cpio is a tool for creating and extracting archives, or copying
+files from one place to another. It handles a number of cpio formats as
+well as reading and writing tar files.
+.PP
+Following archive formats are supported: binary, old ASCII, new ASCII, crc, HPUX binary, HPUX old
+ASCII, old tar, and POSIX.1 tar. The tar format is provided for compatibility with the tar program. By
+default, cpio creates binary format archives, for compatibility with older cpio programs. When extracting
+from archives, cpio automatically recognizes which kind of archive it is reading and can read archives created
+on machines with a different byte-order.
+.PP
.SS "Main operation mode:"
.TP
\fB\-i\fR, \fB\-\-extract\fR
@@ -27,7 +119,8 @@
bytes
.TP
\fB\-B\fR
-Set the I/O block size to 5120 bytes
+Set the I/O block size to 5120 bytes.
+Initially the block size is 512 bytes.
.TP
\fB\-c\fR
Identical to "\-H newc", use the new (SVR4)
@@ -42,21 +135,61 @@
Change to directory DIR
.TP
\fB\-\-force\-local\fR
-Archive file is local, even if its name contains
-colons
+With \-F, \-I, or \-O, take the archive file name to be a local file
+even if it contains a colon, which would ordinarily indicate a
+remote host name.
.TP
\fB\-H\fR, \fB\-\-format\fR=\fI\,FORMAT\/\fR
-Use given archive FORMAT
+Use given archive FORMAT.
+The valid formats are listed below; the same names are also recognized in
+all\-caps. The default in copy-in mode is to automatically detect the archive
+format, and in copy-out mode is `\fBbin\fR'.
+.TP
+`bin'
+The obsolete binary format.
+.TP
+`odc'
+The old (\s-1POSIX\s0.1) portable format.
+.TP
+`newc'
+The new (\s-1SVR4\s0) portable format, which supports file systems
+having more than 65536 i\-nodes.
+.TP
+`crc'
+The new (\s-1SVR4\s0) portable format with a checksum (Sum32) added.
+.TP
+`tar'
+The old tar format.
+.TP
+`ustar'
+The \s-1POSIX\s0.1 tar format. Also recognizes \s-1GNU\s0 tar archives,
+which are similar but not identical.
+.TP
+`hpbin'
+The obsolete binary format used by \s-1HPUX\s0's cpio (which stores
+device files differently).
+.TP
+`hpodc'
+The portable format used by \s-1HPUX\s0's cpio (which stores device
+files differently).
.TP
\fB\-\-quiet\fR
Do not print the number of blocks copied
.TP
\fB\-R\fR, \fB\-\-owner\fR=\fI\,[USER][\/\fR:.][GROUP]
Set the ownership of all files created to the
-specified USER and/or GROUP
+specified USER and/or GROUP.
+Either the user, the group, or both, must be present. If the group is omitted
+but the \&\*(lq:\*(rq or \*(lq.\*(rq separator is given, use the given user's
+login group. Only the super-user can change files' ownership in copy\-in mode.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
-Verbosely list the files processed
+List the files processed, or with `\fB\-t\fR', give an `\fBls \-l\fR' style
+table of contents listing. In a verbose table of contents of a
+ustar archive, user and group names in the archive that do not
+exist on the local system are replaced by the names that
+correspond locally to the numeric \s-1UID\s0 and \s-1GID\s0 stored in the
+archive.
.TP
\fB\-V\fR, \fB\-\-dot\fR
Print a "." for each file processed
@@ -73,22 +206,28 @@
and host names in case of a remote archive
.TP
\fB\-M\fR, \fB\-\-message\fR=\fI\,STRING\/\fR
-Print STRING when the end of a volume of the
-backup media is reached
+Print \s-1STRING\s0 when the end of a volume of the backup media (such
+as a tape or a floppy disk) is reached, to prompt the user to
+insert a new volume. If \s-1STRING\s0 contains the string \*(lq%d\*(rq, it is
+replaced by the current volume number (starting at 1).
.TP
\fB\-\-rsh\-command\fR=\fI\,COMMAND\/\fR
Use COMMAND instead of rsh
+(typically /usr/bin/ssh)
.SS "Operation modifiers valid only in copy-in mode:"
.TP
\fB\-b\fR, \fB\-\-swap\fR
Swap both halfwords of words and bytes of
halfwords in the data. Equivalent to \fB\-sS\fR
+Use this option to convert 32\-bit integers between big-endian and little-endian
+machines.
.TP
\fB\-f\fR, \fB\-\-nonmatching\fR
Only copy files that do not match any of the given
patterns
.TP
-\fB\-I\fR [[USER@]HOST:]FILE\-NAME Archive filename to use instead of standard input.
+\fB\-I\fR [[USER@]HOST:]FILE\-NAME
+Archive filename to use instead of standard input.
Optional USER and HOST specify the user and host
names in case of a remote archive
.TP
@@ -121,6 +260,7 @@
.TP
\fB\-A\fR, \fB\-\-append\fR
Append to an existing archive.
+The archive must be a disk file specified with the \-O or \-F (\-file) option.
.TP
\fB\-\-device\-independent\fR, \fB\-\-reproducible\fR
Create device\-independent (reproducible) archives
@@ -128,7 +268,8 @@
\fB\-\-ignore\-devno\fR
Don't store device numbers
.TP
-\fB\-O\fR [[USER@]HOST:]FILE\-NAME Archive filename to use instead of standard
+\fB\-O\fR [[USER@]HOST:]FILE\-NAME
+Archive filename to use instead of standard
output. Optional USER and HOST specify the user
and host names in case of a remote archive
.TP
@@ -152,10 +293,13 @@
.TP
\fB\-0\fR, \fB\-\-null\fR
Filenames in the list are delimited by null
-characters instead of newlines
+characters instead of newlines, so that files whose names contain newlines can
+be archived. \s-1GNU\s0 find is one way to produce a list of null-terminated
+filenames.
.TP
\fB\-a\fR, \fB\-\-reset\-access\-time\fR
-Reset the access times of files after reading them
+Reset the access times of files after reading them, so that it
+does not look like they have just been read.
.TP
\fB\-L\fR, \fB\-\-dereference\fR
Dereference symbolic links (copy the files
@@ -170,7 +314,10 @@
creating files
.TP
\fB\-\-no\-preserve\-owner\fR
-Do not change the ownership of the files
+Do not change the ownership of the files; leave them owned by the
+user extracting them. This is the default for non-root users, so
+that users on System V don't inadvertently give away files. This
+option can be used in copy-in mode and copy-pass mode
.TP
\fB\-\-sparse\fR
Write files with large blocks of zeros as sparse
@@ -190,11 +337,83 @@
.PP
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
+
+.PP
+.SH EXAMPLES
+When creating an archive, cpio takes the list of files to be
+processed from the standard input, and then sends the archive to the
+standard output, or to the device defined by the `\fB\-F\fR' option.
+Usually find or ls is used to provide this list to
+the standard input. In the following example you can see the
+possibilities for archiving the contents of a single directory.
+.PP
+.B % ls | cpio \-ov > directory.cpio
+.PP
+The `\fB\-o\fR' option creates the archive, and the `\fB\-v\fR' option prints the
+names of the files archived as they are added. Notice that the options
+can be put together after a single `\fB\-\fR' or can be placed separately on
+the command line. The `\fB>\fR' redirects the cpio output to the file
+`\fBdirectory.cpio\fR'.
+.PP
+If you wanted to archive an entire directory tree, the find command
+can provide the file list to cpio:
+.PP
+.B % find . \-print \-depth | cpio \-ov > tree.cpio
+.PP
+This will take all the files in the current directory, the
+directories below and place them in the archive tree.cpio. Again the
+`\fB\-o\fR' creates an archive, and the `\fB\-v\fR' option shows you the name of the
+files as they are archived. see \*(lqCopy\-out mode\*(rq. Using the `\fB.\fR' in
+the find statement will give you more flexibility when doing restores,
+as it will save file names with a relative path vice a hard wired,
+absolute path. The `\fB\-depth\fR' option forces `\fBfind\fR' to print of the
+entries in a directory before printing the directory itself. This
+limits the effects of restrictive directory permissions by printing the
+directory entries in a directory before the directory name itself.
+.PP
+Extracting an archive requires a bit more thought because cpio will
+not create directories by default. Another characteristic, is it will
+not overwrite existing files unless you tell it to.
+.PP
+.B % cpio \-iv < directory.cpio
+.PP
+This will retrieve the files archived in the file directory.cpio and
+place them in the present directory. The `\fB\-i\fR' option extracts the
+archive and the `\fB\-v\fR' shows the file names as they are extracted. If
+you are dealing with an archived directory tree, you need to use the
+`\fB\-d\fR' option to create directories as necessary, something like:
+.PP
+.B % cpio \-idv < tree.cpio
+.PP
+This will take the contents of the archive tree.cpio and extract it
+to the current directory. If you try to extract the files on top of
+files of the same name that already exist (and have the same or later
+modification time) cpio will not extract the file unless told to do so
+by the \-u option. see \*(lqCopy\-in mode\*(rq.
+.PP
+In copy-pass mode, cpio copies files from one directory tree to
+another, combining the copy-out and copy-in steps without actually
+using an archive. It reads the list of files to copy from the standard
+input; the directory into which it will copy them is given as a
+non-option argument. see \*(lqCopy\-pass mode\*(rq.
+.PP
+.B % find . \-depth \-print0 | cpio \-\-null \-pvd new-dir
+.PP
+The example shows copying the files of the present directory, and
+sub-directories to a new directory called new\-dir. Some new options are
+the `\fB\-print0\fR' available with \s-1GNU\s0 find, combined with the `\fB\-\-null\fR'
+option of cpio. These two options act together to send file names
+between find and cpio, even if special characters are embedded in the
+file names. Another is `\fB\-p\fR', which tells cpio to pass the files it
+finds to the directory `\fBnew-dir\fR'.
+
+
.SH AUTHOR
Written by Phil Nelson, David MacKenzie, John Oleynick,
and Sergey Poznyakoff.
.SH "REPORTING BUGS"
Report bugs to <bug\-cpio@gnu.org>.
+Report bugs in this manual page via https://bugzilla.redhat.com.
.SH COPYRIGHT
Copyright \(co 2015 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
@@ -213,3 +432,7 @@
.B info cpio
.PP
should give you access to the complete manual.
+
+The online copy of the documentation is available at the following address:
+.PP
+http://www.gnu.org/software/cpio/manual

88
man/help.patch Normal file
View File

@ -0,0 +1,88 @@
diff --git a/src/cpio b/src/cpio
index 79bcd82..eb703bf 100755
Binary files a/src/cpio and b/src/cpio differ
diff --git a/src/main.c b/src/main.c
index 13cdfcf..141332e 100644
--- a/src/main.c
+++ b/src/main.c
@@ -110,7 +110,7 @@ static struct argp_option options[] = {
/* ********** */
#define GRID 100
{NULL, 0, NULL, 0,
- N_("Operation modifiers valid in any mode:"), GRID },
+ N_("Operation modifiers valid in any mode:"), GRID +1},
{"directory", 'D', N_("DIR"), 0,
N_("Change to directory DIR"), GRID+1 },
@@ -145,7 +145,7 @@ static struct argp_option options[] = {
#define GRID 110
{NULL, 0, NULL, 0,
- N_("Operation modifiers valid in copy-in and copy-out modes"), GRID },
+ N_("Operation modifiers valid in copy-in and copy-out modes"), GRID +1},
{"file", 'F', N_("[[USER@]HOST:]FILE-NAME"), 0,
N_("Use this FILE-NAME instead of standard input or output. Optional USER and HOST specify the user and host names in case of a remote archive"), GRID+1 },
{"message", 'M', N_("STRING"), 0,
@@ -158,7 +158,7 @@ static struct argp_option options[] = {
/* ********** */
#define GRID 200
{NULL, 0, NULL, 0,
- N_("Operation modifiers valid only in copy-in mode:"), GRID },
+ N_("Operation modifiers valid only in copy-in mode:"), GRID +1},
{"nonmatching", 'f', 0, 0,
N_("Only copy files that do not match any of the given patterns"), GRID+1 },
{"numeric-uid-gid", 'n', 0, 0,
@@ -188,7 +188,7 @@ static struct argp_option options[] = {
/* ********** */
#define GRID 300
{NULL, 0, NULL, 0,
- N_("Operation modifiers valid only in copy-out mode:"), GRID },
+ N_("Operation modifiers valid only in copy-out mode:"), GRID +1},
{"append", 'A', 0, 0,
N_("Append to an existing archive."), GRID+1 },
{NULL, 'O', N_("[[USER@]HOST:]FILE-NAME"), 0,
@@ -205,7 +205,7 @@ static struct argp_option options[] = {
/* ********** */
#define GRID 400
{NULL, 0, NULL, 0,
- N_("Operation modifiers valid only in copy-pass mode:"), GRID},
+ N_("Operation modifiers valid only in copy-pass mode:"), GRID +1},
{"link", 'l', 0, 0,
N_("Link files instead of copying them, when possible"), GRID+1 },
@@ -214,7 +214,7 @@ static struct argp_option options[] = {
/* ********** */
#define GRID 500
{NULL, 0, NULL, 0,
- N_("Operation modifiers valid in copy-in and copy-out modes:"), GRID },
+ N_("Operation modifiers valid in copy-in and copy-out modes:"), GRID +1},
{"absolute-filenames", ABSOLUTE_FILENAMES_OPTION, 0, 0,
N_("Do not strip file system prefix components from the file names"),
GRID+1 },
@@ -224,7 +224,7 @@ static struct argp_option options[] = {
/* ********** */
#define GRID 600
{NULL, 0, NULL, 0,
- N_("Operation modifiers valid in copy-out and copy-pass modes:"), GRID },
+ N_("Operation modifiers valid in copy-out and copy-pass modes:"), GRID +1},
{"null", '0', 0, 0,
N_("Filenames in the list are delimited by null characters instead of newlines"), GRID+1 },
{"dereference", 'L', 0, 0,
@@ -236,7 +236,7 @@ static struct argp_option options[] = {
/* ********** */
#define GRID 700
{NULL, 0, NULL, 0,
- N_("Operation modifiers valid in copy-in and copy-pass modes:"), GRID },
+ N_("Operation modifiers valid in copy-in and copy-pass modes:"), GRID +1},
{"preserve-modification-time", 'm', 0, 0,
N_("Retain previous file modification times when creating files"), GRID+1 },
{"make-directories", 'd', 0, 0,
@@ -562,7 +562,7 @@ static struct argp argp = {
options,
parse_opt,
N_("[destination-directory]"),
- doc,
+ NULL,
NULL,
NULL,
NULL

215
man/latest-output Normal file
View File

@ -0,0 +1,215 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.1.
.TH CPIO "1" "September 2015" "cpio 2.12" "User Commands"
.SH NAME
cpio \- manual page for cpio 2.12
.SH SYNOPSIS
.B cpio
[\fI\,OPTION\/\fR...] [\fI\,destination-directory\/\fR]
.SH DESCRIPTION
.SS "Main operation mode:"
.TP
\fB\-i\fR, \fB\-\-extract\fR
Extract files from an archive (run in copy\-in
mode)
.TP
\fB\-o\fR, \fB\-\-create\fR
Create the archive (run in copy\-out mode)
.TP
\fB\-p\fR, \fB\-\-pass\-through\fR
Run in copy\-pass mode
.TP
\fB\-t\fR, \fB\-\-list\fR
Print a table of contents of the input
.SS "Operation modifiers valid in any mode:"
.TP
\fB\-\-block\-size\fR=\fI\,BLOCK\-SIZE\/\fR
Set the I/O block size to BLOCK\-SIZE * 512
bytes
.TP
\fB\-B\fR
Set the I/O block size to 5120 bytes
.TP
\fB\-c\fR
Identical to "\-H newc", use the new (SVR4)
portable format. If you wish the old portable
(ASCII) archive format, use "\-H odc" instead.
.TP
\fB\-C\fR, \fB\-\-io\-size\fR=\fI\,NUMBER\/\fR
Set the I/O block size to the given NUMBER of
bytes
.TP
\fB\-D\fR, \fB\-\-directory\fR=\fI\,DIR\/\fR
Change to directory DIR
.TP
\fB\-\-force\-local\fR
Archive file is local, even if its name contains
colons
.TP
\fB\-H\fR, \fB\-\-format\fR=\fI\,FORMAT\/\fR
Use given archive FORMAT
.TP
\fB\-\-quiet\fR
Do not print the number of blocks copied
.TP
\fB\-R\fR, \fB\-\-owner\fR=\fI\,[USER][\/\fR:.][GROUP]
Set the ownership of all files created to the
specified USER and/or GROUP
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Verbosely list the files processed
.TP
\fB\-V\fR, \fB\-\-dot\fR
Print a "." for each file processed
.TP
\fB\-W\fR, \fB\-\-warning\fR=\fI\,FLAG\/\fR
Control warning display. Currently FLAG is one of
\&'none', 'truncate', 'all'. Multiple options
accumulate.
.SS "Operation modifiers valid in copy-in and copy-out modes:"
.TP
\fB\-F\fR, \fB\-\-file\fR=\fI\,[[USER\/\fR@]HOST:]FILE\-NAME
Use this FILE\-NAME instead of standard input or
output. Optional USER and HOST specify the user
and host names in case of a remote archive
.TP
\fB\-M\fR, \fB\-\-message\fR=\fI\,STRING\/\fR
Print STRING when the end of a volume of the
backup media is reached
.TP
\fB\-\-rsh\-command\fR=\fI\,COMMAND\/\fR
Use COMMAND instead of rsh
.SS "Operation modifiers valid only in copy-in mode:"
.TP
\fB\-b\fR, \fB\-\-swap\fR
Swap both halfwords of words and bytes of
halfwords in the data. Equivalent to \fB\-sS\fR
.TP
\fB\-f\fR, \fB\-\-nonmatching\fR
Only copy files that do not match any of the given
patterns
.TP
\fB\-I\fR [[USER@]HOST:]FILE\-NAME Archive filename to use instead of standard input.
Optional USER and HOST specify the user and host
names in case of a remote archive
.TP
\fB\-n\fR, \fB\-\-numeric\-uid\-gid\fR
In the verbose table of contents listing, show
numeric UID and GID
.TP
\fB\-r\fR, \fB\-\-rename\fR
Interactively rename files
.TP
\fB\-s\fR, \fB\-\-swap\-bytes\fR
Swap the bytes of each halfword in the files
.TP
\fB\-S\fR, \fB\-\-swap\-halfwords\fR
Swap the halfwords of each word (4 bytes) in the
files
.TP
\fB\-\-to\-stdout\fR
Extract files to standard output
.TP
\fB\-E\fR, \fB\-\-pattern\-file\fR=\fI\,FILE\/\fR
Read additional patterns specifying filenames to
extract or list from FILE
.TP
\fB\-\-only\-verify\-crc\fR
When reading a CRC format archive, only verify the
checksum of each file in the archive, don't
actually extract the files
.SS "Operation modifiers valid only in copy-out mode:"
.TP
\fB\-A\fR, \fB\-\-append\fR
Append to an existing archive.
.TP
\fB\-\-device\-independent\fR, \fB\-\-reproducible\fR
Create device\-independent (reproducible) archives
.TP
\fB\-\-ignore\-devno\fR
Don't store device numbers
.TP
\fB\-O\fR [[USER@]HOST:]FILE\-NAME Archive filename to use instead of standard
output. Optional USER and HOST specify the user
and host names in case of a remote archive
.TP
\fB\-\-renumber\-inodes\fR
Renumber inodes
.SS "Operation modifiers valid only in copy-pass mode:"
.TP
\fB\-l\fR, \fB\-\-link\fR
Link files instead of copying them, when
possible
.SS "Operation modifiers valid in copy-in and copy-out modes:"
.TP
\fB\-\-absolute\-filenames\fR
Do not strip file system prefix components from
the file names
.TP
\fB\-\-no\-absolute\-filenames\fR
Create all files relative to the current
directory
.SS "Operation modifiers valid in copy-out and copy-pass modes:"
.TP
\fB\-0\fR, \fB\-\-null\fR
Filenames in the list are delimited by null
characters instead of newlines
.TP
\fB\-a\fR, \fB\-\-reset\-access\-time\fR
Reset the access times of files after reading them
.TP
\fB\-L\fR, \fB\-\-dereference\fR
Dereference symbolic links (copy the files
that they point to instead of copying the links).
.SS "Operation modifiers valid in copy-in and copy-pass modes:"
.TP
\fB\-d\fR, \fB\-\-make\-directories\fR
Create leading directories where needed
.TP
\fB\-m\fR, \fB\-\-preserve\-modification\-time\fR
Retain previous file modification times when
creating files
.TP
\fB\-\-no\-preserve\-owner\fR
Do not change the ownership of the files
.TP
\fB\-\-sparse\fR
Write files with large blocks of zeros as sparse
files
.TP
\fB\-u\fR, \fB\-\-unconditional\fR
Replace all files unconditionally
.TP
\-?, \fB\-\-help\fR
give this help list
.TP
\fB\-\-usage\fR
give a short usage message
.TP
\fB\-\-version\fR
print program version
.PP
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
.SH AUTHOR
Written by Phil Nelson, David MacKenzie, John Oleynick,
and Sergey Poznyakoff.
.SH "REPORTING BUGS"
Report bugs to <bug\-cpio@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2015 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B cpio
is maintained as a Texinfo manual. If the
.B info
and
.B cpio
programs are properly installed at your site, the command
.IP
.B info cpio
.PP
should give you access to the complete manual.