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-66
R Command
Considerations
•
The PRV ON command requires that the process you are debugging be executing
under the local super ID (255, 155). After you specify the PRV ON command, you
can enter any of the privileged commands or options.
•
Privileged debugging is never available automatically. Before using the privileged
Debug commands and options, you must always issue the PRV ON command; the
security subsystem then decides whether you have the proper access to be
granted privileged debugging. The only exception is where a process falls into a
debugging session that is already privileged because of an earlier PRV ON
command from Debug (or a SET PRIV MODE ON command from Inspect) during
the life of the process.
•
The privileged Debug commands are:
°
The FREEZE, HALT, PRV, V, and VQA commands
°
Access data and code in the kernel address space (Kseg0 and Kseg2).
°
Plant code breakpoints in code containing PRIV or CALLABLE procedures,
including licensed UC, UL, UCr, SRLs, or system code and library.
°
Commands that modify user code.
Example
For examples that use the R command, see Appendix F, Sample Debug Sessions.
R Command
The R command causes the application process to leave the debug state and resume
execution.
You can specify a conditional resume. For a conditional resume, Debug executes the
R command only if the specified relation between the two expressions is true. A
conditional resume is particularly useful to include in a command string on an execute
code breakpoint or execute memory-access breakpoint.
The form of the R command is:
expression-1
is a 16-bit word expression.
R [ expression-1 op expression-2 ]