diff options
| author | Matthew Dempsky <matthew@cvs.openbsd.org> | 2011-04-05 00:46:07 +0000 |
|---|---|---|
| committer | Matthew Dempsky <matthew@cvs.openbsd.org> | 2011-04-05 00:46:07 +0000 |
| commit | 51ba8d7b1a57078dab71c00043b9ec98fce3e440 (patch) | |
| tree | 7ea65677cafb73a9b2d5932fc266795c85386f28 /lib/libc/net/getaddrinfo.3 | |
| parent | a5eee0f175a227a79e93c57b950864cdbc0e13fa (diff) | |
Add AI_FQDN flag to getaddrinfo(3). Prompted by discussions with djm@
about cert checking in OpenSSH. Man page wording tweaks thanks to
jmc@.
ok henning@, jmc@; positive feedback from djm@, ajacoutat@
Committing now to reuse guenther@'s libc minor bump instead of
cranking it again, as suggested by deraadt@.
Diffstat (limited to 'lib/libc/net/getaddrinfo.3')
| -rw-r--r-- | lib/libc/net/getaddrinfo.3 | 32 |
1 files changed, 29 insertions, 3 deletions
diff --git a/lib/libc/net/getaddrinfo.3 b/lib/libc/net/getaddrinfo.3 index 7250407d659..da6e64683f9 100644 --- a/lib/libc/net/getaddrinfo.3 +++ b/lib/libc/net/getaddrinfo.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: getaddrinfo.3,v 1.47 2009/07/09 10:14:41 eric Exp $ +.\" $OpenBSD: getaddrinfo.3,v 1.48 2011/04/05 00:46:06 matthew Exp $ .\" $KAME: getaddrinfo.3,v 1.36 2005/01/05 03:23:05 itojun Exp $ .\" .\" Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC") @@ -16,7 +16,7 @@ .\" OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR .\" PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: July 9 2009 $ +.Dd $Mdocdate: April 5 2011 $ .Dt GETADDRINFO 3 .Os .Sh NAME @@ -126,11 +126,33 @@ If the bit is set, a successful call to .Fn getaddrinfo will return a NUL-terminated string containing the canonical name -of the specified hostname in the +of the specified host name in the .Fa ai_canonname element of the first .Li addrinfo structure returned. +.It Dv AI_FQDN +If the +.Dv AI_FQDN +bit is set, a successful call to +.Fn getaddrinfo +will return a NUL-terminated string containing the fully qualified domain name +of the specified host name in the +.Fa ai_canonname +element of the first +.Li addrinfo +structure returned. +.Pp +This is different from the +.Dv AI_CANONNAME +bit flag that returns the canonical name registered in DNS, +which may be different from the fully qualified domain name +that the host name resolved to. +Only one of the +.Dv AI_FQDN +and +.Dv AI_CANONNAME +bits can be set. .It Dv AI_NUMERICHOST If the .Dv AI_NUMERICHOST @@ -438,6 +460,10 @@ function is defined by the draft specification and documented in .Dv "RFC 3493" , .Dq Basic Socket Interface Extensions for IPv6 . +.Pp +The +.Dv AI_FQDN +flag bit first appeared in Windows 7. .Sh BUGS The implementation of .Fn getaddrinfo |