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

Glossary
G-Series Common Glossary
Glossary-2
export
export. To offer a symbol definition for use by other loadfiles. A loadfile exports a symbol
definition for use by other loadfiles that need a data item or function having that
symbolic name.
extended link format (ELF). A standard binary file format common on UNIX systems. The
ELF format is used for position-independent code (PIC) files on both TNS/R and
TNS/E systems.
file name. A string of characters that uniquely identifies a file.
In the PC environment, file names for disk files normally have at least two parts (the
disk name and the file name); for example, B:MYFILE.
In the Guardian environment, disk file names include a node name, volume name,
subvolume name, and file identifier; for example, \NODE.$DISK.SUBVOL.MYFILE.
In the Open System Services (OSS) environment, a file is identified by a pathname;
for example, /usr/john/workfile.
frame. On TNS/E systems, a 16 KB unit of physical memory; also called a physical page.
general-purpose register (GPR). One of a small number of undedicated high-speed
memory locations in a processor.
global breakpoint. A breakpoint set in shared code, such as a system library or DLL. Any
program that encounters the global breakpoint drops into the debug state. Only a
privileged user (super ID) can perform global debugging and debug global breakpoints.
GPR. See general-purpose register (GPR).
HP Tandem Advanced Command Language (TACL). The user interface to the HP
NonStop operating system. The TACL product is both a command interpreter and a
command language. Users can write TACL programs that perform complex tasks or
provide a consistent user interface across independently programmed applications.
import. To refer to a symbol definition from another loadfile. A loadfile imports a symbol
definition when it needs a data item or function having that symbolic name.
linkfile. (1) For native C/C++ compilers in the Guardian environment, a command file for
input to the nld or ld utility. (2) A file containing object code that is not yet ready to
load and execute. Linkfiles are combined by means of a linker or binder to make an
executable loadfile for a program or library. Compiling creates one linkfile per
independent source module. Contrast with loadfile.
loadfile. An executable object code file that is ready for loading into memory and executing
on the computer. Loadfiles are further classified as executable programs (containing a
main routine at which to begin execution of that program) or executable libraries
(supplying routines or variables to multiple programs or separately loaded libraries). A
TNS code file might be both a loadfile and a linkfile. Native code files are never both.
Contrast with linkfile.










