HP-UX Reference (11i v2 04/09) - 2 System Calls (vol 5)

p
pstat_getlocality(2) pstat_getlocality(2)
There is one instance of this context for each locality on the system. For each locality requested,
data, up to a maximum of elemsize bytes, are returned in the
struct pst_locality pointed
to by buf . The elemcount parameter specifies the number of
struct pst_locality that are
available at buf to be filled in. The index parameter specifies the starting index within the con-
text of localities.
The types and field members of the
struct pst_locality are as follows:
pst_locality_flags_t psl_flags
Contains information about the given locality. See the description of pst_locality_flags_t
below for details.
int64_t psl_ldom_id
This is the LDOM id used by mpctl(2) to identify this locality. For the interleaved locality,
this field will be -1.
int64_t psl_physical_id
A hardware-based number that ties the locality to some recognizable physically indexable
entity. An example of this is a cell id number.
uint64_t psl_total_pages
The total number of physical pages in this locality.
uint64_t psl_free_pages
The number of free physical pages in this locality at this moment.
uint64_t psl_cpus
The number of enabled cpus in this locality. This is irrespective of any processor sets
that may be in effect for those cpus.
psl_flags is a bitfield described by the enumerated type pst_locality_flags_t . This field describes
some of the properties of the locality. Valid values for pst_locality_flags_t are the following:
PSL_INTERLEAVED
This locality is the interleaved locality.
PSL_LOCAL This locality is not an interleaved locality. It will map to exactly one local-
ity domain returned by the mpctl(2) system call. PSL_LOCAL and
PSL_INTERLEAVED are mutually exclusive.
PSL_FLOATING This locality does not contribute any physical memory to the interleave.
PSL_FLOATING can only be set if PSL_LOCAL is also set.
On an UMA system, there will be one locality and
PSL_LOCAL will be set in psl_flags.
pstat_getproclocality()
Returns information specific to a particular process’ locality behavior.
There is one instance of this context for each locality for each process on the system. For each
instance requested, data, up to a maximum of elemsize bytes, are returned in the
struct
pst_proc_locality pointed to by buf . At most one instance (locality) is returned for each
call to pstat_getproclocality(). The pid parameter specifies the process id of the pro-
cess for which locality information is to be returned. A pid of zero indicates that locality infor-
mation for the currently executing process should be returned. The index parameter specifies
the starting index within the context of localities.
The types and field members of the
struct pst_proc_locality are as follows:
int64_t ppl_ldom_id
This is the LDOM id used by mpctl(2) to identify this locality. For the interleaved locality,
this field will be -1.
uint64_t ppl_rss_total
The total number of resident pages for this process in this locality.
uint64_t ppl_rss_shared
The number of shared resident pages for this process in this locality.
uint64_t ppl_rss_private
The number of private resident pages for this process in this locality.
HP-UX 11i Version 2: September 2004 − 2 − Hewlett-Packard Company Section 2−−259