home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / progc / zmnp12.arj / README < prev    next >
Text File  |  1990-08-29  |  5KB  |  163 lines
  1. ZMNP library - evaluation version for Turbo C 2.00 and 2.01.
  2. Version 1.2  19 Mar 90
  3.  
  4.  
  5. Contents:
  6.  
  7. readme        This file.
  8. makefile      Make file for cu.exe.
  9. cu.c          Source for cu.exe.
  10. zmnp.doc      Interface decription for libraries.
  11. cu.exe          Demonstration program.
  12. zmnp.h          Library header file.
  13. zmnps.lib     Small model library.
  14.  
  15.  
  16. General.
  17.  
  18. This package contains the evaluation version of the ZMNP comms library
  19. for PC compatibles which features (in addition to basic interrupt
  20. driven asynchronous comms functions) MNP level 2 error correction, the
  21. XMODEM, YMODEM and ZMODEM file transfer protocols and background file
  22. transfers. The library works with Turbo C versions 2.00 and 2.01. 
  23. Libraries are also available for the medium, compact and large memory
  24. models.
  25.  
  26.  
  27. CU.C and CU.EXE.
  28.  
  29. CU.EXE (to which CU.C is the source) is a demonstration/testbed program
  30. for the ZMNP library.  It is whimsically named after the UNIX cu command
  31. to which it bears only the most superficial resemblance.
  32.  
  33. Usage: cu [options]
  34.        Options are:
  35.        -o     MNP originate mode.
  36.        -a     MNP answer mode.
  37.        -p<port>  Use COM<port> (default COM1).
  38.        -s<speed> Bps (default 2400).
  39.  
  40. Note that if CU is invoked without either of the -o or -a options, it
  41. will make no attempt to make a MNP connection.
  42.  
  43. When you are running CU, there are four commands you can issue:
  44.  
  45. ~s      starts a ZMODEM upload.  You will be prompted for the names of
  46.         the files to upload (no wildcard support, but you can add this
  47.         to CU.C if you want).
  48. ~r      starts a ZMODEM download.  In the normal course of events, it is
  49.         unnecessary to issue this command as CU will automatically start
  50.         a ZMODEM download as soon as it sees the initialisation string
  51.         from the remote end.  However, if the remote is sending a
  52.         command rather than a file, the download will have to be started
  53.         manually.
  54. ~.      hangs up, restores the 8250 and the interrupt vectors to the 
  55.         state they were in before running CU and exits.
  56.  
  57. Foreground file transfers may be interrupted by typing ^C (Control C)
  58. or ^Break.  Pressing any key during a file upload or download will
  59. start a MS-DOS command shell.  The file transfer will continue in the
  60. background.  Type 'exit' at the DOS prompt to return to cu.
  61.  
  62.  
  63. Example session (calling CIX):
  64.  
  65. C:>cu -o
  66. atdp013901244               <-- You type this - CU doesn't know how to dial.
  67. CONNECT 2400                <-- From Hayes compatible modem.
  68. MNP level 2                 <-- From CU - MNP negotation succeeded.
  69.  
  70. Type 'cix' to login: qix
  71.  
  72.  
  73. CIX  Version 1.248  12/21/89
  74. You are on line: tty51
  75. Nickname? (Enter 'new' for new user) username
  76. Password:
  77. You have 3 file(s) in your private subdir.
  78. You have 3 mail message(s) in your in-basket.
  79. There are 2 unread mail message(s).
  80. You are a member of 46 conference(s).
  81. You are now listening for chat
  82. Macro defined.
  83. M:bye
  84. username, you have been online 0:53 on tty51
  85. Goodbye from CIX     !!!HANGUP NOW!!!
  86. MNP link broken
  87.  
  88. C:>
  89.  
  90.  
  91. Restrictions in the evaluation version.
  92.  
  93. 1) The library displays an unsightly version message.  This does not
  94.    appear in the production version.
  95.  
  96. 2) Only the small code / small data library is supplied.  All memory
  97.    models are supported in the production version.
  98.  
  99.  
  100. Licence.
  101.  
  102. You are welcome to use this software for evaluation purposes.  You may
  103. make and distribute copies of the evaluation version of this software. 
  104. If you want to continue to use this software after you have evaluated
  105. it, you should register.  Registration costs 30 pounds sterling plus
  106. VAT at the current rate (15% at the time of writing making a total of
  107. 34.50 pounds sterling).  Registered users will receive the production
  108. version of the object library (all memory models) and will be entitled
  109. to join the ZMNP support conference on the CIX conferencing system. 
  110. The production version of the object library will be supplied on MS-DOS
  111. format 5 1/4 inch high density disc (it can also be supplied via
  112. BINMAIL on CIX if preferred).  Please note that it is a condition of
  113. the licence that use of the ZMNP library in your own programs be
  114. credited either in the program or its documentation.  No runtime
  115. royalties are payable.
  116.  
  117.  
  118. Problems/bugs.
  119.  
  120. Please report any bugs to me.  Suggestions for improvements are also
  121. very welcome.  Whilst I will make every effort to sort out any
  122. problems, please note that no responsibility will be accepted for any
  123. loss or damage, consequential or otherwise caused by the use of these
  124. libraries or cu.exe.
  125.  
  126.  
  127. Giles Todd
  128. Rundart Ltd
  129. 5 Brentnall Close
  130. Great Sankey
  131. Warrington
  132. WA5 1XN
  133. England
  134.  
  135. +44 (0)925 33472
  136.  
  137. gtodd@cix.UUCP (Internet)
  138. ...!ukc!slxsys!cix!gtodd (uucp)
  139.  
  140. 8<-----------------------------------------------------------------------------
  141.  
  142. Order form.
  143.  
  144. To: Rundart Ltd, 5 Brentnall Close, Great Sankey, Warrington, WA5 1XN
  145.  
  146. Please register my copy of the ZMNP library and send me the production
  147. version of the object libraries on disc / via BINMAIL to work with
  148. Turbo C.  I enclose a cheque for 34.50 pounds sterling (including VAT).
  149.  
  150. Name
  151.  
  152. Address
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.