Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

add cmetz paper, correct example

Browse Source
This commit is contained in:
itojun 2000-06-22 20:32:28 +00:00
parent 40b277ee3a
commit d18bfb3eba
2 changed files with 43 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
lib/libc/net/getaddrinfo.3
View File

@ -1,5 +1,5 @@
.\" $NetBSD: getaddrinfo.3,v 1.10 2000/05/11 03:08:46 itojun Exp $
.\" $KAME: getaddrinfo.3,v 1.12 2000/05/11 03:02:45 itojun Exp $
.\" $NetBSD: getaddrinfo.3,v 1.11 2000/06/22 20:32:28 itojun Exp $
.\" $KAME: getaddrinfo.3,v 1.14 2000/06/22 20:25:50 itojun Exp $
.\"
.\" Copyright (c) 1983, 1987, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -370,7 +370,7 @@ if (error) {
s = -1;
for (res = res0; res; res = res->ai_next) {
s = socket(res->ai_family, res->ai_socktype,
res->ai_protocol);
res->ai_protocol);
if (s < 0) {
cause = "socket";
continue;
@ -414,7 +414,7 @@ if (error) {
nsock = 0;
for (res = res0; res && nsock < MAXSOCK; res = res->ai_next) {
s[nsock] = socket(res->ai_family, res->ai_socktype,
res->ai_protocol);
res->ai_protocol);
if (s[nsock] < 0) {
cause = "socket";
continue;
@ -521,6 +521,12 @@ indicate an unknown error.
.%N draft-ietf-ipngwg-scopedaddr-format-01.txt
.%O work in progress material
.Re
.Rs
.%A Craig Metz
.%T Protocol Independence Using the Sockets API
.%B "Proceedings of the freenix track: 2000 USENIX annual technical conference"
.%D June 2000
.Re
.\"
.Sh HISTORY
The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit.

37
lib/libc/net/getnameinfo.3
View File

@ -1,5 +1,5 @@
.\" $NetBSD: getnameinfo.3,v 1.8 2000/06/04 08:52:21 itojun Exp $
.\" $KAME: getnameinfo.3,v 1.10 2000/05/11 03:02:45 itojun Exp $
.\" $KAME: getnameinfo.3,v 1.13 2000/06/22 20:25:50 itojun Exp $
.\"
.\" Copyright (c) 1983, 1987, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -105,7 +105,7 @@ or
.Fa servlen
arguments.
Otherwise, the caller must provide buffers large enough to hold the
nodename and the service name, including the terminating null characters.
nodename and the service name, including the terminating null characters.
.Pp
Unfortunately most systems do not provide constants that specify the
maximum size of either a fully-qualified domain name or a service name.
@ -205,7 +205,7 @@ struct sockaddr *sa; /* input */
char hbuf[NI_MAXHOST], sbuf[NI_MAXSERV];
if (getnameinfo(sa, sa->sa_len, hbuf, sizeof(hbuf), sbuf,
sizeof(sbuf), NI_NUMERICHOST | NI_NUMERICSERV)) {
sizeof(sbuf), NI_NUMERICHOST | NI_NUMERICSERV)) {
errx(1, "could not get numeric hostname");
/*NOTREACHED*/
}
@ -218,7 +218,7 @@ struct sockaddr *sa; /* input */
char hbuf[NI_MAXHOST];
if (getnameinfo(sa, sa->sa_len, hbuf, sizeof(hbuf), NULL, 0,
NI_NAMEREQD)) {
NI_NAMEREQD)) {
errx(1, "could not resolve hostname");
/*NOTREACHED*/
}
@ -235,6 +235,29 @@ printf("host=%s\\n", hbuf);
.Sh DIAGNOSTICS
The function indicates successful completion by a zero return value;
a non-zero return value indicates failure.
Error codes are as below:
.Bl -tag -width Er
.It Bq Er EAI_AGAIN
The name could not be resolved at this time.
Future attempts may succeed.
.It Bq Er EAI_BADFLAGS
The flags had an invalid value.
.It Bq Er EAI_FAIL
A non-recoverable error occurred.
.It Bq Er EAI_FAMILY
The address family was not recognized or the address length was invalid
for the specified family.
.It Bq Er EAI_MEMORY
There was a memory allocation failure.
.It Bq Er EAI_NONAME
The name does not resolve for the supplied parameters.
.Dv NI_NAMEREQD
is set and the host's name cannot be located,
or both nodename and servname were null.
.It Bq Er EAI_SYSTEM
A system error occurred.
The error code can be found in errno.
.El
.\"
.Sh SEE ALSO
.Xr getaddrinfo 3 ,
@ -262,6 +285,12 @@ a non-zero return value indicates failure.
.%N draft-ietf-ipngwg-scopedaddr-format-01.txt
.%O work in progress material
.Re
.Rs
.%A Craig Metz
.%T Protocol Independence Using the Sockets API
.%B "Proceedings of the freenix track: 2000 USENIX annual technical conference"
.%D June 2000
.Re
.\"
.Sh HISTORY
The implementation first appeared in WIDE Hydrangea IPv6 protocol stack kit.