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

Glossary
Debug Manual—421921-003
Glossary-6
program
program. A set of instructions that a computer is capable of executing.
program file. An executable object file. See to object file.
reduced instruction-set computing (RISC). A processor architecture based on a relatively
small and simple instruction set, a large number of general-purpose registers, and an
optimized instruction pipeline that supports high-performance instruction execution.
Contrast with complex instruction-set computing (CISC).
register-exact point. A location in an accelerated program at which the values in both
memory and the register stack are the same as they would be if the program were
running on a TNS processor. Register-exact points are also memory-exact points.
Contrast with memory-exact point.
relative extended address. An address that can be used when the processor module is in
privileged or nonprivileged mode to access the user code, user library, and user data
spaces of the process. A relative extended address can also be used in privileged
mode to access the system code, system library, and system data spaces of the
process.
RISC. See reduced instruction-set computing (RISC).
RISC instructions. Register-oriented 32-bit machine instructions that are directly executed
on TNS/R processors. RISC instructions execute only on TNS/R systems, not on TNS
systems. Contrast with TNS instructions.
selectable segment. An extended data segment that shares the same relative address
space with all other selectable segments allocated by a process (and therefore does
not have a distinct range of relative addresses within the current environment).
Contrast with flat segment.
signal. A means by which a native or OSS process can be notified of or affected by an
event occurring in the system. Some signals are used to notify a process when certain
errors occur that prevent it from continuing execution of the current code stream. See
also TNS/R native signal and OSS signal. Contrast with trap.
signal handler. A procedure that is executed when a signal is received by a process.
StmtDebug. An Accelerator option that directs the Accelerator to optimize instructions only
within the code produced for any one statement. Instructions are not optimized across
statements. This option typically produces less-optimized code than the ProcDebug
option. However, debugging is easier than with the ProcDebug option because the
beginning of every statement in the source program is a memory-exact point. Contrast
with ProcDebug.
super ID. The user ID that permits unrestricted access to the system. On Guardian
systems, it is user number 255,255; on OSS systems, it is the root user.