New: getnameinfo man page has inappropriate text copied from getaddrinfo
https://bugzilla.kernel.org/show_bug.cgi?id=52741
Summary: getnameinfo man page has inappropriate text copied
from getaddrinfo
Product: Documentation
Version: unspecified
Platform: All
OS/Version: Linux
Tree: Mainline
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
AssignedTo: documentation_man-pages-ztI5WcYan/[email protected]
ReportedBy: [email protected]
Regression: No
As of release 3.43 on 2012-08-05, the man page for getnameinfo(3) contains the following in its first paragraph:
"It combines the functionality of gethostbyaddr(3) and getservbyport(3), but unlike those functions, getaddrinfo(3) is reentrant and allows programs to eliminate IPv4-versus-IPv6 dependencies."
This text is identical to what's in getaddrinfo(3). It seems someone copied it but didn't rewrite it to describe the functions that getnameinfo(3) is intended to replace.
Signature · 7 lines
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
A message that is not in the archive (sent off-list or not yet received): bug-52741-11311-3bo0kxnWaOQUvHkbgXJLS5sdmw4N0Rt+2LY78lusg7I@public.gmane.org/
[Bug 52741] getnameinfo man page has inappropriate text copied from getaddrinfo
https://bugzilla.kernel.org/show_bug.cgi?id=52741
Michael Kerrisk <[email protected]> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |RESOLVED
CC| |[email protected]
Resolution| |CODE_FIX--- Comment #1 from Michael Kerrisk <[email protected]> 2013-01-15 19:46:01 --- Thkanks for the report Peter.
So, it seems here were a confused references in both getnameinfo() and getaddrinfo(). I applied the following patch.
man3/getaddrinfo.3 +1 -1
@@ -91,7 +91,7 @@ function combines the functionality provided by the .\" .BR getipnodebyaddr (3), .BR getservbyname (3) and -.BR getservbyport (3) +.BR getservbyname (3) functions into a single interface, but unlike the latter functions, .BR getaddrinfo () is reentrant and allows programs to eliminate IPv4-versus-IPv6 dependencies.
man3/getnameinfo.3 +2 -2
@@ -38,7 +38,7 @@ It combines the functionality of and .BR getservbyport (3), but unlike those functions, -.BR getaddrinfo (3) +.BR getnameinfo (3) is reentrant and allows programs to eliminate IPv4-versus-IPv6 dependencies.
@@ -111,7 +111,7 @@ cannot be determined.) If set, then the numeric form of the service address is returned. (When not set, this will still happen in case the service's name cannot be determined.) -.SS "Extensions to getaddrinfo() for Internationalized Domain Names" +.SS "Extensions to getnameinfo() for Internationalized Domain Names" .PP Starting with glibc 2.3.4, .BR getnameinfo ()
Signature · 7 lines
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email ------- You are receiving this mail because: ------- You are watching the assignee of the bug. -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html
A message that is not in the archive (sent off-list or not yet received): 20130115194601.9BFD311FB6C-590EEB7GvNiWaY/[email protected]
Re: [Bug 52741] getnameinfo man page has inappropriate text copied from getaddrinfo
Quoted 11 lines · Le 15/01/2013 15:46, bugzilla-daemon-590EEB7GvNiWaY/[email protected]…
https://bugzilla.kernel.org/show_bug.cgi?id=52741
--- Comment #1 from Michael Kerrisk <[email protected]> 2013-01-15 19:46:01 --- Thkanks for the report Peter.
So, it seems here were a confused references in both
getnameinfo()andgetaddrinfo(). I applied the following patch.
man3/getaddrinfo.3 function combines the functionality provided by the · line 94
Quoted 5 lines
man3/getaddrinfo.3 +1
-1@@ -91,7 +91,7 @@ function combines the functionality provided by the .\" .BR getipnodebyaddr (3), .BR getservbyname (3) and -.BR getservbyport (3) +.BR getservbyname (3)
That change doesn't seem right (duplicating the getservbyname(3) reference).
Regards
David
Re: [Bug 52741] getnameinfo man page has inappropriate text copied from getaddrinfo
Quoted 10 lines · David Prévot
Quoted 8 lines · Le 15/01/2013 15:46, bugzilla-daemon-590EEB7GvNiWaY/[email protected]…
https://bugzilla.kernel.org/show_bug.cgi?id=52741
--- Comment #1 from Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w-XMD5yJDbdMReXY1tMh2IBg@public.gmane.org> 2013-01-15 19:46:01 --- Thkanks for the report Peter.
So, it seems here were a confused references in both
getnameinfo()andgetaddrinfo(). I applied the following patch.
Quoted 10 lines
man3/getaddrinfo.3 function combines the functionality provided by the · line 94
Quoted 8 lines
man3/getaddrinfo.3 +1
-1@@ -91,7 +91,7 @@ function combines the functionality provided by the .\" .BR getipnodebyaddr (3), .BR getservbyname (3) and -.BR getservbyport (3) +.BR getservbyname (3)That change doesn't seem right (duplicating the getservbyname(3) reference).
Thanks, David.
It should of course have been "gethostbyname(3) and getservbyname(3)". Fixed now.
Cheers,
Michael
Signature · 7 lines
Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Author of "The Linux Programming Interface"; http://man7.org/tlpi/ -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html