Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-77
PROCESS_GETINFOLIST_ Procedure
If a value is supplied for oss-pid, then srch-option must be 3,
processhandle must be omitted or null (-1 in each word), and cpu and pin must
be omitted or -1. This parameter is ignored if
srch-option is 0,1, or 2.
General Considerations
•
All considerations listed under PROCESS_GETINFO_ also apply to
PROCESS_GETINFOLIST_.
•
You must qualify any file names used as search attributes. If the process of
interest is located on a remote node, local-form file names are treated as local to
that node,
not local to the caller’s node.
•
All returned file names are fully qualified.
•
When using PROCESS_GETINFOLIST_ procedure, if you want to get information
on every process in the processor, specify a search criteria that will find every
process. For example, specify Search Attribute Code 9 with 0 as the search value.
Information will be returned for all processes since all processes have a priority
that is greater than or equal to 0.
Auxiliary Data
Certain attributes require auxiliary data that provides additional information about the
attributes. This auxiliary data is provided by the caller and immediately follows the
attribute code in the
ret-attr-list array. The word containing the attribute code
includes a field in which the caller specifies the length of the auxiliary data (see
Attribute Codes and Value Representations
on page 12-79).
Note that if any auxiliary data is included in
ret-attr-list, the ret-attr-count
parameter must include the word count for the auxiliary data.
Iterative Attributes
Iterative attributes are used to report information about multiple loadfiles. These
attributes return a variable length array describing object files loaded for the target
process. The iterative attributes perform an iterative query, in which multiple loadfiles
are queried. Each iteration is an invocation of
PROCESS_GETINFOLIST_. Iteration is
controlled by a 64-bit context value that is input as auxiliary data in
ret-attr-list
and returned in
ret-values-list.
To start an iterative query, the caller initially sets the context value to zero. When the
query is complete, that is, all loadfiles requested by the attribute have been reported,
the returned context value is zero.
A nonzero returned context value indicates that the returned information has exceeded
the amount of available space specified by
ret-values-list and
ret-values-maxlen. In this case, as much information as will fit in the space is
returned; the caller can then copy the returned context value into the attribute’s
auxiliary data and call
PROCESS_GETINFOLIST_ to continue iterating.