getpgid() - プロセス・グループ ID の取得

標準

標準/拡張機能	C/C++	依存項目
XPG4.2 Single UNIX Specification、バージョン 3	両方

形式

#define _XOPEN_SOURCE_EXTENDED 1
#include <unistd.h>

pid_t getpgid(pid_t pid);

機能説明

getpgid() 関数は、そのプロセス ID が pid と等しいプロセスのプロセス・グループ ID を戻します。pid が 0 の場合、getpgid() は呼び出しプロセスの PID を戻します。

戻り値

正常に実行された場合、getpgid() はプロセス・グループ ID を戻します。

正常に実行されなかった場合、getpgid() は (pid_t)-1 を戻して、errno を次のいずれかの値に設定します。

エラー・コード: 説明
EPERM: そのプロセス ID が pid と等しいプロセスが、呼び出しプロセスと同じセッションにありません。また、このインプリメンテーションでは、そのプロセスのプロセス・グループ ID を呼び出しプロセスから取得することが許可されていません。
ESRCH: pid と等しいプロセス ID を持つプロセスがありません。

次の場合、getpgid() は失敗する可能性があります。

エラー・コード: 説明
EINVAL: pid 引数の値が有効ではありません。

関連情報