HP-UX Reference (11i v3 07/02) - 2 System Calls (vol 5)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

__pset_rtctl(2) __pset_rtctl(2)

busy. See pset_setattr (2) for supported values.

PSET_ATTR_NONEMPTY

Indicates the behavior on a request to destroy a non-empty processor set.

A non-empty processor set has at least one processor assigned to it. 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 RTE

processor set in use. See pset_setattr (2) for supported values.

PSET_ATTR_LCPU

Indicates whether the physical processor cores in the RTE pset is enabled

with logical processors (LCPUs). See pset_setattr (2) for details and sup-

ported values.

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.

Security Restrictions

Some or all of the actions associated with this system call require the

PSET privilege. Processes owned by

the superuser have this privilege. Processes owned by other users may have this privilege, depending on

system conﬁguration. See privileges (5) for more information about privileged access on systems that sup-

port ﬁne-grained privileges.

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.

EXAMPLES

Create a new processor set, and conﬁgure it as an 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);

}

26 Hewlett-Packard Company − 3 − HP-UX 11i Version 3: February 2007