pstat.2 (2010 09)

p
pstat(2) pstat(2)
On success, the function returns the length of the path name copied starting at the location specified by
buf. If the path name is not available in the system cache,
0 is returned and errno is not set. On other
failures, the value of
-1 is returned and
errno is set indicating the cause of the failure. This call does
not work for sockets.
PSTAT FUNCTION
Name
pstat_getpmq()
- get information for a POSIX message queue
Synopsis
#include <sys/pstat.h>
int pstat_getpmq(
struct pst_pmqinfo *buf,
size_t elemsize ,
size_t elemcount ,
int index
);
Description
pstat_getpmq() returns information specific to a particular POSIX message queue. There is one
instance of this context for each POSIX message queue on the system. For each instance requested, up to
a maximum of elemsize bytes of data is returned in the pst_pmqinfo structures pointed to by buf . The
elemcount parameter specifies the number of
pst_pmqinfo structures that are available at buf to be
filled in. The index parameter specifies the starting index within the context of POSIX message queues.
PSTAT FUNCTION
Name
pstat_getproc() - get information for a process
Synopsis
#include <sys/pstat.h>
int pstat_getproc(
struct pst_status *buf,
size_t elemsize ,
size_t elemcount ,
int index
);
Description
pstat_getproc() returns information specific to a particular process. There is one instance of this
context for each active process on the system. For each instance requested, up to a maximum of elemsize
bytes of data is returned in the
pst_status structures pointed to by buf. The elemcount parameter
specifies the number of pst_status structures that are available at buf to be filled in. The index
parameter specifies the starting index within the context of processes. As a shortcut, information for a
single process can be obtained by setting elemcount to 0 and setting index to the PID of that process.
PSTAT FUNCTION
Name
pstat_getprocessor() - get information for a processor
Synopsis
#include <sys/pstat.h>
int pstat_getprocessor(
struct pst_processor *buf,
size_t elemsize ,
size_t elemcount ,
int index
);
10 Hewlett-Packard Company − 10 − HP-UX 11i Version 3: September 2010