NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | VERSIONS | CONFORMING TO | SEE ALSO | COLOPHON

The Linux Programming Interface

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

NAME         top

       getloadavg - get system load averages

SYNOPSIS         top

       #define _BSD_SOURCE         /* See feature_test_macros(7) */
       #include <stdlib.h>

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

DESCRIPTION         top

       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         top

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

VERSIONS         top

       This function is available in glibc since version 2.2.

CONFORMING TO         top

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

SEE ALSO         top

       uptime(1), proc(5)

COLOPHON         top

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

Linux                                 2007-12-08                        GETLOADAVG(3)

HTML rendering created 2010-12-03 by Michael Kerrisk, author of The Linux Programming Interface