pstat_getlocality.2 (2010 09)

p
pstat_getlocality(2) pstat_getlocality(2)
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.
uint64_t ppl_rss_weighted
The number of resident pages for this process in this locality, weighted by the number of
processes sharing each page. Private pages count as one page, and shared pages count as
the page divided by the number of processes sharing that page.
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010