processor_info - determine type and status of a processor

---

SYNOPSIS

#include <sys/types.h>
#include <sys/processor.h>

int processor_info(processorid_t processorid, processor_info_t *infop);

DESCRIPTION

The status of the processor specified by processorid is returned in the processor_info_t structure pointed to by infop.

The structure contains the following members:

int	pi_state;	/* P_ONLINE, P_OFFLINE or P_POWEROFF*/
char	pi_processor_type[PI_TYPELEN];
char	pi_fputypes[PI_FPUTYPE];
int	pi_clock;	/* CPU clock freq in MHz */

The fields have the following meanings:

pi_state is the current state of the processor, either P_ONLINE, P_OFFLINE or P_POWEROFF.

pi_processor_type is a NULL-terminated ASCII string specifying the type of the processor.

pi_fputypes 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.

pi_clock is the processor clock frequency rounded to the nearest megahertz. It may be 0 if not known.

RETURN VALUES

processor_info returns 0 if successful. Otherwise -1 is returned and errno is set to reflect the error.

ERRORS

EINVAL

An non-existent processor ID was specified.

EFAULT

The processor_info_t structure pointed to by infop was not writable by the user.

SEE ALSO

Created by unroff & hp-tools. © by Hans-Peter Bischof. All Rights Reserved (1997).

Last modified 07/October/97