home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / comms / comprgs / term20_1.lzh / XPR_Libs / xprxmodem.doc < prev    next >
Text File  |  1992-03-05  |  4KB  |  118 lines
  1.                                 XPRXMODEM v34.3
  2.  
  3. A small bug crept into the code, which went undetected, until XPRXmodem
  4. was tested with other versions of XModem.  (Thanks to Scott Velez for
  5. helping to confirm this.)  It has now been fixed.  Following is the
  6. "readme" file from the previous release.  Note the file size is now
  7. 12,352 bytes, and I've adapted xcrc.h (from XPRZmodem v2.10) for
  8. XPRXmodem, since it's a bit faster.  Also, MYREVISION is now 36 (libsup.c),
  9. so "version xprxmodem.library" should now correctly, return 34.36.
  10. (I forgot to bump this in v34.2.)
  11.  
  12.                                         My humble apologies. -- Anthon
  13.  
  14.                       - - - - - - - - - - - - - - - - - -
  15.  
  16.                                 XPRXMODEM v34.2
  17.  
  18. Following is an independent (ie by me) update to xprxmodem.library (v34.1),
  19. by Marc Boucher.
  20.  
  21. The only change is to crc checking, in which, the old method of computing
  22. crc polynomials on the fly, has been replaced with a table of pre-computed
  23. polynomials and the appropriate code (by Marc G. Mendel), reducing the time
  24. between receiving the block & acking it.  Thus, transfers are sped up.
  25. (The really observant will notice the source code was extracted from the
  26. Unsit1.5 archive that I recently uploaded to Unix.source).
  27.  
  28. Here's some data rates (reported by VLT's update window) for a null modem
  29. setup between two Amigas running VLTjr & xprxmodem (1K blocks with CRC, of
  30. course):
  31.  
  32.             2400 baud    19200 baud(*)   |   file size
  33.                                          |
  34.      34.1      201           654         |    11,820
  35.                                          |
  36.      34.2      212           796         |    12,332
  37.     _____________________________________|
  38.                                          |
  39.      Gains      5%           20%         |
  40.  
  41. Diffs to dlink.c are included for those interested in the code.  Also,
  42. I've bumped up the revision number to v34.2.  The library was compiled and
  43. linked with Manx Aztec C v5.2.
  44.  
  45.                                    -- Anthon Pang (a665@mindlink.bc.ca)
  46.  
  47. (*) You'll have to look elsewhere for an explanation of why it's
  48.     not 8 times faster...
  49.  
  50. --
  51.  
  52. xprxmodem.library -- version 34.2
  53.  
  54.  
  55. This is an XPR 2.0 implementation of the XMODEM protocol.
  56.  
  57. based on bmodem: the BIX modem program by David Betz, BYTE Magazine/BIX
  58.         (Modified substantially by W.G.J. Langeveld for use in VLT)
  59.  
  60. Source code modifications and additions needed for XPR are:
  61.  
  62.     Copyright ⌐1990 Marc Boucher, All Rights Reserved.
  63.  
  64. This software is provided "AS IS" without warranty of any kind, either
  65. expressed or implied, with respect to the programs described herein, their
  66. quality, performance, or fitness for any particular purpose.
  67.  
  68. In no event will the author(s) be liable for direct, indirect, incidental,
  69. or consequential damages.
  70.  
  71. redistribution of this software is permitted, provided that:
  72.  
  73.     1. all files are included, and in their original form.
  74.     2. if included with a particular product (commercial or
  75.        otherwise), proper credit is given to the authors in that
  76.        product's documentation.
  77.  
  78. By using or distributing this software, you agree to understand and accept
  79. the above.
  80.  
  81. The desire to move the seldom used xmodem protocol out of VLT, while
  82. maintaining the functionality to those who needed it, motivated this
  83. XPR implementation.
  84.  
  85. There's nothing really fancy about it.
  86.  
  87. Configurable options are: Text Mode, CRC, and 1K blocks
  88.  
  89. They default to "off" (T0,C0,K0).
  90.  
  91. This can be overridden by a environment variable, "XPRXMODEM", containing
  92. a setup string, of the following format:
  93.  
  94. 3 fields seperated by commas. The first character of every field is the type,
  95. one of:
  96.     T (text mode), C (crc), K (1k blocks).
  97.  
  98. The second char is either 0 or 1, expressing the boolean state of the
  99. option.
  100.     examples:
  101.  
  102.     T0,C1,K1 --> text mode off (binary mode), crc on, 1k blocks
  103.  
  104.     T1,C0,K0 --> text mode, crc off (checksum), normal 128byte blocks
  105.  
  106. The user might also be prompted for such a string when XProtocolSetUp() is
  107. called, if the comm program does not provide the xpr_options callback
  108. function.
  109.  
  110. If xpr_finfo is implemented in the terminal program, then it is used
  111. to get the file type and the Text Mode field in the setup string is
  112. ignored.
  113.  
  114. Marc Boucher
  115.     Internet: marc@CAM.ORG
  116.     BIX: mboucher
  117.     Phone: +1 514 466 8932
  118.