home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource4 / 277_01 / xmodem.doc < prev    next >
Text File  |  1988-11-15  |  2KB  |  61 lines
  1. Xmodem Under Xenix/Unix
  2. copyright 1986 Ronald Florence
  3.  
  4. The module xmodem.c is written to be compiled with a modified version
  5. of cu.c and/or with xr.c, using the defines specified in the Makefile 
  6. and the headers of the appropriate files. 
  7.  
  8. Remote Xmodem 
  9.  
  10. When compiled with xr.c, xmodem.c provides standalone programs, xr
  11. and xt (actually a link) which enable a remote computer logged onto
  12. the host (unix) machine to transmit to or receive from the unix machine
  13. using Xmodem protocol.  
  14.  
  15. The options are the same for both send and receive:
  16.  
  17.     -c    crc mode (checksum is the default)
  18.     -d fn    debug messages to fn
  19.     -t    text (CR-NL <-> NL conversions)
  20.  
  21. To transfer TO the unix host give the command
  22.  
  23.      xr [-ct] [-d errfile] filename
  24.  
  25. on the unix host, wait for xr to announce it is ready, then begin the
  26. Xmodem send from the remote machine.  To transfer FROM the unix host,
  27. give the command
  28.  
  29.     xt [-ct] [-d errfile] filename
  30.  
  31. on the unix host, wait for xt to announce it is ready, then begin the
  32. Xmodem receive on the remote machine.  xt will adjust to the sync 
  33. character of the Xmodem receiver (match crc or checksum).
  34.  
  35. Both xt and xr ignore signals, and should be terminated by sending a
  36. Ctrl-X <CAN>, which is the signal Xmodem programs normally send to
  37. cancel a transfer.  If the remote machine screws up, the Ctrl-X can be
  38. sent manually.
  39.  
  40. The byte counts of text files transferred from ms-dos machines with the
  41. "-t" option will be shorter on the unix machine because the <CR>s have
  42. been dropped.
  43.  
  44.  
  45. Xmodem with cu or other terminal programs
  46.  
  47. If you have a unix/xenix source license, xmodem.c can be compiled with
  48. cu.c to provide a version of cu that can receive and transmit to
  49. bulletin boards, Compuserve, etc., using Xmodem (Modem 7) protocol in
  50. either crc or checksum mode.  
  51.  
  52. The xmodem.c module can also be compiled with other terminal programs,
  53. such as kermit, to provide xmodem transfer capabilities.  One easy way 
  54. to use the module with a program like cu is to kill the receive process 
  55. in cu, condition the line to 
  56.  
  57.     ~(ISTRIP | IXON | IXOFF | PARENB) , CS8
  58.  
  59. then fork to start xget() or xput().  When the child is finished,
  60. do a longjmp to restart the receive process.
  61.