System Calls                                      psetsetattr(2)



NAME
     psetsetattr, psetgetattr - set or get processor set attri-
     butes

SYNOPSIS
     #include 

     int psetsetattr(psetidt pset, uintt attr);


     int psetgetattr(psetidt pset, uintt *attr);


DESCRIPTION
     The psetsetattr() function sets attributes of the processor
     set  specified by pset.  The bitmask of attributes to be set
     or cleared is specified by attr.


     The psetgetattr function returns attributes of the  proces-
     sor  set  specified by pset. On successful return, attr will
     contain the bitmask of attributes for the specified  proces-
     sor set.


     The value of the attr argument is the  bitwise  inclusive-OR
     of these attributes, defined in :

     PSETNOESCAPE    Unbinding of LWPs from  the  processor  set
                      with    this    attribute    requires   the
                      {PRIVSYSRESCONFIG}   privilege   to   be
                      asserted  in  the effective set of the cal-
                      ling process.



     The binding of LWPs and processes to processor sets is  con-
     trolled by psetbind(2). When the PSETNOESCAPE attribute is
     cleared, a process calling psetbind() can clear the proces-
     sor  set  binding of any LWP whose real or effective user ID
     matches  its  own  real  of  effective  user  ID.    Setting
     PSETNOESCAPE  attribute  forces psetbind() to requires the
     {PRIVSYSRESCONFIG} privilege to be asserted in the effec-
     tive set of the calling process.

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

ERORS
     These function will fail if:




SunOS 5.11          Last change: 28 Jun 2004                    1






System Calls                                      psetsetattr(2)



     EFAULT     The location pointed to by attr was not  writable
                by the user.


     EINVAL     An invalid processor set ID was specified.

                The caller is in a  non-global  zone,  the  pools
                facility  is  active,  and the processor is not a
                member of the zone's pool's processor set.


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


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Stable                      
    
     MT-Level                     Async-Signal-Safe           
    


SEE ALSO
     pooladm(1M),    pooladm(1M),    psrset(1M),     zoneadm(1M),
     psetbind(2), poolsetstatus(3POL), attributes(5)





















SunOS 5.11          Last change: 28 Jun 2004                    2