NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO
#include <sys/pset.h>int pset_bind(psetid_t pset, idtype_t idtype, id_t id, psetid_t *opset);
The pset_bind() function binds the LWP or set of LWPs specified by idtype and id to the processor set specified by pset. If obind is not NULL, pset_bind() sets the psetid_t variable pointed to by opset to the previous processor set binding of one of the specified LWP, or to PS_NONE if the selected LWP was not bound.
If idtype is P_PID, the binding affects all LWPs of the process with process ID (PID) id.
If idtype is P_LWPID, the binding affects the LWP of the current process with LWP ID id.
If idtype is P_TASKID, the binding affects all LWPs of all processes with task ID id.
If id is P_MYID, the specified LWP or process is the current one.
If pset is PS_NONE, the processor set bindings of the specified LWPs are cleared.
If pset is PS_QUERY, the processor set bindings are not changed.
The effective user of the calling process must be super-user, or its real or effective user ID must match the real or effective user ID of the LWPs being bound, or pset must be PS_QUERY. If the calling process does not have permission to change all of the specified LWPs, the bindings of the LWPs for which it does have permission will be changed even though an error is returned.
If the processor set type of pset is PS_PRIVATE (see pset_info(2)), the effective user of the calling process must be super-user.
LWPs that have been bound to a processor with processor_bind(2) may also be bound to a processor set if the processor is part of the processor set. If this occurs, the binding to the processor remains in effect. If the processor binding is later removed, the processor set binding becomes effective.
Upon successful completion, 0 is returned. Otherwise, -1 is returned and errno is set to indicate the error.
The pset_bind() function will fail if:
One of the LWPs is bound to a processor, and the specified processor set does not include that processor.
The location pointed to by opset was not NULL and not writable by the user.
An invalid processor set ID was specified; or idtype was not P_PID, P_LWPID, or P_TASKID.
The effective user of the calling process is not super-user, and either the processor set type of pset is PS_USER, or the real or effective user ID of the calling process does not match the real or effective user ID of one of the LWPs being bound.
No processes, LWPs, or tasks were found to match the criteria specified by idtype and id.
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO