home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 9 Archive / 09-Archive.zip / PAX20.ZIP / README < prev    next >
Text File  |  1990-11-12  |  8KB  |  197 lines
  1. PAX - Portable Archive Interchange
  2.  
  3. Copyright (C) 1989 Mark H. Colburn
  4. All Rights Reserved.
  5.  
  6.  
  7. Introduction
  8.  
  9.     This is version 2.0 of Pax, an archiving utility.
  10.  
  11.     Pax is an archiving utility that reads and writes tar and cpio formats,
  12.     both the traditional ones and the extended formats specified in IEEE
  13.     1003.1.  It handles multi-volume archives and automatically determines
  14.     the format of an archive while reading it.  Three user interfaces are
  15.     supported: tar, cpio, and pax.  The pax interface was designed by IEEE
  16.     1003.2 as a compromise in the chronic controversy over which of tar or
  17.     cpio is best.
  18.  
  19.     The Pax utility is being distributed free of charge and may be
  20.     redistributed by others in either source or binary form.  (See the
  21.     liscensing section for restrictions)
  22.  
  23.     The source for Pax has been posted to comp.sources.unix on USENET and
  24.     will also be available by anonymous FTP on the Internet from uunet.uu.net,
  25.     moon.src.honeywell.com and from ucb-arpa.berkeley.edu.  The source
  26.     to Pax is also available via anonymous UUCP from minnetech.mn.org, the
  27.     author's home machine and possibly other sites.
  28.  
  29.     The source for Pax will continue to change as long as the definition of
  30.     the utility is modified by the 1003.2 working group.  (For example,
  31.     there are a number of changes in Draft 8 which will be incorporated as
  32.     soon as Draft 8 is available).  Additional modifications will be made
  33.     based on user input, such as request for support of additional archive
  34.     formats, etc.  Patches and new releases will be made as new functionality
  35.     is added or problems are diagnosed and fixed.
  36.  
  37.  
  38. Installation
  39.  
  40.     In order to install Pax, you must run the Configure script.
  41.     In addition, if your systems does not have at least a somewhat POSIX
  42.     compliant <limits.h>, then you may have to tweak some of the values in
  43.     limits.h.
  44.  
  45. Portability
  46.  
  47.     Pax is intended to run on as many systems as possible.  If you have
  48.     problems getting Pax to compile or run on your system, please let me
  49.     know so that the source or the installation procedure can be modified.
  50.  
  51.     Pax has been tested and appears to run correctly on the following
  52.     machines:
  53.  
  54.         Machine                 Operating System/Release
  55.     ---------------------------------------------------
  56.     Altos 586        System III (2.3)
  57.     AT&T UNIX PC        System V.2 (Release 3.51)
  58.         Convergent S/320    CTIX/68k 6.1, UNIX SysV 3.1
  59.         Convergent S/80        CTIX/68k 6.1, UNIX SysV 3.1
  60.     Cray 2            UNICOS
  61.     Encore CC        02.00.r088
  62.     HP 9000            HP/UX 6.0.1
  63.         IBM PC/AT        Microport SV/AT V2.4
  64.     Mac II             A/UX 1.0
  65.     NCR Tower        System V.2
  66.     Pyramid            AT&T and Berkeley universe
  67.     Sequent Symetry        Dynix 3.0
  68.     SGI Iris 4D/60G        UNIX 3.0
  69.     SGI Iris 4D/70G        UNIX 3.0
  70.     SCO Xenix 386         2.3.2
  71.     SCO Unix 386         3.2
  72.     Sun 2            SunOS 3.4
  73.     Sun 2            SunOS 3.5
  74.     Sun 3            SunOS 3.4
  75.     Sun 3            SunOS 3.5
  76.     Sun 3            SunOS 4.0
  77.     Sun 4            SunOS 4.0
  78.     VAX 8750        BSD 4.3 (Mt. Xinu)
  79.     VAX 8650        BSD 4.3 (Mt. Xinu)
  80.     VAX 780            BSD 4.3 (Berkeley)
  81.     ---------------------------------------------------
  82.  
  83.     In future releases, the source will be moving toward ANSI C and POSIX
  84.     compatibility.  This should allow for portability over any system
  85.     supporting both ANSI and POSIX.  In addition, POSIX/ANSI portability
  86.     library routines will be developed which will allow the code to run on
  87.     the standard machines available now.
  88.  
  89.  
  90. DOS stuff:
  91.  
  92.     It has been tested only with the Microsoft C V5.1 compiler.  It
  93.     supports both the DOS filesystem and the "tape on a disk" system
  94.     used by micro UN*X systems.  This will allow for easy transfer of
  95.     files to and from UN*X systems.  To get TAR.EXE and CPIO.EXE just
  96.     copy PAX.EXE to TAR.EXE and CPIO.EXE.  To use the "tape on a disk"
  97.     feature give an archive filename of "a:dio" or "b:dio" (dio stands
  98.     for direct I/O) for floppy drives "a" and "b".  This program will
  99.     support any media supported by DOS, but you MUST do a DIR on an
  100.     MSDOS formatted disk at the density you want to use before using
  101.     PAX, TAR, or CPIO with direct I/O.  Note that the direct I/O
  102.     destroys the logical structure of the disk.  Multiple volumes and
  103.     the tar append option are supported.
  104.  
  105.     The problems with forward and backward slashes have been fixed.
  106.     Note that this is a 3 in 1 program.  PAX.EXE may be renamed to
  107.     TAR.EXE or CPIO.EXE to get that default funcionality. Since
  108.     MSDOS 2.X does not report the file name to the program, those
  109.     users will have to use the pax interface (which is the default) as
  110.     described in pax.man. Note that both tar and cpio archives can
  111.     be accessed through the pax interface. True dos character device
  112.     support (eg. a tape drive with a character device driver,
  113.     inspired by John B. Theil) has been added, but is only available
  114.     when the archive filename is supplied on the command line (not
  115.     stdin-stdout).
  116.  
  117.     This program does not do ANY translation on data files OR file
  118.     names other than changing backslashes to forward slashes and
  119.     uppercase to lowercase in the file names when writing an archive
  120.     on an MSDOS machine.
  121.  
  122.     Examples:
  123.  
  124.     Using direct i/o on a floppy with tar.exe (a:dio and b:dio are special)
  125.  
  126.         1) Put high or low density MSDOS formatted floppy in drive "a".
  127.         2) Do a DIR (this is a required step)
  128.         3) Remove the floppy
  129.         4) Put a floppy in drive "a" with the same density as step 1
  130.         5) tar cvf "a:dio" .
  131.  
  132.     Using direct i/o on a floppy with cpio.exe (a:dio and b:dio are special)
  133.  
  134.         1) Put high or low density MSDOS formatted floppy in drive "a".
  135.         2) Do a DIR (this is a required step)
  136.         3) Remove the floppy
  137.         4) Put a floppy in drive "a" with the same density as step 1
  138.         5) find . -print | cpio -ocvBD "a:dio"
  139.  
  140.     Using direct i/o on a floppy with pax.exe and the tar archive format
  141.     (a:dio and b:dio are special)
  142.  
  143.         1) Put high or low density MSDOS formatted floppy in drive "a".
  144.         2) Do a DIR (this is a required step)
  145.         3) Remove the floppy
  146.         4) Put a floppy in drive "a" with the same density as step 1
  147.         5) pax -w -b 20 -f "a:dio" -x ustar .
  148.  
  149.     Using tar.exe within the MSDOS filesystem (the filename does not matter)
  150.     Will not destroy the logical structure of the disk.  Similarly for
  151.     cpio.exe and pax.exe.
  152.  
  153.         1) Put high or low density MSDOS formatted floppy in drive "a".
  154.         2) tar cvf "a:whatever.tar" .
  155.  
  156.     Using tar.exe within the MSDOS filesystem to a character device like a
  157.     tape drive.
  158.  
  159.         1) Put tape in tape drive
  160.         2) tar cvf "/dev/tape" .
  161.  
  162.  
  163. Credit Where Credit is Due
  164.  
  165.     Parts of the code which makes up Pax were gleaned from a number of
  166.     different sources: the directory access routines in ./dirent/ are
  167.     copies of Doug Gwyn's dirent library; some of the tar archive
  168.     routines were initially written by John Gilmore for his PDTAR;
  169.     Harold Walters provided the basis for the MSDOS support and
  170.     finally afio, written by Mark Brukhartz at Lachman Associates, was
  171.     the basis for the buffering schemes used in pax.
  172.  
  173.  
  174. Licensing
  175.  
  176.     Copyright (c) 1989 Mark H. Colburn.
  177.     All rights reserved.
  178.  
  179.     Redistribution and use in source and binary forms are permitted
  180.     provided that the above copyright notice is duplicated in all such
  181.     forms and that any documentation, advertising materials, and other
  182.     materials related to such distribution and use acknowledge that the
  183.     software was developed by Mark H. Colburn.
  184.  
  185.     THE SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
  186.     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  187.     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  188.  
  189. Please report any bug or problems to:
  190.  
  191. Mark Colburn
  192. Open Systems Architects, Inc.
  193. 7555 Marketplace Drive
  194. Eden Prairie, MN 55344
  195.  
  196. mark@minnetech.MN.ORG
  197.