From nobody Mon Jun 2 21:09:38 2025 X-Original-To: dev-commits-src-main@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 4bB6130ZHyz5xPLj for ; Mon, 02 Jun 2025 21:09:43 +0000 (UTC) (envelope-from ziaee@FreeBSD.org) Received: from mailtransmit05.runbox.com (mailtransmit05.runbox.com [IPv6:2a0c:5a00:149::26]) (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 4bB6124zLpz3WY0; Mon, 02 Jun 2025 21:09:42 +0000 (UTC) (envelope-from ziaee@FreeBSD.org) Authentication-Results: mx1.freebsd.org; none Received: from mailtransmit03.runbox ([10.9.9.163] helo=aibo.runbox.com) by mailtransmit05.runbox.com with esmtps (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 (Exim 4.93) (envelope-from ) id 1uMCPb-003BRU-0g; Mon, 02 Jun 2025 23:09:39 +0200 Received: from [10.9.9.127] (helo=rmmprod05.runbox) by mailtransmit03.runbox with esmtp (Exim 4.86_2) (envelope-from ) id 1uMCPa-0008O2-3U; Mon, 02 Jun 2025 23:09:38 +0200 Received: from mail by rmmprod05.runbox with local (Exim 4.86_2) (envelope-from ) id 1uMCPa-0001zo-27; Mon, 02 Jun 2025 23:09:38 +0200 Content-Type: text/plain; charset="utf-8" Content-Disposition: inline Content-Transfer-Encoding: quoted-printable List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Received: from [Authenticated alias (960477)] by runbox.com with http (RMM6); Mon, 02 Jun 2025 21:09:38 GMT From: "Alexander Ziaee" To: "Kevin Bowling" , "Alexander Ziaee" CC: "src-committers" , "dev-commits-src-all" , "dev-commits-src-main" Subject: Re: git: e3307d05311e - main - mlx.4: Improve specificity for apropos + hw notes Date: Mon, 02 Jun 2025 21:09:38 +0000 (UTC) X-RMM-Aliasid: 960477 X-Mailer: RMM6 In-Reply-To: Message-Id: X-Rspamd-Queue-Id: 4bB6124zLpz3WY0 X-Spamd-Bar: ---- X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; ASN(0.00)[asn:50304, ipnet:2a0c:5a00::/29, country:NO] On 2025-06-02 16:58 -04:00 EDT, "Kevin Bowling" = wrote: > On Mon, Jun 2, 2025 at 1:32=E2=80=AFPM Alexander Ziaee wrote: >> >> The branch main has been updated by ziaee: >> >> URL: https://cgit.FreeBSD.org/src/commit/?id=3De3307d05311e8c042e7e7ea21= 57fc51f50297369 >> >> commit e3307d05311e8c042e7e7ea2157fc51f50297369 >> Author: Alexander Ziaee >> AuthorDate: 2025-06-02 20:31:14 +0000 >> Commit: Alexander Ziaee >> CommitDate: 2025-06-02 20:31:16 +0000 >> >> mlx.4: Improve specificity for apropos + hw notes >> >> + There are decades of SCSIs, these are Ultra-SCSI >=20 > I guess it's become deep arcana at this point but > https://www.kernel.org/doc/Documentation/blockdev/README.DAC960 has a > breakdown of the chipsets, it looks like Fast/Wide (pre-Ultra) to > Ultra2 are supported by this driver. Wow, thank you! I think deep arcana, while rarely useful, is really helpful= to put in the manual since it's so hard to find. After dinner I will write= something and throw another review up. >> + Remove generalizations from the end of HARDWARE >> + Tag SPDX >> >> MFC after: 3 days >> Reviewed by: mhorne >> Approved by: mhorne (mentor) >> Differential Revision: https://reviews.freebsd.org/D50545 >> --- >> share/man/man4/mlx.4 | 17 ++++++----------- >> 1 file changed, 6 insertions(+), 11 deletions(-) >> >> diff --git a/share/man/man4/mlx.4 b/share/man/man4/mlx.4 >> index 7cb3e9a98c1d..a5443f308088 100644 >> --- a/share/man/man4/mlx.4 >> +++ b/share/man/man4/mlx.4 >> @@ -1,4 +1,6 @@ >> .\" >> +.\" SPDX-License-Identifier: BSD-2-Clause >> +.\" >> .\" Copyright (c) 2003 David O'Brien >> .\" Copyright (c) 2000 Jeroen Ruigrok van der Werven >> .\" Copyright (c) 2000 Michael Smith >> @@ -23,12 +25,12 @@ >> .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE U= SE OF >> .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. >> .\" >> -.Dd January 10, 2025 >> +.Dd May 27, 2025 >> .Dt MLX 4 >> .Os >> .Sh NAME >> .Nm mlx >> -.Nd Mylex DAC-family RAID driver >> +.Nd Mylex DAC-family Ultra-SCSI RAID driver >> .Sh SYNOPSIS >> To compile this driver into the kernel, >> place the following lines in your >> @@ -50,9 +52,9 @@ The >> driver provides support for Mylex DAC-family PCI to SCSI RAID controlle= rs, >> including versions relabeled by Digital/Compaq. >> .Sh HARDWARE >> -Controllers supported by the >> +The >> .Nm >> -driver include: >> +driver supports the following Ultra-SCSI RAID controllers: >> .Pp >> .Bl -bullet -compact >> .It >> @@ -79,13 +81,6 @@ Mylex eXtremeRAID 1100 (DAC1164P) >> RAIDarray 230 controllers, aka the Ultra-SCSI DEC KZPAC-AA (1-ch, 4MB >> cache), KZPAC-CA (3-ch, 4MB), KZPAC-CB (3-ch, 8MB cache) >> .El >> -.Pp >> -All major firmware revisions (2.x, 3.x, 4.x and 5.x) are supported, how= ever >> -it is always advisable to upgrade to the most recent firmware >> -available for the controller. >> -.Pp >> -Compatible Mylex controllers not listed should work, but have not been >> -verified. >> .Sh DIAGNOSTICS >> .Ss Controller initialisation phase >> .Bl -diag >=20=