killpg - phpMan

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 signal(7) for a list
       of signals.  If pgrp is 0, killpg() sends the signal to the sending process's  pro-
       cess group.

       (POSIX says: If pgrp is less than or equal to 1, the behaviour is undefined.)

       For  a  process  to  have  permission to send a signal it must either be privileged
       (under Linux: have the CAP_KILL capability), or the real or effective  user  ID  of
       the sending process must equal the real or saved set-user-ID of the target process.
       In the case of SIGCONT it suffices when the sending and receiving processes  belong
       to the same session.

RETURN VALUE
       On success, zero is returned.  On error, -1 is returned, and errno is set appropri-
       ately.

ERRORS
       EINVAL Sig is not a valid signal number.

       EPERM  The process does not have permission to send the signal to any of the target
              processes.

       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.

NOTES
       There are various differences between the permission checking in  BSD-type  systems
       and  System  V-type  systems. See the POSIX rationale for kill().  A difference not
       mentioned by POSIX concerns the return value EPERM: BSD documents that no signal is
       sent  and  EPERM  returned when the permission check failed for at least one target
       process, while POSIX documents EPERM only when the permission check failed for  all
       target processes.

CONFORMING TO
       SVr4, 4.4BSD (The killpg() function call first appeared in 4BSD), POSIX.1-2001.

SEE ALSO
       getpgrp(2), kill(2), signal(2), capabilities(7)



BSD Man Page                      2004-06-21                         KILLPG(2)

Generated by $Id: phpMan.php,v 4.54 2007/08/21 09:05:22 chedong Exp $ Author: Che Dong
On Apache/2.2.3 (Red Hat)
Under GNU General Public License
2009-12-24 02:07 @127.0.0.1 CrawledBy CCBot/1.0 (+http://www.commoncrawl.org/bot.html)