wait3(2) BSD スタイルでプロセスの状態変化を待つ

Other Alias

wait4

書式

#include <sys/types.h>
#include <sys/time.h>
#include <sys/resource.h>
#include <sys/wait.h>


pid_t wait3(int *status, int options,
struct rusage *rusage);

pid_t wait4(pid_t pid, int *status, int options,
struct rusage *rusage);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

wait3():

_BSD_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED

wait4():
_BSD_SOURCE

説明

これらの関数は廃止予定である。 新しいプログラムでは waitpid(2) や waitid(2) を使用すること。

システムコール wait3() と wait4() は waitpid(2) と同様の動作をする。それに加え、子プロセスのリソース使用状況の情報を rusage が指す構造体に入れて返す。

rusage を使用する点を除けば、次の wait3() の呼び出し

    wait3(status, options, rusage);
は以下と等価である。
    waitpid(-1, status, options);
同様に、次の wait4() の呼び出し
    wait4(pid, status, options, rusage);
は以下と等価である。
    waitpid(pid, status, options);
言い換えると、 wait3() は全ての子プロセスを対象に待つが、 wait4() では特定の子プロセス (複数可) を選んで待つことができる。

rusage が NULL でない場合、 rusage が指す rusage 構造体 には子プロセスのアカウント情報が格納される。 詳しくは getrusage(2) を参照のこと。

返り値

waitpid(2) と同様。

エラー

waitpid(2) と同様。

準拠

4.3BSD.

SUSv1 には wait3() の規定があった。 SUSv2 には wait3() が含まれていたが、「過去の名残 (LEGACY)」となっていた。 SUSv3 では wait3() は削除された。

注意

現在では <sys/time.h> をインクルードする必要はないが、インクルードしておくと 移植性を高めることができる (実際には <sys/resource.h>rusage 構造体が定義されているが、そのフィールドで使用されている struct timeval 型は <sys/time.h> で定義されている)。

Linux では、 wait3() はライブラリ関数であり、 wait4() システムコールを使って実装されている。

この文書について

この man ページは Linux man-pages プロジェクトのリリース 3.65 の一部である。 プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。