BSD 4_4 development
[unix-history] / usr / share / man / cat3 / kvm_geterr.0
KVM_GETERR(3) BSD Programmer's Manual KVM_GETERR(3)
N\bNA\bAM\bME\bE
k\bkv\bvm\bm_\b_g\bge\bet\bte\ber\brr\br - get error message on kvm descriptor
S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
#\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<k\bkv\bvm\bm.\b.h\bh>\b>
_\bc_\bh_\ba_\br _\b*
k\bkv\bvm\bm_\b_g\bge\bet\bte\ber\brr\br(_\bk_\bv_\bm_\b__\bt _\b*_\bk_\bd);
D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
This function returns a string describing the most recent error condition
on the descriptor _\bk_\bd. 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.
B\bBU\bUG\bGS\bS
This routine cannot be used to access error conditions due to a failed
k\bkv\bvm\bm_\b_o\bop\bpe\ben\bnf\bfi\bil\ble\bes\bs() call, since failure is indicated by returning a NULL de-
scriptor. Therefore, errors on open are output to the special error
buffer passed to k\bkv\bvm\bm_\b_o\bop\bpe\ben\bnf\bfi\bil\ble\bes\bs(). This option is not available to
k\bkv\bvm\bm_\b_o\bop\bpe\ben\bn().
S\bSE\bEE\bE A\bAL\bLS\bSO\bO
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)
4.4BSD June 4, 1993 1