/contrib/bind9/lib/lwres/man/lwres_hstrerror.3
https://bitbucket.org/freebsd/freebsd-head/ · Unknown · 99 lines · 99 code · 0 blank · 0 comment · 0 complexity · 8b71ba0101a971ab3a10348508b37f78 MD5 · raw file
- .\" Copyright (C) 2004, 2005, 2007, 2012 Internet Systems Consortium, Inc. ("ISC")
- .\" Copyright (C) 2000, 2001 Internet Software Consortium.
- .\"
- .\" Permission to use, copy, modify, and/or distribute this software for any
- .\" purpose with or without fee is hereby granted, provided that the above
- .\" copyright notice and this permission notice appear in all copies.
- .\"
- .\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
- .\" REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
- .\" AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
- .\" INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
- .\" LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
- .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
- .\" PERFORMANCE OF THIS SOFTWARE.
- .\"
- .\" $Id$
- .\"
- .hy 0
- .ad l
- .\" Title: lwres_hstrerror
- .\" Author:
- .\" Generator: DocBook XSL Stylesheets v1.71.1 <http://docbook.sf.net/>
- .\" Date: Jun 30, 2000
- .\" Manual: BIND9
- .\" Source: BIND9
- .\"
- .TH "LWRES_HSTRERROR" "3" "Jun 30, 2000" "BIND9" "BIND9"
- .\" disable hyphenation
- .nh
- .\" disable justification (adjust text to left margin only)
- .ad l
- .SH "NAME"
- lwres_herror, lwres_hstrerror \- lightweight resolver error message generation
- .SH "SYNOPSIS"
- .nf
- #include <lwres/netdb.h>
- .fi
- .HP 18
- .BI "void lwres_herror(const\ char\ *" "s" ");"
- .HP 29
- .BI "const char * lwres_hstrerror(int\ " "err" ");"
- .SH "DESCRIPTION"
- .PP
- \fBlwres_herror()\fR
- prints the string
- \fIs\fR
- on
- \fBstderr\fR
- followed by the string generated by
- \fBlwres_hstrerror()\fR
- for the error code stored in the global variable
- \fBlwres_h_errno\fR.
- .PP
- \fBlwres_hstrerror()\fR
- returns an appropriate string for the error code gievn by
- \fIerr\fR. The values of the error codes and messages are as follows:
- .PP
- \fBNETDB_SUCCESS\fR
- .RS 4
- Resolver Error 0 (no error)
- .RE
- .PP
- \fBHOST_NOT_FOUND\fR
- .RS 4
- Unknown host
- .RE
- .PP
- \fBTRY_AGAIN\fR
- .RS 4
- Host name lookup failure
- .RE
- .PP
- \fBNO_RECOVERY\fR
- .RS 4
- Unknown server error
- .RE
- .PP
- \fBNO_DATA\fR
- .RS 4
- No address associated with name
- .RE
- .SH "RETURN VALUES"
- .PP
- The string
- Unknown resolver error
- is returned by
- \fBlwres_hstrerror()\fR
- when the value of
- \fBlwres_h_errno\fR
- is not a valid error code.
- .SH "SEE ALSO"
- .PP
- \fBherror\fR(3),
- \fBlwres_hstrerror\fR(3).
- .SH "COPYRIGHT"
- Copyright \(co 2004, 2005, 2007, 2012 Internet Systems Consortium, Inc. ("ISC")
- .br
- Copyright \(co 2000, 2001 Internet Software Consortium.
- .br