KILLPG

Section: Linux Programmer's Manual (3)
Updated: 1993-04-04
Index Return to Main Contents
 

NAME

killpg - send signal to all members of a process group  

SYNOPSIS

#include <signal.h>

int killpg(pid_t pgrp, int signal);
 

DESCRIPTION

The killpg() function causes signal signal to be sent to all the processes in the process group pgrp or to the processes' own process group if pgrp is equal to zero.

If pgrp is greater than 1, it is equivalent to


kill(-pgrp,signal);
 

RETURN VALUE

The value returned is -1 on error, or 0 for success.  

ERRORS

Errors are returned in errno and can be one of the following:
EINVAL
for an invalid signal,
EPERM
if the userid of the calling process is not equal to that of the process the signal is sent to, and the userid is not that of the superuser.
ESRCH
for a process group which does not exist, and
 

CONFORMING TO

SUSv2, POSIX.1-2001  

SEE ALSO

kill(2), signal(2), sigqueue(2), signal(7)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
CONFORMING TO
SEE ALSO

linux.jgfs.net manual pages