freebsd man page for kinfo_getfile

KINFO_GETFILE(3)					   BSD Library Functions Manual 					  KINFO_GETFILE(3)

NAME
     kinfo_getfile -- function for getting per-process file descriptor information

LIBRARY
     System Utilities Library (libutil, -lutil)

SYNOPSIS
     #include <sys/types.h>
     #include <libutil.h>

     struct kinfo_file *
     kinfo_getfile(pid_t pid, int *cntp);

DESCRIPTION
     This function is used for obtaining the file descriptor information of a particular process.

     The pid field contains the process identifier.  This should be the a process that you have privilege to access.  The cntp field allows the
     caller to know how many records are returned.

     This function is a wrapper around sysctl(3) with the KERN_PROC_FILEDESC mib.  While the kernel returns a packed structure, this function
     expands the data into a fixed record format.

RETURN VALUES
     On success the kinfo_getfile() function returns a pointer to an array of struct kinfo_file structures as defined by <sys/user.h>.	The array
     was obtained by an internal call to malloc(3) and must be freed by the caller with a call to free(3).  On failure the kinfo_getfile() func-
     tion returns NULL.

SEE ALSO
     free(3), kinfo_getvmmap(3), malloc(3), sysctl(3)

BSD
								 December 6, 2008							       BSD