home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / ckl196.zip / ckuaaa.txt < prev    next >
Text File  |  2000-01-01  |  7KB  |  183 lines
  1. File CKUAAA.TXT                                                     Jan 2000
  2.  
  3.                C-KERMIT FILES FOR UNIX
  4.  
  5.   Copyright (C) 1985, 2000
  6.     Trustees of Columbia University in the City of New York.
  7.     All rights reserved.  See the C-Kermit COPYING.TXT file or the
  8.     copyright text in the ckcmai.c module for disclaimer and permissions.
  9.  
  10. All files for UNIX C-Kermit have Kermit Distribution names beginning with
  11. 'ck'.  Those particular to UNIX begin with 'cku'.  Those that UNIX C-Kermit
  12. share in common with other C-Kermit implementations begin with 'ckc' or 'ckw'.
  13. When retrieving these files via ftp from kermit.columbia.edu, a UNIX computer,
  14. use only lowercase letters in filenames.  (Actually, many of the 'cku' files
  15. are used on other platforms, too.)
  16.  
  17. All the files needed for UNIX C-Kermit are listed below, and are available
  18. separately in the kermit/f directory.  They are also available in a compressed
  19. tar archive in kermit/archives called ckuxxx.tar.Z, where xxx is the C-Kermit
  20. edit number, for example cku195.tar.Z (and also .gz for gunzip).  Retrieve
  21. this file to your UNIX system in binary mode.  Here is an example of how to
  22. retrieve, unpack, and build:
  23.  
  24.   mkdir kermit
  25.   cd kermit
  26.   ftp kermit.columbia.edu
  27.   Name: anonymous (or "ftp")
  28.   Password: (supply your email address)
  29.   ftp> cd kermit/archives
  30.   ftp> binary (or "type binary")
  31.   ftp> get cku195.tar.Z (or .gz)
  32.   ftp> bye
  33.   uncompress cku195.tar.Z (or gunzip cku195.tar.gz)
  34.   tar xvf cku195.tar
  35.   make xxx
  36.  
  37. where "xxx" is the appropriate makefile entry, for example "make linux".
  38. Please read the comments at the top of the makefile for details.
  39.  
  40. Prebuilt binary executables for selected platforms are in kermit/bin, with
  41. names starting with 'cku'.  See kermit/bin/READ.ME for further information.
  42.  
  43.  
  44. DOCUMENTATION
  45.  
  46.   Frank da Cruz and Christine M. Gianone, "Using C-Kermit", Second Edition,
  47.   Digital Press /  Butterworth-Heinemann, Woburn, MA, 1997, 622 pages,
  48.   ISBN 1-55558-164-1.  Price: US $44.95.  Available in bookstores and
  49.   computer stores, or order from Columbia University, phone 1-212-854-3703,
  50.   MasterCard and Visa accepted.  Please purchase the documentation: it should
  51.   answer most of your questions, and sales help to fund the Kermit Project.
  52.  
  53.  
  54. UNIX C-KERMIT FILES:
  55.  
  56. COPYING.TXT - Copyright and permissions notice.
  57.  
  58. ckuaaa.txt  - 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. ckuker.cpp  - C-Preprocessor source for the ckuker.nr file.
  64.  
  65. The following files should be placed in a world-readable directory, such as
  66. /usr/local/lib/kermit, so everybody can read and/or copy them:
  67.  
  68. ckermit.ini - Standard C-Kermit initialization file.  Rename to .kermrc
  69.               and place in your home directory.  Or read ckuins.txt to learn
  70.               how to set up a system-wide initialization file.
  71.  
  72. ckermod.ini - Sample C-Kermit customization file.  Rename to .mykermrc and
  73.               place in your home directory.
  74.  
  75. ckermit.kdd - Sample dialing directory file.  Replace this with your own
  76.               dialing directory in the same format, and rename it to .kdd.
  77.  
  78. ckermit.knd - Sample network directory file.  Replace this with your own
  79.               dialing directory in the same format, and rename it to .knd.
  80.  
  81. ckermit.ksd - Sample services directory.  Replace this with your own services
  82.               directory in the same format, and rename to .ksd.
  83.  
  84. ckermit2.txt- Updates to C-Kermit since the most recent edition of "Using
  85.               C-Kermit" was published; documentation for new features.
  86.  
  87. ckcbwr.txt  - General C-Kermit "Beware file" - hints and tips, known bugs, etc.
  88.  
  89. ckubwr.txt  - UNIX-specific C-Kermit "Beware File".
  90.  
  91. ckedemo.ksc, ckevt.ksc, ckepage.ksc -
  92.               Macro definitions used in "Using C-Kermit".
  93.  
  94. FILES FOR BUILDING UNIX C-KERMIT:
  95.  
  96. ckuins.txt  - UNIX C-Kermit installation instructions.
  97.  
  98. ckcplm.txt  - C-Kermit Program Logic Manual.
  99.  
  100. ckccfg.txt  - Documentation for configuration options.
  101.  
  102. makefile    - UNIX makefile for building C-Kermit from source code.  See
  103.               ckuins.txt for details, and also read the comments at the top
  104.               of the makefile.  This makefile has hundreds of entries in it;
  105.               please be careful to pick the most appropriate one.  (NOTE: if
  106.               you don't find a file called "makefile" then look for it under
  107.               alternative names: "Makefile", "ckuker.mak", etc.
  108.  
  109. ckubs2.mak  - Makefile specifically for 2.10 and 2.11 BSD systems.  Read the
  110.               comments in this file for more info.
  111.  
  112. ckpker.mk   - Makefile specifically for Plan 9.
  113.  
  114. C-KERMIT SOURCE FILES:
  115.  
  116. ckcdeb.h    - Header file common to all C-Kermit modules.
  117. ckcasc.h    - Header file for ASCII character definitions.
  118. ckcsig.h    - Header file for signal handling functions.
  119. ckuver.h    - Header file for version heralds.
  120.  
  121. ckcmai.c    - Main program
  122. ckclib.c    - Common library routines
  123. ckclib.h    - Prototypes for common library routines
  124.  
  125. ckcuni.c    - Unicode support
  126. ckcuni.h    - Definitions and prototypes for Unicode
  127.  
  128. ckufio.c    - UNIX (and OS/2) system-specific file i/o module for C-Kermit.
  129. ckutio.c    - UNIX system-specific communications i/o module for C-Kermit.
  130. ckusig.c    - UNIX signal handling functions.
  131. ckucns.c    - Select-based CONNECT command for UNIX (preferred)
  132. ckucon.c    - Fork-based CONNECT command for UNIX (only if no select())
  133. ckupty.c    - Pseudoterminal support
  134.  
  135. ckcpro.w    - System-independent C-Kermit protocol module, written in 'wart',
  136.               a lex-like preprocessor for C.
  137. ckwart.c    - The 'wart' preprocessor.
  138.  
  139. ckcker.h    - Header file for Kermit protocol items.
  140.  
  141. ckcfns.c, ckcfn2.c, ckcfn3.c - System-independent Kermit protocol support
  142.               routines.
  143.  
  144. ckuusr.c, ckuus2.c, ckuus3.c, ckuus4.c, ckuus5.c, ckuus6.c, ckuus7.c -
  145.               User interface: interactive command processor.
  146.  
  147. ckuusy.c    - User interface: command-line option processor.
  148.  
  149. ckuusx.c    - Support functions shared by interactive-mode and command-line
  150.               option processors.
  151.  
  152. ckuusr.h    - Header file for user interface.
  153.  
  154. ckucmd.c    - Command-parsing functions (keywords, filenames, numbers, etc).
  155. ckucmd.h    - Header file for command-parsing functions.
  156.  
  157. ckuxla.c    - Character-set translation module.
  158. ckcxla.h    - System-independent header file for character-set translation.
  159. ckuxla.h    - UNIX-specific header file for character-set translation.
  160.  
  161. ckudia.c    - DIAL command processor.
  162. ckuscr.c    - SCRIPT command processor.
  163. ckcnet.c    - Network support module.
  164. ckcnet.h    - Header file for network support module.
  165.  
  166. ckctel.c    - Telnet protocol module
  167. ckctel.h    - Definitions and prototypes for Telnet protocol.
  168.  
  169. OTHER FILES:
  170.  
  171. These are not included in the tar.Z file.  FTP these separately from the
  172. kermit/b directory if you need them.
  173.  
  174. ckc196.txt  - Program update history for edits 193-196.
  175. ckc192.txt  - Program update history for edits 191-192.
  176. ckc190.txt  - Program update history for edits 189-190.
  177. ckc188.txt  - Program update history, edits 179-188.
  178. ckc178.txt  - Program edit history, 5A edits through 178.
  179. ckcv4f.txt  - Program edit history, version 4F.
  180. ckcv4e.txt  - Program edit history, version 4E.
  181.  
  182. (End of file ckuaaa.txt)
  183.