summaryrefslogtreecommitdiffstats
path: root/lib/libc/net/resolver.3
diff options
context:
space:
mode:
authordelphij <delphij@FreeBSD.org>2009-05-29 07:55:44 +0000
committerdelphij <delphij@FreeBSD.org>2009-05-29 07:55:44 +0000
commitfb4a68cc3a982243575f41ccff8d3d019133027b (patch)
tree028c44531fafaf81c90fb547e25f8d4a129e80a9 /lib/libc/net/resolver.3
parentdafeb495e62f85e08a23a9536ffd3edd8ac1104e (diff)
downloadFreeBSD-src-fb4a68cc3a982243575f41ccff8d3d019133027b.zip
FreeBSD-src-fb4a68cc3a982243575f41ccff8d3d019133027b.tar.gz
Document how to enable strict RFC 1034 enforcements.
PR: kern/129477
Diffstat (limited to 'lib/libc/net/resolver.3')
-rw-r--r--lib/libc/net/resolver.315
1 files changed, 14 insertions, 1 deletions
diff --git a/lib/libc/net/resolver.3 b/lib/libc/net/resolver.3
index e35a545..c1a37b3 100644
--- a/lib/libc/net/resolver.3
+++ b/lib/libc/net/resolver.3
@@ -28,7 +28,7 @@
.\" @(#)resolver.3 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$
.\"
-.Dd November 4, 2006
+.Dd May 29, 2009
.Dt RESOLVER 3
.Os
.Sh NAME
@@ -401,6 +401,19 @@ function properly if the programmer attempts to declare his or her own
.Va _res
structure in an attempt to replace the per-thread version referred to
by that macro.
+.Pp
+The following compile-time option can be specified to change the default
+behavior of resolver routines when necessary.
+.Bl -tag -width RES_ENFORCE_RFC1034
+.It Dv RES_ENFORCE_RFC1034
+If this symbol is defined during compile-time,
+.Fn res_search
+will enforce RFC 1034 check, namely, disallow using of underscore character
+within host names.
+This is used by the standard host lookup routines like
+.Xr gethostbyname 3 .
+For compatibility reasons this option is not enabled by default.
+.El
.Sh RETURN VALUES
The
.Fn res_init
OpenPOWER on IntegriCloud