Visit Our UNIX and Linux User Community

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

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.11 28 Jun 2004 getloadavg(3C)

Featured Tech Videos