killpg(3)               (BSD Compatibility Package)               killpg(3)

NAME
     killpg - send signal to a process group

SYNOPSIS
     /usr/ucb/cc [flag ...] file ... -lucb

     #include <signal.h>

     int killpg(pidt pgrp, int sig);

DESCRIPTION
     killpg sends the signal sig to the process group pgrp. See sigvec for
     a list of signals.

     If pgrp is greater than 1, killpg(pgrp, sig) is equivalent to
     kill(-pgrp, sig). If pgrp is less than or equal to 1, the behavior of
     killpg() is undefined.

     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 effec-
     tive user ID of the sending process is the privileged user. A single
     exception is the signal SIGCONT, which may always be sent to any des-
     cendant 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 indi-
     cate the error.

DIAGNOSTICS
     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 privi-
               leged 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
     kill(2), setpgrp(2), sigaction(2), sigvec(3), signal(5).











Page 1                       Reliant UNIX 5.44                Printed 11/98