home *** CD-ROM | disk | FTP | other *** search
/ Supremacy 1 / Supremacy-1.iso / UTILS / S-T / STING.ZIP / STING / DEV-KIT / LOGSTING / README.TXT < prev   
Text File  |  1997-05-03  |  2KB  |  49 lines
  1.  
  2. This is LogSTinG, a tool for logging all STinG calls into a file, or 
  3. a pipe, the latter only if MiNT or MagiC > 3.0 is used.
  4.  
  5. LogSTinG may be started at any time _after_ STinG has completed all 
  6. initialization. Thus generally it must be started from the desktop, 
  7. which is not bad because it is not intended to be there permanently.
  8. Use the control program LOGCTRL.PRG to remove LogSTinG again. Note that 
  9. programs that install and use their own copy of the STinG TPL structure, 
  10. must be terminated before LogSTinG is removed via LogCTRL, if they have 
  11. been started while LogSTinG was active. If this is violated, then any 
  12. action carried out by that unterminated program will eventually result 
  13. in a system crash. I can't do anything about that. Using an own copy 
  14. of the TPL is not the general behaviour of STinG clients, though, so 
  15. normally you don't have to worry about this.
  16.  
  17. LogSTinG recognizes if it is started while another copy is active, and 
  18. denies installation then. Similarly LogCTRL can't be started without 
  19. having LogSTinG started first.
  20.  
  21. Once started, LogSTinG logs all STinG calls along with parameters and 
  22. return values into the file STING.LOG which is in the same directory 
  23. LogSTinG has been started from. The file may be deleted or renamed 
  24. during operation, LogSTinG will immediately create a new one. Use 
  25. LogCTRL to change this default file, or whether at all parameters 
  26. should be logged, etc. You can also tell LogSTinG to only log selected 
  27. STinG calls.
  28.  
  29. Note that a LogSTinG log contains STinG traffic data to and from your 
  30. site ! This is true for confidential e-mail as well as passwords, that 
  31. are carried via TCP, for instance. The password for your ISP account 
  32. is safe, however, because it is only handled by the Dialer, which does 
  33. not use STinG to send the password. Be very careful, when giving log 
  34. files away ! Cut away confidential data !
  35.  
  36. For each STinG call the log file is opened and closed a couple of times. 
  37. Which MagiC on an ST this is noticable, but well tolerable. If your 
  38. system doesn't cache disk data effectively, LogSTinG might slow down 
  39. execution of your client to much. Some people thus asked me for an in-
  40. built buffer that is written to disk on a regular basis. If you keep 
  41. urging me, one day I'll put that in. That'd speed things up for slow 
  42. systems.
  43.  
  44.  
  45. Any ideas, comments, flames, letterbombs to
  46.  
  47. Peter Rottengatter
  48. perot@pallas.amp.uni-hannover.de
  49.