home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / new / util / libs / sslib / ssdiag.doc < prev    next >
Text File  |  1994-12-12  |  2KB  |  53 lines
  1.  
  2.                                SS Diagnostics 5.0
  3.  
  4.                (c) 1993,1994 MJSoft System Software, Martin Mares
  5.  
  6. ================================================================================
  7.  
  8.    SSDiag is a diagnostic tool for developing of programs using ss.library.
  9. It is a part of ss.library distribution archive and may not be distributed
  10. separately. For copyright notice and similar information see SSLib.README.
  11.  
  12.    This tool has been designed to be used only by programers, therefore
  13. casual user will probably have some problems with understanding its work.
  14.  
  15.    SSDiag is a command-line controlled software. Summary of command can be
  16. obtained using the '?' command.
  17.  
  18.    All numbers written out by this program are hexadecimal.
  19.  
  20.    It isn't recommended to list the resource list of currently running
  21. program, because there's no locking mechanism on it.
  22.  
  23.  
  24. Commands:
  25. ---------
  26.  
  27. Q         quit SSDiag
  28.  
  29. T         list tasks using ss.library. Each task is presented by its task node
  30.           address, base of variables (the pointer which is usually stored in A5)
  31.           and its name (the name of command, not the name of the task)
  32.  
  33. U <name>  select task to be watched by its name. If there're multiple tasks
  34.           with this name, SSDiag will refuse the selection.
  35.  
  36. U <addr>  select task to be watched by its base of variables. Usually entered
  37.           as a hexadecimal number (0x...).
  38.  
  39. B         show basic variables of the task (for description see SS.i)
  40.  
  41. L         list resources allocated by the task. Lists all resource lists
  42.           and tracked resources.
  43.  
  44. K         kill task calling its ExitCleanup routine. Not recommended, very
  45.           dangerous. Cannot be applied on running tasks. Killing of a task,
  46.           which is waiting for file access, can cause system crash.
  47.  
  48. S         show some fields in SSBase.
  49. A         analyse program's stack. Displays each longword of program's stack
  50.       along with memory it points to. The longwords overlap each other
  51.       (if you have $12345678 $9ABCDEF0 on the stack, $12345678 $56789ABC
  52.       and $9ABCDEF0 will be displayed).
  53.