home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / qnx2.tar.gz / qnx2.tar / qnx2kerdoc.txt < prev    next >
Text File  |  1995-05-01  |  3KB  |  101 lines
  1. William F Hullsiek (WFH);    28-April-1995
  2.  
  3. This version of Kermit is derived from Kermit: A File Transfer Protocol by
  4. Frank da Cruz (c) 1987.  Buy the book!
  5.  
  6. This software is intended to be a minimalist version of Kermit. File transfer
  7. only.  It is implemented in order move files between QNX-2 and other systems.
  8.  
  9. Features supported:
  10.  
  11.     <> client
  12.         <> get
  13.         <> finish
  14.         <> send
  15.         <> remote type
  16.         <> remote rename (if the host supports it)
  17.         <> remote command
  18.  
  19.     <> server
  20.         <> send
  21.         <> receive
  22.         <> finish
  23.         <> remote type
  24.  
  25.             (It does not handle other commands very well)
  26.  
  27.     <> packets to 2048
  28.     <> block-check 1,2,3
  29.     <> run-length compression
  30.     <> image and text
  31.  
  32. Non-standard Features:
  33.  
  34.     The following features were added in order to implement a store
  35.     and forward message passing application.
  36.  
  37.     -m filename        
  38.  
  39.         This is the move command. It is the same as send with the
  40.         exception that it deletes the file upon successful transfer.
  41.  
  42.     chaining a command
  43.  
  44.     -C host-command
  45.  
  46.         Can be placed on the same command line as -m. The host-command
  47.         will be issued to the server upon successful transfer of the
  48.         file.
  49.  
  50.     Example:
  51.         
  52.         /cmds/kermit -l $cti1 -i -m #1 -C "mv #2 /home/qnx2_input/#2"
  53.  
  54.         #1 is the QNX-2 filename
  55.         #2 is the QNX-4 filename
  56.  
  57. Testing
  58.  
  59.     This has been tested with MS-DOS Kermit at 9600, 19200, and 38400.
  60.  
  61.     This has been tested with C-Kermit-5A for QNX-4 at 9600, 19200 and
  62.     38400.
  63.  
  64. Programming Notes by WFH; 21-July-1994
  65.  
  66.     I added the "Move" command -m. This deletes the file from the
  67.     originating system when it has been successfully copied.
  68.  
  69.     I also modified the state machine to allow a host-command to be issued 
  70.     with a move command. For my application, I wanted to start a script
  71.     on a host system after the file has been transferred. It is a bit of
  72.     a hack -- but it works reliable.
  73.  
  74.     Originally, I thought about porting C-Kermit-5A to the QNX-2 environment. 
  75.     It could be done -- but I do not have the time.
  76.  
  77.     All of the code is in Kermit.c with the exception of the ccitt.crc
  78.     file.  My thought was to keep things as small as possible. I can edit
  79.     the entire program from within QED.
  80.  
  81.     The primitives, tt__ and z___ are derived from stuff found in
  82.     implementations of kermit stored on the QNX Bulletin board QUICS.
  83.  
  84.     I re-designed the routine rpack to extract the length of the packet
  85.     and then do a read against the input device. This is non-portable but 
  86.     helps in accessing the disk.
  87.  
  88. Notes by WFH;  28-April-1995
  89.  
  90.     This software has been running reliable between a QNX-2 and QNX-4
  91.     system for several months.
  92.     
  93. (End)
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.