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

p
pset_ctl(2) pset_ctl(2)
NAME
pset_ctl - processor set control
SYNOPSIS
#include <sys/pset.h>
int pset_ctl(
pset_request_t
request,
psetid_t
pset,
id_t
id
);
DESCRIPTION
The pset_ctl() function provides a means to query the system processor set configuration and assign-
ment information. The request argument specifies what information is needed for the pset processor set.
The following request values are supported:
PSET_GETCURRENTPSET
Return the ID of the processor set binding for the calling thread. The pset and id arguments are
ignored.
PSET_GETFIRSTLDOM
Return the ID of the first locality domain contributing to the processor set pset. The id argu-
ment is ignored.
PSET_GETFIRSTPSET
Return the ID of the first processor set in the system. The pset and id arguments are ignored.
PSET_GETFIRSTSPU
Return the ID of the first processor in the processor set pset. It will return -1 if the processor set
is empty. Any processors in the processor set that is in transition are ignored. The id argument
is ignored.
PSET_GETNEXTLDOM
Return the ID of the next locality domain after the locality domain specified in id that contri-
butes to the processor set pset.
Typically,
PSET_GETFIRSTLDOM
is called to determine the first locality domain in a processor
set.
PSET_GETNEXTLDOM
is then called in a loop (until the call returns -1) to determine the
IDs of the remaining locality domain in the processor set.
PSET_GETNEXTPSET
Return the ID of the next processor set in the system after pset. The id argument is ignored.
Typically,
PSET_GETFIRSTPSET
is called to determine the first processor set.
PSET_GETNEXTPSET
is then called in a loop (until the call returns -1) to determine the IDs of
the remaining processor sets in the system.
PSET_GETNEXTSPU
Return the ID of next processor in the processor set pset after the processor specified in id.
Typically,
PSET_GETFIRSTSPU is called to determine the first processor in a processor set.
PSET_GETNEXTSPU is then called in a loop (until the call returns -1) to determine the IDs of
the remaining processors in the processor set.
PSET_GETNUMLDOMS
Return the number of locality domains that have at least one processor assigned to the processor
set pset. The id argument is ignored.
PSET_GETNUMPSETS
Return the current number of processor sets in the system. It will always be greater than or
equal to one. The pset and id arguments are ignored.
PSET_GETNUMSPUS
Return the number of processors assigned to the processor set pset. Any processors in the pro-
cessor set that is in transition are not included. The id argument is ignored.
PSET_LDOMSPUS
Return number of processors contributed by the locality domain specified by id to the processor
set pset.
HP-UX 11i Version 3: February 2007 − 1 − Hewlett-Packard Company 283