$NetBSD: patch-ab,v 1.2 1998/08/07 10:35:48 agc Exp $ --- cpio.1.orig Wed Nov 30 19:23:38 1994 +++ cpio.1 Tue Mar 3 14:11:31 1998 @@ -1,8 +1,8 @@ .TH CPIO 1L \" -*- nroff -*- .SH NAME -cpio \- copy files to and from archives +gcpio \- GNU cpio, copy files to and from archives .SH SYNOPSIS -.B cpio +.B gcpio {\-o|\-\-create} [\-0acvABLV] [\-C bytes] [\-H format] [\-M message] [\-O [[user@]host:]archive] [\-F [[user@]host:]archive] [\-\-file=[[user@]host:]archive] [\-\-format=format] [\-\-message=message] @@ -10,7 +10,7 @@ [\-\-block-size=blocks] [\-\-dereference] [\-\-io-size=bytes] [\-\-quiet] [\-\-force\-local] [\-\-help] [\-\-version] < name-list [> archive] -.B cpio +.B gcpio {\-i|\-\-extract} [\-bcdfmnrtsuvBSV] [\-C bytes] [\-E file] [\-H format] [\-M message] [\-R [user][:.][group]] [\-I [[user@]host:]archive] [\-F [[user@]host:]archive] [\-\-file=[[user@]host:]archive] @@ -22,7 +22,7 @@ [\-\-force\-local] [\-\-no\-absolute\-filenames] [\-\-sparse] [\-\-only\-verify\-crc] [\-\-quiet] [\-\-help] [\-\-version] [pattern...] [< archive] -.B cpio +.B gcpio {\-p|\-\-pass-through} [\-0adlmuvLV] [\-R [user][:.][group]] [\-\-null] [\-\-reset-access-time] [\-\-make-directories] [\-\-link] [\-\-quiet] [\-\-preserve-modification-time] [\-\-unconditional] [\-\-verbose] [\-\-dot] @@ -32,16 +32,16 @@ This manual page documents the GNU version of .BR cpio . -.B cpio +.B gcpio copies files into or out of a cpio or tar archive, which is a file that contains other files plus information about them, such as their file name, owner, timestamps, and access permissions. The archive can be another file on the disk, a magnetic tape, or a pipe. -.B cpio +.B gcpio has three operating modes. .PP In copy-out mode, -.B cpio +.B gcpio 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 @@ -52,7 +52,7 @@ directories that are unwritable or not searchable. .PP In copy-in mode, -.B cpio +.B gcpio 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 @@ -63,14 +63,14 @@ extracted. .PP In copy-pass mode, -.B cpio +.B gcpio 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. .PP -.B cpio +.B gcpio supports the following archive formats: binary, old ASCII, new ASCII, crc, HPUX binary, HPUX old ASCII, old tar, and POSIX.1 tar. The binary format @@ -86,7 +86,7 @@ The crc format is like the new ASCII format, but also contains a checksum for each file which -.B cpio +.B gcpio calculates when creating an archive and verifies when the file is extracted from the archive. The HPUX formats are provided for compatibility with HPUX's cpio which @@ -102,18 +102,18 @@ than 255 characters (less unless they have a "/" in just the right place). .PP By default, -.B cpio +.B gcpio creates binary format archives, for compatibility with older .B cpio programs. When extracting from archives, -.B cpio +.B gcpio automatically recognizes which kind of archive it is reading and can read archives created on machines with a different byte-order. .PP Some of the options to -.B cpio +.B gcpio apply only to certain operating modes; see the SYNOPSIS section for a list of which options are allowed in which modes. .SS OPTIONS @@ -164,7 +164,7 @@ In copy-in mode, read additional patterns specifying filenames to extract or list from FILE. The lines of FILE are treated as if they had been non-option arguments to -.BR cpio . +.BR gcpio . .TP .I "\-f, \-\-nonmatching" Only copy files that do not match any of the given patterns. @@ -322,5 +322,5 @@ .TP .I "\-\-version" Print the -.B cpio +.B gcpio program version number and exit.