getrusage() - リソース使用率についての情報の取得

標準

標準/拡張機能 C/C++ 依存項目

XPG4.2
Single UNIX Specification、バージョン 3

両方  

形式

#define _XOPEN_SOURCE_EXTENDED 1
#include <sys/resource.h>

int getrusage(int who, struct rusage *r_usage);

機能説明

getrusage() 関数は、現行プロセスまたは現行プロセスが 終了して子の待ち状態になっているプロセスによって使用されるリソースの量を 測る方法を提供します。who 引数の値が RUSAGE_SELF の場合、情報は現行プロセスに よって使用されるリソースについて戻されます。who 引数の値が RUSAGE_CHILDREN の場合は、情報は、終了して子 の待ち状態の現行プロセスによって使用されるリソースについて戻されます。 子を待つことがない場合 (例えば、親が SA_NOCLDWAIT を設定している 場合や SIGCHLD を SIG_IGN へ設定する場合) は、子プロセスのリソース情報は 廃棄され、getrusage() が提供するリソース情報には含まれません。

r_usage 引数は、戻された情報が保管される struct rusage 型のオブジェクトのポインターです。

戻り値

正常に実行された場合、getrusage() は 0 を戻します。

正常に実行されなかった場合、getrusage() は -1 を戻して、errno を次のいずれかの 値に設定します。
エラー・コード
説明
EINVAL
who 引数の値が無効です。

関連情報