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-23
Stopping Native Inspect
Stopping Native Inspect
Native Inspect runs as a separate process from the current process being debugged
and stops:
•
When the current process stops, if Native Inspect was started automatically to
debug a process.
•
If you enter the exit command or the quit command to explicitly stop. Native
Inspect detaches from the current process and stops, leaving breakpoints in place.
Note, however, that if any of these breakpoints is subsequently hit, another
debugger instance is automatically started.
Differences Between Native Inspect and WDB
and GDB
•
WDB and GDB support an internal run command (used to start a program from
within the debugger). Native Inspect, however, does not allow you to start a
process from within the debugger.
You can, however, use the attach command to attach an instance of Native Inspect
to a TNS/E native process. (Native Inspect also supports several commands, such
as the vector command, that are not supported by WDB or GDB.)
•
Native Inspect does not support deferred breakpoints. In WDB and GDB, deferred
breakpoints can be set on functions before a program or library is loaded.
•
You cannot call functions in the current process from Native Inspect.
•
Native Inspect does not support threading (such as Standard POSIX Threads).
•
Native Inspect does not support the WDB/GDB ability to suspend the debugging
target when a DLL is loaded or unloaded (catch load and catch unload). If
you need to debug static initialization code, use Visual Inspect.
•
Native Inspect supports debugging multiple processes, but WBD and GDB do not
support multiprocess debugging in the way that Native Inspect does.










