killjob(2)

NAME
     killjob - terminates all processes for the specified job

SYNOPSIS
     #include <sys/resource.h>

     int killjob(jid_t jid, int signal)

DESCRIPTION
     The killjob function sends a kill signal to terminate all processes for
     the specified job ID.  The killjob function checks the credentials of the
     calling function versus the credentials of each process it is signaling.
     If the MAC_WRITE label on the job being terminated is different from the
     calling process, then the killjob function checks for the CAP_KILL
     capability.  See the capability(4) and capabilities(4) man pages for more
     information on the capability mechanism that provides fine grained
     control over the privileges of a process.

ERRORS
     Under the following conditions, the killjob function fails and sets errno
     to:

     [ENOPKG]       The job limits software is not installed.

     [ENOJOB]       A job with the specified job ID cannot be found.

SEE ALSO
     killjob(2), makenewjob(2), jlimit_startjob(3c), killpg(3B).

DIAGNOSTICS
     Upon successful completion, killjob returns a value of 0.  Otherwise, a
     value of -1 is returned and errno is set to indicate the error.