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-4
Categories of Native Inspect Commands
can command Decodes a specified address.
disassemble command,
da command
Displays a range of memory as instructions
delete display command
Deletes an expression from the automatic display list
disable display
command
Disables automatic display items
display command
Adds an expression to the automatic display list
enable display
command
Enables automatic display items that have been disabled
env command
Displays environment information about a process
fn command
Searches for a value (finds a number) in the virtual address
space of the current process
i command
Displays memory as instructions
jb command
Displays memory at a specified jump-buffer-address
modify command
, info
command with the
registers option
Changes the content of memory
output command
Displays the value of a specified expression without saving it
to the value history list
print command
Evaluates and displays the value of a specified expression,
saving the result on the value history list
reg command
Displays registers
set command (variable)
Evaluates an expression and assigns the resulting value to a
variable
x command
Examines memory at a specified address
Stack Commands
bt command
,
tn command
Prints a backtrace of all the stack frames
down command, down-
silently command
Selects the stack frame that is called by the currently selected
stack frame
frame command, select-
frame command
Selects a specified stack frame
info command
with
frame option
Displays information about frames and registers
tj command, tu
command
Traces the stack from a TNS/E native jump buffer (tj
command) or a ucontext buffer (tu command) contained at
the specified address
Table 3-1. Commands of Native Inspect (page 4 of 5)
Group Name and
Command Name Function