pset_getattr.2 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

pset_getattr(2) pset_getattr(2)

NAME

pset_getattr(), pset_setattr() - manage processor set attributes

SYNOPSIS

#include <sys/pset.h>

int pset_getattr(

psetid_t pset,

pset_attrtype_t type,

pset_attrval_t* val);

int pset_setattr(

psetid_t pset,

pset_attrtype_t type,

pset_attrval_t val);

DESCRIPTION

The pset_getattr()

function returns the current value of the attribute type for the processor set pset

in the memory location pointed to by val.

The

pset_setattr()

function assigns the value val to the attribute type for processor set pset .

A user can not change the attribute values for the system default processor set

PS_DEFAULT using the

pset_setattr() function.

A user with the

PSET privilege or a user with READ permission for the processor set may query any

attribute values.

The following processor set attributes may be queried or changed through these functions:

PSET_ATTR_GRPID

The GID (group id) of the processor set owner. The creator’s GID is assigned at processor set

creation time. A user with the PSET privilege or the pset owner may change the value of this

attribute.

PSET_ATTR_OWNID

The UID of the processor set owner. The creator is assigned as the owner at processor set

creation time. A user with the PSET privilege or the pset owner may change the value of this

attribute.

PSET_ATTR_PERM

The access permission bitmask for the processor set. These are deﬁned similar to ﬁle access

permissions. There are three types of access:

EXEC The user can bind its process or thread to the processor set using the

pset_bind() function (see pset_bind (2)).

READ The user can query the processor set attributes.

WRITE The user can modify the processor set attributes and conﬁguration, and destroy the

processor set.

The following bit values are used for the access bitmask:

PSET_GROUP_EXEC

All users in processor set owner’s group have EXEC access.

PSET_GROUP_READ

All users in processor set owner’s group have READ access.

PSET_GROUP_WRITE

All users in processor set owner’s group have WRITE access.

PSET_OTHER_EXEC

All others have EXEC access.

PSET_OTHER_READ

All others have READ access.

PSET_OTHER_WRITE

All others have WRITE access.

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

Summary of content (4 pages)

PAGE 1
pset_getattr(2) pset_getattr(2) NAME pset_getattr(), pset_setattr() - manage processor set attributes SYNOPSIS #include int pset_getattr( psetid_t pset, pset_attrtype_t type, pset_attrval_t* val); int pset_setattr( psetid_t pset, pset_attrtype_t type, pset_attrval_t val); DESCRIPTION The pset_getattr() function returns the current value of the attribute type for the processor set pset in the memory location pointed to by val .
PAGE 2
pset_getattr(2) pset_getattr(2) PSET_OWNER_EXEC The processor set owner has EXEC access. PSET_OWNER_READ The processor set owner has READ access. PSET_OWNER_WRITE The processor set owner has WRITE access. A newly created processor set by default has READ and EXEC access for everyone, but WRITE access only for the processor set owner. A user with the PSET privilege or the pset owner may change the value of the PSET_ATTR_PERM attribute.
PAGE 3
pset_getattr(2) pset_getattr(2) PSET_ATTRVAL_DFLTPSET Assign the processor to the specified processor set, and migrate all threads and processes to the system default processor set PS_DEFAULT. This is the default value for this attribute. A user with the PSET privilege or a user with WRITE permissions may change the value of the PSET_ATTR_LASTSPU attribute.
PAGE 4
(Notes) A (Notes) pA 4 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010