69 lines
1.9 KiB
Groff
69 lines
1.9 KiB
Groff
.\"
|
|
.\" 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).
|