getjusage(2)

NAME
     getjusage - get job usage information

SYNOPSIS
     #include <sys/resource.h>

     int getjusage(jid_t jid, int resource, struct job rusage *up)

DESCRIPTION
     The getjusage function gets the resource usage values for the specified
     job ID.  An example of resource usage is the accumulated cputime for the
     current job.  If the current job ID is different from the job ID being
     requested, the getjusage function checks for the CAP_MAC_READ 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 getjusage 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
     getjlimit(2), getrusage(3).

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