Bug 13792

Summary: Difficult to find documentation of "securelevel"
Product: Documentation Reporter: brett <brett>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description brett 1999-09-17 18:20:01 UTC 
The commands "apropos securelevel" and "man -k securelevel" don't turn
up the documentation of this important setting, which is frequently
asked about. It's actually documentd in a nonintuitive place: the
man page for init(8). The user should be guided to the correct pages --
init(8) and security(7) -- when investigating this setting.

How-To-Repeat: apropos securelevel
Comment 1 nik freebsd_committer freebsd_triage 1999-12-14 16:02:58 UTC 
On Fri, Sep 17, 1999 at 10:17:56AM -0700, brett@lariat.org wrote:
> The commands "apropos securelevel" and "man -k securelevel" don't turn
> up the documentation of this important setting, which is frequently
> asked about. It's actually documentd in a nonintuitive place: the
> man page for init(8). The user should be guided to the correct pages --
> init(8) and security(7) -- when investigating this setting.

It's now documented in /etc/defaults/rc.conf, where there are a couple of
knobs to tweak, and an explicit reference to init(8).

I could also add an explicit

    MLINKS=	init.8 securelevel.8

in the Makefile for init, so that "man 8 securelevel" worked.

Thoughts?

N
-- 
    If you want to imagine the future, imagine a tennis shoe stamping
    on a penguin's face forever.
        --- with apologies to George Orwell
Comment 2 brett 1999-12-15 00:53:04 UTC 
The link would help! And maybe a crossreference to "security" (whichever
chapter it's in; I forget offhand).

--Brett

At 09:02 AM 12/14/1999 , Nik Clayton wrote:
>On Fri, Sep 17, 1999 at 10:17:56AM -0700, brett@lariat.org wrote:
> > The commands "apropos securelevel" and "man -k securelevel" don't turn
> > up the documentation of this important setting, which is frequently
> > asked about. It's actually documentd in a nonintuitive place: the
> > man page for init(8). The user should be guided to the correct pages --
> > init(8) and security(7) -- when investigating this setting.
>
>It's now documented in /etc/defaults/rc.conf, where there are a couple of
>knobs to tweak, and an explicit reference to init(8).
>
>I could also add an explicit
>
>     MLINKS=     init.8 securelevel.8
>
>in the Makefile for init, so that "man 8 securelevel" worked.
>
>Thoughts?
>
>N
>-- 
>     If you want to imagine the future, imagine a tennis shoe stamping
>     on a penguin's face forever.
>         --- with apologies to George Orwell
Comment 3 Alexander Langer 2000-05-24 16:42:25 UTC 
I also agree:
the link to securelevel.8 is good.

Please commit (and/or close this PR).

Alex
Comment 4 alex freebsd_committer freebsd_triage 2000-06-09 10:40:47 UTC 
State Changed
From-To: open->closed

Symlink init.8 --> securelevel.8 committed.