GETLOADAVG(3)               BSD Programmer's Manual              GETLOADAVG(3)

NAME
     getloadavg - get system load averages

SYNOPSIS
     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; otherwise, the num-
     ber of samples actually retrieved is returned.

SEE ALSO
     uptime(1),  nlist(3),  kmem(4)

HISTORY
     The getloadavg() function is currently under development.

BUGS
     Programs using this utility must have read permission on /dev/kmem. This
     restriction will eventually be lifted.

BSDI BSD/386                    March 26, 1993                               1