home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / Assembler / dse-src5.dms / in.adf / chapter4.text < prev    next >
Encoding:
Text File  |  1990-05-07  |  8.4 KB  |  238 lines
  1. SYMBOLIC DEBUGGER
  2. -----------------
  3.  
  4.  
  5.  
  6. THE SYMBOLIC DEBUGGER IS A BUILT IN MACHINE CODE MONITOR WITH EXTENSIVE USE
  7. OF THE ASSEMBLER'S FACILITIES,SUCH AS SYMBOL TABLE ACCESS,ARITHMETIC
  8. OPERATIONS,AND INPUT IN ANY BASE.IN ADDITION,THE DEBUGGER OFFERS A
  9. DISASSEMBLER,A LINE ASSEMBLER,TRACE,MULTIPLE BREAKPOINTS AS WELL AS EXAMINE/
  10. MODIFY REGISTERS & MEMORY,FILL,COPY,SEARCH etc.
  11.  
  12.  
  13. X       -XAMINE ALL REGISTERS
  14. Xr      -XAMINE/MODIFY REGISTER r
  15. Gn      -GOTO ADRESS n
  16. Jn      -JUMP TO SUBROUTINE AT n
  17. Qsn     -QUERY (EXAMINE) MEMORY AT n
  18. Nn      -mNEMONICS OF MEMORY AT n
  19. An      -ASSEMBLE IMMEDIATE AT n
  20. Msn     -MODIFY/EXAMINE MEMORY AT n
  21. Sn      -SINGLE STEP,n STEPS
  22. Fs      -FILL MEMORY (BYTES)
  23. C       -COPY MEMORY
  24. ?       -DISPLAY VALUE OF EXPRESSION
  25. @       -SETS COMMAND TAIL
  26. Y       -VDU
  27.  
  28.  
  29.  
  30. VARIOUS DEFAULT VALUES APPLY IF THE NUMERIC PARAMETER IS OMITTED FROM THE
  31. COMMANDS ABOVE.IN THE CASE OF SINGLE STEP,THE DEFAULT IS 1.GOTO,AND JMP TO
  32. SUBR,DEFAULT TO THE CURRENT PC.THE MEMORY ADRESSES IN Q,N,M,AND O,ALL
  33. DEFAULT TO THE LAST USED ADRESS OF ONE OF THE FOUR (THE CURRENT OBJECT
  34. LOCATION).IN ADDITION,A SIZE CAN BE SPECIFIED FOR F,Q,AND M.THIS WILL
  35. DEFAULT TO BYTE,BUT .W OR .L CAN BE SPECIFIED FOR WORD OR LONGWORD
  36. OPERATIONS.
  37.  
  38.  
  39.  
  40. X-XAMINE REGISTER
  41. -----------------
  42. THE 8 DATA, 8 ADRESS , PC , SR, USP AND SSP REGISTERS ARE DISPLAYED.
  43. THE FLAGS INDICATED BY BITS IN THE STATUS REGISTER ARE EXPLICITLY DISPLAYED
  44. AND THE CURRENT INSTRUCTION (i.e. THE ONE WHICH WOULD BE EXECUTED NEXT)
  45. IS DISASSEMBLED AND DISPLAYED.
  46.  
  47.  
  48. THE FORMAT OF THE DISPLAY IS:
  49.  
  50. D0=00000000 00000000 0000000 00000000 D4=00000000 00000000 00000000 00000000
  51. A0=00000000 00000000 0000000 00000000 A4=00000000 00000000 00000000 00000000
  52. SSP=00000000 USP=00000000 SR=A31F tsxn/vc PC=000000 BR   $000008
  53.  
  54.  
  55. ACROSS THE TOPLINE ARE THE 8 DATA REGISTERS, D0, D1, D2, D3, D4, D5, D6, D7.
  56. THE NEXT LINE DISPLAYS THE ADRESS REGISTERS, A0, A1, A2, A3, ....  , A6
  57. AND THE STACKPOINTER A7 WHICH IS THE USER OR SUPERVISOR SP DEPENDING ON THE
  58. 'S'BIT IN THE STATUS REGISTER.
  59. THE THIRD LINE DISPLAYS THE TWO STACKPOINTERS, THE STATUS REGISTER WORD,
  60. THE FLAGS SET IN THE STATUSREGISTER, THE PROGRAMM COUNTER, AND THE
  61. INSTRUCTION AT WHICH IT POINTS.
  62.  
  63.  
  64. Xr- XAMINE/MODIFY REGISTER
  65. --------------------------
  66. THE REGISTER INDICATED BY r ID DISPLAYED, AND THE CONTEST CAN BE ALTERED.
  67. TO ALTER THE VALUE, JUST TYPE IN THE NEW VALUE, FOLLOWED BY <RET>, AND
  68. THE NEW VALUE WILL BE DISPLAYED. IF NO CHANGE IS REQUIRED, JUST TYPE <RET>.
  69. ALL REGISTERS ARE 32 BITS EXCEPT FOR SR, WHICH IS 16. SP AND A7 REFER TO USP
  70. OR SSP, DEPENDING ON THE S BIT OF THE STATUS REGISTER.
  71.  
  72. VALID REGISTERS ARE:
  73.  
  74. D0...D7           DATA REGISTERS
  75. A0...A7           ADRESS REGISTERS
  76. SP                STACK POINTER (=A7)
  77. USP               USER STACK POINTER
  78. SSP               SUPERVISOR STACK POINTER
  79. SR                STATUS REGISTER (16 BIT)
  80. PC                PROGRAMM COUNTER
  81.  
  82. IN ADDITION THE FOLLOWING POINTERS CAN BE EXAMINED AND MODOFIED:
  83.  
  84. SOF      START OF SOURCE POINTER           SOL       START OF LINK POINTER
  85. EOF      END OF SOURCE POINTER             EOL       END OF LINK POINTER
  86.  
  87.  
  88.  
  89. Gn - GOTO ADRESS n
  90. ------------------
  91.  
  92. THE ADRESS n IS PLACED IN THE PROGRAMMCOUNTER, IF n IS NOT GIVEN, THE PC
  93. REMAINS UNCHANGED. BREAKPOINTS ARE PROMPTED FOR, UP TO 8 IN ALL. TO SET A
  94. BREAKPOINT, JUST TYPE IN THE ADRESS AFTER THE PROMPT. TYPING <RET> AFTER
  95. A PROMPT SETS NO BREAKPOINT, AND BEGINS TO EXECUTE THE CODE FROM THE ADRESS
  96. IN PC.
  97.  
  98. Jn - JUMP TO SUBROUTINE
  99. -----------------------
  100.  
  101. SEE G ABOVE, ONLY A RETURN ADRESS IS PLACED ON THE STACK (IF SR=USER
  102. MODE,USP. IF SR=SUPERVISOR MODE, SSP). THE STACKS ARE RESET THUS ANY
  103. INFORMATION PREVIOUSLY ON THE STACK IS LOST.
  104. NOTE THAT ON RETURN, THE PC POINTS TO AN ILLEGAL INSTRUCTION, SOMEWHERE IN
  105. THE HEART OF SEKA. THIS IS CORRECT, IT IS USED AS A BREAKPOINT. SINCE THE
  106. RTS INSTARUCTION LOSES THE VALUE OF PC BEFORE RETURN, THERE IS NO WAY TO
  107. TELL IF YOU EXITED VIA A NORMAL EXIT OR NOT.
  108.  
  109.  
  110. Qsn - QUERY MEMORY
  111. ------------------
  112. 128 BYTES, 64 WORDS OR 32 LONGWORDS OF MEMORY ARE DISPLAYED IN HEX
  113. STARTING AT n, OR DEFAULTING TO THE CURRENT OBJECT LOCATION.
  114. THE CURRENT OBJECT LOCATION IS ADVANCED TO THE ADRESS ONE AFTER THE LAST
  115. BYTE. THE ASCII CHARACTERS REPRESENTED BY THIS ARE DISPLAYED ON THE RIGHT OF
  116. THE HEX DISPLAY.
  117.  
  118.  
  119. Nn - mNEMONICS
  120. --------------
  121. 16 LINES OF CODE ARE DISASSEMBLED TO THEW SCREEN, STARTING AT n, OR
  122. DEFAULTING TO THE CURRENT OBJECT LOCATION. THE CURRENT OBJECT LOCATION IS
  123. ADVANCED TO ONE PAST THE LAST ADRESS DISPLAYED. SEE SECTION ON DISASSEMBLER,
  124. BELOW.
  125.  
  126.  
  127. An - ASSEMBLE IMMEDIATE
  128. -----------------------
  129. THE ADRESS n IS DISPLAYED, AND THE USER IS IN IMMEDIATE ASSEMBLY MODE.
  130. AN INSTRUCTION MAY BE ENTERED, AND IT WILL BE ASSEMBLED DIRECTLY INTO
  131. MEMORY, AND THE NEXT ADRESS WILL BE DISPLAYED. THE MODE MAY BE EXITED
  132. BY TYPING <ESC>. IF AN ERROR IS MADE IN THE mNEMONIC, AN ERROR MESSAGE
  133. WILL BE DISPLAYED, AND THE MODE EXITED. NOTE: IT IS NOT POSSIBLE TO OMIT
  134. n FOR THIS COMMAND, BUT " A*" MAY BE TYPED, TO INDICATE TO ASSEMBLE FROM
  135. THE CURRENT LOCATION.
  136.  
  137.  
  138. Msn - MODIFY/EXAMINE MEMORY
  139. ---------------------------
  140.  
  141. THE ADRESS n , DEFAULTING TO THE CURRENT OBJECT LOCATION IS DISPLAYED,
  142. AND THE CONTENTS OF THE BYTE, WORD OR LONGWORD IS ALSO DISPLAYED.
  143. TO MODIFY THIS LOCATION, SIMPLY TYPE IN THE DESIRED VALUE, AND THE DISPLAYED
  144. MEMORY WILL UPDATE ITSELF. TO ADVANCE TO THJE NEXT LOCATION, TYPE JUST
  145. <RET>. TO EXIT TO SEKA COMMAND MODE TYPE <ESC>.
  146.  
  147.  
  148. Sn - SINGLE STEP
  149. ----------------
  150.  
  151. THE S COMMAND WILL SINGLE STEP THE PROGRAM, USING THE TRACE FACILITY
  152. ON THE 68000. IF n IS SPECIFIED, n STEPS WILL BE PERFORMED BEFORE REPORTING
  153. BACK TO THE DEBUGGER. THE PC MUST BE SET UP BEFOREHAND, EITHER AS A RESULT
  154. OF A PREVIOUS S OR G COMMAND OR AS A RESULT OF AN EXPLICIT XPC.
  155.  
  156. STEP WILL NOT TRACE THROUGH TRAP CALLS OR LINE-A LINE-F CALLS SINCE
  157. THESE WILL USUALLY BE CALLS TO THE OPERATING SYSTEM. THIS IS DONE
  158. AUTOMATICALLY BY STEP BY PLACING A BREAKPOINT AFTER THE CALL.
  159.  
  160.  
  161.  
  162. Fs-FILL
  163. -------
  164. THREE PARAMETERS WILL BE PROMPTED FOR,BEGIN,END,AND DATA.THE DATA BYTE,WORD
  165. OR LONGWORD WILL BE FILLED IN BETWEEN BEGIN UP TO,BUT NOT INCLUDING END.
  166.  
  167.  
  168.  
  169. C-COPY
  170. ------
  171. THREE PARAMETERS WILL BE PROMPTED FOR,BEGIN,END,AND DESTINATION.
  172. THE MEMORY WILL BE COPIED FROM THE AREA BEGIN UP TO,BUT NOT INCLUDING END,TO
  173. THE AREA STARTING AT DEST.THE COPY IS AN INTELLIGENT COPY(?),AND WILL NOT
  174. OVERWRITE THE DATA IT IS COPYING,EVEN IF THE DESTINATION AREA OVERLAPS THE
  175. SOURCE AREA.
  176.  
  177.  
  178.  
  179. ?-DISPLAY VALUE
  180. ---------------
  181. THE EXPRESSION OR VALUE AFTER THE ? WILL BE EVALUATED,AND THE RESULT
  182. DISPLAYED IN DECIMAL AND HEXADECIMAL.THIS IS USEFUL FOR EVERYTHING FROM
  183. EXAMINING THE VALUE OF A SYMBOL TO PERFORMING CALCULATIONS.IT CAN ALSO BE
  184. USED TO CONVERT FROM ONE BASE TO ANOTHER.
  185.  
  186.  
  187.  
  188. @-SET COMMAND TAIL
  189. ------------------
  190. THIS COMMAND TAKES A TEXT STRING AS AN ARGUMENT,AND IT SETS THE "COMMAND
  191. TAIL" AREA OF THE BASE PAGE FOR THE OBJECT PROGRAM TO BE THE TEXT
  192. STRING.??????????????
  193.  
  194.  
  195.  
  196. Y-VDU
  197. -----
  198. THIS ENTERS A SIMPLE VDU MODE,WHERE THE SCREEN AND KEYBOARD COMMUNICATE WITH
  199. A DEVICE ON THE SERIAL LINE,USING DEFAULT BAUDRATE AND CHARACTERISTICS.
  200. SET ON POWER UP OR A ANOTHER INITALIZATION PROGRAM.EXIT BY TYPING <CTRL-C>.
  201. NOTE:<CTRL-C>,<CTRL-S> AND <CTRL-Q> ARE INTERPRETED IN THE NORMAL
  202. CONTEXT,AND NOT SET DOWN THE SERIAL LINE.
  203.  
  204.  
  205.  
  206. DISASSEMBLER
  207. ------------
  208.  
  209. A STANDARD FEATURE OF SEKA IS SIMPLE LINE DISASSEMBLER,FULLY INTEGRATED WITH
  210. THE MAIN ASSEMBLER PACKAGE.THE MNEMONICS USED ARE STANDARD MOTOROLA- JUST
  211. LIKE THE ASSEMBLER. THE DISASSEMBLER IS INVOKED BY THE COMMAND N (FOR
  212. mNEMONICS) FOLLOWED BY AN ADRESS. 16 LINES ARE DISPLAYED.
  213.  
  214. THE DISASSEMBLER CAN DISASSEMBLE ALL 68000 INSTRUCTIONS,BUT IS NOT DEFINED
  215. FOR INVALID INSTRUCTIONS. IT SHOULD ALWAYS BE REMEMBERED THAT SOME AREAS OF
  216. MEMORY ARE DATA AREAS AND DO NOT CONTAIN VALID CODE. DISASSEMBLING THESE CAN
  217. GIVE INCORRECT INSTRUCTIONS - YOU HAVE BEEN WARNED!!!
  218.  
  219. ALTHOUGH ITS PRIMARY FUNCTION IS AS A DEBUGGING AID(S),IT CAN BE USED TO
  220. DISASSEMBLE BLOCKS OF CODE.THIS CAN BE A SLOW PROCESS,BUT THE LINE
  221. DISASSEMBLER IS PREFERABLE TO NONE.
  222.  
  223. IT SHOULD BE REMEMBERED THAT SOME INSTRUCTIONS CAN DISPLAY DIFFERENTLY TO
  224. THE INSTRUCTION TYPED INTO THE ASSEMBLER.ALL NUMBERS AND ADRESSES ARE
  225. DISASSEMBLED IN HEX,AND ALTHOUGH .B .W AND .L SUFFIXES ARE SOMETIMES ADDED
  226. IN PLACE WHERE THEY COULD BE OMITTED,IN UNAMBIGUOUS PLACES THEY ARE OFTEN
  227. NOT DISPLAYED. INSTRUCTIONS WHERE THE ASSEMBLER HAS USED A QUICKFORM,etc.
  228. ,ARE DISPLAYED AS SUCH.IN ADDITION,INSTRUCTIONS SUCH AS EXG CAN DISPLAY THE
  229. REGISTERS IN EITHER ORDER - THE FUNCTION IS IDENTICAL.
  230.  
  231. END OF CHAPTER4
  232. (C)1987 BY CAPTAIN CHAOS & CAPTAIN HOLLIDAY FROM THE CAPTAIN CREW
  233.  
  234.  
  235.  
  236.  
  237.  
  238.