Standard C Library Functions                  psetgetloadavg(3C)



NAME
     psetgetloadavg - get system load averages for  a  processor
     set

SYNOPSIS
     #include 
     #include 

     int psetgetloadavg(psetidt pset, double loadavg[], int nelem);


DESCRIPTION
     The  psetgetloadavg()  function  returns  the   number   of
     processes  assigned  to the specified processor set that are
     in the system run queue, averaged over  various  periods  of
     time.   Up  to  nelem  samples are retrieved and assigned to
     successive elements of loadavg[].  The system imposes a max-
     imum of 3 samples, representing averages over the last 1, 5,
     and 15 minutes, respectively.


     The LOADAVG1MIN, LOADAVG5MIN, and  LOADAVG15MIN  indices,
     defined  in , can be used to extract the data
     from the appropriate element of the loadavg[] array.


     If pset is PSNONE,  the  load  average  for  processes  not
     assigned to a processor set is returned.


     If pset is PSMYID, the load average for the  processor  set
     to  which the caller is bound is returned.  If the caller is
     not bound to a processor set, the result is the same  as  if
     PSNONE was specified.

RETURN VALUES
     Upon successful completion, the number of samples   actually
     retrieved  is returned. If the load average was unobtainable
     or the processor set does not  exist,  -1  is  returned  and
     errno is set to indicate the error.

ERORS
     The psetgetloadavg() function will fail if:

     EINVAL    The number of elements specified is less  than  0,
               or an invalid processor set ID was specified.

               The caller is in  a  non-global  zone,  the  pools
               facility  is  active,  and the specified processor
               set is not that of the zone's pool.





SunOS 5.11          Last change: 28 Jun 2004                    1






Standard C Library Functions                  psetgetloadavg(3C)



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Stable                      
    
     MT-Level                     Async-Signal-Safe           
    


SEE ALSO
     uptime(1),  w(1),  psrset(1M),   prstat(1M),   psetbind(2),
     psetcreate(2), Kstat(3PERL), attributes(5)





































SunOS 5.11          Last change: 28 Jun 2004                    2