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

Introducing Native Inspect
Native Inspect Manual—528122-003
1-21
Assessing Your Location After an Event
Table 1-2. Event Handling by Native Inspect
Events Response by Native Inspect
Breakpoint events
Instruction breakpoint
Instruction step
TNS instruction breakpoint
Memory access breakpoint
Displays current code location (PC) and prompts
user for input.
(For TNS instruction breakpoint, displays the current
native code location.)
Entering debug events
Process created in debug
Process puts itself in
debug
Process forced into debug
Process executes embedded
BPT (TNS process)
Creates a debug session with the process (attaches
to the process); makes the process the current
process; displays the current code location and
prompts the user for input.
(For the embedded BPT in a TNS process, displays
the native code location.)
Signal event
Process signalled
Responds according to the preferences set with the
mh command
. Actions include handing control to the
user, printing a message, and forwarding the signal
to the program. (Native Inspect gains control of the
current process at the point of signal generation,
before signal handler setup code is invoked.)
Process death event
Process death
Detaches from the current process and notifies you
that the session was terminated because the current
process died. If Native Inspect is debugging one or
more additional processes, no current process is
designated as the current process. If there are no
other processes and Native Inspect was started
automatically, Native Inspect stops. If you started
the debugger, Native Inspect continues to prompt.
OSS exec event
OSS exec
Receives process death event and terminates its
session with the current process (the one that called
exec). If the newly created process is running in the
same CPU as Native Inspect and tdm_execve was
used with the debug option, then Native Inspect
receives the process entered debug event and
attaches to the new process.










