Re: CVS commit: src

[Simon Burge <simonb%NetBSD.org@localhost>]

Daniel Carosone wrote:

> On Wed, Sep 20, 2006 at 01:03:17AM +0200, Elad Efrat wrote:
> > >> Remove securelevel-related text from init(8) man-page as they're now in
> > >> secmodel_bsd44(9).
> > >
> > > That was not documentation for kernel programmers. Please fix this commit
> > > so the documentation remains available for those who don't have comp.tgz
> > > installed.
> > >
> > > (maybe move the man page to secmodel_bsd44.7 ?)
> >
> > Let's wait for others voice in; I don't really mind.
> 
> init(8) was always a kind of odd / non-obvious place for securelevel
> to be documented, but I agree with Pavel too - this is not programmer
> info in section 9 either.  Wherever it ends up, the most important
> thing is that it's well cross-referenced from sysctl(8), init(8) (for
> historical reasons), secmodel(9), etc. so that people can find it.
> 
> maybe a sysctl.conf(4) similar to options(4) that can document the
> important knobs and act as an index to other more specific pages?

My first thought it that a sysctl.conf(4) (should that be section 5?)
would be duplicating sysctl(3) and sysctl(8) (which both also have
duplication).  Something in section 7 I think sounds about right.
Maybe a a detailed secmodel_bsd44(7) like Pavel suggests and simple
cross-referencing securelevel(7)?

Certainly init(8) wasn't the right place - it was just that init(8)
controlled securelevel during boot.

Simon.