home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / qnx2.zip / readme < prev   
Text File  |  1995-04-28  |  3KB  |  100 lines
  1.  
  2. William F Hullsiek (WFH);    28-April-1995
  3.  
  4. This version of Kermit is derived from Kermit: A File Transfer Protocol by
  5. Frank da Cruz (c) 1987.  Buy the book!
  6.  
  7. This software is intended to be a minimalist version of Kermit. File transfer only.
  8. It is implemented in order move files between QNX-2 and other systems.
  9.  
  10.  
  11. Features supported:
  12.  
  13.     <> client
  14.         <> get
  15.         <> finish
  16.         <> send
  17.         <> remote type
  18.         <> remote rename (if the host supports it)
  19.         <> remote command
  20.  
  21.     <> server
  22.         <> send
  23.         <> receive
  24.         <> finish
  25.         <> remote type
  26.  
  27.             (It does not handle other commands very well)
  28.  
  29.     <> packets to 2048
  30.     <> block-check 1,2,3
  31.     <> run-length compression
  32.     <> image and text
  33.  
  34. Non-standard Features:
  35.  
  36.     The following features were added in order to implement a store
  37.     and forward message passing application.
  38.  
  39.     -m filename        
  40.  
  41.         This is the move command. It is the same as send with the exception
  42.         that it deletes the file upon successful transfer.
  43.  
  44.     chaining a command
  45.  
  46.     -C host-command
  47.  
  48.         Can be placed on the same command line as -m. The host-command will
  49.         be issued to the server upon successful transfer of the file.
  50.  
  51.     Example:
  52.         
  53.         /cmds/kermit -l $cti1 -i -m #1 -C "mv #2 /home/qnx2_input/#2"
  54.  
  55.         #1 is the QNX-2 filename
  56.         #2 is the QNX-4 filename
  57.  
  58. Testing
  59.  
  60.     This has been tested with MS-DOS Kermit at 9600, 19200, and 38400.
  61.  
  62.     This has been tested with C-Kermit-5A for QNX-4 at 9600, 19200 and 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 file.
  78.     My thought was to keep things as small as possible. I can edit the entire
  79.     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 system
  91.     for several months.
  92.     
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.