getloadavg -- get system load averages


#include <stdlib.h>

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


getloadavg() 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.

Return Value

If the load average could not be obtained, -1 is returned. Otherwise, the number of samples actually retrieved is returned.