HP-UX Reference (11i v2 07/12) - 2 System Calls (vol 5)

_
__pset_rtctl(2) __pset_rtctl(2)
RTE_PSET_GETNEXTPSET
Return the ID of the next RTE processor set in the system after pset.
The arg argument is ignored.
Typically,
RTE_PSET_GETFIRSTPSET
is called to determine the
first RTE processor set.
RTE_PSET_GETNEXTPSET
is then called
in a loop (until the call returns -1) to determine the IDs of the remain-
ing RTE processor sets in the system.
See pset_ctl (2) for additional processor set query operations. The
pset_ctl() function allows users to
query all processor sets in the system, processors in a specific processor set, and a processor set given a pro-
cessor.
A processor may be added to an RTE processor set using the
pset_assign()
function. In this case, the
processor is made unavailable to the kernel daemons; external I/O interrupts and pending callouts on this
processor are reassigned to processors in non-RTE processor sets in the system. Conversely, if a processor
is removed from an RTE processor set and added to a non-RTE processor set, it is made available to the
kernel daemons and for external I/O interrupts. Similarly, if a non-empty RTE processor set is destroyed,
its processors are made available to the kernel daemons and for external I/O interrupts.
Only a user with appropriate privileges may configure and unconfigure an RTE processor set. However,
any user may query the IDs and configuration of RTE processor sets. Only a user with appropriate
privileges may reassign processors into or out of an RTE processor set, change attribute values, or destroy
an RTE processor set. Any user with EXEC permissions in an RTE processor set may run applications in
that RTE processor set.
HP-UX processor sets define processor set attributes to provide users explicit control in managing their pro-
cessor set configuration and work load assignment among many users and applications (see pset_getattr (2)
for details). A processor set is assigned default values for these attributes at creation time. The RTE pro-
cessor sets attributes are assigned different default values at time of configuration. The supported attri-
butes and their default values are:
PSET_ATTR_OWNID UID of the processor set owner. When a processor set is converted
into an RTE pset, the owner of the pset changes to that of the
effective uid of the calling process. The owner of the pset or a user
with appropriate privilege can change this attribute using
pset_setattr() (see pset_setattr (2)).
PSET_ATTR_GRPID GID of processor set’s owner group. When a processor set is con-
verted into an RTE pset, the group of the pset changes to that of the
effective gid of the calling process. The owner of the pset or a user
with appropriate privilege can change this attribute using
pset_setattr() (see pset_setattr (2)).
PSET_ATTR_PERM Access permissions for the processor set. When a processor set is con-
verted to an RTE processor set, the permissions are reset such that
the processor set owner has all permissions, group has READ and
EXEC permissions, and others have only READ permissions. The
owner of the pset or a user with appropriate privileges can change
this attribute using
pset_setattr()
(see pset_setattr (2)).
PSET_ATTR_EMPTY Indicates the behavior on a request to bind a process or a thread to a
processor set that does not contain any processors. For RTE processor
sets, such a request will be rejected by default. However, a user with
appropriate privileges or a user with WRITE access to the pset can
change the value of this attribute to allow deletion of an empty RTE
processor set. Refer to pset_getattr() (see pset_getattr (2)) for
supported values.
PSET_ATTR_IOINTR A flag to indicate if processors in the processor set are configured to
receive external I/O interrupts or not. All processors in an RTE pro-
cessor set are disabled to receive interrupts. This attribute cannot be
enabled until the processor set is unconfigured as an RTE processor
set.
PSET_ATTR_LASTSPU Indicates the behavior on a request to remove the last processor from
a processor set if there are active processes and threads bound to the
processor set. For RTE processor sets, such a request will be rejected
by default. However, a user with appropriate privileges or a user
HP-UX 11i Version 2: December 2007 Update − 2 − Hewlett-Packard Company 25