killpg(2) [freebsd man page]

KILLPG(2)						      BSD System Calls Manual							 KILLPG(2)

NAME

     killpg -- send signal to a process group

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

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

     int
     killpg(pid_t pgrp, int sig);

DESCRIPTION

     The killpg() function sends the signal sig to the process group pgrp.  See sigaction(2) for a list of signals.  If pgrp is 0, killpg() sends
     the signal to the sending process's process group.

     The sending process must be able to kill() at least one process in the receiving process group.

RETURN VALUES

     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.

ERRORS

     The killpg() function will fail and no signal will be sent if:

     [EINVAL]		The sig argument is not a valid signal number.

     [ESRCH]		No process can be found in the process group specified by pgrp.

     [EPERM]		kill() returns EPERM for all processes in the process group.

SEE ALSO

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

HISTORY

     The killpg() function appeared in 4.0BSD.

BSD
								  March 15, 2012							       BSD

KILLPG(2)						     Linux Programmer's Manual							 KILLPG(2)

NAME

       killpg - send signal to a process group

SYNOPSIS

       #include <signal.h>

       int killpg(int pgrp, int sig);

DESCRIPTION

       Killpg  sends  the signal sig to the process group pgrp.  See sigaction(2) for a list of signals.  If pgrp is 0, killpg sends the signal to
       the sending process's process group.

       The sending process and members of the process group must have the same effective user ID, or the sender must be the super-user.  As a sin-
       gle special case the continue signal SIGCONT may be sent to any process that is a descendant of the current process.

RETURN VALUE

       On success, zero is returned.  On error, -1 is returned, and errno is set appropriately.

ERRORS

       EINVAL Sig is not a valid signal number.

       ESRCH  No process can be found in the process group specified by pgrp.

       ESRCH  The process group was given as 0 but the sending process does not have a process group.

       EPERM  The  sending  process  is not the super-user and one or more of the target processes has an effective user ID different from that of
	      the sending process.

CONFORMING TO

       SVr4, 4.4BSD (The killpg function call first appeared in 4.0BSD).

SEE ALSO

       kill(2), getpgrp(2), signal(2)

BSD Man Page							    1993-07-23								 KILLPG(2)