HP-UX Reference (11i v3 07/02) - 2 System Calls (vol 5)

p
pstat(2) pstat(2)
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.
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.
HP-UX 11i Version 3: February 2007 − 9 − Hewlett-Packard Company 299