From 2a3bb6a8a48c23728e1b182ce668e5ebacf0f2ce Mon Sep 17 00:00:00 2001 From: Pavel Raiskup Date: Mon, 14 Sep 2015 13:53:34 +0200 Subject: [PATCH] man: (re)generate by help2man 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 --- cpio.1 | 393 +++++++++++++++++++++++-------------------- cpio.spec | 5 +- man/README | 19 +++ man/cpio | 16 ++ man/downstream.patch | 357 +++++++++++++++++++++++++++++++++++++++ man/help.patch | 88 ++++++++++ man/latest-output | 215 +++++++++++++++++++++++ 7 files changed, 906 insertions(+), 187 deletions(-) create mode 100644 man/README create mode 100755 man/cpio create mode 100644 man/downstream.patch create mode 100644 man/help.patch create mode 100644 man/latest-output diff --git a/cpio.1 b/cpio.1 index e227c7a..670277c 100644 --- a/cpio.1 +++ b/cpio.1 @@ -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 -*- .SH NAME 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. .PP .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] [\-\-file=[[user@]host:]archive] [\-\-format=format] [\-\-warning=FLAG] [\-\-message=message][\-\-null] [\-\-reset\-access\-time] [\-\-verbose] @@ -52,6 +55,7 @@ extracted. see \*(lqOptions\*(rq. .PP .B cpio {\-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] @@ -62,6 +66,8 @@ extracted. see \*(lqOptions\*(rq. [\-\-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 @@ -74,7 +80,7 @@ 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]] +{\-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]] @@ -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 on machines with a different byte-order. .PP -.SH OPTIONS +.SS "Main operation mode:" .TP -`\fB\-0, \-\-null\fR' -Read a list of filenames terminated by a null character, instead -of a newline, 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. This option may be used in copy-out -and copy-pass modes. +\fB\-i\fR, \fB\-\-extract\fR +Extract files from an archive (run in copy\-in +mode) .TP -`\fB\-a, \-\-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. +\fB\-o\fR, \fB\-\-create\fR +Create the archive (run in copy\-out mode) .TP -`\fB\-A, \-\-append\fR' -Append to an existing archive. Only works in copy-out mode. The -archive must be a disk file specified with the \-O or \-F (\-file) -option. +\fB\-p\fR, \fB\-\-pass\-through\fR +Run in copy\-pass mode .TP -`\fB\-b, \-\-swap\fR' -Swap both halfwords of words and bytes of halfwords in the data. -Equivalent to \-sS. This option may be used in copy-in mode. Use -this option to convert 32\-bit integers between big-endian and -little-endian machines. +\fB\-t\fR, \fB\-\-list\fR +Print a table of contents of the input +.SS "Operation modifiers valid in any mode:" .TP -`\fB\-B\fR' -Set the I/O block size to 5120 bytes. Initially the block size is -512 bytes. +\fB\-\-block\-size\fR=\fI\,BLOCK\-SIZE\/\fR +Set the I/O block size to BLOCK\-SIZE * 512 +bytes .TP -`\fB\-\-block\-size=BLOCK\-SIZE\fR' -Set the I/O block size to BLOCK-SIZE * 512 bytes. +\fB\-B\fR +Set the I/O block size to 5120 bytes. +Initially the block size is 512 bytes. .TP -`\fB\-c\fR' -Identical to \*(lq\-H newc\*(rq, use the new (\s-1SVR4\s0) portable format. -If you wish the old portable (\s-1ASCII\s0) archive format, use \*(lq\-H odc\*(rq instead. +\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 \s-1IO\-SIZE\s0, \-\-io\-size=IO\-SIZE\fR' -Set the I/O block size to IO-SIZE bytes. +\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, \-\-make\-directories\fR' -Create leading directories where needed. +\fB\-D\fR, \fB\-\-directory\fR=\fI\,DIR\/\fR +Change to directory DIR .TP -`\fB\-E \s-1FILE\s0, \-\-pattern\-file=FILE\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' +\fB\-\-force\-local\fR 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 \s-1FORMAT\s0, \-\-format=FORMAT\fR' -Use archive format \s-1FORMAT\s0. 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'. +\fB\-H\fR, \fB\-\-format\fR=\fI\,FORMAT\/\fR +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. @@ -188,113 +173,17 @@ device files differently). The portable format used by \s-1HPUX\s0's cpio (which stores device files differently). .TP -`\fB\-i, \-\-extract\fR' -Run in copy-in mode. see \*(lqCopy\-in mode\*(rq. +\fB\-\-quiet\fR +Do not print the number of blocks copied .TP -`\fB\-I archive\fR' -Archive filename to use instead of standard input. 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). +\fB\-R\fR, \fB\-\-owner\fR=\fI\,[USER][\/\fR:.][GROUP] +Set the ownership of all files created to the +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\-k\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' +\fB\-v\fR, \fB\-\-verbose\fR 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 @@ -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 archive. .TP -`\fB\-V, \-\-dot\fR' -Print a `\fB.\fR' for each file processed. +\fB\-V\fR, \fB\-\-dot\fR +Print a "." for each file processed .TP -`\fB\-W, \-\-warning\fR' -Control warning display. Currently FLAG is one of 'none', 'truncate', 'all'. Multiple options accumulate. +\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\-\-license\fR' -Print license and exit. +\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?, \-\-help\fR' -Give a help page similar to this manpage. +\fB\-M\fR, \fB\-\-message\fR=\fI\,STRING\/\fR +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\-\-usage\fR' -Give a short usage message. +\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\-\-version\fR' -Print the cpio program version number and exit. +\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. +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 .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 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 -.B cpio -falls -into this category. Thus this man page may not be complete, nor current, and was included in the Red Hat -CVS tree because man is a great tool :). -.PP -.SH REPORTING BUGS -Please report bugs via https://bugzilla.redhat.com. -.PP -.SH SEE ALSO + +.SH AUTHOR +Written by Phil Nelson, David MacKenzie, John Oleynick, +and Sergey Poznyakoff. +.SH "REPORTING BUGS" +Report bugs to . +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 . +.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 @@ -410,8 +431,8 @@ programs are properly installed at your site, the command .IP .B info cpio .PP -should give you access to the complete manual. The online copy of the documentation -is available at the following address: +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 - diff --git a/cpio.spec b/cpio.spec index 95eb704..abdff37 100644 --- a/cpio.spec +++ b/cpio.spec @@ -1,7 +1,7 @@ Summary: A GNU archiving program Name: cpio Version: 2.12 -Release: 1%{?dist} +Release: 2%{?dist} License: GPLv3+ Group: Applications/Archiving URL: http://www.gnu.org/software/cpio/ @@ -114,6 +114,9 @@ fi %{_infodir}/*.info* %changelog +* Mon Sep 14 2015 Pavel Raiskup - 2.12-2 +- (re)generate manual page for new options + * Mon Sep 14 2015 Pavel Raiskup - 2.12-1 - rebase, per release notes http://lists.gnu.org/archive/html/bug-cpio/2015-09/msg00004.html diff --git a/man/README b/man/README new file mode 100644 index 0000000..0074a64 --- /dev/null +++ b/man/README @@ -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` diff --git a/man/cpio b/man/cpio new file mode 100755 index 0000000..1d09635 --- /dev/null +++ b/man/cpio @@ -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 diff --git a/man/downstream.patch b/man/downstream.patch new file mode 100644 index 0000000..c2d69a1 --- /dev/null +++ b/man/downstream.patch @@ -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 . ++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 . +@@ -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 diff --git a/man/help.patch b/man/help.patch new file mode 100644 index 0000000..b092122 --- /dev/null +++ b/man/help.patch @@ -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 diff --git a/man/latest-output b/man/latest-output new file mode 100644 index 0000000..83af8a3 --- /dev/null +++ b/man/latest-output @@ -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 . +.SH COPYRIGHT +Copyright \(co 2015 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later . +.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.