Standard C Library Functions                       getloadavg(3C)



NAME
     getloadavg - get system load averages

SYNOPSIS
     #include 

     int getloadavg(double loadavg[], int nelem);


DESCRIPTION
     The getloadavg() function returns the number of processes 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 maximum 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.

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

ERORS
     The getloadavg() function will fail if:

     EINVAL    The number of elements specified is less than 0.


USAGE
     If the caller is in a non-global zone and the pools facility
     is  active,  the  behavior  of getloadavg() is equivalent to
     that  of  psetgetloadavg(3C)  called  with  psetid  set  to
     PSMYID.

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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Async-Signal-Safe           
    


SEE ALSO




SunOS 5.11          Last change: 28 Jun 2004                    1






Standard C Library Functions                       getloadavg(3C)



     uptime(1),      w(1),       pooladm(1M),       Kstat(3PERL),
     psetgetloadavg(3C), standards(5)





















































SunOS 5.11          Last change: 28 Jun 2004                    2