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-50
FREEZE Command
•
Two possible uses for this command are finding data structures with particular
values and finding code that has moved slightly because of a minor change.
If you omit value and mask, the FNL command uses the value and mask specified
by the previous FNL command but starts searching at the newly specified address.
•
If you omit address, value, and mask, the FNL command uses the value and
mask specified by the previous FNL command and starts searching at the address
where the previous FNL command terminated.
Examples
The following shows the search for a 32-bit word starting with string 45. The mask
indicates that we are to ignore the contents of the lower 16 bits of the 32-bit word as
well as the lower 16 bits of our search pattern.
050,03,00272-fnl q, '45xx' & 0xffff0000
0008002C: 0x34353637
For more FNL Command examples, see Appendix F, Sample Debug Sessions.
FREEZE Command
The FREEZE command disables the processor and asserts a freeze on other
processors that have freeze enabled. The form of the FREEZE command is:
Considerations
•
The FREEZE command is allowed only if you are debugging in privileged mode as
described under the PRV command.
•
Once a processor is frozen, a service provider can use the service processor (SP)
to examine the current processor and another frozen processor.
Example
245,02,00033-FREEZE ! Freezes the current processor, 02 in this example,
! and asserts a freeze on other processors.
FREEZE