home *** CD-ROM | disk | FTP | other *** search
/ The AGA Experience 2 / agavol2.iso / software / utilities / comms / term / documentation / xpr_libs / xprxmodem.doc < prev    next >
Text File  |  1993-02-13  |  2KB  |  67 lines
  1. xprxmodem.library -- version 34.2
  2.  
  3.  
  4. This is an XPR 2.0 implementation of the XMODEM protocol.
  5.  
  6. based on bmodem: the BIX modem program by David Betz, BYTE Magazine/BIX
  7.         (Modified substantially by W.G.J. Langeveld for use in VLT)
  8.  
  9. Source code modifications and additions needed for XPR are:
  10.  
  11.     Copyright ©1990 Marc Boucher, All Rights Reserved.
  12.  
  13. This software is provided "AS IS" without warranty of any kind, either
  14. expressed or implied, with respect to the programs described herein, their
  15. quality, performance, or fitness for any particular purpose.
  16.  
  17. In no event will the author(s) be liable for direct, indirect, incidental,
  18. or consequential damages.
  19.  
  20. redistribution of this software is permitted, provided that:
  21.  
  22.     1. all files are included, and in their original form.
  23.     2. if included with a particular product (commercial or
  24.        otherwise), proper credit is given to the authors in that
  25.        product's documentation.
  26.  
  27. By using or distributing this software, you agree to understand and accept
  28. the above.
  29.  
  30. The desire to move the seldom used xmodem protocol out of VLT, while
  31. maintaining the functionality to those who needed it, motivated this
  32. XPR implementation.
  33.  
  34. There's nothing really fancy about it.
  35.  
  36. Configurable options are: Text Mode, CRC, and 1K blocks
  37.  
  38. They default to "off" (T0,C0,K0).
  39.  
  40. This can be overridden by a environment variable, "XPRXMODEM", containing
  41. a setup string, of the following format:
  42.  
  43. 3 fields seperated by commas. The first character of every field is the type,
  44. one of:
  45.     T (text mode), C (crc), K (1k blocks).
  46.  
  47. The second char is either 0 or 1, expressing the boolean state of the
  48. option.
  49.     examples:
  50.  
  51.     T0,C1,K1 --> text mode off (binary mode), crc on, 1k blocks
  52.  
  53.     T1,C0,K0 --> text mode, crc off (checksum), normal 128byte blocks
  54.  
  55. The user might also be prompted for such a string when XProtocolSetUp() is
  56. called, if the comm program does not provide the xpr_options callback
  57. function.
  58.  
  59. If xpr_finfo is implemented in the terminal program, then it is used
  60. to get the file type and the Text Mode field in the setup string is
  61. ignored.
  62.  
  63. Marc Boucher
  64.     Internet: marc@CAM.ORG
  65.     BIX: mboucher
  66.     Phone: +1 514 466 8932
  67.