Standard C Library Functions                           killpg(3C)



NAME
     killpg - send signal to a process group

SYNOPSIS
     #include 

     int killpg(pidt 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 pro-
     cess, unless the effective 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.

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


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:










SunOS 5.11          Last change: 24 Jul 2002                    1






Standard C Library Functions                           killpg(3C)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     kill(2), setpgrp(2), sigaction(2),  signal.h(3HEAD),  attri-
     butes(5), standards(5)











































SunOS 5.11          Last change: 24 Jul 2002                    2