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-2
Categories of Native Inspect Commands
comment command,
# command
Introduces a comment line
dir command
Modifies the search path for source files
eq command
Evaluates an expression and displays the result in several
bases
fc command
Redisplays a previous command for editing and reexecution
files command
,
ls command
Displays the files in the current working directory
help command, help
option
Displays help information about Native Inspect commands
info command
Displays information about the debugging target
log command
Turns session logging on or off
map-source-name
command
Defines mapping rules between the source file names at
compilation time and at debug time
pwd command
Prints the current working directory
quit command
,
exit command
Ends the Native Inspect session
set command
(environment)
Sets environment settings for Native Inspect
show command
Displays environment settings for Native Inspect
source command
Reads commands from a file
version option
Displays the version of Native Inspect and Tcl
Session Control Commands
attach command
Associates Native Inspect with the specified process
detach command
Dissassociates Native Inspect from the current process or
from a specified process
priv command
Controls the privilege level of the working session (super ID
user only)
switch command
Transfers the current process to Visual Inspect or to Inspect
vector command
Changes the process designated as the current process
wait command
Waits for the next Debug event or for the Break key to be
pressed
Snapshot Commands
save command
Creates a snapshot file (or save file) of the current TNS/E or
TNS emulated process
snapshot command
Opens a TNS/E native process snapshot file for analysis
Table 3-1. Commands of Native Inspect (page 2 of 5)
Group Name and
Command Name Function










