HPlogo System Debug Reference Manual > Chapter 10 System Debug Standard Functions

func nmproc

MPE documents

Complete PDF
Table of Contents
Index

E0201 Edition 4 ♥
E0300 Edition 3
E0692 Edition 3

Returns the NM procedure name and offset corresponding to the specified virtual address.

Syntax



    nmproc (virtaddr [length])

The string returned by NMPROC is one of the following two formats:
  • parent_procname.procedure_name + base offset

  • or

  • procedure_name + base offset

Detailed descriptions of each of the above return strings follow:
parent_procname

The name of the level one procedure containing the nested procedure at the specified address.

procedure_name

The name of the procedure. If the name is longer than length characters, it is truncated with an asterisk ( *).

base

The output base used to represent offset.


   $    Hexadecimal
   %    Octal
   #    Decimal

offset

If the offset is nonzero, then it is returned, appended to the procedure name. The offset is formatted based on the current fill, justification, and output base values.

Formal Declaration



   nmproc:str (virtaddr:ptr [length:u16=$40])

Parameters


virtaddr

The address for which the symbolic procedure name/offset is to be returned.

Virtaddr can be a short pointer, a long pointer, or a full logical code pointer.

length

The maximum length of the procedure name and offset string to be returned. If the name does not fully fit into the space specified, the procedure name is truncated and is followed by an asterisk (*) to indicate the truncation.

Examples



   $nmdebug > wl FOPEN
   SYS $a.3f8140

   $nmdebug > wl nmproc( a.3f8140 )
   OPEN

   $nmdebug > wl FOPEN+40
   SYS $a.3f8180

   $nmdebug > wl nmproc( a.3f8180 )
   FOPEN+$40

   $nmdebug > wl nmproc( pc )
   PROGRAM+4c

Limitations, Restrictions


none




func nmpath


func nmstackbase