getloadavg(3C)						   Standard C Library Functions 					    getloadavg(3C)

NAME

       getloadavg - get system load averages

SYNOPSIS

       #include <sys/loadavg.h>

       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 sam-
       ples 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 LOADAVG_1MIN, LOADAVG_5MIN, and LOADAVG_15MIN indices, defined in <sys/loadavg.h>, 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.

ERRORS

       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 pset_getload-
       avg(3C) called with psetid set to PS_MYID.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Async-Signal-Safe 	   |
       +-----------------------------+-----------------------------+

SEE ALSO

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

SunOS 5.10							    28 Jun 2004 						    getloadavg(3C)