.\"
.\" Copyright (C) 2000, 2001  Internet Software Consortium.
.\"
.\" Permission to use, copy, modify, and 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 INTERNET SOFTWARE CONSORTIUM
.\" DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
.\" INTERNET SOFTWARE CONSORTIUM 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.
.\"
.TH "LWRES_HSTRERROR" "3" "Jun 30, 2000" "BIND9" ""
.SH NAME
lwres_herror, lwres_hstrerror \- lightweight resolver error message generation
.SH SYNOPSIS
\fB#include <lwres/netdb.h>
.sp
.na
void
lwres_herror(const char *s);
.ad
.sp
.na
const char *
lwres_hstrerror(int err);
.ad
\fR
.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 lwres_h_errno.
.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:
.TP
\fBNETDB_SUCCESS\fR
\fBResolver Error 0 (no error)\fR
.TP
\fBHOST_NOT_FOUND\fR
\fBUnknown host\fR
.TP
\fBTRY_AGAIN\fR
\fBHost name lookup failure\fR
.TP
\fBNO_RECOVERY\fR
\fBUnknown server error\fR
.TP
\fBNO_DATA\fR
\fBNo address associated with name\fR
.SH "RETURN VALUES"
.PP
The string \fBUnknown resolver error\fR is returned by
\fBlwres_hstrerror()\fR
when the value of
lwres_h_errno
is not a valid error code.
.SH "SEE ALSO"
.PP
\fBherror\fR(3),
\fBlwres_hstrerror\fR(3).