NetBSD Problem Report #58903

From www@netbsd.org  Sat Dec 14 00:02:47 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)
	 key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256
	 client-signature RSA-PSS (2048 bits) client-digest SHA256)
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 79DB91A923C
	for <gnats-bugs@gnats.NetBSD.org>; Sat, 14 Dec 2024 00:02:47 +0000 (UTC)
Message-Id: <20241214000245.960411A923D@mollari.NetBSD.org>
Date: Sat, 14 Dec 2024 00:02:45 +0000 (UTC)
From: als@thangorodrim.ch
Reply-To: als@thangorodrim.ch
To: gnats-bugs@NetBSD.org
Subject: missing man page for pyro driver on sparc64
X-Send-Pr-Version: www-1.0

>Number:         58903
>Category:       port-sparc64
>Synopsis:       missing man page for pyro driver on sparc64
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    port-sparc64-maintainer
>State:          feedback
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Dec 14 00:05:00 +0000 2024
>Closed-Date:    
>Last-Modified:  Mon Dec 16 15:35:01 +0000 2024
>Originator:     Alexander Schreiber
>Release:        NetBSD 10.0
>Organization:
not much
>Environment:
NetBSD [hostname redacted] 10.0 NetBSD 10.0 (GENERIC) #0: Fri Dec 13 12:47:00 UTC 2024  root@[hostname redacted]:/usr/obj/sys/arch/sparc64/compile/GENERIC sparc64

>Description:
This machine has the pyro driver active, from dmesg:

[     1.000000] mainbus0 (root): SUNW,A70 (Sun Ultra 45 Workstation): hostid [redacted]
[     1.000000] pyro0 at mainbus0: "Fire", rev 3, ign 780, bus A 2 to 12
[     1.000000] pyro0: pci0 at pyro0
[     1.000000] pyro1 at mainbus0: "Fire", rev 3, ign 7c0, bus B 2 to 255
[     1.000000] pyro1: pci11 at pyro1


However, NetBSD does not appear to have documentation for it:

man pyro
man: no entry for pyro in the manual.

apropos pyro
apropos: No relevant results obtained.
Please make sure that you spelled all the terms correctly or try using different keywords.

and /usr/src/sys/arch/sparc64/dev/pyro.c is impressively mum on comments what this thing is for.

OpenBSD has a (very, very short) man page for it:

https://man.openbsd.org/pyro

Quoting it: "The pyro device provides support for the Fire and Oberon pci(4) bus, as found on UltraSPARC III based sparc64 systems. It supports the ioctl(2) interface in pci(4)."


>How-To-Repeat:
man pyro -> no results
>Fix:
It would be appreciated if /usr/src/sys/arch/sparc64/dev/pyro.c actually explained what the driver is for, as well as having the man page for it (even if we just nick the OpenBSD one)


>Release-Note:

>Audit-Trail:
From: "matthew green" <mrg@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/58903 CVS commit: src/share/man/man4/man4.sparc64
Date: Sun, 15 Dec 2024 09:22:19 +0000

 Module Name:	src
 Committed By:	mrg
 Date:		Sun Dec 15 09:22:19 UTC 2024

 Added Files:
 	src/share/man/man4/man4.sparc64: pyro.4

 Log Message:
 add pyro(4) manual, as requested in PR#58903.


 To generate a diff of this commit:
 cvs rdiff -u -r0 -r1.1 src/share/man/man4/man4.sparc64/pyro.4

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

From: Alexander Schreiber <als@thangorodrim.ch>
To: gnats-bugs@netbsd.org
Cc: 
Subject: Re: port-sparc64/58903: missing man page for pyro driver on sparc64
Date: Sun, 15 Dec 2024 15:38:43 +0100

 Disregard my last update, I mixed up my PR numbers. Sorry for the noise
 and thanks to Matthew Green for the patch.

From: "matthew green" <mrg@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc: 
Subject: PR/58903 CVS commit: src
Date: Sun, 15 Dec 2024 20:57:47 +0000

 Module Name:	src
 Committed By:	mrg
 Date:		Sun Dec 15 20:57:47 UTC 2024

 Modified Files:
 	src/distrib/sets/lists/man: mi
 	src/distrib/sets/lists/manhtml: mi
 	src/share/man/man4/man4.sparc64: Makefile

 Log Message:
 install new pryo(4) manual, as requested in PR#58903.


 To generate a diff of this commit:
 cvs rdiff -u -r1.1791 -r1.1792 src/distrib/sets/lists/man/mi
 cvs rdiff -u -r1.13 -r1.14 src/distrib/sets/lists/manhtml/mi
 cvs rdiff -u -r1.8 -r1.9 src/share/man/man4/man4.sparc64/Makefile

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

State-Changed-From-To: open->feedback
State-Changed-By: mrg@NetBSD.org
State-Changed-When: Sun, 15 Dec 2024 22:51:07 +0000
State-Changed-Why:
fixed in -current, do you want this in -10?  thakns.


From: Alexander Schreiber <als@thangorodrim.ch>
To: gnats-bugs@netbsd.org
Cc: port-sparc64-maintainer@netbsd.org, netbsd-bugs@netbsd.org,
	gnats-admin@netbsd.org, mrg@netbsd.org
Subject: Re: port-sparc64/58903 (missing man page for pyro driver on sparc64)
Date: Mon, 16 Dec 2024 16:19:25 +0100

 On Sun, Dec 15, 2024 at 10:51:07PM +0000, mrg@NetBSD.org wrote:
 > Synopsis: missing man page for pyro driver on sparc64
 > 
 > fixed in -current, do you want this in -10?  thakns.

 Thanks for the fix and having it in -10 would be nice.

>Unformatted:

Home	PR Database Search