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

p
pstat(2) pstat(2)
See the pstat_getproclocality(2) manpage.
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’ address space.
For each instance requested, data, up to a maximum of
elemsize bytes, is returned in
the
struct pst_vm_status
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 information is to be returned. An
elem-
count parameter of zero indicates that address space information for the currently exe-
cuting process should be returned. The index parameter specifies the starting index
(beginning 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’
address space. As a shortcut, information for a specific process (other than the currently
executing one) may 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_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, data, up to a maximum of
elemsize bytes, is returned in the
structs pst_pseminfo pointed to by buf. The elemcount parameter specifies the
number of structs pst_pseminfo 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.
pstat_getpset()
Returns information specific to a particular processor set. There is one instance of this
context for each processor set on the system. For each instance requested, data, up to a
maximum of elemsize bytes, are returned in the struct pst_pset pointed by buf.
The elemcount parameter specifies the number of structs pst_pset that are avail-
able at buf to be filled in. The index parameter specifies the starting index within the
context of processor sets. As a shortcut, information for a single processor set may be
obtained by setting elemcount to zero and setting index to the pset id of that proces-
sor set.
pstat_getsem()
Returns information specific to a particular System V semaphore set. There is one
instance of this context for each System V semaphore set on the system. For each
instance requested, data, up to a maximum of elemsize bytes, is returned in the
structs pst_seminfo pointed to by buf. The elemcount parameter specifies the
number of structs pst_seminfo that are available at buf to be filled in. The
index parameter specifies the starting index within the context of System V sema-
phore sets. As a shortcut, information for a single semaphore set may be obtained by set-
ting elemcount to zero and setting index to the semid of that semaphore set.
pstat_getshm()
Returns information specific to a particular System V shared memory segment. There
is one instance of this context for each System V shared memory segment on the sys-
tem. For each instance requested, data, up to a maximum of elemsize bytes, is
returned in the structs pst_shminfo pointed to by buf. The elemcount parame-
ter specifies the number of structs pst_shminfo that are available at buf to be
filled in. The index parameter specifies the starting index within the context of Sys-
tem V shared memory segments. As a shortcut, information for a single shared memory
segment may be obtained by setting elemcount to zero and setting index to the
shmid of that shared memory segment.
pstat_getsocket()
Returns detailed information specific to a socket. For the specified socket, there is one
instance of this context. For each call, data, up to a maximum of elemsize bytes, is
returned in the struct pst_socket pointed to by buf. The fid parameter
uniquely identifies the socket. This fid is obtained from calls to pstat_getfile() or
pstat_getfile2(). Use of this function is limited to UID==0 or effective UID match.
Please refer pstat_getfiledetails() call for more information on effective UID
HP-UX 11i Version 2: September 2004 − 8 − Hewlett-Packard Company Section 2−−247