diff options
| author | Michael Kerrisk <mtk.manpages@gmail.com> | 2015-05-11 11:11:21 +0200 |
|---|---|---|
| committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2015-05-11 11:11:21 +0200 |
| commit | 0b8a39ad9f63b1959ae097dce02ed75d44bee01b (patch) | |
| tree | 90f0f9a25c3f10f3168dab7d970420e0e1856e2d | |
| parent | 7f325581588b753add72e0466071bd8b782c3093 (diff) | |
| download | man-pages-0b8a39ad9f63b1959ae097dce02ed75d44bee01b.tar.gz | |
gethostbyname.3: Remove mention of IPv6 addresses, which are not supported
As reported by Laszlo Ersek:
gethostbyname(3) fails to resolve the IPv6 address "::1",
but the manual page says: "If name is an IPv4 or IPv6 address,
no lookup is performed and gethostbyname() simply copies name
into the h_name field [...]".
Debian bug report:
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=455762
glibc bug report:
http://sourceware.org/bugzilla/show_bug.cgi?id=5479
SUSv3 link for gethostbyname(3):
http://www.opengroup.org/onlinepubs/000095399/functions/gethostbyname.html
It seems that the glibc behavior is conformant, and the manual
page is in error.
Reported-by: Laszlo Ersek <lacos@caesar.elte.hu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
| -rw-r--r-- | man3/gethostbyname.3 | 8 |
1 files changed, 3 insertions, 5 deletions
diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index e0b94b0501..d79eb3222a 100644 --- a/man3/gethostbyname.3 +++ b/man3/gethostbyname.3 @@ -149,13 +149,11 @@ for the given host .IR name . Here .I name -is either a hostname, or an IPv4 address in standard dot notation (as for -.BR inet_addr (3)), -or an IPv6 address in colon (and possibly dot) notation. -(See RFC\ 1884 for the description of IPv6 addresses.) +is either a hostname or an IPv4 address in standard dot notation (as for +.BR inet_addr (3)). If .I name -is an IPv4 or IPv6 address, no lookup is performed and +is an IPv4 address, no lookup is performed and .BR gethostbyname () simply copies .I name |