From nobody Thu Nov 6 03:57:48 2025 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4d27h51RG8z6Flkb; Thu, 06 Nov 2025 03:57:57 +0000 (UTC) (envelope-from ziaee@FreeBSD.org) Received: from mailtransmit04.runbox.com (mailtransmit04.runbox.com [IPv6:2a0c:5a00:149::25]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (prime256v1) server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 4d27h46GrDz40L6; Thu, 06 Nov 2025 03:57:56 +0000 (UTC) (envelope-from ziaee@FreeBSD.org) Authentication-Results: mx1.freebsd.org; none Received: from mailtransmit02.runbox ([10.9.9.162] helo=aibo.runbox.com) by mailtransmit04.runbox.com with esmtps (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.93) (envelope-from ) id 1vGr89-0093VA-0e; Thu, 06 Nov 2025 04:57:49 +0100 Received: from [10.9.9.129] (helo=rmmprod07.runbox) by mailtransmit02.runbox with esmtp (Exim 4.86_2) (envelope-from ) id 1vGr88-0002Cd-Kn; Thu, 06 Nov 2025 04:57:48 +0100 Received: from mail by rmmprod07.runbox with local (Exim 4.86_2) (envelope-from ) id 1vGr88-0006WK-JG; Thu, 06 Nov 2025 04:57:48 +0100 Content-Type: text/plain; charset="utf-8" Content-Disposition: inline Content-Transfer-Encoding: quoted-printable List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Received: from [Authenticated alias (960477)] by runbox.com with http (RMM6); Thu, 06 Nov 2025 03:57:48 GMT From: "Alexander Ziaee" To: "John Baldwin" , "doc-committers" , "dev-commits-doc-all" Subject: Re: git: ff18000da3 - main - HW Relnotes: Add nvd to template Date: Thu, 06 Nov 2025 03:57:48 +0000 (UTC) X-RMM-Aliasid: 960477 X-Mailer: RMM6 In-Reply-To: <1e57a02e-bf86-44cc-abc7-c788c1d35a28@FreeBSD.org> Message-Id: X-Spamd-Bar: ---- X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; ASN(0.00)[asn:50304, ipnet:2a0c:5a00::/29, country:NO] X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated X-Rspamd-Queue-Id: 4d27h46GrDz40L6 On 2025-11-05 22:10 -05:00 EST, "John Baldwin" 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=3Dff18000da31f4135af522f4= 3beb4d0877b024fea >> > commit ff18000da31f4135af522f43beb4d0877b024fea >> Author: Alexander Ziaee >> AuthorDate: 2025-11-05 23:07:39 +0000 >> Commit: Alexander Ziaee >> 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/archet= ypes/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; >=20 > Hmm, it's not clear to me that nda/nvd are really hardware devices so muc= h as software > drivers layered on top of a hardware abstraction (NVMe namespaces). We w= ouldn'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 a= re interested > in is which pieces of hardware will work, not necessarily the software ab= stractions we > layer on top of them. >=20 > Similarly, you wouldn't list mfid(4) for the logical RAID volumes on an m= fi(4) controller, > just that we support mfi(4) controllers. The fact that you can access th= e 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 s= howed ahci bridges and raid controllers. As a normal, non-swe technician, I'm comfortable with going down to microce= nter and opening my laptop, but I don't really know what a software abstrac= tion layered on top of a hardware driver is. I want to go to microcenter an= d buy an nvme drive for my laptop. I know it doesn't have a raid card, and = I know ahci is some old stuff that isn't what I want. Is it supported? Because I heard that BSD is several years behind in hardwa= re support and doesn't really have stuff like USB4 or suspend. That is why these lines are a value add to this document. Best, Alex=