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-12
Set Conditional Code Breakpoint
If you omit mask, Debug uses -1 (0xFFFF for a 16-bit constant or 0xFFFFFFFF
for a 32-bit constant).
op
is a relational operator and must be one of the following:
constant
is an expression. The value is 32 bits if a TNS/R register or an N-mode
test-address is used; otherwise, it is 16 bits.
ALL
specifies an attribute for the breakpoint only if you are debugging in privileged
mode as described under the PRV command. For more information, see Set
Unconditional Code Breakpoint on page 4-7.
Considerations
•
When you set a breakpoint, Debug displays information describing this breakpoint.
For a description of 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 or memory-exact points. These points are
marked in displays by the I and PMAP commands. For more information, see
Rules About RISC Breakpoints
on page 2-7.
•
When the N-mode address form is used for the test-address, mask, and
constant refer to a 32-bit value. Otherwise, a 16-bit value is assumed.
•
When TNS/R register is used, mask and constant refer to 32-bit values. For
TNS register, a 16-bit value is assumed.
•
If a Q-mode address is required for test-address, the Q-mode address can be
converted to a 32-bit address with the AMAP command if the program has a
selectable segment in use. For example, to obtain the address location of the 10th
16-bit word of the selectable segment, enter the command AMAP Q#10. The
result, 0x00080014, can be entered for the test-address value. Alternatively,
the byte address offset can be added to 0x00080000 to get the test-address
value in a selectable segment.
< break if the variable is less than constant. This operator does a
signed comparison.
> break if the variable is greater than constant. This operator does
a signed comparison.
= break if the variable is equal to constant.
# | <> break if the variable is not equal to constant.