1GETLOADAVG(3)            BSD Library Functions Manual            GETLOADAVG(3)
2

NAME

4     getloadavg — get system load averages
5

SYNOPSIS

7     #define _BSD_SOURCE
8     #include <stdlib.h>
9
10     int
11     getloadavg(double loadavg[], int nelem);
12

DESCRIPTION

14     The getloadavg() function returns the number of processes in the system
15     run queue averaged over various periods of time.  Up to nelem samples are
16     retrieved and assigned to successive elements of loadavg[].  The system
17     imposes a maximum of 3 samples, representing averages over the last 1, 5,
18     and 15 minutes, respectively.
19

DIAGNOSTICS

21     If the load average was unobtainable, -1 is returned; otherwise, the num‐
22     ber of samples actually retrieved is returned.
23

SEE ALSO

25     uptime(1), proc(5,) feature_test_macros(7)
26

HISTORY

28     The getloadavg() function appeared in 4.3BSD-Reno.  This function is
29     available in glibc since version 2.2.
30

CONFORMING TO

32     Not in POSIX.1-2001.  Present on the BSDs and Solaris.
33
344.3BSD                           June 4, 1993                           4.3BSD
Impressum