killpg(3)              C LIBRARY FUNCTIONS              killpg(3)



NAME
     killpg - send signal to a process group

SYNOPSIS
     cc [ flag... ] file ... -lucb

     int killpg(pgrp, sig)
     int pgrp, sig;

DESCRIPTION
     killpg sends the signal sig to the process group pgrp.   See
     sigvec(3) 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 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 VALUE
     Upon successful completion, a value of 0 is returned.   Oth-
     erwise,  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  any  of  the
     following occur:

     EINVAL         sig is not a valid signal number.

     ESRCH          No processes were found in the specified pro-
                    cess group.

     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 tar-
                    get processes.

SEE ALSO
     sigvec(3)
     kill(2), setpgrp(2), sigaction(2) in the Programmer's Refer-
     ence Manual.













             Last change: BSD Compatibility Package             1