manpagez: man pages & more
man getloadavg(3)
Home | html | info | man
getloadavg(3)            BSD Library Functions Manual            getloadavg(3)


NAME

     getloadavg -- get system load averages


LIBRARY

     Standard C Library (libc, -lc)


SYNOPSIS

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


SEE ALSO

     uptime(1), kvm_getloadavg(3), sysctl(3)


HISTORY

     The getloadavg() function appeared in 4.3BSD-Reno.

BSD                              June 4, 1993                              BSD

Mac OS X 10.8 - Generated Tue Aug 28 05:28:06 CDT 2012
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.