System Calls processor_info(2)
NAME
processor_info - determine type and status of a processor
SYNOPSIS
#include
#include
int processor_info(processorid_t processorid, processor_info_t *infop);
DESCRIPTION
The processor_info() function returns the status of the pro-
cessor specified by processorid in the processor_info_t
structure pointed to by infop.The structure processor_info_t contains the following
members:int pi_state;
char pi_processor_type[PI_TYPELEN];
char pi_fputypes[PI_FPUTYPE];
int pi_clock;
The pi_state member is the current state of the processor,
either P_ONLINE, P_OFFLINE, P_NOINTR, P_FAULTED, P_SPARE, or
P_POWEROFF.
The pi_processor_type member is a null-terminated ASCII
string specifying the type of the processor.The pi_fputypes member is a null-terminated ASCII string
containing the comma-separated types of floating-point units
(FPUs) attached to the processor. This string will be empty if no FPU is attached.The pi_clock member is the processor clock frequency rounded
to the nearest megahertz. It may be 0 if not known.RETURN VALUES
Upon successful completion, 0 is returned. Otherwise, -1 is
returned and errno is set to indicate the error.ERRORS
The processor_info() function will fail if:
SunOS 5.11 Last change: 28 Jun 2004 1
System Calls processor_info(2)
EINVAL An non-existent processor ID was specified.
The caller is in a non-global zone, the pools
facility is active, and the processor is not a member of the zone's pool's processor set.EFAULT The processor_info_t structure pointed to by
infop was not writable by the user.SEE ALSO
pooladm(1M), psradm(1M), psrinfo(1M), zoneadm(1M),p_online(2), sysconf(3C)
SunOS 5.11 Last change: 28 Jun 2004 2