HP 3000 Manuals

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


System Debug Reference Manual

func nmproc 

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



MPE/iX 5.0 Documentation