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
Sample Debug Sessions
Debug Manual—421921-003
F-18
TNS Program Example
FNL Command
We use the FNL command to find data in 32-bit form. Because the value we are
searching for is 32-bit, the specified address must be aligned on a even 4-byte
boundary (last digit must be hexadecimal 0, 4, 8, or C).
We can also look for a specific pattern within the 32-bit word while ignoring the other
bits. We use the FNL command with a mask to look only for the bit pattern 0x3435 in
the second and third byte of the word.
Stopping the Program
Before we move to the examples we are going to demonstrate below, we must first
stop the program using the STOP command.
050,03,00013-fnl q0, '3456'
0008002C: 0x33343536
050,03,00013 (FNL)-
** DEBUG error 51: FNL reached address boundary. To continue, enter the following
address:
0x000A0000
050,03,00013-FNL 0x000A0000
000A22E0: 0x33343536
050,03,00013 (FNL)-
** DEBUG error 52: FNL stopped searching at the following address:
0x000BEFD0
Address not valid
Note. The output addresses for the FNL command are hexadecimal byte addresses. The FNL
command stops the search at either the end of the segment or when the low-order 17 bits of
the address are zero. If the address boundary is reached, it is necessary to restart only the
command with the address. The value to search for is the same as the last search.
050,03,00013-FNL q0, 0x00343500 & 0x00ffff00
0008002C: 0x33343536
050,03,00013 (FNL)-