Manualshelf

pset_ctl.2 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
1234
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_GETFIRSTPROXIMATESPU
Return the ID of the first processor in the processor set pset that is in the proximity of the pro-
cessor specified by id. Even when the processor given by id is enabled, the return value will
be -1 if none of the proximate processors contribute to the processor set pset . If the processor
given by id is not enabled, -1 is returned.
See mpctl (2) for details on proximate processors.
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 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_GETNEXTPROXIMATESPU
Return the ID of the next processor in the processor set pset that is in the proximity of the pro-
cessor specified by id.
Typically,
PSET_GETFIRSTPROXIMATESPU
is called to determine the first proximate proces-
sor.
PSET_GETNEXTPROXIMATESPU is then called in a loop (until the call returns -1) to
determine the IDs of the remaining proximate processors.
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.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)