NetBSD Problem Report #57832

From www@netbsd.org  Tue Jan  9 22:41:22 2024
Return-Path: <www@netbsd.org>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 268FE1A9238
	for <gnats-bugs@gnats.NetBSD.org>; Tue,  9 Jan 2024 22:41:22 +0000 (UTC)
Message-Id: <20240109224121.287F31A9239@mollari.NetBSD.org>
Date: Tue,  9 Jan 2024 22:41:21 +0000 (UTC)
From: campbell+netbsd@mumble.net
Reply-To: campbell+netbsd@mumble.net
To: gnats-bugs@NetBSD.org
Subject: getnameinfo(3) man page fails to document NI_NUMERICSCOPE
X-Send-Pr-Version: www-1.0

>Number:         57832
>Category:       lib
>Synopsis:       getnameinfo(3) man page fails to document NI_NUMERICSCOPE
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    jkoshy
>State:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Jan 09 22:45:00 +0000 2024
>Closed-Date:    Mon Mar 11 22:21:58 +0000 2024
>Last-Modified:  Mon Mar 11 22:21:58 +0000 2024
>Originator:     Taylor R Campbell
>Release:        current, 10, 9, 8
>Organization:
The NetBSDv6 Foundation
>Environment:
>Description:
POSIX defines a flag NI_NUMERICSCOPE for getnameinfo(3):

   If the flag bit NI_NUMERICSCOPE is set, the numeric form of the scope identifier shall be returned (for example, interface index) instead of its name.  This flag shall be ignored if the sa argument is not an IPv6 address.

   https://pubs.opengroup.org/onlinepubs/9699919799/functions/getnameinfo.html

This is defined in our netdb.h, and a cursory examination of getnameinfo.c turns up code to respect it so it is presumably implemented.

However, it doesn't appear in our getnameinfo(3) man page.
>How-To-Repeat:
man getnameinfo
https://man.NetBSD.org/getnameinfo.3
>Fix:
Yes, please!

>Release-Note:

>Audit-Trail:

Responsible-Changed-From-To: lib-bug-people->jkoshy
Responsible-Changed-By: jkoshy@NetBSD.org
Responsible-Changed-When: Mon, 05 Feb 2024 09:00:59 +0000
Responsible-Changed-Why:
Taking a look.


State-Changed-From-To: open->feedback
State-Changed-By: jkoshy@NetBSD.org
State-Changed-When: Thu, 15 Feb 2024 15:09:45 +0000
State-Changed-Why:
Documented in r1.43 of libc/net/getnameinfo.3.


From: "Joseph Koshy" <jkoshy@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/57832 CVS commit: src/lib/libc/net
Date: Thu, 15 Feb 2024 15:08:24 +0000

 Module Name:	src
 Committed By:	jkoshy
 Date:		Thu Feb 15 15:08:23 UTC 2024

 Modified Files:
 	src/lib/libc/net: getnameinfo.3

 Log Message:
 Document the NI_NUMERICSCOPE flag.

 PR lib/57832


 To generate a diff of this commit:
 cvs rdiff -u -r1.42 -r1.43 src/lib/libc/net/getnameinfo.3

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: feedback->needs-pullups
State-Changed-By: riastradh@NetBSD.org
State-Changed-When: Fri, 23 Feb 2024 02:56:35 +0000
State-Changed-Why:
Thanks!  Needs pullup-10, pullup-9, pullup-8.


State-Changed-From-To: needs-pullups->pending-pullups
State-Changed-By: riastradh@NetBSD.org
State-Changed-When: Fri, 01 Mar 2024 15:12:09 +0000
State-Changed-Why:
pullup-10 #614
pullup-9 #1808
pullup-8 #1941


From: "Martin Husemann" <martin@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/57832 CVS commit: [netbsd-10] src/lib/libc/net
Date: Sun, 10 Mar 2024 18:42:42 +0000

 Module Name:	src
 Committed By:	martin
 Date:		Sun Mar 10 18:42:42 UTC 2024

 Modified Files:
 	src/lib/libc/net [netbsd-10]: getnameinfo.3

 Log Message:
 Pull up following revision(s) (requested by riastradh in ticket #614):

 	lib/libc/net/getnameinfo.3: revision 1.43

 Document the NI_NUMERICSCOPE flag.
 PR lib/57832


 To generate a diff of this commit:
 cvs rdiff -u -r1.42 -r1.42.16.1 src/lib/libc/net/getnameinfo.3

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

From: "Martin Husemann" <martin@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/57832 CVS commit: [netbsd-9] src/lib/libc/net
Date: Sun, 10 Mar 2024 18:44:37 +0000

 Module Name:	src
 Committed By:	martin
 Date:		Sun Mar 10 18:44:37 UTC 2024

 Modified Files:
 	src/lib/libc/net [netbsd-9]: getnameinfo.3

 Log Message:
 Pull up following revision(s) (requested by riastradh in ticket #1808):

 	lib/libc/net/getnameinfo.3: revision 1.43

 Document the NI_NUMERICSCOPE flag.
 PR lib/57832


 To generate a diff of this commit:
 cvs rdiff -u -r1.42 -r1.42.8.1 src/lib/libc/net/getnameinfo.3

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

From: "Martin Husemann" <martin@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/57832 CVS commit: [netbsd-8] src/lib/libc/net
Date: Sun, 10 Mar 2024 18:48:57 +0000

 Module Name:	src
 Committed By:	martin
 Date:		Sun Mar 10 18:48:57 UTC 2024

 Modified Files:
 	src/lib/libc/net [netbsd-8]: getnameinfo.3

 Log Message:
 Pull up following revision(s) (requested by riastradh in ticket #1941):

 	lib/libc/net/getnameinfo.3: revision 1.43

 Document the NI_NUMERICSCOPE flag.
 PR lib/57832


 To generate a diff of this commit:
 cvs rdiff -u -r1.41 -r1.41.18.1 src/lib/libc/net/getnameinfo.3

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: pending-pullups->closed
State-Changed-By: riastradh@NetBSD.org
State-Changed-When: Mon, 11 Mar 2024 22:21:58 +0000
State-Changed-Why:
fixed and pulled up


>Unformatted:

Home	PR Database Search