killpg(3)               (BSD Compatibility Package)               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.  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 any of the following
         occur:

         EINVAL         sig is not a valid signal number.

         ESRCH          No processes were found in the specified process
                        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 target processes.

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












   7/91                                                                 Page 1