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

Debug Commands
Debug Manual—421921-003
4-8
Set Unconditional Code Breakpoint
ALL
indicates that the breakpoint applies to all processes in the processor executing
the code being debugged. The ALL option is allowed only in privileged mode. A
global breakpoint (this is, a breakpoint set with the ALL option) is delivered to any
process that executes the code location that is breakpointed. A private breakpoint
(without the ALL option) is delivered only to the process that created the
breakpoint.
Considerations
•
When you set a breakpoint, Debug displays information describing this breakpoint.
For more information on the information displayed, see Display Breakpoints on
page 4-16.
•
When debugging accelerated programs, you can set breakpoints in TNS code only
on instructions that are register-exact points or memory-exact points. These points
are marked in displays by the I and PMAP commands. For more information, see
Section 2, Using Debug on TNS/R Processors.
•
A global breakpoint is associated with a particular memory object, regardless of
any process. The breakpoint persists as long as the containing memory object
exists; the breakpoint disappears when the memory object is deleted. By contrast,
a private breakpoint is associated with a particular memory object within a
particular process; the breakpoint disappears when the object disappears or the
process terminates.
°
A global breakpoint in system code, or in a system library, persists until the
processor is reloaded.
°
A global breakpoint in a public SRL or public DLL persists as long as that SRL
or DLL persists. The breakpoint disappears if the SRL is untitled or the
processor is reloaded.
°
A global breakpoint in user code, a user library, private SRL, or private DLL
persists as long as at least one process is executing that code, library, SRL, or
DLL. The breakpoint disappears when no process is executing that code,
library, SRL, or DLL.
°
A global breakpoint in an OSS shared memory object persists as long as the
object persists.