HP 3000 Manuals

func nmbpinstr [ System Debug Reference Manual ] MPE/iX 5.0 Documentation


System Debug Reference Manual

func nmbpinstr 

Returns the original NM instruction at a specified NM code address where
a NM 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



MPE/iX 5.0 Documentation