Manual Pages for UNIX Operating System command usage for man pset_create

System Calls                                       pset_create(2)



NAME
     pset_create, pset_destroy, pset_assign - manage sets of pro-
     cessors

SYNOPSIS
     #include 

     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).


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


     The pset_destroy() function destroys the processor set pset,
     releasing  its constituent processors and processes. If pset
     is PS_MYID, the processor set to which the caller  is  bound
     is destroyed.


     The pset_assign() function 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  pro-
     cessor.


     On successful return, if opset is non-null, opset will  con-
     tain 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.





SunOS 5.11          Last change: 22 Feb 2008                    1






System Calls                                       pset_create(2)



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


     If pset is PS_MYID, processor cpu is assigned to the proces-
     sor  set to which the caller belongs. If the caller does not
     belong to a processor set, processor cpu  is  released  from
     its current processor set.


     These functions  are  restricted  to  privileged  processes,
     except for pset_assign() when pset is PS_QUERY.

RETURN VALUES
     Upon successful completion, these functions return 0. Other-
     wise, -1 is returned and errno is set to indicate the error.

ERRORS
     These functions will fail if:

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


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


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


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


     ENOTSUP    The pools facility is active. See pooladm(1M) and
                pool_set_status(3POOL) for information about ena-
                bling and disabling the pools facility.


     EPERM      The  {PRIV_SYS_RES_CONFIG}   privilege   is   not
                asserted in the effective set of the calling pro-
                cess.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



SunOS 5.11          Last change: 22 Feb 2008                    2






System Calls                                       pset_create(2)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Async-Signal-Safe           |
    |_____________________________|_____________________________|


SEE ALSO
     pooladm(1M),    psradm(1M),     psrinfo(1M),     psrset(1M),
     p_online(2),  processor_bind(2), pset_bind(2), pset_info(2),
     pool_set_status(3POOL), pset_getloadavg(3C),  attributes(5),
     privileges(5)

NOTES
     The processor set type of PS_SYSTEM is no longer supported.


     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.11          Last change: 22 Feb 2008                    3