__pset_rtctl.2 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

__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 ﬁrst

RTE processor set.

RTE_PSET_GETNEXTPSET

is then called in a

loop (until the call returns -1) to determine the IDs of the remaining

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 speciﬁc processor set, processor set given a proces-

sor, etc.

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 proces-

sor 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 des-

troyed, its processors are made available to the kernel daemons and for external I/O interrupts.

Only a user with appropriate privileges may conﬁgure and unconﬁgure an RTE processor set. However,

any user may query the IDs and conﬁguration 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 deﬁne processor set attributes to provide users explicit control in managing their

processor set conﬁguration 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 processor sets attributes are assigned different default values at time of conﬁguration.

The supported attributes 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 appropri-

ate 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 converted

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 is 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. See pset_getattr (2) for supported values.

PSET_ATTR_IOINTR A ﬂag to indicate if processors in the processor set are conﬁgured 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 unconﬁgured 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 is 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

2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010