On 2025-06-02 16:58 -04:00 EDT, "Kevin Bowling" <kevin.bowl...@kev009.com> wrote: > On Mon, Jun 2, 2025 at 1:32 PM Alexander Ziaee <zi...@freebsd.org> wrote: >> >> The branch main has been updated by ziaee: >> >> URL: >> https://cgit.FreeBSD.org/src/commit/?id=e3307d05311e8c042e7e7ea2157fc51f50297369 >> >> commit e3307d05311e8c042e7e7ea2157fc51f50297369 >> Author: Alexander Ziaee <zi...@freebsd.org> >> AuthorDate: 2025-06-02 20:31:14 +0000 >> Commit: Alexander Ziaee <zi...@freebsd.org> >> 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 > > 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 USE 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 controllers, >> 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, however >> -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 >
