KVM_GETERR(3)               BSD Programmer's Manual              KVM_GETERR(3)

NAME
     kvmgeterr - get error message on kvm descriptor

SYNOPSIS
     #include <kvm.h>

     char *
     kvmgeterr(kvmt *kd)

DESCRIPTION
     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
     This routine cannot be used to access error conditions due to a failed
     kvmopenfiles() call, since failure is indicated by returning a NULL de-
     scriptor.  Therefore, errors on open are output to the special error
     buffer passed to kvmopenfiles().  This option is not available to
     kvmopen().

SEE ALSO
     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)

BSDI BSD/386                    March 26, 1993                               1