[src/trunk]: src/lib/libc/net document AI_NUMERICSERV

[itojun <itojun%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/15936ece44e3
branches:  trunk
changeset: 565593:15936ece44e3
user:      itojun <itojun%NetBSD.org@localhost>
date:      Wed Apr 14 04:42:35 2004 +0000

description:
document AI_NUMERICSERV

diffstat:

 lib/libc/net/getaddrinfo.3 |  33 ++++++++++++++++++++++++++++++---
 1 files changed, 30 insertions(+), 3 deletions(-)

diffs (68 lines):

diff -r 922221090c4e -r 15936ece44e3 lib/libc/net/getaddrinfo.3
--- a/lib/libc/net/getaddrinfo.3        Wed Apr 14 04:37:59 2004 +0000
+++ b/lib/libc/net/getaddrinfo.3        Wed Apr 14 04:42:35 2004 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: getaddrinfo.3,v 1.33 2004/03/01 23:06:21 itojun Exp $
+.\"    $NetBSD: getaddrinfo.3,v 1.34 2004/04/14 04:42:35 itojun Exp $
 .\"    $KAME: getaddrinfo.3,v 1.32 2003/04/30 06:06:42 itojun Exp $
 .\"
 .\" Copyright (c) 1983, 1987, 1991, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"     From: @(#)gethostbyname.3      8.4 (Berkeley) 5/25/95
 .\"
-.Dd May 14, 2002
+.Dd April 14, 2004
 .Dt GETADDRINFO 3
 .Os
 .\"
@@ -70,7 +70,7 @@
 header:
 .Bd -literal -offset
 struct addrinfo {
-     int       ai_flags;     /* AI_PASSIVE, AI_CANONNAME, AI_NUMERICHOST */
+     int       ai_flags;     /* AI_xxx */
      int       ai_family;    /* PF_xxx */
      int       ai_socktype;  /* SOCK_xxx */
      int       ai_protocol;  /* 0 or IPPROTO_xxx for IPv4 and IPv6 */
@@ -265,6 +265,23 @@
 This flag prevents any type of name resolution service (e.g., the DNS)
 from being called.
 .Pp
+If the
+.Dv AI_NUMERICSERV
+bit is set in the
+.Fa ai_flags
+member of the
+.Fa hints
+structure, then a
+.Pf non Dv NULL
+.Fa servname
+string supplied shall be a numeric port string.
+Otherwise, an
+.Dv EAI_NONAME
+error shall be returned.
+This flag shall prevent any
+type of name resolution service (for example, NIS) from being
+invoked.
+.Pp
 The arguments to
 .Fn getaddrinfo
 must sufficiently be consistent and unambiguous.
@@ -575,6 +592,16 @@
 .%D March 1999
 .Re
 .Rs
+.%A R. Gilligan
+.%A S. Thomson
+.%A J. Bound
+.%A J. McCann
+.%A W. Stevens
+.%T Basic Socket Interface Extensions for IPv6
+.%R RFC 3493
+.%D February 2003
+.Re
+.Rs
 .%A Tatsuya Jinmei
 .%A Atsushi Onoe
 .%T "An Extension of Format for IPv6 Scoped Addresses"