Date: Wed, 5 Nov 2025 20:46:12 -0800 From: John Baldwin <jhb@FreeBSD.org> To: Alexander Ziaee <ziaee@FreeBSD.org>, doc-committers <doc-committers@FreeBSD.org>, dev-commits-doc-all <dev-commits-doc-all@FreeBSD.org> Subject: Re: git: ff18000da3 - main - HW Relnotes: Add nvd to template Message-ID: <5fcf75df-603e-4a76-82c0-3934406316fc@FreeBSD.org> In-Reply-To: <E1vGr88-0006WK-JG@rmmprod07.runbox>
index | next in thread | previous in thread | raw e-mail
On 11/5/25 22:57, Alexander Ziaee wrote: > On 2025-11-05 22:10 -05:00 EST, "John Baldwin" <jhb@FreeBSD.org> wrote: >> On 11/5/25 18:08, Alexander Ziaee wrote: >>> The branch main has been updated by ziaee: >>>> URL: https://cgit.FreeBSD.org/doc/commit/?id=ff18000da31f4135af522f43beb4d0877b024fea >>>> commit ff18000da31f4135af522f43beb4d0877b024fea >>> Author: Alexander Ziaee <ziaee@FreeBSD.org> >>> AuthorDate: 2025-11-05 23:07:39 +0000 >>> Commit: Alexander Ziaee <ziaee@FreeBSD.org> >>> CommitDate: 2025-11-05 23:07:39 +0000 >>>> HW Relnotes: Add nvd to template >>> --- >>> website/archetypes/release/hardware.adoc | 2 ++ >>> 1 file changed, 2 insertions(+) >>>> diff --git a/website/archetypes/release/hardware.adoc b/website/archetypes/release/hardware.adoc >>> index 0a9026c2fd..304641abd1 100644 >>> --- a/website/archetypes/release/hardware.adoc >>> +++ b/website/archetypes/release/hardware.adoc >>> @@ -312,6 +312,8 @@ EISA adapters are not supported. >>> > &hwlist.nda; >>> > +&hwlist.nvd; >>> + >>> &hwlist.ocs_fc; >> >> Hmm, it's not clear to me that nda/nvd are really hardware devices so much as software >> drivers layered on top of a hardware abstraction (NVMe namespaces). We wouldn't list >> vlan(4) support as a distinct hardware feature in a list of NIC devices, and I feel >> like listing da(4) or pass(4) or nda(4) or nvd(4) is similar to vlan(4). In particular, >> you can't hold an nda(4) or vlan(4) (or wlan(4)) in your hand the way you can hold an >> M.2 NVMe device, or a NIC. I think for the hardware notes, what people are interested >> in is which pieces of hardware will work, not necessarily the software abstractions we >> layer on top of them. >> >> Similarly, you wouldn't list mfid(4) for the logical RAID volumes on an mfi(4) controller, >> just that we support mfi(4) controllers. The fact that you can access the RAID volumes >> exported by such a controller is implied by supporting the controller. > > Well, yes, but before I added these, searching the page for a "nvme" only showed ahci bridges and raid controllers. I think that means we need a suitable section in nvme.4 so we can use &hwlist.nvme then? Having both nvd and nda listed back to back seems a bit redundant vs having a good description for nvme(4) that says it supports PCIe NVMe devices I think? -- John Baldwinhome | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?5fcf75df-603e-4a76-82c0-3934406316fc>