contrib/cpio/README

   1 This is GNU cpio, a program to manage archives of files.
   2 As of version 2.0, it supports the features of the System V release 4
   3 cpio, including support for tar archives.
   4
   5 This package also includes rmt, the remote tape server, and mt, a tape
   6 drive control program; these two programs will only be compiled if
   7 your system supports remote command execution, and tape drive control
   8 operations, respectively.
   9
  10 See the file INSTALL for compilation and installation instructions for Unix.
  11
  12 For non-Unix systems:
  13
  14 makefile.pc is a makefile for Turbo C or C++ or Borland C++ on MS-DOS.
  15
  16 makefile.os2 is a makefile for MS C and GNU C (emx/gcc) on OS/2.
  17 cpio.def is a linker definition file for the MS C OS/2 version.
  18
  19
  20 The main advantages of GNU cpio over Unix versions are:
  21
  22 * It can access tape drives on other hosts using TCP/IP.
  23
  24 * `-o' and `-p' can copy symbolic links either as symbolic links or,
  25 with `-L', as the files they point to.
  26
  27 * `-i' automatically recognizes the archive format and tries to
  28 recover from corrupted archives.
  29
  30 * The output of '-itv' looks like 'ls -l'.
  31
  32 * It accepts long-named options as well as traditional
  33 single-character options.
  34
  35 A few features of other versions of cpio are missing from GNU cpio, including:
  36
  37 * The `-6' option to support Sixth Edition Unix cpio archives with `-i'.
  38
  39 * An option to limit volume size, like afio -s.
  40
  41
  42 GNU cpio supports the POSIX.1 "ustar" tar format.  GNU tar supports a
  43 somewhat different, early draft of that format.  That draft format has
  44 a slightly different magic number in the tar header and doesn't
  45 include the path prefix part of the header, which allows storing file
  46 names that are longer than 100 characters.  GNU cpio knows to
  47 recognize the nonstandard GNU tar "ustar" archives.
  48
  49 The following patch to GNU tar 1.11.1 makes GNU tar recognize standard
  50 "ustar" archives, such as GNU cpio produces, except that it won't use
  51 the path prefix.  Without this patch, GNU tar thinks that standard
  52 "ustar" archives are old-format tar archives and can not use the extra
  53 information that "ustar" format contains.  If you use this patch,
  54 remember that you will lose the beginnings of paths that are longer
  55 than 100 characters.  That's why it's not an official part of GNU tar.
  56 (Adding support for the path prefix to GNU tar is not trivial.)
  57
  58 --- list.c.orig Mon Sep 14 17:04:03 1992
  59 +++ list.c      Wed Oct 14 14:02:28 1992
  60 @@ -439,7 +439,7 @@
  61                 st->st_ctime = from_oct(1+12, header->header.ctime);
  62         }
  63
  64 -       if (0==strcmp(header->header.magic, TMAGIC)) {
  65 +       if (0==strncmp(header->header.magic, TMAGIC, 5)) {
  66                 /* Unix Standard tar archive */
  67                 *stdp = 1;
  68                 if (wantug) {
  69
  70 Mail suggestions and bug reports for GNU cpio to
  71 bug-gnu-utils@prep.ai.mit.edu.