| resolver.3 (165903) | resolver.3 (193024) |
|---|---|
| 1.\" Copyright (c) 1985, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 12 unchanged lines hidden (view full) --- 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" 28.\" @(#)resolver.3 8.1 (Berkeley) 6/4/93 | 1.\" Copyright (c) 1985, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 12 unchanged lines hidden (view full) --- 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" 28.\" @(#)resolver.3 8.1 (Berkeley) 6/4/93 |
| 29.\" $FreeBSD: head/lib/libc/net/resolver.3 165903 2007-01-09 00:28:16Z imp $ | 29.\" $FreeBSD: head/lib/libc/net/resolver.3 193024 2009-05-29 07:55:44Z delphij $ |
| 30.\" | 30.\" |
| 31.Dd November 4, 2006 | 31.Dd May 29, 2009 |
| 32.Dt RESOLVER 3 33.Os 34.Sh NAME 35.Nm res_query , 36.Nm res_search , 37.Nm res_mkquery , 38.Nm res_send , 39.Nm res_init , --- 356 unchanged lines hidden (view full) --- 396to a buffer pointed to by 397.Fa dst . 398.Sh IMPLEMENTATION NOTES 399This implementation of the resolver is thread-safe, but it will not 400function properly if the programmer attempts to declare his or her own 401.Va _res 402structure in an attempt to replace the per-thread version referred to 403by that macro. | 32.Dt RESOLVER 3 33.Os 34.Sh NAME 35.Nm res_query , 36.Nm res_search , 37.Nm res_mkquery , 38.Nm res_send , 39.Nm res_init , --- 356 unchanged lines hidden (view full) --- 396to a buffer pointed to by 397.Fa dst . 398.Sh IMPLEMENTATION NOTES 399This implementation of the resolver is thread-safe, but it will not 400function properly if the programmer attempts to declare his or her own 401.Va _res 402structure in an attempt to replace the per-thread version referred to 403by that macro. |
| 404.Pp 405The following compile-time option can be specified to change the default 406behavior of resolver routines when necessary. 407.Bl -tag -width RES_ENFORCE_RFC1034 408.It Dv RES_ENFORCE_RFC1034 409If this symbol is defined during compile-time, 410.Fn res_search 411will enforce RFC 1034 check, namely, disallow using of underscore character 412within host names. 413This is used by the standard host lookup routines like 414.Xr gethostbyname 3 . 415For compatibility reasons this option is not enabled by default. 416.El |
|
| 404.Sh RETURN VALUES 405The 406.Fn res_init 407function will return 0 on success, or \-1 in a threaded program if 408per-thread storage could not be allocated. 409.Pp 410The 411.Fn res_mkquery , --- 37 unchanged lines hidden --- | 417.Sh RETURN VALUES 418The 419.Fn res_init 420function will return 0 on success, or \-1 in a threaded program if 421per-thread storage could not be allocated. 422.Pp 423The 424.Fn res_mkquery , --- 37 unchanged lines hidden --- |