home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / EXITBUG.ZIP / EXITBUG.DOC next >
Text File  |  1994-09-03  |  5KB  |  105 lines
  1.                                 EXITBUG 
  2.                                 =======
  3.  
  4.             Drop file compatibility fix for QuickBBS and some doors
  5.                     Written in Turbo C by Bruce Bowman  
  6.                                          
  7. ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  8. DISCLAIMER:  The author hereby makes no claims about the suitability of this
  9. program for its given purpose...and takes on  no responsibility for whatever
  10. consequences may occur as a result of using this program.
  11. ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  12. Exitbug is freeware. Feel free to use and distribute it at will, as long as
  13. no charge is made for procurement or  use of this program beyond the normal
  14. BBS membership fees.   However, this program is  NOT public domain -- it is
  15. copyrighted, and the author retains all legal rights.                       
  16. ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  17.  
  18. Why ExitBug?
  19. -----------
  20. Version 2.76a (and undoubtedly some others) of QuickBBS suffers from some
  21. compatibility problems with a number of doors, regarding the time the door
  22. thinks is available when the user starts it. Many doors, it appears, read
  23. only the EXITINFO.BBS file, and assume the TmLimit field contains the time
  24. the user had when they drop to the door. In actuality, this field contains
  25. the amount of time the user had when he LOGGED ON. This allows the caller
  26. to circumvent events and time limits for awhile by entering a door shortly
  27. before they run out of time and using the extra time to play. ExitBug reads
  28. the DORINFO1.DEF and patches EXITINFO.BBS with the proper values so these
  29. doors will operate properly under QuickBBS.
  30.  
  31. A Comment...
  32. ------------
  33. The format of the QuickBBS drop files has been standard for some time...but
  34. unfortunately they appear to have become out of line with the norm amongst
  35. other BBS software that also use the EXITINFO.BBS drop file. The author of 
  36. this program makes no claims as to who is "at fault" for this situation -- 
  37. he is merely trying to rectify it. Hopefully this problem will take care of 
  38. itself with the release of version 2.80 of QuickBBS and its support for the
  39. DOOR.SYS drop file.
  40.  
  41. How to Run ExitBug
  42. ------------------
  43. ExitBug must be run both before and after the door, from the directory in
  44. which the DORINFO1.DEF and EXITINFO.BBS drop files are located. This is
  45. necessary so the program can re-patch the EXITINFO.BBS file back the way 
  46. it was before QuickBBS reads it. The program itself can also be in this
  47. directory, or anywhere on your DOS path.
  48.  
  49. The program will create a temporary file TMP$$.TMP, which contains an
  50. integer value which is the amount of time the caller used before they 
  51. entered the door. This is necessary to rebuild the EXITINFO.BBS file after
  52. the door is run.
  53.  
  54. Command Syntax:
  55. --------------
  56.  
  57.       EXITBUG BEFORE|AFTER {BANK}
  58.  
  59. Obviously, use the "before" keyword prior to running the door, and the
  60. "after" keyword afterwards. If the improper syntax is given or the program
  61. cannot find the drop files, ExitBug will print an error message to StdOut 
  62. and exit with an errorlevel of 1. An errorlevel of 0 indicates successful
  63. program termination.             
  64.  
  65. Typical batch application:
  66.  
  67.      CD \BBS\NODE%2
  68.      EXITBUG BEFORE
  69.      CD \DOORS\GAME
  70.      GAME <parameters>
  71.      CD \BBS\NODE%2
  72.      EXITBUG AFTER  
  73.      EXIT                                
  74.  
  75. If you are using exitbug for a time banking or gambling door, add the BANK
  76. keyword (actually, ANY word in this position will be treated as BANK). 
  77. Sometimes this will help -- other times it won't. There seems to be little 
  78. consistency in how doors monitor time usage; therefore, you will just have 
  79. to try it. At least ExitBug gives you some chance of getting it working --
  80. it did help me get one time gambling door to work correctly. 
  81.      
  82. .   .   .   .   .   .   .   .   .   .
  83.      
  84. That's about all. Hopefully it will help you overcome this problem until a
  85. more polished remedy can be found.
  86.         
  87. Obtaining ExitBug
  88. -----------------
  89. ExitBug can be file requested direct from the author at the following email
  90. addresses under the magic name of EXITBUG:
  91.  
  92.                       1:231/710@fidonet.org
  93.                      15:655/402@adltnet.ftn
  94.                      75:7317/71@doornet.ftn
  95.  
  96. If you feel compelled to pay me for this, I will accept donations towards
  97. my other programming endeavors (such as BCheckers). Send what you feel it
  98. is worth to the following address:
  99.  
  100.                       Bruce Bowman
  101.                       8364 S SR 39
  102.                       Clayton, IN  46118
  103.                                                                   
  104. BEB 
  105. 9/2/94