killpg(3) [linux man page]

KILLPG(P)						     POSIX Programmer's Manual							 KILLPG(P)

NAME

       killpg - send a signal to a process group

SYNOPSIS

       #include <signal.h>

       int killpg(pid_t pgrp, int sig);

DESCRIPTION

       The killpg() function shall send the signal specified by sig to the process group specified by pgrp.

       If  pgrp  is greater than 1, killpg(pgrp, sig) shall be equivalent to kill(-pgrp, sig). If pgrp is less than or equal to 1, the behavior of
       killpg() is undefined.

RETURN VALUE

       Refer to kill() .

ERRORS

       Refer to kill() .

       The following sections are informative.

EXAMPLES

       None.

APPLICATION USAGE

       None.

RATIONALE

       None.

FUTURE DIRECTIONS

       None.

SEE ALSO

       getpgid() , getpid() , kill() , raise() , the Base Definitions volume of IEEE Std 1003.1-2001, <signal.h>

COPYRIGHT

       Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1, 2003 Edition, Standard for Information Technol-
       ogy -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of
       Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between this version and  the  original  IEEE
       and  The  Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained
       online at http://www.opengroup.org/unix/online.html .

IEEE
/The Open Group						       2003								 KILLPG(P)

Check Out this Related 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

Linux and UNIX Man Pages

killpg(3) [linux man page]

Check Out this Related Man Page