home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / gnu / cpio-2.3-src.lha.pi < prev    next >
Text File  |  1995-04-15  |  4KB  |  82 lines
  1. .name
  2. cpio
  3. .fullname
  4. GNU cp in/out program
  5. .type
  6. System Administration
  7. .short
  8. GNU utility to copy to/from archives.
  9. .description
  10. Cpio copies files into or out of a cpio or tar archive, which is a
  11. file that contains other files plus information about them, such as
  12. their pathname, owner, timestamps, and access permissions.  The
  13. archive can be another file on the disk, a magnetic tape, or a pipe.
  14. Cpio has three operating modes.  In copy-out mode, cpio copies files
  15. into an archive.  It reads a list of filenames, one per line, on the
  16. standard input, and writes the archive onto the standard output.  A
  17. typical way to generate the list of filenames is with the find
  18. command; you should give find the -depth option to minimize problems
  19. with permissions on directories that are unwritable or not searchable.
  20.  
  21. In copy-in mode, cpio copies files out of an archive or lists the
  22. archive contents.  It reads the archive from the standard input.  Any
  23. non-option command line arguments are shell globbing patterns; only
  24. files in the archive whose names match one or more of those patterns
  25. are copied from the archive.  Unlike in the shell, an initial `.' in a
  26. filename does match a wildcard at the start of a pattern, and a `/' in
  27. a filename can match wildcards.  If no patterns are given, all files
  28. are extracted.
  29.  
  30. In copy-pass mode, cpio copies files from one directory tree to
  31. another, combining the copy-out and copy-in steps without actually
  32. using an archive.  It reads the list of files to copy from the
  33. standard input; the directory into which it will copy them is given as
  34. a non-option argument.
  35.  
  36. Cpio supports the following archive formats: binary, old ASCII, new
  37. ASCII, crc, HPUX binary, HPUX old ASCII, old tar, and POSIX.1 tar.
  38. The binary format is obsolete because it encodes information about the
  39. files in a way that is not portable between different machine
  40. architectures.  The old ASCII format is portable between different
  41. machine architectures, but should not be used on file systems with
  42. more than 65536 i-nodes.  The new ASCII format is portable between
  43. different machine architectures and can be used on any size file
  44. system, but is not supported by all versions of cpio; currently, it is
  45. only supported by GNU and Unix System V R4.  The crc format is like
  46. the new ASCII format, but also contains a checksum for each file which
  47. cpio calculates when creating an archive and verifies when the file is
  48. extracted from the archive.  The HPUX formats are provided for
  49. compatibility with HPUX's cpio which stores device files differently.
  50.  
  51. The tar format is provided for compatability with the tar program.  It
  52. can not be used to archive files with names longer than 100
  53. characters, and can not be used to archive "special" (block or
  54. character devices) files.  The POSIX.1 tar format can not be used to
  55. archive files with names longer than 255 characters (less unless they
  56. have a "/" in just the right place).
  57.  
  58. By default, cpio creates binary format archives, for compatibility
  59. with older cpio programs.  When extracting from archives, cpio
  60. automatically recognizes which kind of archive it is reading and can
  61. read archives created on machines with a different byte-order.
  62.  
  63. Some of the options to cpio apply only to certain operating modes; see
  64. the SYNOPSIS section for a list of which options are allowed in which
  65. modes.
  66. .version
  67. 2.3
  68. .author
  69. Phil Nelson
  70. David MacKenzie
  71. John Oleynick
  72. .email
  73. phil@cs.wwu.edu
  74. djm@gnu.ai.mit.edu
  75. juo@klinzhai.rutgers.edu
  76. .requirements
  77. The binary requires ixemul.library.
  78. .distribution
  79. GNU Public License
  80. .described-by
  81. Fred Fish (fnf@amigalib.com)
  82.