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-67
S[TOP] Command
op
is one of these operators:
expression-2
is a 16-bit word expression.
Considerations
•
You cannot resume a process that entered Debug either because it received a
nondeferrable signal or because a synchronous trap occurred. A signal is
nondeferrable if it was generated by the system because the process cannot
continue executing the instruction stream. The only traps from which you can
resume are the looptimer trap and the arithmetic overflow trap, provided that the T
and V bits are not both set in the ENV register.
If you enter an R command on a nonresumable process, the process is deleted
after Debug exits with the same Guardian Stop message or OSS wait status as
would have been generated had the signal or trap terminated the process without
entering Debug.
Example
This command sets an execute memory-access breakpoint at offset %42 with two
conditional resume requests:
100,02,00033-BM 42, (R K17 < 12; R R0 < 54;)
S[TOP] Command
The STOP (or S) command deletes an application process. The form of the STOP
command is:
< resume if expression-1 is less than expression-2. This operator
does an unsigned comparison.
> resume if expression-1 is greater than expression-2. This
operator does an unsigned comparison.
= resume if expression-1 is equal to expression-2.
<> resume if expression-1 is not equal to expression-2.
S[TOP]
Note. The process deletion is treated as a normal deletion (for example, a system message -5
is sent to the creator of the deleted process).