Guardian Procedure Calls Reference Manual

PROCESSOR_GETNAME_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
The PROCESSOR_GETNAME_ procedure returns a processor's type and model. You can designate
the processor of interest either by supplying a processor number with a node number or name, or
by supplying a processor number alone. Alternatively, you can supply just the numeric representation
of the processor type. If none of these are supplied, the procedure returns information about the
caller's processor.
For further information about supported processors, see Table 39 (page 1168).
Syntax for C Programmers
#include <cextdecs(PROCESSOR_GETNAME_)>
short PROCESSOR_GETNAME_ ( [ short cpu-number ]
,char *name
,short maxlen
,short *namelen
,[ short *cpu-type-out ]
,[ const char *node-name ]
,[ short length ]
,[ __int32_t node-number ]
,[ short cpu-type-in ]
,[ short expand-name ]
,[ short *cpu-model-out ]
,[ short cpu-model-in ] );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
• The parameter length specifies the length in bytes of the character string pointed to by
node-name. The parameters node-name and length must either both be supplied or both
be absent.
Syntax for TAL Programmers
error := PROCESSOR_GETNAME_ ( [ cpu-number ] ! i
,name:maxlen ! o:i
,namelen ! o
,[ cpu-type-out ] ! o
,[ node-name:length ] ! i:i
,[ node-number ] ! i
,[ cpu-type-in ] ! i
,[ expand-name ] ! i
,[ cpu-model-out ] ! o
,[ cpu-model-in ] ); ! i
1172 Guardian Procedure Calls (P)