getjusage(2)

NAME
     getjusage - get job usage information

SYNOPSIS
     #include <sys/resource.h>

     int getjusage(jid_t jid, int resource, struct jobrusage *up)

DESCRIPTION
     The getjusage function retrieves the resource usage values for the
     specified job ID.  If the jid parameter is zero, usage values for the
     current job will be returned.  If jid is non-zero, it represents the job
     ID of the job for which usages values are retrieved.  The resource
     parameter specifies the resource for which the usage values are returned.
     Allowable values are taken from the JLIMIT_xxx macros found in the
     sys/resource.h file.  For example, the JLIMIT_CPU macro is for cpu time.
     The up parameter points to a jobrusage structure in the user program
     where the usage values will be returned.

     If the job ID of the caller is different from job specified by jid, the
     real or effective user ID of the caller must match the user ID of the
     user associated with the job.  User association is established by the
     user parmater for makenewjob.  Otherwise, 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.

     [EINVAL]       The limit denoted by resource is invalid.

     [EPERM]        The caller does not have permission to access the usage
                    information.

     [EFAULT]       The the address of up is invalid.

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.