NAME

pset_create, pset_destroy, pset_assign − manage sets of processors

SYNOPSIS

#include <sys/pset.h>

int pset_create(psetid_t ∗newpset);

int pset_destroy(psetid_t pset);

int pset_assign(psetid_t pset, processorid_t cpu, psetid_t ∗opset);

DESCRIPTION

These functions control the creation and management of sets of processors.  Processor sets allow a subset of the system’s processors to be set aside for exclusive use by specified LWPs and processes.  The binding of LWPs and processes to processor sets is controlled by pset_bind(2). 

pset_create creates an empty processor set that contains no processors.  On successful return, newpset will contain the ID of the new processor set. 

pset_destroy destroys the processor set pset, releasing its constituent processors and processes.

pset_assign assigns the processor cpu to the processor set pset. A processor that has been assigned to a processor set will run only LWPs and processes that have been explicitly bound to that processor set, unless another LWP requires a resource that is only available on that processor.  On successful return, if opset is non-NULL, opset will contain the processor set ID of the former processor set of the processor. 

If pset is PS_NONE, pset_assign releases processor cpu from its current processor set. 

If pset is PS_QUERY, pset_assign makes no change to processor sets, but returns the current processor set ID of processor cpu in opset.

These functions are restricted to superuser use, except for pset_assign when pset is PS_QUERY. 

RETURN VALUES

These functions return 0 if successful; otherwise, −1 is returned and errno is set to reflect the error. 

ERRORS

EBUSY The processor could not be moved to the specified processor set. 

EINVAL The specified processor does not exist, the specified processor is not on-line, or an invalid processor set was specified. 

EFAULT The location pointed to by newpset was not writable by the user, or the location pointed to by opset was not NULL and not writable by the user. 

ENOMEM There was insufficient space for pset_create to create a new processor set. 

EPERM The effective user of the calling process is not superuser. 

SEE ALSO

psradm(1M), psrinfo(1M), psrset(1M), p_online(2), processor_bind(2), pset_bind(2), pset_info(2)

NOTES

Processors belonging to different processor sets of type PS_SYSTEM (see pset_info(2)) cannot be assigned to the same processor set of type PS_PRIVATE.  If this is attempted, pset_assign will fail and set errno to EINVAL. 

Processors with LWPs bound to them using processor_bind(2) cannot be assigned to a new processor set.  If this is attempted, pset_assign will fail and set errno to EBUSY. 

SunOS 5.6  —  Last change: 10 Jan 1997