System Calls                                    processorinfo(2)



NAME
     processorinfo - determine type and status of a processor

SYNOPSIS
     #include 
     #include 

     int processorinfo(processoridt processorid, processorinfot *infop);


DESCRIPTION
     The processorinfo() function returns the status of the pro-
     cessor  specified  by  processorid  in  the processorinfot
     structure pointed to by infop.


     The  structure  processorinfot  contains   the   following
     members:

       int      pistate;
       char     piprocessortype[PITYPELEN];
       char     pifputypes[PIFPUTYPE];
       int      piclock;



     The pistate member is the current state of  the  processor,
     either PONLINE, POFLINE, PNOINTR, PFAULTED, PSPARE, or
     POWEROF.


     The piprocessortype  member  is  a  null-terminated  ASCI
     string specifying the type of the processor.


     The pifputypes member is  a  null-terminated  ASCI  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 piclock 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.

ERORS
     The processorinfo() function will fail if:





SunOS 5.11          Last change: 28 Jun 2004                    1






System Calls                                    processorinfo(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   processorinfot  structure  pointed  to  by
               infop was not writable by the user.


SEE ALSO
     pooladm(1M),    psradm(1M),    psrinfo(1M),     zoneadm(1M),
     ponline(2), sysconf(3C)









































SunOS 5.11          Last change: 28 Jun 2004                    2