HP 3000 Manuals HP 3000 Manuals
func ltolog
Long to logical. Converts a long pointer into a NM logical code pointer
(LCPTR).
Syntax
ltolog (longptr)
The SID of the long pointer (input parameter) is compared with the SID of
each of the loaded NM executable libraries for a match. If a SID match
is found, then the appropriate logical code pointer is returned.
If the SID does not match any of the loaded NM files, then the long
pointer is tested to see if it points to a NM section of translated CM
code produced by the Object Code Translator (OCT). If the long pointer is
found to be translated code, then a special TRANS logical code pointer is
returned.
Refer to appendix C for a discussion of CM object code translation, node
points, and breakpoints in translated CM code.
If both of the previous tests fail, then a special unknown type (UNKN) is
returned.
Formal Declaration
ltolog:lcptr (longptr:lptr)
Parameters
longptr The long pointer to be converted into a NM logical code
pointer.
Examples
$nmdebug > wl ltolog (a.2034c)
SYS $a.2034
The SID $a matches the SID for the system library (SYS) NL.PUB.SYS. The
long pointer is converted into the logical code pointer SYS a.2034.
$nmdebug > wl ltolog (3c.3208)
PROG $3c.3208
The SID $3c matches the SID of the program file.
$nmdebug > wl ltolog (20.10264)
TRANS $20.10264
The SID $20 does not match any of the loaded NM files. A final test is
applied, in case the virtual address is in translated CM code. In this
example, the address does point to a NM section of translated CM object
code (translated by the Object Code Translator).
$nmdebug > wl ltolog (123.45678)
UNKN $123.45678
The SID $123 does not match any of the loaded NM files and does not point
to translated code. The special unknown logical code pointer is
returned.
Limitations, Restrictions
none