HP-UX Reference (11i v1 05/09) - 2 System Calls (vol 5)

p
pset_getattr()(2) pset_getattr()(2)
A superuser, a PRIV_PSET privilege user, or the pset owner may change value of the
PSET_ATTR_PERM
attribute.
PSET_ATTR_IOINTR
A value of PSET_ATTRVAL_ALLOW
indicates that processors in this processor set are
configured to receive external interrupts. It may be assigned a value of
PSET_ATTRVAL_DISALLOW
to disable all processors in the processor set from receiving and
processing external I/O interrupts. Not all platforms may support this feature. By default, I/O
interrupts are enabled on all processors. The feature may be useful for some realtime applica-
tions where unpredictable interrupt handling overhead may adversely impact the application’s
response time requirements.
Only a superuser or a PRIV_PSET privilege user may change this attribute.
PSET_ATTR_NONEMPTY
Indicates the behavior when a request to destroy a non-empty processor set is made through the
pset_destroy()
function. Possible values are:
PSET_ATTRVAL_DFLTPSET
Reassign all processors in the processor set pset to the system
default processor set. Migrate all threads and processes bound
to this processor set to the system default processor set. This
is the default value for this attribute.
PSET_ATTRVAL_FAIL
Make the request fail with an [EBUSY] error if there are
threads or processes bound to the processor set or if there are
processors assigned to the processor set.
PSET_ATTRVAL_FAILBUSY
Make the request fail with an [EBUSY] error if there are
active threads or processes bound to the processor set. Other-
wise, perform the operation by reassigning the processors in
the pset to the system default processor set.
A superuser, a PRIV_PSET privilege user, or a user with WRITE permissions may change value
of this attribute.
PSET_ATTR_EMPTY
Indicates the behavior when a request to bind a process or a thread to an empty processor set is made
through the pset_bind() function. Possible values are:
PSET_ATTRVAL_ALLOW
Go through with the request. However, the affected threads will not be
scheduled to execute until a processor is assigned to the empty proces-
sor set.
PSET_ATTRVAL_FAIL
Reject the request with an [EINVAL] error. This is the default value for
this attribute.
A superuser, a PRIV_PSET privilege user, or a user with WRITE permissions may change value of
this attribute.
PSET_ATTR_LASTSPU
Indicates the behavior when a request to remove the last processor from a processor set is made
through the pset_assign() function, or through the processor deallocation functionality. Possible
values are:
PSET_ATTRVAL_FAIL Make the request fail if there are active threads and processes
assigned to the processor set.
PSET_ATTRVAL_DFLTPSET Assign the processor to the specified processor set, and migrate all
threads and processes to the system default processor set
PS_DEFAULT. This is the default value for this attribute.
A superuser, a PRIV_PSET privilege user, or a user with WRITE permissions may change the value
of the PSET_ATTR_LASTSPU attribute.
The default value for any attribute can be assigned using the PSET_ATTRVAL_DEFAULT value in the
pset_setattr() function.
RETURN VALUE
The functions return zero on successful completion. Otherwise, -1 is returned and errno is set to indicate
the error.
Section 2−−236 Hewlett-Packard Company − 2 − HP-UX 11i Version 1: September 2005