[Bug 52741] New: getnameinfo man page has inappropriate text copied from getaddrinfo

[Bug 52741] New: getnameinfo man page has inappropriate text copied from getaddrinfo

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

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/vQLgFONoPN62D2FQJk+8+b@public.gmane.org
        ReportedBy: bigpeteb-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org
        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.

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Bug 52741] getnameinfo man page has inappropriate text copied from getaddrinfo

[bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r]

https://bugzilla.kernel.org/show_bug.cgi?id=52741


Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
                 CC|                            |mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org
         Resolution|                            |CODE_FIX




--- Comment #1 from Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@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() and
getaddrinfo(). I applied the following patch.

--- a/man3/getaddrinfo.3
+++ b/man3/getaddrinfo.3
@@ -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.
diff --git a/man3/getnameinfo.3 b/man3/getnameinfo.3
index f1001cd..5bafd76 100644
--- a/man3/getnameinfo.3
+++ b/man3/getnameinfo.3
@@ -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 ()

-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [Bug 52741] getnameinfo man page has inappropriate text copied from getaddrinfo

[David Prévot]

[-- Attachment #1: Type: text/plain, Size: 790 bytes --]

Le 15/01/2013 15:46,
bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r@public.gmane.org a écrit :
> https://bugzilla.kernel.org/show_bug.cgi?id=52741

> --- Comment #1 from Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@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() and
> getaddrinfo(). I applied the following patch.
> 
> --- a/man3/getaddrinfo.3
> +++ b/man3/getaddrinfo.3
> @@ -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



[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 836 bytes --]

Re: [Bug 52741] getnameinfo man page has inappropriate text copied from getaddrinfo

[Michael Kerrisk (man-pages)]

On Fri, Jan 25, 2013 at 9:13 PM, David Prévot <taffit-8fiUuRrzOP0dnm+yROfE0A@public.gmane.org> wrote:
> Le 15/01/2013 15:46,
> bugzilla-daemon-590EEB7GvNiWaY/ihj7yzEB+6BGkLq7r@public.gmane.org a écrit :
>> 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() and
>> getaddrinfo(). I applied the following patch.
>>
>> --- a/man3/getaddrinfo.3
>> +++ b/man3/getaddrinfo.3
>> @@ -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


-- 
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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html