killpg(SLIB)                   6 January 1993                   killpg(SLIB)


 Name

    killpg - send signal to a process group

 Syntax


    killpg(pgrp, sig)
    int pgrp, sig;


 Description

    killpg sends the signal sig to the process group pgrp.  See signal(S) for
    a list of signals.

    The sending process and members of the process group must have the same
    effective user ID, or the sender must be the super-user.

 Return value

    Upon successful completion, a value of zero 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
    occurs:

    [EINVAL]  sig is not a valid signal number.

    [ESRCH]   No process can be found in the process group specified by pgrp.

    [ESRCH]   The process group was given as 0 but the sending process does
              not have a process group.

    [EPERM]   The sending process is not the super-user and one or more of
              the target processes has an effective user ID different from
              that of the sending process.

 See also

    kill(S)