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

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

__pset_rtctl(2) __pset_rtctl(2)

Processor Set Support

Use sysconf() with _SC_PSET_SUPPORT

to see if the processor set functionality is supported by the

underlying HP-UX operating system version.

Use

sysconf() with _SC_PSET_RTE_SUPPORT

to see if the RTE processor set functionality is sup-

ported by the underlying HP-UX operating system version.

EXAMPLE

Create a new processor set, and conﬁgure it as RTE processor set:

#include <sys/rtpset.h>

psetid_t new_psetid;

int ret;

if ((ret = pset_create(&new_psetid)) < 0) {

perror("pset_create()");

exit(1);

}

if ((ret = __pset_rtctl(RTE_PSET_CONFIG, new_psetid, 0)) < 0) {

perror("__pset_rtctl()");

exit(2);

}

RETURN VALUE

__pset_rtctl() returns zero on successful completion for

RTE_PSET_CONFIG and

RTE_PSET_UNCONFIG

requests.

For

RTE_PSET_GETFIRSTPSET

and RTE_PSET_GETNEXTPSET requests, the ID of an RTE processor

set is returned if one is found.

Otherwise, -1 is returned and

errno is set to indicate the error.

ERRORS

__pset_rtctl fails if one or more of the following is true:

[EALREADY]

The speciﬁed processor set pset is already conﬁgured as RTE processor set, and the

RTE_PSET_CONFIG request is issued.

[EINVAL] The request is invalid.

[EINVAL] The speciﬁed processor set pset is invalid.

[EINVAL] The speciﬁed processor set pset is not an RTE processor set, and

RTE_PSET_UNCONFIG

request is issued.

[EINVAL] The request is RTE_PSET_GETNEXTPSET

and there is no other RTE processor set after

pset.

[ENOSYS] The RTE processor set functionality is not supported by the underlying HP-UX version.

[EPERM] The user does not have necessary permissions to perform the requested operation.

[EPERM] The speciﬁed processor set, pset, is a special, reserved processor set, and cannot be conﬁgured

as an RTE processor set.