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 *