Native Inspect Quick Reference Card

Controlling Breakpoints (Cont.)
•
condition
breakpoint-number
[
conditional-
expression] - Specifies a conditional expression for
evaluation at a specific breakpoint.
•
delete [
breakpoints
] [
breakpoint-number
...] -
Deletes instruction breakpoints
•
disable [
breakpoints
] [
breakpoint-number
... ]
- Disables specified breakpoints
•
dmab [-g] - Deletes a memory access breakpoint (MAB).
•
enable [once | delete] [breakpoint-number ...]
- Enables breakpoints that have been disabled.
•
ignore breakpoint-number ignore-count - Sets the
number of breakpoint hits to ignore.
•
info breakpoints - Lists information about all user-
defined breakpoints (including per-process breakpoints,
global breakpoints, and catch events.).
•
mab [{*
native address
|
variable
}
[size][flags] [-e linespec]] - Sets a memory access
breakpoint (MAB).
Displaying and Modifying Process Information
•
a native-address [count] - Displays memory in ASCII
format.
•
d native-address [count] [:format] - Displays
memory in a specified format.
•
delete display [
num
] - Removes an expression from the
automatic display list.
•
disable display [
num
] - Disables automatic display
items.
•
{disassemble | da} [[
start-address
][
end-
address] | function-name] - Displays a range of
memory as instructions.
•
display [[/format] expression] - Adds an expression
to the list that is automatically displayed when the process is
suspended.
•
enable display [num] - Enables automatic display items.
•
env - Displays process environment information.
•
fn value [start-addr [end-addr]] [type]
- Searches for a value (finds a number) in the virtual address
space of the current process.
•
i
{{
native-address
[
count
]} |
function
-name} -
Displays memory as instructions.
•
output [/
format
]
expressions
- Displays the value of
a specified expression (does not save the result in value
history).
Displaying and Modifying Process Information (Cont.)
•
modify native-address value {8 | 16 | 32 | 64} (or
info with registers) - Changes the content of memory.
•
print - [/
format
]
expressions
Evaluates and display the
value of a specified expression (saves the result in value
history).
•
reg - Displays registers.
•
set [variable]
var-name
{
expression
|
value
}
(Variable) - Evaluates an expression and assigns its value to a
variable.
•
x [/format] address - Examines memory at a specified
address.
Displaying and Selecting Stack Information
•
{bt | tn} [count] - Prints a backtrace of all the stack
frames.
•
{down | down-silently} count - Selects the stack frame
that is called by the selected stack frame.
•
{frame | select-frame} [
number
] - Selects a specified
stack frame.
•
info attribute (with the frame option) - Displays
information about frames and registers.
•
tj native-address - Traces the stack from a TNS/E native
jump buffer contained at the specified address.
•
tu
native-address
- Traces the stack from a ucontext
buffer contained at the specified address.
•
{up | up-silently} count - Selects the stack frame that
called the currently selected stack frame.
Using Object and Symbol Files
•
{add-symbol-file | symbol-file} filename
- Adds symbol file information.
•
ptype [
data-type
|
variable-name
]
- Prints information about a specified data type.
•
{symbol | symbol-file} [-g] [-readnow] pathname -
Opens a native code file and builds internal symbol tables.
•
unload-symbol-file [-g] symbol-file-name
- Discards symbol data associated with a specified filename.
•
whatis
expression
- Displays the data type of a specified
expression.
Managing Memory
•
set heap-check
attribute value
- Displays settings
for commands that debug memory problems.
•
vq
[
segid
] - Displays information about the extended
segments allocated by the current process. Specify segid to
change the current selectable segment.
Command Syntax Elements
• Linespec
- Specifies a single source line with the list or
breakpoint commands, using:

number - A line number in the current file.
 filename:number
- A line number in the source.
 function
- A line at which the body of the function begins.
 filename:function
- The line at which the body of the
specified function begins.

*address - The line containing the program address.
•
native-address - Specifies a 32-bit or 64-bit address, using
the following:

Hexadecimal (for example, 0x120001DC0).

Decimal (for example, 48331845824).

Octal (for example, 044000016700).
• llce
- Specifies a low-level conditional expression to set
conditional breakpoints with the break, tbreak, or mab
commands as follows:
-e native-address [& mask] operator value
 mask
is a 64-bit mask.
 operator
is one of !=, ==, < or >.
 value
is an integer.
•
expression
- Specifies a list of operands and operators for
evaluation. Other valid expressions are:

$, $$ - Refers to the last two values printed.

$number - References previous print commands.
 $register-name
- Displays register contents.
•
/format - Specifies a repeat count with the x, print, and
output commands as follows: /[count][format][size]
 count
- An integer specifying the number of units of size to
display or print.

format - Specifies the display format as follows:
a address
i instruction (ICODE)
u unsigned decimal
c char
o octal
x hexadecimal
d decimal
s null terminated string
f float
t binary
 size - Specifies the unit size as follows:
b byte
h half word (16 bits)
w word (32 bits)
g giant (64 bits)
pTAL and COBOL Considerations:
•
For pTAL programs use: procedure[subprocedure]
•
For COBOL programs use one of the following:
Program-unit [program-unit]
[section.]paragraph
paragraph [of section]