killpg()

Send a signal to a process group

Synopsis:

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

int killpg( pid_t pgrp, 
            int sig );

Library:

libc

Description:

The killpg() function sends the signal sig to the process group specified by pgrp. If sig is zero, no signal is sent, but pgrp is still checked for validity.

If pgrp is greater than 1, killpg (pgrp, sig) is equivalent to kill (-pgrp, sig).

Returns:

0 for success, or -1 if an error occurs (errno is set).

Errors:

EAGAIN

Insufficient system resources are available to deliver the signal.

EINVAL

The signal sig is invalid or not supported.

EPERM

The process doesn't have permission to send this signal to any receiving process.

ESRCH

No process group can be found corresponding to the specified pgrp or pgrp is less than or equal to 1.

Examples:

See sigprocmask().

Classification:

Standard Unix

See also:

getpid(), kill(), setsid(), sigaction(), signal(), SignalKill(), sigqueue()