Subject: Re: mib list in sysctl.8
To: YAMAMOTO Takashi <yamt@mwd.biglobe.ne.jp>
From: Pavel Cahyna <pavel@NetBSD.org>
List: tech-userlevel
Date: 11/18/2006 11:08:40
On Sat, Nov 18, 2006 at 07:49:23PM +0900, YAMAMOTO Takashi wrote:
> > We should have a documentation for sysctl MIBs that is inluded in man.tgz
> > and uses MIB names, not the constants. (in a new sysctl.7 ?)
> 
> i think it's a good idea.  do you want to do it? :)

What exactly would it mean? My idea was to completely remove the
symbolic constants (CTL_* etc.) and the header files where they can be
found from sysctl.3, in the descriptions replace the constants by MIB
names (e.g. CTL_HW -> hw, HW_MACHINE -> machine) and move the
descriptions to sysctl.7, leaving only the documentation of the
sysctl*() functions and some examples in sysctl.3 . Do you agree with
that, or should the symbolic constants remain documented somewhere?

Pavel