BSD 4_3 development

[unix-history] / usr / contrib / kermit / README

The files in this directory represent the Unix version 4C(057) of Kermit as
of 7/31/85.  All other versions are available from Columbia University by means
described below.  Their brochure and order form follow.  The file ckaaaa.hlp
describes the other files in this directory.

This is the Columbia University Kermit brochure and order form as of June 1985.
If a lot of time has passed since then, chances are that it will be obsolete,
in which case you should inquire at the address below or call 212-280-3703 to
find out if the terms and conditions have changed, or whether any new systems
have been added to the list of those supported by Kermit.

******************************
\f
              Columbia University Center for Computing Activities

                       THE KERMIT FILE TRANSFER PROTOCOL

                                   June 1985



Kermit is a protocol for transferring sequential files between computers of all
sizes over ordinary asynchronous telecommunication lines using packets,  check-
sums, and retransmission to promote data integrity.  Kermit is non-proprietary,
thoroughly documented, and in wide use.  The  protocol  and  the  original  im-
plementations  were  developed at Columbia University and have been shared with
many other institutions, some of which have made significant  contributions  of
their  own.  Kermit is presently available for more than 100 different machines
and operating systems, and additional versions are  always  under  development.
Current implementations include:

  Unix (V7, 4.x BSD, System III, System V, Xenix, Venix, PC/IX; C language)
  Software Tools (various systems; Ratfor)

  Burroughs B6800, B7900 (Algol)
  Cray-1, Cray-XMP (CTSS; Fortran-77)
  CDC Cyber 170 (NOS, NOS/BE; Fortran-77)
  Data General Nova (RDOS; Fortran-5)
  Data General AOS (Fortran-5), AOS/VS (Pascal)
  DEC PDP-11 (RT11,RSX11M(+),RSTS,P/OS,TSX+; Macro-11), (MUMPS; MUMPS-11)
  DEC VAX-11 (VMS; Bliss-32 or Macro-32), (VMS; Pascal/Fortran)
  DECsystem-10 (TOPS-10; Bliss-36, Macro-10)
  DECSYSTEM-20 (TOPS-20; Macro-20)
  Harris 800 (VOS; Pascal)
  Honeywell (MULTICS; PL/I), DPS-6,8 (GCOS; C, B), CP6 (Pascal)
  Hewlett-Packard 1000 (RTE-6/VM; Fortran), HP3000 (MPE; SPL or Fortran)
  IBM 370-Series (VM/CMS, MVS/TSO, MVS/GUTS, MTS, MUSIC; Assembler)
  Perkin-Elmer 3200 Series (OS32; Fortran)
  PRIME (PRIMOS; PL/P)
  Sperry/Univac-1100 (EXEC; Assembler or Ratfor or Pascal)
  Tandem (Nonstop; TAL)

  CP/M-80 (about 20 different systems; ASM)
  CP/M-86 (DEC Rainbow, NEC APC, and several other systems; ASM86)
  MS-DOS, PC-DOS (IBM PC,XT,AT, DEC Rainbow, and many other systems; MASM)
  UCSD p-System (IBM PC, Terak, and other systems; Pascal)

  Alpha Micro 68000 (Alpha 68K Assembler)
  Apollo (Aegis; Pascal)
  Apple II 6502 (Apple DOS; DEC-10/20 CROSS or Apple Assembler)
  Apple Macintosh (SUMACC C)
  Atari (DOS; Action!)
  Commodore 64 (DEC-10/20 CROSS or FORTH)
  DEC Pro-300 Series (P/OS; Bliss-16 or Macro-11),(Pro/RT; Macro),(Venix; C)
  Intel Development System (ISIS; PL/M)
  NCR Tower (OS 1.02; C)
  Perq (Pascal)
  TRS80 Models I,III,4 (TRSDOS; ASM), Model 16 (Xenix; C), Color Computer (Asm)

The  IBM  mainframe Kermits work only with asynchronous TTY connections through
3705 or equivalent front ends.  The VM/CMS and MVS/TSO versions  also  have  an
\f
option  to  allow file transfer through Series/1 or other front ends supporting
the Yale ASCII Communications System;  beyond  that  exception,  Kermit  cannot
transfer  files in the IBM synchronous 3270-style full screen terminal environ-
ment.

The Kermit software -- including source -- is furnished free, without  license,
and  with no restriction on copying or redistribution except that it should not
be sold for profit, and that any copyright notices must be left intact.   Under
certain  conditions  (described  in a separate document) software producers may
include Kermit protocol in their products.  Kermit software  and  documentation
is furnished without warranty of any kind, and neither Columbia University, nor
the individual  authors,  nor  any  institution  that  has  contributed  Kermit
material, acknowledge any liability for any claims arising from the use of Ker-
mit.

Although the Kermit software is free and unlicensed, Columbia University cannot
afford  to  distribute  it for free because the demand is too great.  To defray
our costs for media, printing, postage, labor, and computing resources, we  re-
quire  a  moderate distribution fee from those who request Kermit directly from
us.  The schedule is given on the Kermit Order Form.    Alternate  sources  for
Kermit material are listed below.

Kermit  is  distributed  by  Columbia University only on 9-track magnetic tape,
suitable for reading on most mainframe and minicomputers.  It is  assumed  that
Kermit  will  be  ordered in this form by institutional computer centers, whose
professional staff will  take  the  responsibility  for  ``bootstrapping''  the
microcomputer versions from the tape to diskettes for their users.

