Native Inspect Manual (H06.03+)
Table Of Contents
- What’s New in This Manual
- About This Manual
- 1 Introducing Native Inspect
- Native Inspect on TNS/E Systems
- Debuggers on NonStop TNS/E Systems
- Origins of Native Inspect
- Process Debugging With Native Inspect
- Debugging Multiple Processes
- Global Debugging
- Debugging TNS Processes
- Snapshot File Analysis
- Debugging DLLs
- Handling Events
- Switching Debuggers (To or From Inspect and Visual Inspect)
- Stopping Native Inspect
- Differences Between Native Inspect and WDB and GDB
- 2 Using Native Inspect
- Quick Start for Inspect Users
- Preparing to Debug Using Native Inspect
- Sample Native Inspect Session
- Start Your Program Under Native Inspect
- Load Symbols
- Determine Compilation-Time Source Name
- Set Source Name Mapping
- Add Current Directory to Source Search Path
- List Source
- Set a Breakpoint on main()
- Continue Execution
- Trace the Stack (Back Trace)
- List Source
- Step Execution (Over Any Function Calls)
- Print a Variable
- Step Execution (Over Any Function Calls)
- Step In to a Called Function
- Set a Memory Access Breakpoint (MAB)
- Trace the Stack (Back Trace)
- List Source
- Continue Listing Source
- Set a Breakpoint on Line 52
- Continue Execution
- Display a Structure
- Enable “pretty” Printing
- Modify a Structure Field
- Terminate Program and Session
- 3 Syntax of Native Inspect Commands
- Categories of Native Inspect Commands
- Syntax of Common Command Elements
- # command
- a command
- add-symbol-file command
- amap command
- attach command
- base command
- break command, tbreak command
- bt command
- can command
- cd command
- commands command
- comment command
- condition command
- continue command
- d command
- delete command
- delete display command
- detach command
- dir command
- disable command
- disable display command
- disassemble command, da command
- display command
- dmab command
- down command, down-silently command
- enable command
- enable display command
- env command
- eq command
- exit command
- fc command
- files command
- finish command
- fn command
- frame command, select-frame command
- help command, help option
- hold command
- i command
- ignore command
- ih command
- info command
- jb command
- jump command
- kill command
- list command
- log command
- ls command
- mab command
- map-source-name command
- mh command
- modify command
- next command, nexti command
- nocstm option
- output command
- print command
- priv command
- ptype command
- pwd command
- quit command
- reg command
- save command
- select-frame command
- set command (environment)
- set command (variable)
- show command
- snapshot command
- source command
- step command, stepi command
- switch command
- symbol command, symbol-file command
- tbreak command
- tj command, tu command
- tn command
- unload-symbol-file command
- until command
- up command, up-silently command
- vector command
- version option
- vq command
- wait command
- whatis command
- x command
- 4 Using Tcl Scripting
- A Command Mapping With Debug and Inspect
- Glossary
- Index
Syntax of Native Inspect Commands
Native Inspect Manual—528122-003
3-3
Categories of Native Inspect Commands
Process Control Commands
continue command
Continues the execution of a debugging target
finish command
Executes the current process until execution returns from the
currently selected frame
hold command
Suspends the current process so that you can perform
debugging operations on the process
jump command
Resumes execution at the specified location
kill command
Terminates the current process
next command, nexti
command
Advances program execution but steps over any function
calls within the step range
step command, stepi
command
Advances program execution by one source statement or a
specified number of statements, stepping into any called
functions
until command
Continues execution of the current process until a specified
location is reached or until the current stack frame returns
Execution Control Commands
mh command
(modify handler)
Modifies signal handlers for a specified signal
ih command
(info handler)
Displays information about signal handlers
Breakpoint Commands
break command, tbreak
command
Sets an instruction breakpoint (temporarily, in the case of
tbreak) at a specified line, function, or address
commands command
Specifies commands that Native Inspect is to execute when a
specified breakpoint is hit
condition command
Specifies a conditional expression that Native Inspect is to
evaluate when a specific breakpoint is hit
delete command
Deletes instruction breakpoints
disable command
Disables specified breakpoints
dmab command
Deletes a memory access breakpoint (MAB)
enable command
Enables breakpoints that have been disabled
ignore command
Sets the number of breakpoint hits you want Native Inspect to
ignore before reporting a specified breakpoint
mab command
Sets a memory access breakpoint (MAB)
Memory and Register Commands
a command
Displays memory in ASCII format
d command
Displays memory in a specified format
Table 3-1. Commands of Native Inspect (page 3 of 5)
Group Name and
Command Name Function