Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (A-B)
Guardian Procedure Calls Reference Manual—522629-013
2-18
ADDRTOPROCNAME Procedure
Parameters
error returned value
INT
returns a file-system error code indicating the outcome of the call, as follows:
0 Successful call; the procedure name is deposited into
proc-name for
proc-name-length bytes.
11 A procedure name was not found. This value is returned if an I/O error
occurs during the read of the associated object file or if
p-reg, stack-
env, and the optional pin are legal but do not indicate a code location
associated with a procedure (for example, a location in the PEP or XEP).
22 One of the parameters specifies an address that is out of bounds.
23 The
p-reg, stack-env, and optional pin parameters do not indicate a
legal code location.
24 The
pin parameter was supplied and the caller is not privileged.
29 A required parameter was not supplied.
122 The supplied value of
proc-name-size is less than the length of the
procedure name that is to be returned into
proc-name. The procedure
name (and any other requested output parameters) is returned in
proc-
name
, though it is truncated to the value of proc-name-size.
p-reg input
INT:value
is the target procedure’s P register setting.
stack-env input
INT:value
is the target procedure’s code space identifier in the stack marker ENV register
format. Only the following fields in
stack-env are significant:
<4> Library bit
<7> System code bit
<11:15> Space ID bits
proc-name output
STRING .EXT:ref
is an ASCII string into which is returned the symbolic procedure name
corresponding to the code location specified by
p-reg, stack-env, and the
optional
pin.