home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol132 / tracer.doc < prev    next >
Encoding:
Text File  |  1984-04-29  |  1.7 KB  |  36 lines
  1.     ****************************
  2.     *** TRACER DOCUMENTATION ***
  3.     ****************************
  4.  
  5.  
  6.     THE TRACER PROGRAM IS A UTILITY TO TRACE THE EXECUTION
  7. OF AN 8080 OR Z80 PROGRAM. IT IS WRITTEN USING Z80 OP-CODES SO
  8. IT MUST BE EXECUTED ON A Z80 SYSTEM. AS WRITTEN IT CAN BE
  9. ASSEMBLED TO RUN ANYWHERE IN MEMORY BUT MUST BE IN R/W MEMORY
  10. BECAUSE IT USES SOME SELF MODIFYING CODE. THE TARGET PROGRAM
  11. MUST ALSO BE IN R/W MEMORY BECAUSE THE TRACER USES RESTARTS
  12. (RST6) WHICH IT MOVES THROUGH THE TARGET PROGRAM.
  13.     THE TRACER AND TARGET PROGRAM MUST BE LOADED INTO
  14. MEMORY, THEN ENTER THE TRACER 'INIT' ROUTINE. THE FIRST PROMPT
  15. ASKS FOR THE ADDRESS WHERE YOU WANT TO START DISPLAYING TRACER
  16. INFORMATION. IT MUST BE AN ADDRESS CONTAINING THE FIRST BYTE
  17. OF AN OPCODE. THE SECOND PROMPT ASKS FOR THE ADDRESS WHERE YOU
  18. WISH TO START EXECUTING THE TARGET PROGRAM. THE INPUT ADRESSES
  19. SHOULD BE IN HEX FOLLOWED BY A CARRIAGE RETURN. IF A MISTAKE IS
  20. MADE IN ENTERING, JUST TYPE THE CORRECT ADDRESS AFTER THE
  21. MISTAKE. TRACER TAKE THE LAST FOUR CHARACTERS TYPED. AFTER THE
  22. SECOND ADDRESS IS TYPED TRACER JUMPS TO THE TARGET PROGRAM AT
  23. THE SPECIFIED ADDRESS AND BEGINS EXCUTING. OPON ENCOUNTERING
  24. THE RESTART (RST6) IT WILL:
  25.     1.DISPLAY THE CONTENTS OF THE REGISTERS
  26.     2.REPLACE THE BYTE DISPLACED BY THE BREAKPOINT
  27.     3.CALCULATE THE NEXT OPCODE TO BE EXECUTED
  28.     4.INSTALL A RESTART AT THE NEXT LOCATION
  29.     5.REENTER TARGET PROGRAM AT THE LAST BREAKPOINT
  30.  
  31.     TO PAUSE THE TRACER WHILE IT IS RUNNING YOU PRESS
  32. THE 'ESCAPE' (1BH) KEY. A 'TRACER>' PROMPT SHOULD APPEAR.
  33. A SECOND 'ESCAPE' CONTINUES ON WITH THE TRACE. TO STOP THE
  34. TRACE IN PROGRESS FIRST GET THE TRACE PROMPT BY PRESSING THE
  35. 'ESCAPE KEY. THEN PRESS THE 'X' KEY. TRACER WILL RESTORE THE
  36. DISPLACED OPCODE THEN ENTER THE INPUT MODE AGAIN.