Earlier quoted context omitted.
Not a IllumOS/SmartOS user, but can you comment on how good the man pages are? What you state is sometimes a complaint I hear about OpenBSD, but from my experience using OpenBSD (which was mostly almost a decade ago now) is that's because they actually put a huge amount of effort into making sure the man pages were not just correct, but comprehensive (to the point of requiring code patches to include an accompanying…
These are so different use cases. Good luck trying to find out how to do your network design with the dladm and good luck trying to understand the capabilities and limitations of etherstub from the manpages. But yeah the structure of the OpenBSD man pages looks ok. Where you put proper structured documentation doesn't really matter IMHO. It's conceptually different. You can easily use the OpenBSD manpages, because th…
Whether it accurately explains the capabilities of etherstub I don't know, but it seems to do a good job explaining what it is and is used for. The basic usage is detailed within one of the examples. I'm not sure what you're comparing it to that you think would be a superior way to document it though. I honestly can't imagine it being better in Linux in any way. Windows, it would probably be explained better, but you might have to pay a few hundred dollars for the documentation or training, whether it be from Microsoft or a third party.
> It's conceptually different. You can easily use the OpenBSD man pages, because they map nicely to every other Unix system concept.
Not any more than SmartOS, I'm sure. IIRC, CARP is an OpenBSD designed protocol to compete with Cisco's proprietary VRRP. pfsync is their tool and protocol to sync PF (their own custom firewall implementation) states across a network link. sasync is their own protocol and implementation to sync IPSEC security associations across the network. These were eventually adopted and ported to FreeBSD, but they are far from "every other Unix system concept".
I view OpenBSD and IllumOS/SmartOS to be even more similar in approach now than I did prior to this discussion.