pstat.2 (2010 09)

p
pstat(2) pstat(2)
Description
pstat_getprocessor()
returns information specific to a particular processor (the only processor on
a uniprocessor system). There is one instance of this context for each processor on the system. For each
instance requested, up to a maximum of elemsize bytes of data is returned in the
pst_processor
struc-
tures pointed to by buf. The elemcount parameter specifies the number of
pst_processor
structures
that are available at buf to be filled in. The index parameter specifies the starting index within the con-
text of processors.
PSTAT FUNCTION
Name
pstat_getproclocality()
- get information for a process’s memory placement for each locality
Description
See the pstat_getlocality(2) manpage for the synopsis and full description.
PSTAT FUNCTION
Name
pstat_getprocvm()
- get information for a process’s address space
Synopsis
#include <sys/pstat.h>
int pstat_getprocvm(
struct pst_vm_status *buf,
size_t elemsize ,
size_t elemcount ,
int index
);
Description
pstat_getprocvm()
returns information specific to a particular process’s address space. There is one
instance of this context for each process region contained in the process’s address space. For each
instance requested, up to a maximum of elemsize bytes of data is returned in the
pst_vm_status
struc-
ture pointed to by buf. Only at most one instance (process region) is returned for each call to
pstat_getprocvm()
. The elemcount parameter identifies the process for which address space infor-
mation is to be returned. An elemcount parameter of
0 indicates that address space information for the
currently executing process should be returned. The index parameter specifies the starting index (begin-
ning with 0) within the context of process regions for the indicated process. For example, an index of
3
indicates the 4th process region within the indicated process’s address space. As a shortcut, information
for a specific process (other than the currently executing one) can be obtained by setting elemcount to the
PID of that process. More information on VM regions mapped to files can be obtained with the
pstat_getfiledetails()
call.
PSTAT FUNCTION
Name
pstat_getpsem() - get information for a POSIX named semaphore
Synopsis
#include <sys/pstat.h>
int pstat_getpsem(
struct pst_pseminfo *buf,
size_t elemsize ,
size_t elemcount ,
int index
);
Description
pstat_getpsem() returns information specific to a particular POSIX named semaphore. There is one
instance of this context for each POSIX named semaphore on the system. For each instance requested, up
to a maximum of elemsize bytes of data is returned in the pst_pseminfo structures pointed to by buf .
The elemcount parameter specifies the number of pst_pseminfo structures that are available at buf to
be filled in. The index parameter specifies the starting index within the context of POSIX named sema-
phore sets.
HP-UX 11i Version 3: September 2010 − 11 − Hewlett-Packard Company 11