home *** CD-ROM | disk | FTP | other *** search
/ kermit.columbia.edu / kermit.columbia.edu.tar / kermit.columbia.edu / archives / ckc190.zip / ck9ker.doc < prev    next >
Text File  |  1992-11-28  |  9KB  |  245 lines
  1. C-KERMIT FOR OS-9/68K
  2.  
  3. Version: 5A(188)
  4. Date:    November 23, 1992
  5.  
  6. Adapted to OS-9 by Christian Hemsing, RWTH, Aachen, Germany
  7. E-Mail: CHRIS@LFM.RWTH-AACHEN.DE
  8.  
  9. OS-9/68K C-Kermit Capabilities at a Glance:
  10.  
  11.   Local operation:                   Yes
  12.   Remote operation:                  Yes
  13.   Transfer text files:               Yes
  14.   Transfer binary files:             Yes
  15.   International text:                Yes
  16.   Wildcard send:                     Yes
  17.   File transfer interruption:        Yes
  18.   Filename collision actions:        Yes
  19.   Can time out:                      Yes
  20.   8th-bit prefixing:                 Yes
  21.   Repeat count prefixing:            Yes
  22.   Alternate block checks:            Yes
  23.   Automatic parity detection:        Yes
  24.   Dynamic packet length:             Yes
  25.   CONNECT mode:                      Yes
  26.   Terminal emulation:                No (uses console driver)
  27.   Communication settings:            Yes
  28.   Transmit BREAK:                    Yes
  29.   Support for dialout modems:        Yes
  30.   TCP/IP support:                    No
  31.   X.25 support:                      No
  32.   IBM mainframe communication:       Yes
  33.   Transaction logging:               Yes
  34.   Session logging:                   Yes
  35.   Debug logging:                     Yes
  36.   Packet logging:                    Yes
  37.   Act as server:                     Yes
  38.   Talk to server:                    Yes
  39.   Advanced server functions:         Yes
  40.   Security for server:               Yes
  41.   Local file management:             Yes
  42.   Command/Init files:                Yes (Init file: .kermrc)
  43.   Long packets:                      Yes
  44.   Sliding Windows:                   Yes
  45.   File attributes packets:           Yes
  46.   Command macros:                    Yes
  47.   Script programming language:       Yes
  48.   Raw file transmit and capture:     Yes
  49.  
  50.  
  51. OS-9/68K BACKGROUND
  52.  
  53. OS-9/68k is a multiuser, multitasking operating system designed to run on
  54. all Motorola 680x0 family processors from Microware Systems Corporation, 1900
  55. N.W. 114th Street, Des Moines, Iowa 50332 (Trademarks: Microware, OS-9,
  56. OS-9/68000, OS-9000).
  57.  
  58. Due to its modular design, most of the code is completely hardware
  59. independent, so it can be easily be ported to a different hardware by writing
  60. new device drivers.
  61.  
  62. The original (1980) OS-9/6809 was designed for the Motorola 6809 processor.
  63. Later (1983) they switched to the 680x0 family and released OS-9/68000.  For
  64. speed and compactness reasons most of the OS-9/68000 kernel is written in
  65. 680x0 assembler language.  Now there is a so-called OS-9000 by Microware.  Its
  66. kernel is written in C and thus it is portable.  It is presently available for
  67. 680x0 and Intel's 80386/486, and Microware plans to add further support for
  68. RISC and CISC processors.  (C-Kermit has not yet been tested under OS-9000.)
  69.  
  70. The 100% ROM-able, fast, compact code in conjunction with real-time
  71. capabilities make OS-9/68k ideal for ROM-based systems used in measuring,
  72. controlling, etc.  It has found a wide acceptance within the scientific and
  73. industrial world.
  74.  
  75. Yet, a full disk based OS-9/68k offers a program development environment
  76. similar to UNIX. This includes (of course, limited) UNIX sofware compatibility
  77. at C source code level, source code level debugging, UNIX I/O model, UNIX task 
  78. model, UNIX-like shell and networking.
  79.  
  80. A number of UNIX utilities like lex, yacc, lint, etc, have been ported to
  81. OS-9/68k.
  82.  
  83. The basic commands of OS-9 are:
  84.  
  85.   DEL     delete a file
  86.   DELDIR  delete a directory
  87.   MAKDIR  create a directory
  88.   DIR     directory listing
  89.   PROCS   show currently running processes
  90.   LIST    type contents of a text file
  91.   CWD     change working directory
  92.   PD      print working directory
  93.  
  94. All commands can be given a "-?" as a switch, which will display a brief
  95. (usually sufficient) help message.
  96.  
  97. All command references (like all references to names on OS-9/68k) are NOT
  98. case sensitive (switches, though, may be case sensitive since they are
  99. interpreted by the running program).
  100.  
  101. On OS-9 systems you can redirect stdin, stdout, stderr just like in UNIX,
  102. and you can run programs (including Kermit) in the background.
  103. Pipelines work just like in UNIX.
  104.  
  105. OS-9 doesn't know anything about character sets; all messages are in English
  106. using ascii.
  107.  
  108. OS-9 does not generally have windows etc. (windows has been ported by someone,
  109. though). You can't really say anything about the terminal emulation.
  110. Many systems don't even have a console, but only RS232 lines, with no
  111. action by th driver whatsoever. So it depends on the terminal conncted to
  112. that line.
  113. In case a display is already part of the machine, then it depends on the
  114. vendor (which usually also does the portation), which emulation the console
  115. will have. E.g. I have ported OS-9 to Atari, which includes a VT52 emulation
  116. on the console.
  117. OS-9 is really meant to be ported, so no restrictions are given.
  118.  
  119.  
  120.  
  121. OS-9/68K DEVICES
  122.  
  123. All devices (terminal lines, networks, disks) can have arbitrary names but
  124. the usual convention is:
  125.  
  126.  Terminal lines:
  127.    term  the console terminal
  128.    t1    terminal line #1
  129.    :
  130.    tn    terminal line #n
  131.  
  132.  Harddisks:
  133.    h0    hard disk #0
  134.    h1    hard disk #1
  135.    :
  136.    hn    harddisk #n
  137.  
  138.  Floppy disks (diskettes):
  139.    d0    floppy disk drive #0
  140.    d1    floppy disk drive #1
  141.    :
  142.    d0    floppy disk drive #n
  143.  
  144. A path name starting with a slash ("/") must always include a device name
  145. as the first field.  For example, the C-Kermit command SET LINE /T3 would
  146. select the terminal line /t3.
  147.  
  148. The console terminal is either a real terminal, or the screen and keyboard of
  149. a workstation such as a Macintosh, Amiga, or Atari ST that is running OS-9.
  150. Terminal emulation is not done by OS-9 C-Kermit, but rather by the real
  151. terminal or the workstation console driver.  This includes the capability to
  152. display national and international characters.
  153.  
  154.  
  155. THE OS-9/68K FILE SYSTEM
  156.  
  157. The file system is tree-structured just like the UNIX file system.
  158.  
  159.   /h0/chris
  160.  
  161. means the directory  or file "chris" on hard disk #0.
  162.  
  163.   chris/rubbish
  164.  
  165. means the subdirectory or file "rubbish" in the subdirectory "chris" of the
  166. current directory.
  167.  
  168. The command "chd" without any parameters will always take you to your home
  169. directory.
  170.  
  171. Wildcard expansion is performed by the shell with two metacharacters:
  172.  
  173.   * stands for an arbitrary string of arbitrary length
  174.   ? denotes a single character
  175.  
  176. C-Kermit/OS-9 also expands wildcards itself, using the same notation, for
  177. example:
  178.  
  179.   C-Kermit>send ck*.\?
  180.  
  181. (Note: the question mark must be prefixed by "\" to override its normal
  182. function of giving a help message.)
  183.  
  184. OS-9/68k files are sequential streams of 8-bit bytes, just like in UNIX,
  185. except that carriage return (CR, ASCII 13) is the line terminator, rather than
  186. linefeed (LF, ASCII 10).  Binary files are simply streams of arbitrary 8-bit
  187. bytes.  The OS-9 operating system and utilities are "8-bit clean", so text
  188. files can use any ASCII-based character set that is compatible with your
  189. display and data entry devices, for example ISO 8859-1 Latin Alphabet 1.
  190.  
  191. Unlike UNIX, OS-9/68k has a built-in method to gain exclusive access to
  192. devices, so no lock files are needed.  The user will be told if the device is
  193. already in use.
  194.  
  195.  
  196. TO BUILD C-KERMIT FOR OS-9:
  197.  
  198. Collect all the C-Kermit source files into a directory:
  199.  
  200.   ckc*.c, ckc*.h, cku*.c, cku*.h, ckwart.c, ckcpro.w, ck9*.*
  201.  
  202. There are two makefiles: ck9ker.mak and ck9ker.gcc.  If you have a running
  203. version of the GNU C compiler, use ck9ker.gcc (it produces smaller, more
  204. efficient code); otherwise use ck9ker.mak which uses the standard OS-9/68k C
  205. compiler.  Read the appropropriate makefile, edit the necessary changes
  206. mentioned there, create the subdirectories, and make the new Kermit by typing:
  207.  
  208.   make -f=ck9ker.mak
  209.  
  210. or:
  211.  
  212.   make -f=ck9ker.gcc
  213.  
  214. Read the "beware file" ck9ker.bwr for hints relating to the OS-9 terminal
  215. driver.
  216.  
  217.  
  218. USING OS-9 C-KERMIT
  219.  
  220. The commands and operation of OS-9 C-Kermit should be identical to those of
  221. UNIX C-Kermit, with the exceptions noted above and in the "beware file".  The
  222. user documentation for C-Kermit is:
  223.  
  224.   Frank da Cruz and Christine M. Gianone, "Using C-Kermit", Digital Press,
  225.   Burlington, MA, 1993, approx. 500 pages.  
  226.  
  227.     Order Number: EY-J896E-DP
  228.     Digital Press ISBN: 1-55558-108-0
  229.     Prentice Hall ISBN: 0-13-037490-3
  230.  
  231.   US single-copy price: $34.95; quantity discounts available.  Available in
  232.   computer bookstores or directly from Digital Press.  In the USA, call
  233.   Digital Press toll-free 1-800-344-4825 to order; major credit cards
  234.   accepted.  Overseas, order through your bookstore or your local Digital
  235.   Equipment Corporation branch.  Can also be ordered from:
  236.  
  237.     Kermit Development and Distribution
  238.     Columbia University Center for Computing Activities
  239.     612 West 115th Street
  240.     New York, NY  10025  USA
  241.     Telephone: (USA) 212 854-3703
  242.  
  243.  
  244. (END OF CK9KER.DOC)
  245.