diff options
author | bms <bms@FreeBSD.org> | 2007-02-28 21:28:33 +0000 |
---|---|---|
committer | bms <bms@FreeBSD.org> | 2007-02-28 21:28:33 +0000 |
commit | 9dc2491bfede858913115a26217b4bfca8cd9d43 (patch) | |
tree | 1c495d578acf306cb2b6f0bf1737be4bb441eb5d | |
parent | 0738a9d791c7cf11ec35c5f1b495c0530c978447 (diff) | |
download | FreeBSD-src-9dc2491bfede858913115a26217b4bfca8cd9d43.zip FreeBSD-src-9dc2491bfede858913115a26217b4bfca8cd9d43.tar.gz |
Document the AF_LINK extension which was imported from NetBSD.
-rw-r--r-- | lib/libc/net/getnameinfo.3 | 23 |
1 files changed, 19 insertions, 4 deletions
diff --git a/lib/libc/net/getnameinfo.3 b/lib/libc/net/getnameinfo.3 index 61479cf..e9d17ff 100644 --- a/lib/libc/net/getnameinfo.3 +++ b/lib/libc/net/getnameinfo.3 @@ -18,7 +18,7 @@ .\" .\" $FreeBSD$ .\" -.Dd December 20, 2004 +.Dd February 28, 2007 .Dt GETNAMEINFO 3 .Os .Sh NAME @@ -47,15 +47,29 @@ functions and is the converse of the .Xr getaddrinfo 3 function. .Pp +If a link-layer address is passed to +.Fn getnameinfo , +its ASCII representation will be stored in +.Fa host . +The string pointed to by +.Fa serv +will be set to the empty string if non-NULL; +.Fa flags +will always be ignored. +This is intended as a replacement for the legacy +.Xr link_ntoa 3 +function. +.Pp The .Li sockaddr structure .Fa sa should point to either a -.Li sockaddr_in -or +.Li sockaddr_in , .Li sockaddr_in6 -structure (for IPv4 or IPv6 respectively) that is +or +.Li sockaddr_dl +structure (for IPv4, IPv6 or link-layer respectively) that is .Fa salen bytes long. .Pp @@ -166,6 +180,7 @@ printf("host=%s\en", hbuf); .Xr gethostbyaddr 3 , .Xr getservbyport 3 , .Xr inet_ntop 3 , +.Xr link_ntoa 3 , .Xr resolver 3 , .Xr hosts 5 , .Xr resolv.conf 5 , |