pstat.2 (2010 09)
p
pstat(2) pstat(2)
Name
pstat_getmsg()
- get information for a System V message queue
Synopsis
#include <sys/pstat.h>
int pstat_getmsg(
struct pst_msginfo *buf,
size_t elemsize ,
size_t elemcount ,
int index
);
Description
pstat_getmsg()
returns information specific to a particular System V message queue. There is one
instance of this context for each System V message queue on the system. For each instance requested, up
to a maximum of elemsize bytes of data is returned in the
pst_msginfo structures pointed to by buf .
The elemcount parameter specifies the number of
pst_msginfo structures that are available at buf to
be filled in. The index parameter specifies the starting index within the context of System V message
queues. As a shortcut, information for a single message queue can be obtained by setting elemcount to
0
and setting index to the msqid of that message queue.
PSTAT FUNCTION
Name
pstat_getnode() - get information about an SCA system node
Synopsis
#include <sys/pstat.h>
int pstat_getnode(
struct pst_node *buf,
size_t elemsize ,
size_t elemcount ,
int index
);
Description
pstat_getnode() returns information about a specific SCA system node. There is one instance of this
context for each SCA node on the system. For each instance requested, up to a maximum of elemsize
bytes is returned in the
pst_node structure pointed to by buf . The elemcount parameter specifies the
number of pst_node structures that are available at buf to be filled in. The index parameter specifies
the starting logical node ID that is requested.
PSTAT FUNCTION
Name
pstat_getpathname() - get the full path name of an open file
Synopsis
#include <sys/pstat.h>
int pstat_getpathname(
char *buf,
size_t elemcount ,
struct pst_fid *fid
);
Description
pstat_getpathname() returns the full path name of an open file in buf if it is available in the system
cache of recent names looked up (DNLC). The fid parameter uniquely identifies the open file. This fid is
obtained from calls to pstat_getfile2(), pstat_getproc(),orpstat_getprocvm(). The
value of elemcount should be at least one greater than the length of the path name to be returned. The
PATH_MAX variable from pathconf (2) can be used for this purpose. The use of this function is limited to
UID 0 or an effective UID match. See pstat_getfiledetails() for the definition of effective UID
match.
HP-UX 11i Version 3: September 2010 − 9 − Hewlett-Packard Company 9