home *** CD-ROM | disk | FTP | other *** search
/ Programmer's ROM - The Computer Language Library / programmersrom.iso / ada / general / kerflyer.doc < prev    next >
Encoding:
Text File  |  1988-05-03  |  13.3 KB  |  243 lines

  1.               Columbia University Center for Computing Activities
  2.  
  3.                        THE KERMIT FILE TRANSFER PROTOCOL
  4.  
  5.                                    July 1986
  6.  
  7.  
  8.  
  9. Kermit  is  an  error-correcting protocol for transferring sequential files be-
  10. tween computers of  all  sizes  over  ordinary  asynchronous  telecommunication
  11. lines.  Kermit is non-proprietary, thoroughly documented, and in wide use.  The
  12. protocol and the original implementations were developed at Columbia University
  13. and  have  been shared with thousands of other institutions all over the world,
  14. many of which have made significant contributions of  their  own.    Kermit  is
  15. presently available for more than 200 different machines and operating systems,
  16. and additional versions are always under development.
  17.  
  18. All Kermit programs perform  file  transfer  using  the  Kermit  file  transfer
  19. protocol.    In  addition,  Kermit programs for personal computers also provide
  20. terminal emulation, usually of the DEC VT52, VT100, or  similar  terminal,  and
  21. some  of  the  mainframe Kermit programs are capable of initiating connections,
  22. acting as dumb terminals to remote systems.  Kermit  programs  work  only  over
  23. asynchronous  RS-232 direct or dialup connections, or connections that simulate
  24. them.  For file transfer to take place, there must be a Kermit program  running
  25. on each end of the connection, one on each computer.
  26.  
  27. There are Kermit programs for most popular "generic" operating systems, includ-
  28. ing UNIX, MS-DOS, and CP/M, and for  mainframes  and  minicomputers  from  Bur-
  29. roughs,   Cray,  CDC,  Data  General,  DEC,  Gould  (SEL),  Harris,  Honeywell,
  30. Hewlett-Packard, IBM, Perkin-Elmer, Prime, Sperry/Univac, and Tandem,  and  for
  31. particular  microcomputers  and  workstations  from  Apple, Apollo, Atari, Com-
  32. modore, IBM, Tandy, and many others, written in a wide variety of languages in-
  33. cluding many different assemblers, plus high-level languages like Algol, Basic,
  34. Bliss, C, Forth, Fortran, Lisp, Mumps, Pascal, PL/I, and Ratfor.    A  complete
  35. list of Kermit programs accompanies this flyer.
  36.  
  37. Here  are some details about the several most popular Kermit programs.  Most of
  38. the following implementations are capable of both local and  remote  operation,
  39. server  and  client  modes,  text  and binary file transfer, and support a full
  40. range of communications options -- speed, parity, duplex, flow  control,  hand-
  41. shake  --  to  allow  adaptation  to  a  wide  variety  of hosts (including IBM
  42. mainframes) and communication media.
  43.  
  44.    - IBM PC Kermit Version 2.29 runs under PC-DOS version 2.0 and later on
  45.      the entire IBM PC family, as well as on IBM "clones" and compatibles.
  46.      It provides nearly complete DEC VT102 terminal emulation at speeds up
  47.      to  38.4K  baud  fully  buffered and interrupt driven -- and includes
  48.      support for  color  displays,  compatibility  with  various  "desktop
  49.      organizers,"  and selectable emulation of other terminals.  There are
  50.      also versions of Kermit specifically tailored for a variety of  other
  51.      MS-DOS  systems,  including the DEC Rainbow, Zenith-100, Victor 9000,
  52.      HP-110/150, and many others, and there is a "generic"  MS-DOS  Kermit
  53.      for systems not explicitly covered.
  54.  
  55.    - Macintosh  Kermit  Version  0.8  runs  on  the entire Apple Macintosh
  56.      family, from the original 128K Mac to the Mac/XL, to the  fully  con-
  57.      fi ured   ac nt sh-P us.   t p ovid s fairly co pl te VT
  58.      atgspeedsMupitoo9600lbaud,Iandrfileetransfer upmtoe56Kb.102 emulation
  59.  
  60.  
  61.    - UNIX Kermit is distributed only in C-language source form.  It may be
  62.      built  for  nearly any machine running practically any post-V6 varia-
  63.      tion of UNIX, including V7, Berkeley 2.x and 4.x, AT&T System III and
  64.      System  V, Xenix, Venix, and so on.  The same source also serves as a
  65.      basis for Macintosh, Amiga, and other Kermit programs.
  66.  
  67.    - VAX/VMS Kermit is written in Bliss, but it  is  also  distributed  in
  68.      Macro-32  and  hex  form,  so  that a Bliss compiler is not required.
  69.      Other versions exist in C and Pascal.
  70.  
  71.    - IBM mainframe Kermit programs for VM/CMS and MVS/TSO work  only  with
  72.      asynchronous  ASCII  TTY connections through 3705 or equivalent front
  73.      ends, or through Series/1, 7171, or similar protocol converters  that
  74.      support  the Yale ASCII Communications System; beyond this exception,
  75.      Kermit cannot be  used  to  transfer  files  in  the  IBM  3270-style
  76.      full-screen  terminal  environment.  There are no Kermit programs for
  77.      DOS/VSE, or IBM minis like the System/34 and System/38, because these
  78.      systems do not support asynchronous ASCII communications.  Currently,
  79.      IBM mainframe Kermits run only in remote mode.
  80.  
  81. The Kermit software -- including source code -- is furnished free  and  without
  82. license, and without warranty of any kind, and neither Columbia University, nor
  83. the individual  authors,  nor  any  institution  that  has  contributed  Kermit
  84. material, acknowledge any liability for any claims arising from the use of Ker-
  85. mit.  Furthermore, it must be stated that the quality of  the  Kermit  programs
  86. varies  --  some are polished, well-documented professional products and others
  87. are not.  Kermit programs are contributed by  public-spirited  volunteers,  and
  88. Columbia  University does not wish to discourage such contributions by subject-
  89. ing them to a rating system.  Since source code is provided for  all  implemen-
  90. tations, users may make improvements or write documentation where it is lacking
  91. and are encouraged to contribute their work back to Columbia for  further  dis-
  92. tribution.    Under  certain  conditions  (described  in  a  separate document)
  93. software producers may include Kermit protocol in their products.
  94.  
  95. Although the Kermit software is free and unlicensed, Columbia University cannot
  96. afford  to  distribute  it for free because the demand is too great.  To defray
  97. our costs for media, printing, postage, labor, and computing resources, we  re-
  98. quire  moderate  distribution  fees from those who request Kermit directly from
  99. us.  The schedule is given on the accompanying Kermit Order Form.  You may also
  100. obtain  Kermit  programs  from  many other sources, including user groups, net-
  101. works, dialup bulletin boards, and you may copy them from  friends,  neighbors,
  102. and  colleagues.    In  fact, you may obtain Kermit programs from anyone who is
  103. willing to share them with you, just as you may share them yourself.
  104.  
  105. Kermit is distributed by Columbia  University  primarily  on  9-track  magnetic
  106. tape,  suitable for reading on most mainframe and minicomputers.  It is assumed
  107. that Kermit will be ordered in this form  by  institutional  computer  centers,
  108. whose  professional  staff will take the responsibility for "bootstrapping" the
  109. microcomputer versions from the tape to diskettes for their users.   The  tapes
  110. include  source  code and any available documentation for each Kermit implemen-
  111. tation, and in some cases also binaries (usually encoded in hex or other print-
  112. able format).  Selected microcomputer versions are also available from Columbia
  113. on diskette.
  114.  
  115. Documentation includes the Kermit User Guide, which contains complete  instruc-
  116.  
  117.  
  118. tions  for  using  and  installing the major implementations of Kermit, and the
  119. Kermit Protocol Manual, which is a guide to writing new Kermit programs.    One
  120. printed  copy  of  each  manual is included with any tape order, and additional
  121. copies may be ordered separately.  The manuscript from the Kermit article  that
  122. appeared  in  the  June  and  July  1984  issues of BYTE Magazine, and the book
  123. Kermit, A File Transfer Protocol (Frank da Cruz, Digital Press, 1986) may  also
  124. be ordered separately.
  125.  
  126. Once  you  receive Kermit, you are encouraged to copy and redistribute it, with
  127. the following stipulations: Kermit should not be sold for profit; credit should
  128. be  given  where  it  is  due; and new material should be sent back to Columbia
  129. University so that we can maintain a definitive and comprehensive set of Kermit
  130. implementations  for further distribution.  And finally, please use Kermit only
  131. for peaceful and humane purposes.
  132.                              ORDERING INFORMATION
  133.  
  134. There are two separate Kermit tapes, A and B. There are too many  Kermit  files
  135. to  fit  on  a  single tape (soon, there will be too many to fit on two tapes).
  136. All tapes are half-inch, 2400-foot, 9-track, 1600bpi, odd  parity.    They  are
  137. available ONLY in the following formats:
  138.  
  139.   ANSI:   ANSI labeled ASCII, format D (variable length records, VMS COPY)
  140.   TAR:    UNIX TAR format (written on a VAX with 4.2bsd or Ultrix-32)
  141.   OS:     IBM OS standard labeled EBCDIC, format VB (variable length records)
  142.   CMS:    IBM VM/CMS VMFPLC2 format (unlabeled)
  143.   DEC-10: DECsystem-10 Backup/Interchange format (unlabeled)
  144.   DEC-20: DECSYSTEM-20 DUMPER format (unlabeled)
  145.  
  146. Blocksizes,  when  applicable,  are  our choice and in the range 8K-10K (use of
  147. smaller blocksizes could overflow the tapes).  NO OTHER FORMATS ARE  AVAILABLE.
  148. We  can  NOT  make  800bpi  or  6250bpi tapes, unlabeled tapes (except as noted
  149. above), fixed-block tapes, or custom tapes of any kind.  If none of  the  above
  150. formats  looks  familiar to you, then specify ANSI -- this is an industry stan-
  151. dard format that should be readable by any computer system.
  152.  
  153. Tapes include machine readable source for both programs and documentation.
  154.  
  155. TAPE "A" CONTAINS:
  156.    - The microcomputer (PC, workstation) Kermit implementations
  157.    - The Info-Kermit mail archive
  158.  
  159. TAPE "B" CONTAINS:
  160.    - The mainframe and minicomputer Kermit implementations.
  161.    - The Kermit User Guide and the Kermit Protocol Manual
  162.  
  163. EXCEPTIONS:
  164.    - C-Kermit is the basis of all Unix Kermit  implementations,  mainframe
  165.      and  micro.    It  is on tape B. Macintosh and Amiga Kermits are also
  166.      generated from  the  C-Kermit  sources,  so  they  too  are  on  tape
  167.      B.  Duplicate copies of the Macintosh and Amiga hex and doc files (no
  168.      source) are also included on tape A for convenience.
  169.  
  170.    - While the general documentation is on tape B, any documentation of  a
  171.      specific   nature   is  distributed  together  with  the  program  it
  172.      describes.
  173.  
  174. Kermit diskettes may also be ordered in certain formats; see the order form.
  175.  
  176. TO ORDER KERMIT, fill out the Kermit Order Form and send it to:
  177.  
  178.     Kermit Distribution
  179.     Columbia University Center for Computing Activities
  180.     612 West 115th Street
  181.     New York, NY  10025  (USA)
  182.  
  183. North American orders are shipped by delivery service or first class  US  mail,
  184. and  shipping  costs  are included.  Overseas orders are shipped first class US
  185. mail; an additional shipping charge is required.  Orders are normally processed
  186. within  2-4  weeks of receipt, but firm delivery schedules or methods cannot be
  187. guaranteed.
  188. (V3.00, 1 July 86)             KERMIT ORDER FORM                    #__________
  189.  
  190. Check each desired Kermit Distribution Tape, $100 PER TAPE:
  191.  
  192.  
  193. Format:                 ANSI    TAR      OS     CMS     DEC-10  DEC-20
  194.   Tape A (micros):      [  ]    [  ]    [  ]    [  ]    [  ]    [  ]
  195.   Tape B (mainframes):  [  ]    [  ]    [  ]    [  ]    [  ]    [  ]
  196.  
  197. [ ] For PRIME Computers: Specify ANSI and check  here  to  request  a
  198.    short ANSI-tape-reader program listing (no charge).
  199.  
  200. Tape Subtotal (number of tapes times $100)  . . . . . . . . . . . . $__________
  201.  
  202. Kermit programs on diskette, no source code, $10 each:
  203. [  ] Apple Macintosh  . . . . . . . . . . . . . . . . . . . . . . . $__________
  204. [  ] DEC Rainbow; CP/M-86 . . . . . . . . . . . . . . . . . . . . . $__________
  205. [  ] DEC Rainbow; MS-DOS  . . . . . . . . . . . . . . . . . . . . . $__________
  206. [  ] DEC VT-180 Robin . . . . . . . . . . . . . . . . . . . . . . . $__________
  207. [  ] IBM PC, XT, and AT; PC-DOS . . . . . . . . . . . . . . . . . . $__________
  208.  
  209. Printed documents, enter quantity:
  210. [  ] Book: Kermit, A File Transfer Protocol ($25) . . . . . . . . . $__________
  211. [  ] Kermit User Guide ($5 each)  . . . . . . . . . . . . . . . . . $__________
  212. [  ] Kermit Protocol Manual ($5)  . . . . . . . . . . . . . . . . . $__________
  213. [  ] BYTE Magazine article manuscript ($5)  . . . . . . . . . . . . $__________
  214.  
  215. Program  source  listings, $5 each.  NO NEED to order source listings
  216. if you have ordered tapes, since program  source  is  on  the  tapes.
  217. List  the  ones  you  want  on  a  separate sheet.  Use prefixes from
  218. version list.
  219.  
  220. Listings Subtotal . . . . . . . . . . . . . . . . . . . . . . . . . $__________
  221.  
  222. If you can NOT prepay with a check, include BOTH:
  223.   1.  A $100.00 Order Processing (billing) Fee: . . . . . . . . . . $__________
  224.   2.  AND a Purchase Order; write your P.O. number here:
  225.  
  226.             P.O.#: __________________________
  227.  
  228. Outside North America, add $25.00 for shipping. . . . . . . . . . . $__________
  229. USA RUSH ORDERS (Sent Federal Express), add $20.00. . . . . . . . . $__________
  230.  
  231. GRAND TOTAL: (Do Not Add Sales Tax) . . . . . . . . . . . . . . . . $__________
  232.  
  233. Make checks in U.S. Dollars, payable to:
  234.  
  235.     COLUMBIA UNIVERSITY CENTER FOR COMPUTING ACTIVITIES
  236.  
  237. [ ] Check here for a Columbia University DEC-20  account  application
  238.    form.    A  CU20B  account  will allow you to read the Info-Kermit
  239.    electronic newsletter, and to use  Kermit  itself  to  obtain  new
  240.    releases of Kermit.
  241.  
  242. PLEASE WRITE YOUR SHIPPING ADDRESS HERE:
  243.