home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / program / switrace / ReadMe next >
Encoding:
Text File  |  1992-03-08  |  1.9 KB  |  54 lines
  1.                    SWITrace  v1.00
  2.      Copyright Greg Stewart-Nicholls and Teknologika ltd.
  3.  
  4.  This program is supplied as Freeware. It may not be used in commercial
  5. products, nor distributed for profit. Apart from that, you can pretty
  6. much do as you like with it.
  7.  
  8.  
  9.  SWITrace enables you (as the name implies) to trace the execution of SWI
  10. calls. The program is provided as a module, which implements 3 commands.
  11.  
  12. Trace    - Activates SWI tracing
  13. TraceOff - Disables tracing
  14. TraceFmt - Formats the trace file
  15.  
  16.   You start tracing by entering the 'Trace' command, along with a range of
  17. addresses. All SWI calls from code within the selected range, will be logged
  18. along with the contents of R0-R7. A log file name may be optionally 
  19. supplied.    
  20.  
  21.     NB: Trace log files grow at an astronomical rate. Unless you have 
  22. memory and DASD to burn, be extremely careful in selecting the range of 
  23. addresses to trace. Performance when tracing is abysmal. Try using a RAM 
  24. log file if possible.
  25.  
  26.   TraceOff naturally, deactivates tracing.
  27.  
  28.   TraceFmt is used to format the trace log into something legible. Supply 
  29. the log file name, along with an output file name.
  30.   Below is a couple of sample trace entries:
  31.  
  32.                    SWI Trace Log from 0181FB94 to 01830000
  33.  
  34. SWI        : 00020005    XOS_CLI
  35. At Address : 01820CB0
  36. Regs       : R0-01828DA5 R1-00000000 R2-00000020 R3-000000FF
  37.              R4-00000003 R5-00000154 R6-00000000 R7-FFFFFFFF
  38.  
  39. SWI        : 00020006    XOS_Byte
  40. At Address : 018217A8
  41. Regs       : R0-00000004 R1-00000002 R2-00000020 R3-0181DE14
  42.              R4-00000003 R5-00000154 R6-00000000 R7-FFFFFFFF
  43.  
  44.  
  45.                                            
  46.   Coming attractions:    
  47.                       Masking for selective SWI tracing.
  48.                       Multiple concurrent active traces.
  49.                       Trap processing for selected SWI's
  50.  
  51.   Bug reports and suggested improvements to: nicho@cix.compulink.co.uk
  52.                       
  53.  
  54.