Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-55
PROCESS_DEBUG_ Procedure
Parameters
error returned value
INT
returns a file-system error number indicating the outcome of the process debug
attempt. Possible values include the following:
0 Debug request accepted. If the process to be debugged is not the calling
process, the request might have been queued.
11 Process does not exist.
48 Security violation.
201 Unable to communicate with the processor of the process.
640 The target process runs in privileged mode and the
now parameter was
not set equal to 1.
processhandle input
INT .EXT:ref:10
is the process handle of the process to be debugged. If
processhandle is
omitted or null (-1 in each word), the calling process is to be debugged.
terminal-name:length input:input
STRING .EXT:ref:*, INT:value
if supplied and if
length is not 0, is a file name that designates the terminal from
which the process is to be debugged. If used, the value of
terminal-name must
be exactly
length bytes long. If terminal-name is partially qualified, it is
resolved using the contents of the =_DEFAULTS DEFINE.
The default is the current home terminal of the process to be debugged.
now input
INT:value
if 1, specifies that the process be debugged immediately (even if it is currently
executing privileged code); if omitted or 0, specifies that the normal debug
sequence be executed.
The process access ID (PAID) of the calling process must be the super ID to use
this parameter.
If the calling process runs only in privileged mode,
now must be set to 1 or an error
is returned.