Documentation  includes the Kermit User Guide, which contains complete instruc-
tions for installing and using the major implementations of Kermit, the  Kermit
Protocol  Manual,  which is a guide for writing a new implementation of Kermit,
and the manuscript from the Kermit article that appeared in the June  and  July
1984 issues of BYTE Magazine.

Once you receive Kermit, you may redistribute it on your own terms, and are en-
couraged to do so, with the following stipulations: Kermit should not  be  sold
for  profit; credit should be given where it is due; and new material should be
sent back to Columbia University so that we can maintain a definitive and  com-
prehensive set of Kermit implementations for further distribution.

ALTERNATE SOURCES:

Kermit  is  also  available to users of the BITNET network via a server at host
CUVMA (BITNET users type ``SMSG RSCS  MSG  CUVMA  KERMSRV  HELP''  for  further
information);  the  Internet  (via  anonymous  FTP from host CU20B, in the area
KER:); UUCP from host okstate; and on magnetic tape from user groups like DECUS
and  SHARE.    IBM PC-format MS-DOS Kermit floppies can be ordered from PC-SIG,
Santa Clara CA, (408) 730-9291.
\f                             ORDERING INFORMATION

There are two separate Kermit tapes, A and B. As of June  1985  there  are  too
many Kermit files to fit on a single tape.  All tapes are half-inch, 2400-foot,
9-track, 1600bpi, odd parity.  They are available ONLY in  the  following  for-
mats:

  ANSI:   ANSI labeled ASCII, format D (variable length records)
  TAR:    UNIX TAR format (written on a VAX with 4.2bsd or Ultrix-32)
  OS:     IBM OS standard labeled EBCDIC, format VB (variable length records)
  CMS:    IBM CMS Tape Dump format (unlabeled)
  DEC-10: DECsystem-10 Backup/Interchange format (unlabeled)
  DEC-20: DECSYSTEM-20 DUMPER format (unlabeled)

Blocksizes,  when  applicable,  are our choice and will be in the range 2K-10K.
NO OTHER FORMATS ARE AVAILABLE.  We can  NOT  make  800bpi  or  6250bpi  tapes,
7-track  tapes,  unlabeled tapes (except as noted above), fixed-block tapes, or
custom tapes of any kind.  If none of the above formats looks familiar to  you,
then  specify  ANSI -- this is an industry standard format that should be read-
able by any computer system.  VAX/VMS sites should specify ANSI.

Tapes include machine readable source for both programs and documentation.

TAPE ``A'' CONTAINS:

   - The microcomputer (PC, workstation) Kermit implementations
   - The Kermit User Guide
   - The Kermit Protocol Manual
   - The Info-Kermit mail archive,
   - Other documentation of a general nature

TAPE ``B'' CONTAINS:

   - The mainframe and minicomputer Kermit implementations.

EXCEPTIONS:

   - Macintosh Kermit is one of the  implementations  generated  from  the
     C-Kermit  sources, which are collected on tape B. A duplicate copy of
     the Macintosh hex and doc files is also included on tape A  for  con-
     venience.

   - While  the general documentation is on tape A, any documentation of a
     specific  nature  is  distributed  together  with  the   program   it
     describes.

TO ORDER KERMIT, fill out the Kermit Order Form and send it to:

    Kermit Distribution
    Columbia University Center for Computing Activities
    612 West 115th Street
    New York, NY  10025  (USA)

North  American  orders  are  shipped  UPS or first class US mail, and shipping
costs are included.  Overseas orders are shipped first class US  mail;  an  ad-
ditional shipping charge is required.  Orders are normally processed within 2-4
weeks of receipt.
\f                               KERMIT ORDER FORM

Check each desired Kermit Distribution Tape, $100.00 each:
                                            Amount:
Tape A, in the following format(s):
     [  ] ANSI    [  ] TAR     [  ] OS
     [  ] CMS     [  ] DEC-10  [  ] DEC-20  $________

Tape B, in the following format(s):
     [  ] ANSI    [  ] TAR     [  ] OS
     [  ] CMS     [  ] DEC-10  [  ] DEC-20  $________  

[  ] PRIME computers: specify ANSI and check
     here to receive a listing of a short
     Fortran program for reading ANSI tapes.

Tape Subtotal . . . . . . . . . . . . . . . . . . . . . . . $________

Printed documents $5.00 each, enter quantity:

[  ] Kermit User Guide                       $
[  ] Kermit Protocol Manual                  $          
[  ] BYTE Magazine Kermit article manuscript $

Document Subtotal . . . . . . . . . . . . . . . . . . . . . $________  

Program source listings, $5.00 each.  There is NO NEED to order
source listings if you have ordered a tape, since the program
source is on the tape.  List the ones you want:






Listings Subtotal . . . . . . . . . . . . . . . . . . . . . $________

If you can NOT prepay with a check, but want us to send
    you an invoice, you must include an additional $100.00
    Order Processing Fee: . . . . . . . . . . . . . . . . . $________

Outside North America, please add $25.00 for shipping:. . . $________

GRAND TOTAL:. . . . . . . . . . . . . . . . . . . . . . . . $________

Make checks (in US Dollars) payable to:

         Columbia University Center for Computing Activities

[  ] Check here to apply for a user ID on the Columbia University DEC-20
    system which will allow you to read the Info-Kermit electronic
    newsletter, and to use Kermit itself to obtain new releases of Kermit.

PLEASE WRITE YOUR SHIPPING ADDRESS, AND PURCHASE ORDER NUMBER IF ANY:
-------