System Debug Reference Manual (32650-90888)

416 Chapter10
System Debug Standard Functions
func nmbpinstr
breakpoint has been set.
Syntax
nmbpinstr ( virtaddr [ pin ])
This function accepts the address of an existing NM breakpoint and returns the
instruction associated with that breakpoint. The default action is to look for breakpoints
set by the current PIN. Breakpoint indices for other PINs (including the global PIN) may
be retrieved by using the optional
pin parameter.
Formal Declaration
nmbpinstr:s32 ( virtaddr :ptr [ pin :s16=0])
Parameters
virtaddr The address of an NM breakpoint at which the stored instruction is to be
returned.
Virtaddr can be a short pointer, a long pointer, or a full logical code
pointer.
pin Look for breakpoints set by this PIN. Default is the caller's PIN (a pin of 0
implies this). To specify system (global) breakpoints, use a -1 (or 32762) as
the PIN.
Examples
$nmdebug > dc FOPEN,1
SYS $a.4b9130
004b9130 FOPEN 6bc23fd9 STW 2,-20(0,30)
Display code at the address of FOPEN so we can see what the current instruction is at that
address.
$nmdebug > b FOPEN
added: NM [1] SYS $a.004b9130 FOPEN
$nmdebug > dc FOPEN,1
SYS $a.4b9130
004b9130 FOPEN 0000400e BREAK (nmdebug bp)
Now set a breakpoint at FOPEN and display the code there. The old instruction has been
replaced with a breakpoint instruction.
$nmdebug > wl nmbpinstr(FOPEN)
$6bc23fd09
Use the function to look up the actual instruction. The instruction that is stored in the
system breakpoint table is returned by the function.
Limitations, Restrictions
none