PROC_FDINFOWALK(3PROC) Process Control Library Functions PROC_FDINFOWALK(3PROC)
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