Most of the sysctl variables under the machdep namespace and machdep.mitigations namespace are not documented.
I created a new man page to bring all of these sysctl variables together.
I'm still not sure what a pvo is for PowerPC.
felix.the.red_gmail.com on Oct 25 2021, 1:34 AM.Authored by
Would machdep_sysctl feel odd without a machdep counterpart?
Given the existing pattern of a SYSCTL section in $component(sektion) manual pages, might a machdep (without the prefix) man page name be more suitable, including an introduction about what machdep 'is', or are there are existing examples of sysctl_ prefixed manual pages?
Alternatively, might $component_sysctl(sektion), ie a _sysctl suffix pattern be more suitable, such that any existing manual page can choose to have an 'extended' and dedicated sysctl manual page. I know there are frequent questions like 'what are the sysctl's for this thing' in the community.
I don't know what what precedents / mechanisms there are in manpage culture and implementation for 'namespaced manual pages', but I think the naming/namespace question is an interesting one.
Hi, this is an interesting patch! Thanks for your effort.
I believe most sysctls under the machdep.mitigation namespace would be best documented in the security(7) man page. This is where many are documented already.
As for the rest... I do not think one large catch-all man page is the right approach. By their nature, sysctls under machdep are usually platform dependent, and cover a wide range of topics/functionality. IMO it is confusing for a single man page to touch on such varying topics as signal delivery, virtual memory translation features, and VGA aspect ratios, for example.
My overall goal is to document sysctls, and I wasn't sure where to put these.
Reading through these sysctls, several of them mentioned that being in machdep was
If we could find locations closer to the functionality, I would do away with this page and
So I don't mention it everywhere it's present: should "x86" be "i386" to match FreeBSD nomenclature?
Losing focus and it's past my bedtime. Will continue reviewing later.