freebsd-skq/contrib/cpio
David E. O'Brien 895bfbc4e9 Output a zero rdev except for bdevs, cdevs, fifos and sockets. This
stops regular files with unrepresentable rdevs from being rejected
and makes the output independent of unpreservable metadata.

Don't output a file if the major, minor or totality of its rdev would be
truncated.  Print a message about the skipped files to stderr but don't
report the error in the exit status.  cpio's abysmal error handling doesn't
allow continuing after an error, and the rdev checks had to be misplaced
to avoid the problem of returning an error code from routines that return
void.

Minor numbers are limited to 21 bits in pax's ustar format and to 18
bits in archives created by gnu tar (gnu tar wastes 3 bits for padding).
pax's and cpio's ustar format is incompatible with gnu tar's ustar
format for other reasons (see cpio/README).

Submitted by:	bde via old gnu/usr.bin/cpio v2.3.
1997-03-30 10:34:16 +00:00
..
alloca.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
ChangeLog Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
copyin.c Fix typo. 1997-03-30 10:32:26 +00:00
COPYING Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
COPYING.LIB Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
copyout.c Output a zero rdev except for bdevs, cdevs, fifos and sockets. This 1997-03-30 10:34:16 +00:00
copypass.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
cpio.1 Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
cpio.h Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
cpiohdr.h Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
defer.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
defer.h Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
dirname.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
dstring.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
dstring.h Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
error.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
extern.h Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
filemode.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
filetypes.h Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
getopt1.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
getopt.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
getopt.h Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
global.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
idcache.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
main.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
makepath.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
NEWS Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
README Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
README.FreeBSD Don't need tcexparg.c on FreeBSD. 1997-03-29 23:05:27 +00:00
rmt.h Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
rtapelib.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
safe-stat.h Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
stripslash.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
system.h Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
tar.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
tar.h Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
tarhdr.h Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
userspec.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
util.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
version.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
xmalloc.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00
xstrdup.c Virgin import of GNU cpio v2.4.2. 1997-03-29 22:40:46 +00:00

This is GNU cpio, a program to manage archives of files.
As of version 2.0, it supports the features of the System V release 4
cpio, including support for tar archives.

This package also includes rmt, the remote tape server, and mt, a tape
drive control program; these two programs will only be compiled if
your system supports remote command execution, and tape drive control
operations, respectively.

See the file INSTALL for compilation and installation instructions for Unix.

For non-Unix systems:

makefile.pc is a makefile for Turbo C or C++ or Borland C++ on MS-DOS.

makefile.os2 is a makefile for MS C and GNU C (emx/gcc) on OS/2.
cpio.def is a linker definition file for the MS C OS/2 version.


The main advantages of GNU cpio over Unix versions are:

* It can access tape drives on other hosts using TCP/IP.

* `-o' and `-p' can copy symbolic links either as symbolic links or,
with `-L', as the files they point to.

* `-i' automatically recognizes the archive format and tries to
recover from corrupted archives.

* The output of '-itv' looks like 'ls -l'.

* It accepts long-named options as well as traditional
single-character options.

A few features of other versions of cpio are missing from GNU cpio, including:

* The `-6' option to support Sixth Edition Unix cpio archives with `-i'.

* An option to limit volume size, like afio -s.


GNU cpio supports the POSIX.1 "ustar" tar format.  GNU tar supports a
somewhat different, early draft of that format.  That draft format has
a slightly different magic number in the tar header and doesn't
include the path prefix part of the header, which allows storing file
names that are longer than 100 characters.  GNU cpio knows to
recognize the nonstandard GNU tar "ustar" archives.

The following patch to GNU tar 1.11.1 makes GNU tar recognize standard
"ustar" archives, such as GNU cpio produces, except that it won't use
the path prefix.  Without this patch, GNU tar thinks that standard
"ustar" archives are old-format tar archives and can not use the extra
information that "ustar" format contains.  If you use this patch,
remember that you will lose the beginnings of paths that are longer
than 100 characters.  That's why it's not an official part of GNU tar.
(Adding support for the path prefix to GNU tar is not trivial.)

--- list.c.orig Mon Sep 14 17:04:03 1992
+++ list.c      Wed Oct 14 14:02:28 1992
@@ -439,7 +439,7 @@
                st->st_ctime = from_oct(1+12, header->header.ctime);
        }
 
-       if (0==strcmp(header->header.magic, TMAGIC)) {
+       if (0==strncmp(header->header.magic, TMAGIC, 5)) {
                /* Unix Standard tar archive */
                *stdp = 1;
                if (wantug) {

Mail suggestions and bug reports for GNU cpio to
bug-gnu-utils@prep.ai.mit.edu.