HP-UX Reference (11i v2 03/08) - 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 argu-
ment 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 proces-
sor 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 proces-
sor 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 2: August 2003 − 1 − Hewlett-Packard Company Section 2−−227