1
0
mirror of https://git.FreeBSD.org/src.git synced 2025-01-23 16:01:42 +00:00

Document how to enable strict RFC 1034 enforcements.

PR:		kern/129477
This commit is contained in:
Xin LI 2009-05-29 07:55:44 +00:00
parent a28076c8f7
commit 5512745e3a
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=193024

View File

@ -28,7 +28,7 @@
.\" @(#)resolver.3 8.1 (Berkeley) 6/4/93 .\" @(#)resolver.3 8.1 (Berkeley) 6/4/93
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd November 4, 2006 .Dd May 29, 2009
.Dt RESOLVER 3 .Dt RESOLVER 3
.Os .Os
.Sh NAME .Sh NAME
@ -401,6 +401,19 @@ function properly if the programmer attempts to declare his or her own
.Va _res .Va _res
structure in an attempt to replace the per-thread version referred to structure in an attempt to replace the per-thread version referred to
by that macro. 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 .Sh RETURN VALUES
The The
.Fn res_init .Fn res_init