summaryrefslogtreecommitdiff
path: root/src/lib/libc/net/getnameinfo.3
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--src/lib/libc/net/getnameinfo.337
1 files changed, 33 insertions, 4 deletions
diff --git a/src/lib/libc/net/getnameinfo.3 b/src/lib/libc/net/getnameinfo.3
index 74690d0e41..d73a9a9e55 100644
--- a/src/lib/libc/net/getnameinfo.3
+++ b/src/lib/libc/net/getnameinfo.3
@@ -1,4 +1,5 @@
1.\" $OpenBSD: getnameinfo.3,v 1.6 2000/04/18 03:01:31 aaron Exp $ 1.\" $OpenBSD: getnameinfo.3,v 1.7 2000/06/22 20:29:00 itojun Exp $
2.\" $KAME: getnameinfo.3,v 1.13 2000/06/22 20:25:50 itojun Exp $
2.\" 3.\"
3.\" Copyright (c) 1983, 1987, 1991, 1993 4.\" Copyright (c) 1983, 1987, 1991, 1993
4.\" The Regents of the University of California. All rights reserved. 5.\" The Regents of the University of California. All rights reserved.
@@ -32,7 +33,6 @@
32.\" SUCH DAMAGE. 33.\" SUCH DAMAGE.
33.\" 34.\"
34.\" From: @(#)gethostbyname.3 8.4 (Berkeley) 5/25/95 35.\" From: @(#)gethostbyname.3 8.4 (Berkeley) 5/25/95
35.\" KAME Id: getnameinfo.3,v 1.7 2000/01/17 08:13:04 itojun Exp
36.\" 36.\"
37.Dd May 25, 1995 37.Dd May 25, 1995
38.Dt GETNAMEINFO 3 38.Dt GETNAMEINFO 3
@@ -180,7 +180,7 @@ flags are defined in
180The implementation allows experimental numeric IPv6 address notation with 180The implementation allows experimental numeric IPv6 address notation with
181scope identifier. 181scope identifier.
182IPv6 link-local address will appear as string like 182IPv6 link-local address will appear as string like
183.Dq Li fe80::1@ne0 , 183.Dq Li fe80::1%ne0 ,
184if 184if
185.Dv NI_WITHSCOPEID 185.Dv NI_WITHSCOPEID
186bit is enabled in 186bit is enabled in
@@ -229,6 +229,29 @@ printf("host=%s\\n", hbuf);
229.Sh DIAGNOSTICS 229.Sh DIAGNOSTICS
230The function indicates successful completion by a zero return value; 230The function indicates successful completion by a zero return value;
231a non-zero return value indicates failure. 231a non-zero return value indicates failure.
232Error codes are as below:
233.Bl -tag -width Er
234.It Bq Er EAI_AGAIN
235The name could not be resolved at this time.
236Future attempts may succeed.
237.It Bq Er EAI_BADFLAGS
238The flags had an invalid value.
239.It Bq Er EAI_FAIL
240A non-recoverable error occurred.
241.It Bq Er EAI_FAMILY
242The address family was not recognized or the address length was invalid
243for the specified family.
244.It Bq Er EAI_MEMORY
245There was a memory allocation failure.
246.It Bq Er EAI_NONAME
247The name does not resolve for the supplied parameters.
248.Dv NI_NAMEREQD
249is set and the host's name cannot be located,
250or both nodename and servname were null.
251.It Bq Er EAI_SYSTEM
252A system error occurred.
253The error code can be found in errno.
254.El
232.\" 255.\"
233.Sh SEE ALSO 256.Sh SEE ALSO
234.Xr getaddrinfo 3 , 257.Xr getaddrinfo 3 ,
@@ -253,9 +276,15 @@ a non-zero return value indicates failure.
253.%A Atsushi Onoe 276.%A Atsushi Onoe
254.%T "An Extension of Format for IPv6 Scoped Addresses" 277.%T "An Extension of Format for IPv6 Scoped Addresses"
255.%R internet draft 278.%R internet draft
256.%N draft-ietf-ipngwg-scopedaddr-format-00.txt 279.%N draft-ietf-ipngwg-scopedaddr-format-01.txt
257.%O work in progress material 280.%O work in progress material
258.Re 281.Re
282.Rs
283.%A Craig Metz
284.%T Protocol Independence Using the Sockets API
285.%B "Proceedings of the freenix track: 2000 USENIX annual technical conference"
286.%D June 2000
287.Re
259.\" 288.\"
260.Sh HISTORY 289.Sh HISTORY
261The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit. 290The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit.