NAME

       getloadavg - get system load averages

SYNOPSIS

       #define _BSD_SOURCE         /* See feature_test_macros(7) */
       #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.

RETURN VALUE

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

VERSIONS

       This function is available in glibc since version 2.2.

ATTRIBUTES

       For an explanation of the terms used in this section, see attributes(7).
       ┌──────────────┬───────────────┬─────────┐
       │ Interface    │ Attribute     │ Value   │
       ├──────────────┼───────────────┼─────────┤
       │ getloadavg() │ Thread safety │ MT-Safe │
       └──────────────┴───────────────┴─────────┘

CONFORMING TO

       Not in POSIX.1.  Present on the BSDs and Solaris.

SEE ALSO

       uptime(1), proc(5)

COLOPHON

       This page is part of release 4.04 of  the  Linux  man-pages  project.   A  description  of  the  project,
       information   about   reporting   bugs,   and   the  latest  version  of  this  page,  can  be  found  at
       http://www.kernel.org/doc/man-pages/.

Linux                                              2015-03-02                                      GETLOADAVG(3)