x86: Create manpage for mca subsystem

[jtl]

Summary

Create a manpage for the mca subsystem.

Sponsored by: Netflix

[ziaee]

share/man/man4/mca.4

6

We no longer need to write this, see

https://docs.freebsd.org/en/articles/license-guide/

28

We dropped i386. You're not going to back port this, right? Thus this is only for amd64?

[jtl]

Updated license and clarified this is only applicable to amd64 in main.

[jtl]

share/man/man4/mca.4

6

Thanks! I've updated the license text.

28

I updated this to amd64. I may actually backport this, but I can modify it as part of the MFC. There may be other changes which are needed as part of any MFC.

[markj]

Thanks for writing this.

I wonder how to make the page more discoverable. I'd think we should have platform-specific man pages which describe platform features, so amd64.4 could link to mca.4, pkru.3, etc.. But that's a larger project of course.

share/man/man4/mca.4

21

32

Should we mention the syslog facility/level?

[jhb]

share/man/man4/mca.4

32

I would perhaps say "the system log" rather than "Syslog".

64–66

This language will probably read less stale in the more distant future.

67

78

You don't have to, but if you would find it more readable, you could create a table with columns instead of a tagged list. See for example bhyve_config(5) which uses separate columns for the default value and description. siginfo(3) is another manual page that uses a .Bl -column.

In this case I could imagine a column for the name, one for if the sysctl is writable (Y/N), one for the default value, and the last for the description.

101

I don't know that Haswell needs to be quoted here?

266

Maybe Xr syslogd(8) here?

Not sure if it's worth adding a mention of mcelog in ports? (I'm not convinced mcelog is very useful)