Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
KVM_GETERR(3)	       FreeBSD Library Functions Manual		 KVM_GETERR(3)

NAME
     kvm_geterr	-- get error message on	kvm descriptor

LIBRARY
     Kernel Data Access	Library	(libkvm, -lkvm)

SYNOPSIS
     #include <kvm.h>

     char *
     kvm_geterr(kvm_t *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.

RETURN VALUES
     The function kvm_geterr() will return "" if kd is NULL or an error	has
     not been captured for kd.

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)

BUGS
     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().

FreeBSD	11.1			March 21, 2017			  FreeBSD 11.1

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=kvm_geterr&sektion=3&manpath=FreeBSD+11.1-RELEASE>

home | help