System Debug Reference Manual (32650-90888)

Chapter 10 415
System Debug Standard Functions
func nmbpinstr
Formal Declaration
nmbpindex:u32 ( virtaddr :ptr [ pin :s16=0])
Parameters
virtaddr The address of an NM breakpoint whose index is to be returned.
Virtaddr can be a short or long 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 > bl
NM [1] PROG $ c3.56d80 test_screen+$ab3
NM [2] PROG $ c3.4cf18 test_files
NM @[1] SYS $ a.004b9130 FOPEN
First, list the existing breakpoints.
$nmdebug > wl nmbpindex(test_files)
$2
Find the NM breakpoint index associated with the address test_files.
$nmdebug > wl nmbpindex(FOPEN)
No breakpoint exists in the breakpoint tables with that address.
(error #1080)
Error evaluating a predefined function. (error #4240)
function is"nmbpindex"
wl nmbpindex(FOPEN)
Now, go find the breakpoint index for the breakpoint at FOPEN . In this example we get an
error. This is because we did not specify
pin and thus searched only for process local
breakpoints. We do not have a process local breakpoint at FOPEN.
$nmdebug > wl nmbpindex(FOPEN, -1)
$1
Find the breakpoint index for the breakpoint at FOPEN . This time we specify a -1 to tell the
function to search the list of system breakpoints.
Limitations, Restrictions
none
func nmbpinstr
Returns the original NM instruction at a specified NM code address where a NM