Guardian Procedure Calls Reference Manual

Parameters
cpu
input
INT:value
if present and not -1, is the number of the processor of interest. cpu must be used with pin.
cpu,pin, and optionally nodename:length, must be specified either when a search is to
be performed or when the caller is interested in a specific process but does not know its process
handle. If cpu and pin are specified, processhandle must be omitted or null (-1 in each
word) and oss-pid must be omitted or null (a null OSS process ID is obtained by calling the
OSS_PID_NULL_ procedure).
pin
input, output
INT .EXT:ref:1
if present and not -1, contains either the PIN of the process of interest or the PIN of the first
process to be examined in a search. pin is required if cpu is specified.
If srch-option is omitted or 0, the caller is requesting information about process pin.
If srch-option is 1 or 2, the caller wants to search the processes in cpu for those that match
a set of criteria (such as having a particular user ID and program file name). In this case, pin
is used to indicate where to begin searching, and is usually set to 0 on the initial call. When
the procedure returns, has been updated to reflect the starting point for a subsequent call. pin
is set to -1 if no more matches would be found on a subsequent call.
nodename:length
input:input
STRING .EXT:ref:*, INT:value
if present and length is not 0, specifies the name of the node on which cpu,pin or oss-pid
resides; this parameter cannot be used with processhandle. If used, the value of nodename
must be exactly length bytes long. If cpu and pin are specified or oss-pid is specified but
nodename:length is omitted or length is 0, the local node is used.
If a remote node could be running an operating system version earlier than D30, use the
applicable attributes code (73) to determine which attribute code ranges are defined for the
calling process.
processhandle
input
INT .EXT:ref:10
if present and not null, is an input parameter specifying the process handle of the process of
interest. The null process handle is one which has -1 in each word. (For details, see the
PROCESSHANDLE_NULLIT_ Procedure (page 1140).) However, PROCESS_GETINFOLIST_ also
treats a process handle with -1 in the first word as a null process handle.
If a value is supplied for processhandle, srch-option must be omitted or 0,
nodename:length must be omitted or length must be 0, cpu and pin must be omitted or -1,
and oss-pid must be omitted or null (a null OSS process ID is obtained by calling the
OSS_PID_NULL_ procedure).
ret-attr-list
input
INT .EXT:ref:*
is an array of INTs indicating the attributes, and any auxiliary data supplied with auxilary data
attributes, that are to have their values returned in ret-values-list. See Attribute Codes
1014 Guardian Procedure Calls (P)