makenewjob(2)

NAME
     makenewjob - creates a new job

SYNOPSIS
     #include <sys/resource.h>

     jid_t makenewjob(jid_t rjid, uid_t user)

DESCRIPTION
     The makenewjob function creates a new job container. If the rjid value is
     0, the makenewjob function assigns a rjid value.  If the rjid value is
     not 0, the makenewjob function attempts to create a job with the
     specified job ID.  The uid value provided should be the uid of the user
     associated with the job. The makenewjob function checks for the
     CAP_SETUID 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.

     When a job is first created, the system default limits are applied to the
     job.  The system defaults can be viewed or modified by the systune
     jlimits command.

ERRORS
     Under the following conditions, the function makenewjob sets errno to:

     [EBUSY]        The requested job ID value is in use.

     [ENOPKG]       The job limits software is not installed.

     [EPERM]        The calling process does not have the CAP_SETUID
                    capability.

SEE ALSO
     systune(1M), killjob(2).

DIAGNOSTICS
     Upon successful completion, makenewjob returns a job ID.  If an error
     occurs, a value of -1 is returned and errno is set to indicate the error.
     If job limits software is not installed, makenewjob returns a value of 0.