Debug Manual
Table Of Contents
- What’s New in This Manual
- About This Manual
- 1 Introduction- Execution Modes on TNS/R Systems
- What User Access Is Required for Debugging
- How to Make a Process Enter Debug
- How to Select Debug as the Debugger
- Why a Process Enters Debug
- How to Determine Process State on a Trap or Signal
- Ending a Debug Session
- What Appears in the Debug Header Message
- How to Use Debug
- How Debug Breakpoints Work
 
- 2 Using Debug on TNS/R Processors
- 3 Debug Command Overview
- 4 Debug Commands- Command Summary
- A Command
- AMAP Command
- B Command
- BASE Command
- BM Command
- C Command
- CM Command
- D Command
- DJ Command
- DN Command
- EX[IT] Command
- F[ILES] Command
- FC Command
- FN Command
- FNL Command
- FREEZE Command
- HALT Command
- H[ELP] Command
- I Command
- IH Command (TNS/R Native and OSS Processes)
- INSPECT Command
- LMAP Command
- M Command
- MH Command (TNS/R Native and OSS Processes)
- P[AUSE] Command
- PMAP Command (Accelerated Programs)
- PRV Command
- R Command
- S[TOP] Command
- T Command
- V Command
- VQ Command
- VQA Command
- = Command
- ? Command
 
- A Error Messages
- B ASCII Character Set
- C Command Syntax Summary- Register Syntax
- Expression Syntax
- Address Syntax
- A Command
- AMAP Command
- B Command
- BASE Command
- BM Command
- C Command
- CM Command
- D Command
- DJ Command
- DN Command
- EX[IT] Command
- F[ILES] Command
- FC Command
- FN Command
- FNL Command
- FREEZE Command
- HALT Command
- H[ELP] Command
- I Command
- IH Command
- INSPECT Command
- LMAP Command
- M Command
- MH Command
- Output-Device Syntax
- P[AUSE] Command
- PMAP Command
- PRV Command
- R Command
- S[TOP] Command
- T Command
- V Command
- VQ Command
- VQA Command
- = Command
- ? Command
 
- D Session Boundaries
- E Correspondence Between Debug and Inspect Commands
- F Sample Debug Sessions
- Glossary
- Index

Sample Debug Sessions
Debug Manual—421921-003
F-25
Accelerated Program Example
We set a breakpoint at the next register-exact point and display the registers, as 
follows:
This example shows that an error occurs if an attempt is made to set a TNS code 
breakpoint at a location that is not a memory-exact or register-exact point. To resolve 
the error, use the PMAP command to find a matching RISC location near the TNS 
location.
You can set a breakpoint on any RISC code location. Below, we set a code breakpoint 
and resume the program. When it gets to the breakpoint, we display the registers.
050,03,00032-b %13
@ ADDR: UC.%00,%000013 INS: %000107 SEG: %020737
        INS: STRP  7
050,03,00032-r
DEBUG P=%000013, E=%000317, UC.%00-BREAKPOINT-
050,03,00032-d *
 S=%000057 P=%000013 E=%000317 L=%000022 SP=UC.%00
 ENV IS:     TK CCE RP7
 EXAMPLE_INIT + %000006
 *REG* %000000 %104010 %000002 %177630 %177440 %000031 %002404 %002412
 EXECUTION MODE = ACCELERATED
   $PC: 0x7042003C $HI: 0x0000246F $LO: 0x8881FC7E
 $00:  $00: 0x00000000 $AT: 0x70000000  $V0: 0x7E000000 $V1: 0x00000000
 $04:  $A0: 0x0000257D $A1: 0x00000000  $A2: 0x0000000B $A3: 0x80022438
 $08:  $T0: 0x7042003C $T1: 0x7042003C  $T2: 0x70400000 $T3: 0x70400000
 $12:  $T4: 0x0000FD13 $T5: 0x8006FC14  $T6: 0xFFFFFFFF $T7: 0x00000000
 $16:  $S0: 0x00000000 $S1: 0x7A5D8808  $S2: 0x00000002 $S3: 0xFFFFFF98
 $20:  $S4: 0xC5FFFF20 $S5: 0x00000019  $S6: 0x00000504 $S7: 0x0000050A
 $24:  $T8: 0x70000000 $T9: 0x00000080  $K0: 0xA713A713 $K1: 0xA713A713
 $28:  $GP: 0x70400A00 $SP: 0x0000005E  $S8: 0x00000024 $RA: 0x7A5D9A2C
050,03,00032-b %17
DEBUG error 66: Cannot set TNS breakpoint at this location because there is no 
corresponding RISC breakpoint. 
050,03,00032-b 0x7042004c
 N: 0x7042004C  INS: 0xABB0FFFA
     INS: SWL s0,-6(sp)
050,03,00032-r
DEBUG P=%000013, E=%000317, UC.%00-RISC BREAKPOINT ($PC: 0x7042004C)-
050,03,00032-d *










