NAME    [Toc]    [Back]

     kvm_geterr -- get error message on kvm descriptor

LIBRARY    [Toc]    [Back]

     Kernel Data Access Library (libkvm, -lkvm)

SYNOPSIS    [Toc]    [Back]

     #include <kvm.h>

     char *
     kvm_geterr(kvm_t *kd);

DESCRIPTION    [Toc]    [Back]

     This function returns a string describing the most recent error condition
     on the descriptor kd.  The results are undefined if the most recent
     kvm(3) library call did not produce an error.  The string returned is
     stored in memory owned by kvm(3) so the message should be copied out and
     saved elsewhere if necessary.

BUGS    [Toc]    [Back]

     This routine cannot be used to access error conditions due to a failed
     kvm_openfiles() call, since failure is indicated by returning a NULL
     descriptor.  Therefore, errors on open are output to the special error
     buffer passed to kvm_openfiles().	This option is not available to
     kvm_open().

SEE ALSO    [Toc]    [Back]

     kvm(3), kvm_close(3), kvm_getargv(3), kvm_getenvv(3), kvm_getprocs(3),
     kvm_nlist(3), kvm_open(3), kvm_openfiles(3), kvm_read(3), kvm_write(3)


FreeBSD 5.2.1			 June 4, 1993			 FreeBSD 5.2.1