| kvm_geterr.3 (68575) | kvm_geterr.3 (79754) |
|---|---|
| 1.\" Copyright (c) 1992, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" This code is derived from software developed by the Computer Systems 5.\" Engineering group at Lawrence Berkeley Laboratory under DARPA contract 6.\" BG 91-66 and contributed to Berkeley. 7.\" 8.\" Redistribution and use in source and binary forms, with or without --- 20 unchanged lines hidden (view full) --- 29.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 30.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 31.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 32.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 33.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 34.\" SUCH DAMAGE. 35.\" 36.\" @(#)kvm_geterr.3 8.1 (Berkeley) 6/4/93 | 1.\" Copyright (c) 1992, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" This code is derived from software developed by the Computer Systems 5.\" Engineering group at Lawrence Berkeley Laboratory under DARPA contract 6.\" BG 91-66 and contributed to Berkeley. 7.\" 8.\" Redistribution and use in source and binary forms, with or without --- 20 unchanged lines hidden (view full) --- 29.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 30.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 31.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 32.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 33.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 34.\" SUCH DAMAGE. 35.\" 36.\" @(#)kvm_geterr.3 8.1 (Berkeley) 6/4/93 |
| 37.\" $FreeBSD: head/lib/libkvm/kvm_geterr.3 68575 2000-11-10 17:46:15Z ru $ | 37.\" $FreeBSD: head/lib/libkvm/kvm_geterr.3 79754 2001-07-15 07:53:42Z dd $ |
| 38.\" 39.Dd June 4, 1993 40.Dt KVM_GETERR 3 41.Os 42.Sh NAME 43.Nm kvm_geterr 44.Nd get error message on kvm descriptor 45.Sh LIBRARY --- 4 unchanged lines hidden (view full) --- 50.Fn kvm_geterr "kvm_t *kd" 51.Sh DESCRIPTION 52This function returns a string describing the most recent error condition 53on the descriptor 54.Fa kd . 55The results are undefined if the most recent 56.Xr kvm 3 57library call did not produce an error. | 38.\" 39.Dd June 4, 1993 40.Dt KVM_GETERR 3 41.Os 42.Sh NAME 43.Nm kvm_geterr 44.Nd get error message on kvm descriptor 45.Sh LIBRARY --- 4 unchanged lines hidden (view full) --- 50.Fn kvm_geterr "kvm_t *kd" 51.Sh DESCRIPTION 52This function returns a string describing the most recent error condition 53on the descriptor 54.Fa kd . 55The results are undefined if the most recent 56.Xr kvm 3 57library call did not produce an error. |
| 58The string returned is stored in memory owned by | 58The string returned is stored in memory owned by |
| 59.Xr kvm 3 60so the message should be copied out and saved elsewhere if necessary. 61.Sh BUGS 62This routine cannot be used to access error conditions due to a failed 63.Fn kvm_openfiles 64call, since failure is indicated by returning a 65.Dv NULL 66descriptor. 67Therefore, errors on open are output to the special error buffer | 59.Xr kvm 3 60so the message should be copied out and saved elsewhere if necessary. 61.Sh BUGS 62This routine cannot be used to access error conditions due to a failed 63.Fn kvm_openfiles 64call, since failure is indicated by returning a 65.Dv NULL 66descriptor. 67Therefore, errors on open are output to the special error buffer |
| 68passed to | 68passed to |
| 69.Fn kvm_openfiles . 70This option is not available to 71.Fn kvm_open . 72.Sh SEE ALSO 73.Xr kvm 3 , 74.Xr kvm_close 3 , 75.Xr kvm_getargv 3 , 76.Xr kvm_getenvv 3 , 77.Xr kvm_getprocs 3 , 78.Xr kvm_nlist 3 , 79.Xr kvm_open 3 , 80.Xr kvm_openfiles 3 , 81.Xr kvm_read 3 , 82.Xr kvm_write 3 | 69.Fn kvm_openfiles . 70This option is not available to 71.Fn kvm_open . 72.Sh SEE ALSO 73.Xr kvm 3 , 74.Xr kvm_close 3 , 75.Xr kvm_getargv 3 , 76.Xr kvm_getenvv 3 , 77.Xr kvm_getprocs 3 , 78.Xr kvm_nlist 3 , 79.Xr kvm_open 3 , 80.Xr kvm_openfiles 3 , 81.Xr kvm_read 3 , 82.Xr kvm_write 3 |