System Debug Reference Manual > Chapter 10 System Debug Standard Functions

func nmbpaddr

	MPE documents
	Complete PDF
	Table of Contents
	Index

	E0201 Edition 4 ♥
	E0300 Edition 3
	E0692 Edition 3

Returns the address corresponding to the indicated NM breakpoint index.

Syntax


   %nmbpaddr (bpindex [pin])

This function accepts an index for an existing NM breakpoint and returns the address where the breakpoint is located. The default action is to look for breakpoints set by the current PIN. Breakpoint addresses for other PINs (including the global PIN) may be retrieved by using the optional pin parameter.

Formal Declaration


   nmbpaddr:lptr (bpindex:u32 [pin:s16=0])

Parameters

bpindex: The index of the breakpoint whose address is to be returned.
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_file^
   NM     @[1] SYS  $ a.004b9130 FOPEN

First, list the existing breakpoints.


   $nmdebug > wl nmbpaddr(1)
   PROG $c3.56d80

   $nmdebug > l nmbpaddr(1, -1)
   SYS $a.4b9130

Now use the function to return the address associated with process local breakpoint number one and then with system breakpoint number one.

Limitations, Restrictions

none

func nmaddr

func nmbpindex