名称

getloadavg — システムの負荷平均 (ロードアベレージ) を取得する

ライブラリ

Standard C Library (libc, -lc)

書式

#include < stdlib.h>

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

解説

getloadavg() 関数は、様々な期間の平均されたシステムのランキュー (run queue) のプロセスの数を返します。最大 nelem のサンプルが検索され、 loadavg[]の連続の要素に代入されます。システムは、それぞれ、最近の 1、5 と 15 分間の平均を表わす最高 3 つのサンプルを強要します。

診断

負荷平均が取得不可能だったなら、-1 が返されます。そうでなければ、実際に検索されたサンプルの数が返されます。

関連項目

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

歴史

getloadavg() 関数は、 4.3BSD-Reno で登場しました。