mfi(4)/mrsas(4): Print driver versions consistently

[michaelo]

Summary

MFC after: 3 days

[michaelo]

Screenshot from the machine with both drivers now side by side:

[ziaee]

Thanks for tagging me!

I try to be careful with "FreeBSD" as a search term, I don't think it's appropriate in these driver strings. I also don't know if it matters that it's broadcom megaraid now.

Maybe imp should review this. I'm going to add emaste because he's one marked up the broadcom.

[michaelo]

In D54519#1246275, @ziaee wrote:

Thanks for tagging me!

I try to be careful with "FreeBSD" as a search term, I don't think it's appropriate in these driver strings. I also don't know if it matters that it's broadcom megaraid now.

Maybe imp should review this. I'm going to add emaste because he's one marked up the broadcom.

I *intentionally* did not write Broadcom because the driver was developed when the company still was LSI, then bought by AVAGO which is now named Broadcom:

MFI(4)                 FreeBSD Kernel Interfaces Manual                 MFI(4)

NAME
     mfi – LSI MegaRAID SAS driver

This is fully in line with the driver intro.

[michaelo]

@imp Any objections or opinions here?

[emaste]

device_printf will include the device prefix mfi so I'm not sure why it needs to be repeated, and I'm also not sure what value including FreeBSD in the message brings.
Including LSI, correctly capitalizing MegaRAID, and expanding version all sound good to me.

[imp]

LSI hasn't owned or marked this for a decade.

[ziaee]

correctly capitalizing MegaRAID, and expanding version all sound good to me.

I also agree with this, unsure/no-opinion on LSI.

[michaelo]

I had the following objective:

• Make the string compatible with mrsas(4) since both drivers overlap
• Reflect the author of the driver back then, not now
• Keep mfi in the script because it makes the string consistent with the first point

What is your proposition?

LSI MegaRAID FreeBSD SAS driver version: %s

That would be OK because of the prefix. Unfortunately, mrsas(4) does not print the device prefix and stops at the first device which is inconsistent with mfi(4).

[ziaee]

I think if you want to make them the same you should remove FreeBSD from both. If people search logs for FreeBSD they shouldn't get these drivers, I think.

[michaelo]

In D54519#1248132, @ziaee wrote:

I think if you want to make them the same you should remove FreeBSD from both. If people search logs for FreeBSD they shouldn't get these drivers, I think.

That would be fine for me as long as we (all) agree upon.

[michaelo]

In D54519#1248132, @ziaee wrote:

I think if you want to make them the same you should remove FreeBSD from both. If people search logs for FreeBSD they shouldn't get these drivers, I think.

Done in https://reviews.freebsd.org/D54630

[michaelo]

Drop 'FreeBSD' in version banner

[michaelo]

Unify both changes, use device_printf() in mrsas(4) as well

Will test this also on the server next week

[michaelo]

Looking at booth drivers, mfi(4) uses mfi_attach() to print the message while mrsas(4) uses probe. I could move both to *_attach(), but cannot tell which of both is correct. Logically attach() seems right.

[michaelo]

print driver version in *_attach() function