名称

killpg — プロセスグループにシグナルを送信する

ライブラリ

Standard C Library (libc, -lc)

書式

#include < sys/types.h>
#include < signal.h>

int
killpg( pid_t pgrp, int sig);

解説

killpg() 関数は、プロセスグループ pgrp にシグナル sig を送ります。シグナルのリストについては、 sigaction(2) を参照してください。 pgrp が 0 であるなら、 killpg() は、送信するプロセスのプロセスグループにシグナルを送ります。

送信するプロセスは、受信しているプロセスグループの少なくとも 1 つのプロセスを kill() することができなければなりません。

戻り値

The killpg() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

エラー

killpg() 関数は、つぎの場合に失敗し、シグナルは、送られません:

[ EINVAL]

sig 引数が有効なシグナル番号ではありません。

[ ESRCH]

pgrp によって指定されたプロセスグループでプロセスを見つけることができません。

[ EPERM]

kill() は、プロセスグループのすべてのプロセスに対して EPERM を返します。

関連項目

getpgrp(2), kill(2), sigaction(2)

歴史

killpg() 関数は、 4.0BSD で登場しました。