HP-UX Reference (11i v2 03/08) - 2 System Calls (vol 5)

p
pstat(2) pstat(2)
formed by concatenating the pathname to the mount point of the file system.
Use of this function is limited to UID==0.
On success, the function returns the number of DNLC entries copied. In case of failure,
the value of
-1 is returned and errno
is set indicating the cause of the failure.
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, data, up to a maximum of elemsize bytes, is returned in the
structs pst_msginfo pointed to by buf
. The elemcount parameter specifies the
number of
structs pst_msginfo 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 may be obtained by set-
ting
elemcount to zero and setting index to the
msqid of that message queue.
pstat_getnode()
Returns information specific about a SCA system node. There is one instance of this con-
text for each SCA node on the system, for each instance requested, up to a maximum of
elemsize bytes, is returned in the struct pst_node
pointed to by buf. The
elemcount parameter specifies the number of
struct pst_node that are available
at
buf to be filled in. The index parameter specifies the starting logical node id that is
requested.
pstat_getpathname()
Returns the full pathname of an opened file in buf if it is available in the system cache
of recent names looked up (DNLC). The fid parameter uniquely identifies the opened
file. This fid is obtained from calls to pstat_getfile()
, pstat_getfile2(),
pstat_getproc(),or
pstat_getprocvm(). The value of elemcount should be
at least one greater than the length of the pathname to be returned. The
PATH_MAX
variable from pathconf (2) can be used for this purpose. Use of this function is limited to
UID==0 or effective UID match. Please refer pstat_getfiledetails()
call for
more information on Effective UID match.
On success, the function returns the length of the pathname copied starting at the loca-
tion specified by
buf. If the pathname 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_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, data, up to a maximum of
elemsize bytes, is returned in the structs
pst_pmqinfo pointed to by buf. The elemcount parameter specifies the number of
structs pst_pmqinfo that are available at buf to be filled in. The index parame-
ter specifies the starting index within the context of POSIX message queues.
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, data, up to a max-
imum of
elemsize bytes, is returned in the structs pst_status pointed to by buf.
The elemcount parameter specifies the number of structs pst_status 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 may be obtained
by setting elemcount to zero and setting index to the PID of that process.
pstat_getprocessor()
Returns information specific to a particular processor (the only processor on a uniproces-
sor system). There is one instance of this context for each processor on the system. For
each instance requested, data, up to a maximum of elemsize bytes, is returned in the
structs pst_processor pointed to by buf. The elemcount parameter specifies
the number of structs pst_processor that are available at buf to be filled in. The
index parameter specifies the starting index within the context of processors.
pstat_getproclocality()
Returns information specific to a particular process’s memory placement for each locality.
HP-UX 11i Version 2: August 2003 − 7 − Hewlett-Packard Company Section 2−−241