killpg(3)          UNIX System V(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















10/89                                                                    Page 1