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
ii
1. Introduction (continued)
1. Introduction (continued)
Example of a Memory-Access Breakpoint 1-15
Debug/Program Execution Environment 1-16
2. Using Debug on TNS/R Processors
TNS/R Memory Addressing 2-1
Execution Options 2-3
Running Native Program Files 2-3
Running TNS Program Files 2-4
Running Accelerated Program Files 2-4
Considerations in Using the Accelerator 2-4
Types of Processes 2-5
TNS and RISC Execution Correspondence (Accelerated Mode) 2-5
Breakpoints 2-5
Setting TNS Breakpoints 2-6
Setting RISC Breakpoints 2-7
Rules About RISC Breakpoints 2-7
Considerations for Memory-Access Breakpoints 2-8
TNS/R Registers 2-10
TNS and TNS/R Register Correspondence 2-12
3. Debug Command Overview
Types of Debug Commands 3-1
Breakpoint Commands 3-1
Display Commands 3-3
Modify Commands 3-4
Environment Commands
3-5
Privileged Commands
3-5
Miscellaneous Commands 3-6
Multiple Commands on a Line 3-6
Command Structure 3-6
Capitalization in Commands 3-7
Default Commands 3-7
Notation for Privileged Commands 3-7
Register Syntax 3-7
Expression Syntax 3-9
Address Syntax 3-12