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

Introduction
Debug Manual—421921-003
1-8
How to Determine Process State on a Trap or Signal
If a TNS/R native or OSS process enters Debug because it has received a signal,
Debug automatically displays the name of the signal. Table 1-1 shows the TNS/R
native signals and how they correspond to trap conditions in a TNS process. Additional
signals are supported by Open System Services (OSS). For more information about
OSS signals, see the signal(4) topic in the reference page, either online or in the Open
System Services System Calls Reference Manual.
You can determine the TNS/R register settings (native mode) or the S, P, ENV, and L
register settings (TNS or accelerated mode) at the time of the trap by displaying the
register contents. Use the D command to display the contents of the TNS/R or TNS
environment registers and to display the space identifier. The meanings of the various
bits and the format of the Environment (ENV) register are illustrated in Figure 1-1 on
page 1-9.
For more information about TNS/R registers, see Section 2, Using Debug on TNS/R
Processors. For more information about space identifiers, see What Appears in the
4 Process loop-timer timeout
5 D-series limit does not fit into a C-series interface
8 (Under very unusual circumstances, a signal is delivered to a TNS
process and appears as a trap 8.)
11 Memory manager read error
12 No memory available
13 Uncorrectable memory error. Note that this error should not occur
because the millicode will halt the processor.
Table 1-1. Map of TNS/R Native Signals to Traps
Signal Name Description Trap Number
SIGABRT Abnormal termination (8)
SIGILL Invalid hardware instruction 1
SIGFPE Arithmetic overflow 2
SIGLIMIT Limits exceeded 5
SIGMEMERR Uncorrectable memory error 13
SIGMEMMGR Memory manager disk read
error
11
SIGNOMEM No memory available 12
SIGSEGV Invalid memory reference 0
SIGSTK Stack overflow 3
SIGTIMEOUT Process loop timeout 4
Trap Number Trap Condition (page 2 of 2)