Annotation of coherent/g/usr/bin/pax/doc/README, revision 1.1.1.1

1.1       root        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 1.1 of Pax, a public domain 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 USENIX Association provided some support for this implementation 
                     20:     project.  As a result, the Pax utility is being distributed free of 
                     21:     charge and may be redistributed by others in either source or binary 
                     22:     form.  (See the liscensing section for restrictions)
                     23: 
                     24:     The source for Pax is being posted to comp.sources.unix on USENET and 
                     25:     will also be available by anonymous FTP on the Internet from uunet.uu.net,
                     26:     moon.honeywell.com and from one of the Berkeley machines.  The source
                     27:     to Pax will be available via anonymous UUCP from jhereg.mn.org, the 
                     28:     author's home machine and possibly other sites.
                     29: 
                     30:     The source for Pax will continue to change as long as the definition of 
                     31:     the utility is modified by the 1003.2 working group.  (For example, 
                     32:     there are a number of changes in Draft 8 which will be incorporated as 
                     33:     soon as Draft 8 is available).  Additional modifications will be made 
                     34:     based on user input, such as request for support of additional archive 
                     35:     formats, etc.  Patches and new releases will be made as new functionality 
                     36:     is added or problems are diagnosed and fixed.
                     37: 
                     38: 
                     39: Installation
                     40: 
                     41:     In order to install Pax, you must first edit the Makefile and the 
                     42:     config.h file according to the directions in each of the files.  
                     43:     These two files provide the configuration information for most 
                     44:     commonly available machines.  Please be sure to read through all 
                     45:     the directions in each of these files before attempting to compile
                     46:     Pax.
                     47: 
                     48: 
                     49: Portability
                     50: 
                     51:     Pax is intended to run on as many systems as possible.  If you have
                     52:     problems getting Pax to compile or run on your system, please let me 
                     53:     know so that the source or the installation procedure can be modified.
                     54: 
                     55:     Pax has been tested and appears to run correctly on the following 
                     56:     machines:
                     57: 
                     58:         Machine                 Operating System/Release
                     59:        -------------------------------------------------------
                     60:        Altos 586               System III (2.3)
                     61:        AT&T UNIX PC            System V.2 (Release 3.51)
                     62:        Cray 2                  UNICOS
                     63:        HP 9000                 HP/UX 6.0.1
                     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:        Sun 2                   SunOS 3.4
                     71:        Sun 2                   SunOS 3.5
                     72:        Sun 3                   SunOS 3.4
                     73:        Sun 3                   SunOS 3.5
                     74:        Sun 3                   SunOS 4.0
                     75:        Sun 4                   SunOS 4.0
                     76:        VAX 8750                BSD 4.3 (Mt. Xinu)
                     77:        VAX 8650                BSD 4.3 (Mt. Xinu)
                     78:        VAX 780                 BSD 4.3 (Berkeley)
                     79:        -------------------------------------------------------
                     80: 
                     81:     In future releases, the source will be moving toward ANSI C and POSIX 
                     82:     compatibility.  This should allow for portability over any system 
                     83:     supporting both ANSI and POSIX.  In addition, POSIX/ANSI portability 
                     84:     library routines will be developed which will allow the code to run on 
                     85:     the standard machines available now.
                     86: 
                     87: 
                     88: Credit Where Credit is Due
                     89: 
                     90:     Parts of the code which makes up Pax were gleaned from a number of 
                     91:     different sources: the directory access routines in paxdir.h are 
                     92:     modified copies of Doug Gwyn's dirent library; the regular expression 
                     93:     matching routines in regexp.c are from Henry Spencer, some of the tar 
                     94:     archive routines were initially written by John Gilmore for his PDTAR; 
                     95:     and finally afio, written by Mark Brukhartz at Lachman Associates, was 
                     96:     the basis for the buffering schemes used in pax.
                     97: 
                     98: 
                     99: Licensing
                    100: 
                    101:     Copyright (c) 1989 Mark H. Colburn.  
                    102:     All rights reserved.
                    103: 
                    104:     Redistribution and use in source and binary forms are permitted
                    105:     provided that the above copyright notice is duplicated in all such 
                    106:     forms and that any documentation, advertising materials, and other 
                    107:     materials related to such distribution and use acknowledge that the 
                    108:     software was developed by Mark H. Colburn and sponsored by The 
                    109:     USENIX Association. 
                    110: 
                    111:     THE SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
                    112:     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
                    113:     WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                    114: 
                    115: Please report any bug or problems to:
                    116: 
                    117: Mark Colburn
                    118: NAPS International
                    119: 117 Mackubin St., Suite 1
                    120: St. Paul MN   55102
                    121: (612) 224-9108
                    122: [email protected]

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.