PROC_FDINFOWALK(3PROC) Process Control Library Functions
NAME
proc_fdinfowalk - walk the additional miscellaneous information in a
prfdinfo_t structure
LIBRARY
Process Control Library (libproc, -lproc)
SYNOPSIS
#include <libproc.h> int proc_fdinfowalk(
const prfdinfo_t *info,
proc_fdinfowalk_f *func,
void *arg);
DESCRIPTION
The
proc_fdinfowalk() function walks a
prfdinfo_t structure and calls
the callback function
func once for each miscellaneous item of
information present, along with the user-specified
arg. The definition
of
proc_fdinfowalk_f is available in
libproc(3LIB). The miscellaneous
data types and structures are found in the
fdinfo section of
proc(5).
func will be called once for each miscellaneous item, providing the
item's
type,
size and
address. The
size may include trailing padding
bytes which will be set to zero.
The return value of the caller's
func function determines whether or
not iteration will continue. If
func returns a non-zero value, then
iteration will terminate and that return value will be returned to the
caller. To distinguish between system errors and caller errors, it is
recommended that the function only return positive integers in the
event of an error.
RETURN VALUES
Upon successful completion, the
proc_fdinfowalk() function returns
0.
Otherwise,
-1 is returned and
errno is updated to reflect the error
that occurred.
ERRORS
In addition to the errors listed below, the
proc_fdinfowalk() function
may fail for the same reasons as the
opendir(3C),
readdir(3C), and
malloc(3C) functions.
INTERFACE STABILITY
UncommittedMT-LEVEL MT-SafeSEE ALSO
malloc(3C),
opendir(3C),
readdir(3C),
libproc(3LIB),
proc(5)illumos November 27, 2023 illumos
