pstat.2 (2010 09)

p
pstat(2) pstat(2)
Context Struct Routine Instances SC
Static pst_static pstat_getstatic() 1/system N/A
Dynamic pst_dynamic pstat_getdynamic() 1/system N/A
VM pst_vminfo pstat_getvminfo() 1/system N/A
IPC pst_ipcinfo pstat_getipc() 1/system N/A
Stable Store pst_stable pstat_getstable() 1/system N/A
Crash Dumps pst_crashinfo pstat_getcrashinfo() 1/system N/A
Processor pst_processor pstat_getprocessor() 1/processor No
Disk pst_diskinfo pstat_getdisk() 1/disk No
IO Object pst_ioinfo pstat_getio() 1/IO object No
Swap pst_swapinfo pstat_getswap() 1/swap area No
Dump Areas pst_crashdev pstat_getcrashdev() 1/dump area No
Node pst_node pstat_getnode() 1/node No
Locality pst_locality pstat_getlocality() 1/locality No
Command Line char * pstat_getcommandline() 1/process Yes
Process pst_status pstat_getproc() 1/process Yes
LW Process lwp_status pstat_getlwp() 1/lwp/thread Yes
Process VM pst_vm_status pstat_getprocvm() 1/process region Yes
Process Loc. pst_proc_locality pstat_getproclocality() 1/process loc. Yes
LVM Vol pst_lvinfo pstat_getlv() 1/lvol Yes
Sema Set pst_seminfo pstat_getsem() 1/sem set Yes
Msg Queue pst_msginfo pstat_getmsg() 1/msg queue Yes
Shared Mem pst_shminfo pstat_getshm() 1/shm seg Yes
Processor Set pst_pset pstat_getpset() 1/proc set Yes
P-Sema Set pst_pseminfo pstat_getpsem() 1/sema No
P-Msg Queue pst_pmqinfo pstat_getpmq() 1/msg queue No
Open File pst_fileinfo2 pstat_getfile2() 1/file Yes
Open File pst_filedetails pstat_getfiledetails() 1/file/call N/A
Open Socket pst_socket pstat_getsocket() 1/socket/call N/A
Open Stream pst_stream pstat_getstream() 1/stream/call No
Open File char * pstat_getpathname() 1/file/call N/A
DNLC pst_mpathnode pstat_getmpathname() 1/DNLC entry Yes
The pstat Context
A pstat context represents a logical object or a related set of logical objects upon which pstat reports. A
pstat context does not necessarily correspond directly to a kernel object. For instance, the dynamic con-
text represents a collection of some of the dynamic system-wide information available from the system.
There may be exactly one, or more than one, instance of a given pstat context.
The pstat Index
The pstat index, which exists as an argument of many pstat functions and as a return field of many pstat
functions, represents a logical placement within the given pstat context under consideration. For pstat
contexts with more than one instance, it provides a mechanism to obtain all of the instances of a given
context via multiple calls of the given pstat function. Do not presume that the pstat index has any rela-
tion to the representation of objects within the kernel; it should not be used for any purpose other than to
obtain instances of this particular pstat context. Different instances of a pstat context are not necessarily
contained in sequential pstat indices.
Data Consistency
The pstat functions return data that may be rapidly changing in time. The data may even change during
a single pstat function call. Applications may need to be aware of potential consistency issues in data
returned by pstat due to this. There are two senses of data consistency for pstat: the self-consistency of
data within a given pstat instance and consistency between two or more pstat instances, which may even
be from different contexts.
In general, an attempt is made by the pstat implementation to provide reasonable self-consistency of a
given pstat instance within the bounds of performance constraints. The pstat implementation is designed
such that the information returned in a given data structure will contain only information about one
instance of the given pstat context. However, since pstat often reports on kernel data that are rapidly
changing or that may change at any time, self-consistency between fields within a given structure
returned for a pstat instance is not assured.
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010