pset_getattr.2 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

pset_getattr(2) pset_getattr(2)

PSET_ATTRVAL_DFLTPSET

Assign the processor to the speciﬁed processor set, and migrate all threads and processes

to the system default processor set PS_DEFAULT. This is the default value for this attri-

bute.

A user with the

PSET privilege or a user with WRITE permissions may change the value of the

PSET_ATTR_LASTSPU

attribute.

PSET_ATTR_LCPU

The LCPU attribute of a processor set indicates whether the physical processor cores in a pset are

enabled with logical processors (LCPUs). On systems with the Hyper-Threading (HT) feature

enabled, each processor core may have more than one hyper-thread per physical processor core.

Each hyper-thread is represented to the operating system and applications as a logical processor

(LCPU).

The

PSET_ATTR_LCPU

can be set for the default processor set using the

kctune() command.

This attribute is supported only on system with the Hyper-Threading feature. If this feature is dis-

abled at the ﬁrmware level or is not supported, this attribute cannot change.

PSET_ATTRVAL_ON

Enable the LCPUs in a processor set. This is the default value for systems with the

Hyper-Threading feature enabled.

PSET_ATTR_VAL_OFF

Disable the LCPUs in the processor set. This is the default value for the systems without

the Hyper-Threading feature or systems with the Hyper-Threading disabled in the

ﬁrmware.

The default value for any attribute can be assigned using the

PSET_ATTRVAL_DEFAULT

value in the

pset_setattr() function.

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

support ﬁne-grained privileges.

RETURN VALUE

The functions return zero on successful completion. Otherwise, -1 is returned and errno is set to indicate

the error.

ERRORS

pset_getattr() or pset_setattr()

fails if one or more of the following is true:

[EFAULT] The memory location pointed to by val is not writable by the user for

pset_getattr().

[EINVAL] The speciﬁed processor set pset , the attribute type , or the attribute val is invalid.

[EINVAL] The memory location pointed to by val is NULL for

pset_getattr()

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

[ENOTSUP] The requested attribute value is not supported for the

pset_setattr()

function.

[EPERM] The user does not have the necessary permissions to query or change the processor set

attributes.

AUTHOR

get_getattr and set_getattr were developed by HP.