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



NAME
     getloadavg - get system load averages

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

DESCRIPTION
     The _g_e_t_l_o_a_d_a_v_g function returns the number of processes in
     the system run queue averaged over various periods of time.
     Up to _n_e_l_e_m samples are retrieved and assigned to successive
     elements of _l_o_a_d_a_v_g.  The system imposes a maximum of 3 sam-
     ples, representing averages over the last 1, 5, and 15
     minutes, respectively.

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

SEE ALSO
     uptime(1), sysctl(3), sysctl(8).

HISTORY
     The getloadavg function appeared in 4.3BSD-Reno.

     This function replaces the 2.9BSD compatibility routine
     getla().



























Printed 11/26/99	January 15, 1995			1