home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / cku190.tar.gz / cku190.tar / ckuaaa.hlp < prev    next >
Text File  |  1994-11-12  |  6KB  |  157 lines
  1. File CKUAAA.HLP                                                   October 1994
  2.  
  3.                C-KERMIT FILES FOR UNIX
  4.  
  5. C-Kermit 5A bears the following copyright notice:
  6.  
  7.   Copyright (C) 1985, 1994, Trustees of Columbia University in the City of New
  8.   York.  The C-Kermit software may not be, in whole or in part, licensed or
  9.   sold for profit as a software product itself, nor may it be included in or
  10.   distributed with commercial products or otherwise distributed by commercial
  11.   concerns to their clients or customers without written permission of the
  12.   Office of Kermit Development and Distribution, Columbia University.  This
  13.   copyright notice must not be removed, altered, or obscured.
  14.  
  15. All files for UNIX C-Kermit have Kermit Distribution names beginning with
  16. 'ck'.  Those particular to UNIX begin with 'cku'.  Those that UNIX C-Kermit
  17. share in common with other C-Kermit implementations begin with 'ckc' or 'ckw'.
  18. When retrieving these files via ftp from kermit.columbia.edu, a UNIX computer,
  19. use only lowercase letters in filenames.
  20.  
  21. All the files needed for UNIX C-Kermit are listed below, and are available
  22. separately in the kermit/b directory.  They are also available in a compressed
  23. tar archive in kermit/archives called ckuxxx.tar.Z, where xxx is the C-Kermit
  24. edit number, for example cku190.tar.Z (and also .gz for gunzip).  Retrieve
  25. this file to your UNIX system in binary mode.  Here is an example of how to
  26. retrieve, unpack, and build:
  27.  
  28.   mkdir kermit
  29.   cd kermit
  30.   ftp kermit.columbia.edu
  31.   Name: anonymous (or "ftp")
  32.   Password: (supply your email address)
  33.   ftp> cd kermit/archives
  34.   ftp> binary (or "type binary")
  35.   ftp> get cku190.tar.Z (or .gz)
  36.   ftp> bye
  37.   uncompress cku190.tar.Z (or gunzip cku190.tar.gz)
  38.   tar xvf cku190.tar
  39.   make xxx
  40.  
  41. where "xxx" is the appropriate makefile entry, for example "make sunos41c".
  42.  
  43. Prebuilt binary executables for selected platforms are in kermit/bin, with
  44. names starting with 'cku'.  See kermit/bin/READ.ME for further information.
  45.  
  46. DOCUMENTATION
  47.  
  48.   C-Kermit 5A is documented in the book "Using C-Kermit" by Frank da Cruz and
  49.   Christine M. Gianone, 1993, Digital Press, Woburn, MA, USA.  Digital Press
  50.   ISBN: 1-55558-108-0.  Price: US $34.95.  Available in bookstores and
  51.   computer stores, or order from Columbia University, phone 1-212-854-3703,
  52.   MasterCard and Visa accepted.  Please purchase the documentation: it should
  53.   answer most of your questions, and sales help to fund the Kermit development
  54.   and support effort.
  55.  
  56. UNIX C-KERMIT FILES:
  57.  
  58. ckuaaa.hlp  - This file.
  59.  
  60. ckuker.nr   - UNIX man page for C-Kermit, to be installed in the system's
  61.               local man page directory.  Format via 'nroff -man'.
  62.  
  63. The following files should be placed in a world-readable directory, such as
  64. /usr/local/lib/kermit, so everybody can read and/or copy them:
  65.  
  66. ckermit.ini - Standard C-Kermit initialization file.  Rename to .kermrc
  67.               and place in your home directory.  Or read ckuins.doc to learn
  68.               how to set up a system-wide initialization file.
  69.  
  70. ckermod.ini - Sample C-Kermit customization file.  Rename to .mykermrc and
  71.               place in your home directory.
  72.  
  73. ckermit.kdd - Sample dialing directory file.  Replace this with your own
  74.               dialing directory in the same format, and rename it to .kdd.
  75.  
  76. ckermit.ksd - Sample services directory.  Replace this with your own services
  77.               directory in the same format, and rename to .ksd.
  78.  
  79. ckcker.upd  - Updates to C-Kermit since "Using C-Kermit" was published;
  80.               documentation for new features.
  81.  
  82. ckcker.bwr  - General C-Kermit "Beware file" - hints and tips, known bugs, etc.
  83.  
  84. ckuker.bwr  - UNIX-specific C-Kermit "Beware File".
  85.  
  86. ckedemo.ini, cketest.ini, ckevt.ini -
  87.               Macro definitions used in "Using C-Kermit".
  88.  
  89. FILES FOR BUILDING UNIX C-KERMIT:
  90.  
  91. ckuins.doc  - UNIX C-Kermit installation instructions.  
  92.  
  93. ckccfg.doc  - Documentation for configuration options.
  94.  
  95. ckuker.mak  - UNIX makefile for building C-Kermit from source code.  Rename to
  96.               Makefile (or makefile).  See ckuins.doc for details, and also
  97.               read the comments at the top of the makefile.  This makefile has
  98.               nearly 300 entries in it; please be careful to pick the most
  99.               appropriate one.
  100.  
  101. ckubs2.mak  - As above, but for 2.10 and 2.11 BSD systems.
  102.  
  103. C-KERMIT SOURCE FILES:
  104.  
  105. ckcdeb.h    - Header file common to all C-Kermit modules.
  106. ckcasc.h    - Header file for ASCII character definitions.
  107. ckuver.h    - Header file for version heralds.
  108.  
  109. ckufio.c    - UNIX (and OS/2) system-specific file i/o module for C-Kermit.
  110. ckutio.c    - UNIX system-specific communications i/o module for C-Kermit.
  111. ckucon.c    - The UNIX C-Kermit CONNECT command.
  112.  
  113. ckcpro.w    - System-independent C-Kermit protocol module, written in 'wart',
  114.               a lex-like preprocessor for C. 
  115. ckwart.c    - The 'wart' preprocessor.              
  116.  
  117. ckcker.h    - Header file for Kermit protocol items.
  118.  
  119. ckcfns.c, ckcfn2.c, ckcfn3.c - System-independent Kermit protocol support
  120.               routines.
  121.  
  122. ckuusr.c, ckuus2.c, ckuus3.c, ckuus4.c, ckuus5.c, ckuus6.c, ckuus7.c -
  123.               User interface: interactive command processor.
  124.  
  125. ckuusy.c    - User interface: command-line option processor.
  126.  
  127. ckuusx.c    - Support functions shared by interactive-mode and command-line
  128.               option processors.
  129.  
  130. ckuusr.h    - Header file for user interface.
  131.  
  132. ckucmd.c    - Command-parsing functions (keywords, filenames, numbers, etc).
  133. ckucmd.h    - Header file for command-parsing functions.
  134.  
  135. ckuxla.c    - Character-set translation module.
  136. ckcxla.h    - System-independent header file for character-set translation.
  137. ckuxla.h    - UNIX-specific header file for character-set translation.
  138.  
  139. ckudia.c    - DIAL command processor.
  140. ckuscr.c    - SCRIPT command processor.
  141. ckcnet.c    - Network support module.
  142. ckcnet.h    - Header file for network support module.
  143.  
  144. OTHER FILES:
  145.  
  146. These are not included in the tar.Z file.  FTP these separately from the
  147. kermit/b directory if you need them.
  148.  
  149. ckcplm.doc  - C-Kermit program logic manual (for programmers).
  150. ckc190.upd  - Program update history for edits 189-190.
  151. ckc188.upd  - Program update history, edits 179-188 (big).
  152. ckc178.upd  - Program edit history, 5A edits through 178 (very big).
  153. ckcv4f.upd  - Program edit history, version 4F.
  154. ckcv4e.upd  - Program edit history, version 4E.
  155.  
  156. (End of file ckuaaa.hlp)
  157.