1pset_setattr(2)                  System Calls                  pset_setattr(2)
2
3
4

NAME

6       pset_setattr, pset_getattr - set or get processor set attributes
7

SYNOPSIS

9       #include <sys/pset.h>
10
11       int pset_setattr(psetid_t pset, uint_t attr);
12
13
14       int pset_getattr(psetid_t pset, uint_t *attr);
15
16

DESCRIPTION

18       The pset_setattr() function sets attributes of the processor set speci‐
19       fied by pset.  The bitmask of attributes to be set or cleared is speci‐
20       fied by attr.
21
22
23       The pset_getattr function returns attributes of the processor set spec‐
24       ified by pset. On successful return, attr will contain the  bitmask  of
25       attributes for the specified processor set.
26
27
28       The  value  of  the  attr argument is the bitwise inclusive-OR of these
29       attributes, defined in <sys/pset.h>:
30
31       PSET_NOESCAPE    Unbinding of LWPs from the  processor  set  with  this
32                        attribute requires the {PRIV_SYS_RES_CONFIG} privilege
33                        to be asserted in the effective  set  of  the  calling
34                        process.
35
36
37
38       The  binding  of  LWPs and processes to processor sets is controlled by
39       pset_bind(2). When the PSET_NOESCAPE attribute is  cleared,  a  process
40       calling  pset_bind()  can  clear  the  processor set binding of any LWP
41       whose real or effective user ID matches its own real of effective  user
42       ID.  Setting PSET_NOESCAPE attribute forces pset_bind() to requires the
43       {PRIV_SYS_RES_CONFIG} privilege to be asserted in the effective set  of
44       the calling process.
45

RETURN VALUES

47       Upon  successful completion, these functions return 0. Otherwise, -1 is
48       returned and errno is set to indicate the error.
49

ERRORS

51       These function will fail if:
52
53       EFAULT     The location pointed to by attr  was  not  writable  by  the
54                  user.
55
56
57       EINVAL     An invalid processor set ID was specified.
58
59                  The  caller  is  in a non-global zone, the pools facility is
60                  active, and the processor is not  a  member  of  the  zone's
61                  pool's processor set.
62
63
64       ENOTSUP    The   pools   facility   is   active.  See  pooladm(1M)  and
65                  pool_set_status(3POOL) for information  about  enabling  and
66                  disabling the pools facility.
67
68

ATTRIBUTES

70       See attributes(5) for descriptions of the following attributes:
71
72
73
74
75       ┌─────────────────────────────┬─────────────────────────────┐
76       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
77       ├─────────────────────────────┼─────────────────────────────┤
78       │Interface Stability          │Stable                       │
79       ├─────────────────────────────┼─────────────────────────────┤
80       │MT-Level                     │Async-Signal-Safe            │
81       └─────────────────────────────┴─────────────────────────────┘
82

SEE ALSO

84       pooladm(1M),   pooladm(1M),   psrset(1M),   zoneadm(1M),  pset_bind(2),
85       pool_set_status(3POOL), attributes(5)
86
87
88
89SunOS 5.11                        28 Jun 2004                  pset_setattr(2)
Impressum