freebsd man page for kvm_getfiles

KVM_GETFILES(3) 					   BSD Library Functions Manual 					   KVM_GETFILES(3)

NAME
     kvm_getfiles -- survey open files

LIBRARY
     Kernel Data Access Library (libkvm, -lkvm)

SYNOPSIS
     #include <kvm.h>
     #include <sys/types.h>
     #define _KERNEL
     #include <sys/file.h>
     #undef _KERNEL

     char *
     kvm_getfiles(kvm_t *kd, int op, int arg, int *cnt);

DESCRIPTION
     The kvm_getfiles() function returns a (sub-)set of the open files in the kernel indicated by kd.  The op and arg arguments constitute a pred-
     icate which limits the set of files returned.  No predicates are currently defined.

     The number of files found is returned in the reference parameter cnt.  The files are returned as a contiguous array of file structures, pre-
     ceded by the address of the first file entry in the kernel.  This memory is owned by kvm and is not guaranteed to be persistent across subse-
     quent kvm library calls.  Data should be copied out if it needs to be saved.

RETURN VALUES
     The kvm_getfiles() function will return NULL on failure.

SEE ALSO
     kvm(3), kvm_close(3), kvm_geterr(3), kvm_nlist(3), kvm_open(3), kvm_openfiles(3), kvm_read(3), kvm_write(3)

BUGS
     This routine does not belong in the kvm interface.

BSD
								  April 19, 1994							       BSD