membarrier: Add initial manual page

[emaste]

Flesh out

[emaste]

Structure based on @markj's kcmp man page

lib/libsys/membarrier.2

52

The table renders pretty poorly because of this, will need to make it instead

MEMBARRIER_CMD_QUERY
        Query supported commands. ...

MEMBARRIER_CMD_GLOBAL
        Alias for ...

[emaste]

Source implementation in D32360, commits:

• 8882b7852acf2588d87ccb6d4c6bf7694511fc56
• 74ccb8ecf6c115a79f008bc32d4981f1126b63a8
• 4a69fc16a583face922319c476f3e739d9ce9140

[kib]

lib/libsys/membarrier.2

81

[emaste]

feedback from @kib

[emaste]

mdoc fixup. I'll commit this and iterate on it in the tree if necessary.

[fernape]

Would it be possible to have all the cmds sorted alphabetically?
Only MEMBARRIER_CMD_SHARED references another cmd, but that one (MEMBARRIER_CMD_GLOBAL) will be presented earlier if cmds are sorted.

lib/libsys/membarrier.2

63

Missing final period (".") at the end of the paragraph

105

Maybe .Fa cmd since cmd is an actual argument?

[emaste]

Would it be possible to have all the cmds sorted alphabetically?

They're currently in order of their bit position, but they could be alphabetical instead. I'll take a look,

lib/libsys/membarrier.2

105

Yes and presumably a Dv to follow

.Fa cmd
is
.Dv MEMBARRIER_CMD_QUERY
a bitmask...

[emaste]

Would it be possible to have all the cmds sorted alphabetically?

I decided not to do this, because they're in a somewhat logical order now. It would be odd to put MEMBARRIER_CMD_QUERY between other commands, it should be either first or last. Then there are a number of them that are paired, the CMD_REGISTER_foo and CMD_foo.