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

Contents
Debug Manual—421921-003
ix
Figures
Figures
Figure 1-1. Environment Register (TNS Environment) 1-9
Figure 1-2. Debugging a Remote Process 1-14
Figure 1-3. Debug/User Process Diagram 1-16
Figure 1-4. Debug Displaying and Accepting Data 1-17
Figure 2-1. Diagram of TNS/R Memory 2-2
Figure 2-2. How TNS Breakpoints Can Correspond to RISC Breakpoints 2-6
Figure 2-3. How RISC Breakpoints Correspond to TNS Instructions 2-7
Figure D-1. Scope of Debug Commands’ Effects D-2
Tables
Table 1-1. Map of TNS/R Native Signals to Traps 1-8
Table 2-1. TNS Register Implementation Summary 2-12
Table 2-2. TNS/R Register Use Summary 2-13
Table 3-1. Breakpoint Commands 3-2
Table 3-2. Display Commands 3-3
Table 3-3. Modify Commands 3-4
Table 3-4. Debug Environment Commands 3-5
Table 3-5. Privileged Commands 3-5
Table 3-6. Process Control Commands 3-6
Table 4-1. Debug Command Summary 4-1
Table D-1. Nonprivileged Command Persistence (With Scope of a Process) D-1
Table D-2. Privileged Command Persistence (With Scope of the Processor) D-3
Table E-1. Correspondence Between Debug and Inspect Commands E-1