killpg(3) [netbsd man page]

KILLPG(3)						   BSD Library Functions Manual 						 KILLPG(3)

NAME

     killpg -- send signal to a process group

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <signal.h>

     int
     killpg(pid_t 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 single
     special case the continue signal SIGCONT may be sent to any process that is a descendant of the current process.

RETURN VALUES

     Upon successful completion, a value of 0 is returned.  Otherwise, a value of -1 is returned and the global variable errno is set to indicate
     the error.

ERRORS

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

     [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.

SEE ALSO

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

HISTORY

     The killpg() function call appeared in 4.0BSD.

BSD
								   June 2, 1993 							       BSD

killpg(3C)						   Standard C Library Functions 						killpg(3C)

NAME

       killpg - send signal to a process group

SYNOPSIS

       #include <signal.h>

       int killpg(pid_t pgrp, int sig);

DESCRIPTION

       The killpg() function sends the signal sig to the process group pgrp. See signal.h(3HEAD) for a list of signals.

       The  real  or effective user ID of the sending process must match the real or saved set-user ID of the receiving process, unless the effec-
       tive user ID of the sending process is the privileged user. A single exception is the signal SIGCONT, which  may  always  be  sent  to  any
       descendant of the current process.

RETURN VALUES

       Upon successful completion, 0 is returned. Otherwise, -1 is returned and 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.

       EPERM	 The  effective user ID of the sending process is not privileged user, and neither its real nor effective user ID matches the real
		 or saved set-user ID of one or more of the target processes.

       ESRCH	 No processes were found in the specified process group.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       kill(2), setpgrp(2), sigaction(2), signal.h(3HEAD), attributes(5), standards(5)

SunOS 5.11							    24 Jul 2002 							killpg(3C)