GETLOADAVG(G)       Linux Programmer's Manual       GETLOADAVG(G)



NAME
       getloadavg - get system load averages

SYNOPSIS
       #define _BSD_SOURCE

       or

       #define _GNU_SOURCE

       #include <stdlib.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 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.

DIAGNOSTICS
       If the load average was unobtainable, -1 is returned; oth-
       erwise,  the  number  of  samples  actually  retrieved  is
       returned.

CONFORMING TO
       The getloadavg function appeared in 4.3BSD-Reno.

SEE ALSO
       uptime(e), proc(c)



BSD                         1993-06-04              GETLOADAVG(G)