Guardian Procedure Calls Reference Manual

PROCESSOR_GETINFOLIST_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Processor Attribute Codes and Value Representations
Processor Types and Models
Considerations
Example
Summary
The PROCESSOR_GETINFOLIST_ procedure obtains configuration information and statistics about
a processor. The processor of interest is specified by node name and processor number.
The information about a processor is organized as a set of attributes. The caller provides a list
specifying a code for each attribute to be reported. The attribute values are reported in an output
list parameter.
The input and output parameters described as lists are implemented as arrays of 16-bit words (type
short in C/C++, type INT in TAL/pTAL). Attribute codes occupy one word. Each attribute value
occupies some number of words, always word (two-byte) aligned and padded if necessary to the
next word boundary. Most attributes have fixed lengths, specified for the attribute; some have
variable length.
For further information about supported processors, see Table 39 (page 1168).
Syntax for C Programmers
#include <cextdecs(PROCESSOR_GETINFOLIST_)>
short PROCESSOR_GETINFOLIST_ ( [ const char *nodename ]
,[ short length ]
,[ short cpu ]
,short *ret-attr-list
,short ret-attr-count
,short *ret-values-list
,short ret-values-maxlen
,short *ret-values-len
,[ short *error-detail ] );
The parameter length specifies the length in bytes of the character string pointed to by nodename.
The parameters nodename and length must either both be supplied or both be absent.
Syntax for TAL Programmers
error := PROCESSOR_GETINFOLIST_ ( [ nodename:length ] ! i:i
,[ cpu ] ! i
,ret-attr-list ! i
,ret-attr-count ! i
,ret-values-list ! o
,ret-values-maxlen ! i
,ret-values-len ! o
,[ error-detail ] ); ! o
1156 Guardian Procedure Calls (P)