summaryrefslogtreecommitdiff
path: root/usr.sbin/named/man/resolver.3
diff options
context:
space:
mode:
authorJason Downs <downsj@cvs.openbsd.org>1997-03-12 10:42:55 +0000
committerJason Downs <downsj@cvs.openbsd.org>1997-03-12 10:42:55 +0000
commit6072bd74192e6df1e3ed3f3afe32edfe7d99d2cb (patch)
tree21877bf94332fd37f010aeb1c31f888b63bcd85a /usr.sbin/named/man/resolver.3
parentf1d001e6fcd8bdb74d98ca1547b99958b9d90102 (diff)
BIND 4.9.5-P1.
libresolv and include are required until the new resolver gets integrated into libc.
Diffstat (limited to 'usr.sbin/named/man/resolver.3')
-rw-r--r--usr.sbin/named/man/resolver.341
1 files changed, 38 insertions, 3 deletions
diff --git a/usr.sbin/named/man/resolver.3 b/usr.sbin/named/man/resolver.3
index 6372823e11f..23297c5ee14 100644
--- a/usr.sbin/named/man/resolver.3
+++ b/usr.sbin/named/man/resolver.3
@@ -1,5 +1,4 @@
-.\" $NetBSD: resolver.3,v 1.1 1996/02/02 15:27:53 mrg Exp $
-.\"
+.\" $OpenBSD: resolver.3,v 1.2 1997/03/12 10:42:18 downsj Exp $
.\" Copyright (c) 1985, 1995 The Regents of the University of California.
.\" All rights reserved.
.\"
@@ -18,7 +17,7 @@
.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
.\"
.\" @(#)resolver.3 6.5 (Berkeley) 6/23/90
-.\" $Id: resolver.3,v 8.3 1995/12/22 10:20:28 vixie Exp
+.\" $From: resolver.3,v 8.4 1996/05/09 05:59:10 vixie Exp $
.\"
.TH RESOLVER 3 "December 11, 1995
.UC 4
@@ -100,6 +99,10 @@ res_query, res_search, res_mkquery, res_send, res_init, dn_comp, dn_expand \- re
.B char *exp_dn;
.br
.B int length;
+.PP
+.B herror(const char *s)
+.PP
+.B hstrerror(int err)
.SH DESCRIPTION
These routines are used for making, sending and interpreting
query and reply messages with Internet domain name servers.
@@ -295,6 +298,38 @@ The uncompressed name is placed in the buffer indicated by
which is of size
.IR length .
The size of compressed name is returned or \-1 if there was an error.
+.PP
+The external variable
+.B h_errno
+is set whenever an error occurs during resolver operation. The following
+definitions are given in
+.BR <netdb.h> :
+.PP
+.nf
+#define NETDB_INTERNAL -1 /* see errno */
+#define NETDB_SUCCESS 0 /* no problem */
+#define HOST_NOT_FOUND 1 /* Authoritative Answer Host not found */
+#define TRY_AGAIN 2 /* Non-Authoritive not found, or SERVFAIL */
+#define NO_RECOVERY 3 /* Nonrecoverable: FORMERR, REFUSED, NOTIMP */
+#define NO_DATA 4 /* Valid name, no data for requested type */
+.ft R
+.ad
+.fi
+.PP
+The
+.B herror
+function writes a message to the diagnostic output consisting of the string
+parameter
+.BR s ,
+the constant string ": ", and a message corresponding to the value of
+.BR h_errno .
+.PP
+The
+.B hstrerror
+function returns a string which is the message text corresponding to the
+value of the
+.B err
+parameter.
.SH FILES
/etc/resolv.conf see resolver(5)
.SH "SEE ALSO"