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-4
Additional NonStop Extensions
Additional NonStop Extensions
Native Inspect includes many functions specific to NonStop systems, such as NonStop
OS extensions to the symbol table format, logging, and support for EDIT files and data
breakpoints.
Not Part of the Inspect Subsystem
Because Native Inspect originated in the UNIX world, Native Inspect is not part of the
Inspect subsystem. Both Inspect and Visual Inspect, however, are part of the Inspect
subsystem.
Documentation for Native Inspect
•
This manual: Native Inspect Manual
•
Native Inspect online help (see the help command, help option on page 3-33)
•
Hewlett-Packard home page for WDB:
http://www.hp.com/go/WDB
•
User manual for GDB version 4.17, by Richard M. Stallman and Roland H. Pesch:
http://www.objsw.com/docs/gdb_toc.html
•
Current GDB documentation from Red Hat:
http://sources.redhat.com/gdb/
Comparing Native Inspect to Debug
Native Inspect takes the place of Debug as the low-level default process debugger on
TNS/E systems. Therefore, Native Inspect is the debugger invoked if Visual Inspect
(the preferred debugger on TNS/E systems) is not available (for example., if no
connection exists to a Windows client) or if the INSPECT parameter is set to OFF.
Debugger selection criteria are shown in Figure 1-2, Debugger Selection for a TNS/E
Native Process, on page 1-10 and in Figure 1-3, Debugger Selection for a TNS
Process Running on TNS/E, on page 1-11.
Debug was an integral part of the operating system on previous NonStop platforms.
On TNS/E, Native Inspect is a separate licensed object file
($SYSTEM.SYSnn.EINSPECT), but still fulfills the role of built-in debugger. Whereas
Debug executed in the context of the process being debugged, Native Inspect
executes as a separate process in the same CPU as the process being debugged.
Running as a separate process reduces the chances of the debugger affecting target
process behavior.










