summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJason McIntyre <jmc@cvs.openbsd.org>2005-01-22 15:44:26 +0000
committerJason McIntyre <jmc@cvs.openbsd.org>2005-01-22 15:44:26 +0000
commitc05443485efd8bc4492936a0ca47043a219ffabb (patch)
treeb6bd3ea63227c06807d87b0dde421907ac9b9076
parent6984dc8896fe502097fb0a2b82436490ab6742c8 (diff)
some fixes from netbsd, plus a few of my own;
ok krw@
-rw-r--r--lib/libc/net/resolver.356
1 files changed, 31 insertions, 25 deletions
diff --git a/lib/libc/net/resolver.3 b/lib/libc/net/resolver.3
index 577420e9f1a..ac48252e833 100644
--- a/lib/libc/net/resolver.3
+++ b/lib/libc/net/resolver.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: resolver.3,v 1.17 2003/08/08 09:26:02 jmc Exp $
+.\" $OpenBSD: resolver.3,v 1.18 2005/01/22 15:44:25 jmc Exp $
.\"
.\" Copyright (c) 1985, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -46,7 +46,7 @@
.Fd #include <resolv.h>
.Ft int
.Fo res_query
-.Fa "char *dname"
+.Fa "const char *dname"
.Fa "int class"
.Fa "int type"
.Fa "u_char *answer"
@@ -54,7 +54,7 @@
.Fc
.Ft int
.Fo res_search
-.Fa "char *dname"
+.Fa "const char *dname"
.Fa "int class"
.Fa "int type"
.Fa "u_char *answer"
@@ -63,38 +63,38 @@
.Ft int
.Fo res_mkquery
.Fa "int op"
-.Fa "char *dname"
+.Fa "const char *dname"
.Fa "int class"
.Fa "int type"
-.Fa "char *data"
+.Fa "const u_char *data"
.Fa "int datalen"
-.Fa "struct rrec *newrr"
-.Fa "char *buf"
+.Fa "const u_char *newrr"
+.Fa "u_char *buf"
.Fa "int buflen"
.Fc
.Ft int
.Fo res_send
-.Fa "char *msg"
+.Fa "const u_char *msg"
.Fa "int msglen"
-.Fa "char *answer"
+.Fa "u_char *answer"
.Fa "int anslen"
.Fc
.Ft int
.Fn res_init "void"
.Ft int
.Fo dn_comp
-.Fa "char *exp_dn"
-.Fa "char *comp_dn"
+.Fa "const char *exp_dn"
+.Fa "u_char *comp_dn"
.Fa "int length"
-.Fa "char **dnptrs"
-.Fa "char **lastdnptr"
+.Fa "u_char **dnptrs"
+.Fa "u_char **lastdnptr"
.Fc
.Ft int
.Fo dn_expand
-.Fa "u_char *msg"
-.Fa "u_char *eomorig"
-.Fa "u_char *comp_dn"
-.Fa "u_char *exp_dn"
+.Fa "const u_char *msg"
+.Fa "const u_char *eomorig"
+.Fa "const u_char *comp_dn"
+.Fa "char *exp_dn"
.Fa "int length"
.Fc
.Sh DESCRIPTION
@@ -171,6 +171,14 @@ This causes IPv4 addresses to be returned as an IPv4 mapped address.
For example, 10.1.1.1 will be returned as ::ffff:10.1.1.1.
The option is not meaningful on
.Ox .
+.It Dv RES_USE_EDNS0
+Enables support for OPT pseudo-RR for EDNS0 extension.
+With this option, resolver code will attach OPT pseudo-RR into DNS queries,
+to inform of our receive buffer size.
+The option will allow DNS servers to take advantage of non-default receive
+buffer size, and to send larger replies.
+DNS query packets with EDNS0 extension is not compatible with
+non-EDNS0 DNS servers.
.El
.Pp
The
@@ -303,7 +311,7 @@ The
.Fn dn_expand
entry expands the compressed domain name
.Fa comp_dn
-to a full domain name
+to a full domain name.
The compressed name is contained in a query or reply message;
.Fa msg
is a pointer to the beginning of the message.
@@ -313,11 +321,9 @@ which is of size
.Fa length .
The size of compressed name is returned or \-1 if there was an error.
.Sh FILES
-.Bl -tag -width Pa
-/etc/resolv.conf
-configuration file
-see
-.Xr resolv.conf 5 .
+.Bl -tag -width "/etc/resolv.confXX"
+.It Pa /etc/resolv.conf
+The configuration file.
.El
.Sh SEE ALSO
.Xr gethostbyname 3 ,
@@ -325,12 +331,12 @@ see
.Xr hostname 7 ,
.Xr named 8
.Pp
+.%T RFC 974 ,
.%T RFC 1032 ,
.%T RFC 1033 ,
.%T RFC 1034 ,
.%T RFC 1035 ,
-.%T RFC 1535 ,
-.%T RFC 974
+.%T RFC 1535
.Rs
.%T "Name Server Operations Guide for BIND"
.Re