home *** CD-ROM | disk | FTP | other *** search
/ Really Useful CD 1 / ReallyUsefulCD1.iso / extras / netutils / _netguard / _help < prev    next >
Text File  |  1992-02-15  |  12KB  |  264 lines
  1. ***********************************************************
  2. *                                                         *
  3. *                          NetGuard                       *
  4. *                          --------                       *
  5. *                     Written By G.R.King                 *
  6. *                        (Version 1.00)                   *
  7. *                                                         *
  8. ***********************************************************
  9.  
  10.   NetGuard is primarily designed for use in schools and
  11. colleges, or basically anywhere where Econet is used. It
  12. allows the user to shut himself off from the 'outside
  13. world' and be able to continue using the computer with out
  14. fear of being interrupted.  As you will no doubt know, when
  15. a computer on Econet receives a notify message from another
  16. station, the computer stops everything (if you are in the
  17. Desktop) and displays the message in an error window.  This
  18. can be annoying at the best of times, and even more so when
  19. the message is just someone having a laugh!
  20.  Netguard gives you several options as to how your computer
  21. will deal with a notify message.  You can have the message
  22. displayed immediately if you wish, but instead of
  23. displaying the message in an error box, the message is
  24. displayed in a fully multitasking window.  Another benefit
  25. is that if you have this display window open and you are
  26. sent another  message, the message in the window will
  27. simply be updated without interruption.  You also have two
  28. other options.  You can have the message completely
  29. ignored, or you can have the message stored until you are
  30. ready to read it.  To store the incoming notify message the
  31. option 'Pass to buffer' must be selected on the main
  32. window.  When your station receives a notify message the
  33. computer will grab the message, store it and warn you of
  34. its arrival. It warns you by making the icon on the icon
  35. bar flash and if you have the 'Sound' option selected on
  36. the menu, it will give a loud gong type noise every three
  37. seconds or so.   If you have a stored message and you are
  38. ready to deal with it you can either click on the 'Flush
  39. buffer' icon or the 'Clear buffer' icon.  'Flush buffer'
  40. will display the stored message on screen, whilst 'Clear
  41. buffer' will erase the message.
  42.  If you have the 'Ignore notify' icon set, all messages
  43. will be ignored and you will not be warned of there
  44. arrival.
  45.   You can also have the computer immediately react to the
  46. notify in a number of ways.  On receipt of the message, you
  47. can have the senders computer 'killed', that is to say the
  48. sender of the message will find that he can no longer use
  49. his computer!
  50.  You can have the message echoed back to the sender, so
  51. the sender would receive his own message!
  52.  You can have your computer automatically send a user
  53. definable message to the sender.  The message to be sent
  54. must be typed in to the writeable icon at the bottom of the
  55. window.
  56.  Or, you can select no reaction.
  57.   You will also notice eight icons to the bottom right of
  58. the window, under the heading 'Protection'.  These icons
  59. reflect the current setting of the Econet protection word,
  60. which is held in the CMOS RAM.  They protect against the
  61. following immediate operations :
  62.      
  63.   Icon title         When set
  64.   ----------         -------- 
  65. N/A (Poke       -    Prevents memory from another computer
  66.                      being copied directly into your
  67.                      machine.)
  68.     Peek        -    Prevents memory being copied from
  69.                      your machine.
  70. N/A (JSR/BL     -    Prevents another machine from making
  71.                      your machine branch with link (BL) to
  72.                      another section of memory to execute
  73.                      some code.)
  74.     UPC         -    Prevents another machine sending you
  75.                      the call 'Econet_UserProcedureCall'.
  76.     OSPC        -    Prevents another machine sending you
  77.                      the call 'Econet_OSProcedureCall', 
  78.                      thus preventing your machine from
  79.                      receiving 'Econet_OSCauseFatalError'
  80.                      and 'Econet_CharacterFromNotify'.
  81.     Halt        -    Prevents the remote halting of your
  82.                      machine.
  83.     Cont        -    Prevents the remote continuation of
  84.                      your machine.
  85.     GetReg      -    Prevents another machine from gaining
  86.                      a copy of your machines current 
  87.                      register status.
  88.  
  89. Note: Setting the OSPC icon prevents any station notifying
  90. you.  It is no good having selected for a message to be
  91. displayed immediately if no one can notify you anyway!
  92.  
  93. Sub Note: Pupils in Lipson Community College might have
  94. been victim to the 'Send' application.  This application
  95. allows the user of another machine to remotely crash your
  96. machine, giving the error 'Address Exception at...'.  To
  97. prevent this you should set the 'Halt' icon.
  98.  
  99.  
  100.   Revision History
  101.   ---------------- 
  102.   Version 0.55 (1 Jan 92) 
  103.   -----------------------
  104. Currently only the Ignore notify and immediately display
  105. notify options are up and working (theoretically, that
  106. is),I have had some problems with passing the message to a
  107. buffer as I don't have Econet so therefore can't test
  108. anything. I'll have to wait until I can test it later
  109. on.
  110.  The code for the 'Kill sender' option is written and has
  111. been tested.  Acorn would have a fit if they saw it, as it
  112. does not legally kill the sender (is there a legal way?).
  113. It sends a corrupt data packet to the originator of the
  114. message, in the form of an immediate operation,this can
  115. (and indeed does) have a very strange effect on the
  116. destination machine (it varies), but the destination
  117. machine will almost certainly cease to function correctly
  118. (if at all!). 
  119.  
  120.   Version 0.65 (2 Jan 92) 
  121.   ----------------------- Added the sound feature just in
  122. case the user didn't notice the little flashing icon.  The
  123. Flush & Clear buffer icons are working, or at least if
  124. there was a buffer to flush! Realised I did not have
  125. anywhere to display error messages and such like, I
  126. couldn't just pop up an error box as this would defeat the
  127. object of the application, which is to allow the user to
  128. receive remote messages from Econet and not have to be
  129. interrupted.  So I stuck another icon at the bottom of the
  130. window!
  131.  
  132.   Version 0.75 (4 Jan 92)
  133.   ----------------------- Theoretically all the set
  134. protection icons are up and working, I still haven't had
  135. access to Econet so I don't know for sure!  Removed a bug
  136. from the sound option.  Once you had turned the sound off
  137. it never came back on again!!!
  138.  
  139.   Version 0.80 (17 Jan 92)
  140.   ------------------------ My jaw hit the floor on the
  141. realisation that none of the  protection icons were
  142. working!  Never mind.  They are now! At least some are...
  143. Having problems with 'Bad Mask' error when using SWI call
  144. '4000E'.  As a direct result of this  I have had to leave
  145. out two icons (they will be back soon), but the others are
  146. all working.
  147.   Messed about with the 'Echo' & 'Send Message' functions..
  148. .. No joy!
  149.  
  150.   Version 0.90 (18 Jan 92)
  151.   ------------------------ Messed about with passing the
  152. notify message to the buffer...success!  Or at least,
  153. probably.  As I have said before, I don't have Econet so
  154. I'll have to wait until I can test it to be sure.  The
  155. hardest thing wasn't writing the code to deal with the
  156. message buffering, it was testing it! It took me a hour to
  157. set up a fake notify routine and pass all the relevant info
  158. over to 'NetGuard'.
  159.   Currently 'NetGuard' does not really buffer the messages.
  160. It only records the last one, so if you were sent two
  161. messages, 'NetGuard' would delete the first message on the
  162. arrival of the second. (Never mind, it will soon buffer OK)
  163.   The icon which I stuck at the bottom of the window in
  164. version 0.65, has now been put into use!  It displays the
  165. status of the data packet sent to the sender of the notify
  166. message.
  167.   
  168.   Version 0.95 (21 Jan 92)    (Pre realise)
  169.   ------------------------ 90% of the application is up and
  170. running.  Still needs a  bit of debugging and a few
  171. functions have not yet been included.  I have decided to
  172. release this version of  NetGuard as it is, as a pre
  173. release version.  It is near enough a full version but not
  174. quite, the following  functions are not implemented in this
  175. pre release version of NetGuard :
  176.           
  177.           Protection :
  178.                       Poke
  179.                       JSR/BL
  180.                       Strange things can happen with the
  181.                       icons!! (?)
  182.           Reaction   :
  183.                       Echo
  184.                       Send Message
  185.     Message Window   :
  186.                       Save function on this menu has not
  187.                       yet been implemented.
  188.                       The arrow icons in the top corners
  189.                       as yet do nothing.
  190.  
  191.   Version 1.00 (22 Jan 92)
  192.   ------------------------
  193. Ah ha!  I have made a few improvements.  All reaction
  194. functions are working, that is I have added the Echo & Send
  195. Message function code to the application.  I have taken out
  196. the option to save the text of the notify.  The protection
  197. icons 'Poke' & 'JSR/BL' have been greyed out, as have the
  198. arrow icons on the message display window.  I'm to lazy to
  199. implement it in this version!I don't think the icon at the
  200. bottom of the window actually does anything but I have left
  201. it there just in case.  (It did do something many years
  202. ago, but it apparently doesn't do it properly!)
  203.  
  204.   Discliamer
  205.   ----------
  206. In no circumstances shall the author be liable for any
  207. damage, loss of profits, time or data or any indirect or
  208. consequential loss rising out of the use or inability to
  209. use this software.
  210.  
  211. Improvements coming in the next version:
  212.   
  213.   ALL protection icons will be working!
  214.   FULL buffering capacity, with queue.
  215.   More flexible reaction selections.
  216.   Added intelligence! (You'll have to wait and see!)
  217.   ...and anything else I can think of!
  218.  
  219.  
  220.   Well, if anyone for reasons as yet unknown (more bug
  221. reports, insulting letters, ideas about more features to
  222. add, or just general comments) would like to contact me,  I
  223. can be found at :
  224.              G.R.King      
  225.              54 Neath Road,
  226.              St. Judes,
  227.              Plymouth,
  228.              Devon,
  229.              PL4 8TG
  230.              England.
  231.  
  232. You can contact me on E-Mail via Mike Smith : Arcade #534
  233.  
  234. C ya...
  235.  
  236. Whoops! P.S. :  I retain the full copyright to '!NetGuard'
  237. and all its associated files, with exception of the
  238. 'InterfaceManager', which is the copyrighted material of
  239. Simon Huntington. (and V good it is too!)
  240.   However, the application may be distributed as SHAREWARE,
  241. as long as :
  242.  
  243.   The WHOLE application is copied.
  244.   None of the files are 'tampered' with. *
  245.   None of the code is removed and used in other software. *
  246.   This application is NOT sold for profit. 
  247.  
  248. * :- Without written permission from the author.
  249.  
  250. As SHAREWARE, if you (the user) would like to make regular
  251. use of 'NetGuard' you must register with me at the cost of
  252. ú5.00.  For your money you will be sent the latest copy of
  253. 'Netguard' and will continue to receive the latest version
  254. for as long as I continue to develp 'NetGuard'. When I send
  255. you your updates I will probably stick some PD software on
  256. there as well. 
  257. (When registering please state the verion you have)
  258.  
  259. PPS. Oh and by the way, a short message to all the people
  260. (?) out there who keep moaning about how hard it is to
  261. program in the WIMP enviroment.  There are fifteen year
  262. olds (and younger) out here programming the WIMP and they
  263. have had no programming courses or even passed any GCSEs
  264. yet.  I should know, I'm one of them.