Commit | Line | Data |
---|---|---|
be8ee4f0 C |
1 | KVM_GETERR(3) BSD Programmer's Manual KVM_GETERR(3) |
2 | ||
3 | N\bNA\bAM\bME\bE | |
4 | k\bkv\bvm\bm_\b_g\bge\bet\bte\ber\brr\br - get error message on kvm descriptor | |
5 | ||
6 | S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS | |
7 | #\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<k\bkv\bvm\bm.\b.h\bh>\b> | |
8 | ||
9 | _\bc_\bh_\ba_\br _\b* | |
10 | k\bkv\bvm\bm_\b_g\bge\bet\bte\ber\brr\br(_\bk_\bv_\bm_\b__\bt _\b*_\bk_\bd); | |
11 | ||
12 | D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN | |
13 | This function returns a string describing the most recent error condition | |
14 | on the descriptor _\bk_\bd. The results are undefined if the most recent kvm(3) | |
15 | library call did not produce an error. The string returned is stored in | |
16 | memory owned by kvm(3) so the message should be copied out and saved | |
17 | elsewhere if necessary. | |
18 | ||
19 | B\bBU\bUG\bGS\bS | |
20 | This routine cannot be used to access error conditions due to a failed | |
21 | 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- | |
22 | scriptor. Therefore, errors on open are output to the special error | |
23 | buffer passed to k\bkv\bvm\bm_\b_o\bop\bpe\ben\bnf\bfi\bil\ble\bes\bs(). This option is not available to | |
24 | k\bkv\bvm\bm_\b_o\bop\bpe\ben\bn(). | |
25 | ||
26 | S\bSE\bEE\bE A\bAL\bLS\bSO\bO | |
27 | kvm(3), kvm_close(3), kvm_getargv(3), kvm_getenvv(3), | |
28 | kvm_getprocs(3), kvm_nlist(3), kvm_open(3), kvm_openfiles(3), | |
29 | kvm_read(3), kvm_write(3) | |
30 | ||
31 | 4.4BSD June 4, 1993 1 |