HPlogo System Debug Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 8 System Debug Standard Functions

func nmbpinstr

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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

Feedback to webmaster