Skip site navigation (1)Skip section navigation (2) 
Date:      Fri, 27 Oct 2017 10:39:03 +0000
From:      bugzilla-noreply@freebsd.org
To:        freebsd-bugs@FreeBSD.org
Subject:   [Bug 223276] rc.subr man page not clear
Message-ID:  <bug-223276-8@https.bugs.freebsd.org/bugzilla/>
next in thread | raw e-mail | index | archive | help 
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D223276

            Bug ID: 223276
           Summary: rc.subr man page not clear
           Product: Base System
           Version: 11.1-RELEASE
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: conf
          Assignee: freebsd-bugs@FreeBSD.org
          Reporter: bergerkos@yahoo.co.uk

I had problems reading the rc.subr man page concerning $argument_precmd.

This variable has to do with the (occasional) need to run some EXTERNAL
commands when starting a daemon. It will be such commands as do NOT get
inserted in any of the variables provided through rc.conf nor rc.subr.

The manual just says:
Shell commands to run just before running argument_cmd or the default method
for argument.=20=20=20=20

Now it is not immediately clear from the description that the variable has =
to
do with ADDITIONAL commands, such as are NOT part of the rc.subr framework.=
=20

Ah, but here one may argue: why, $argument_precmd DOES make part of rc.subr
framework, does it not?

Right, but it deals with commands that go BEYOND anything configurable via
rc.conf or rc.subr variables. This, in my opinion, falls into the category =
of
EXTERNAL commands and as such deserves a more explicit mentioning in the
manual. For example:
argument_precmd
ADDITIONAL shell commands to run just before running $argument_cmd or the
default method for $argument, ones that cannot be placed into other rc.conf=
 or
rc.subr variables.=20

I mean, without being a bit more explicit about this, the rc.subr seems to =
be
like a close circle that includes... what it includes. And what is it? Well,
it's rc.subr, don't you know.

--=20
You are receiving this mail because:
You are the assignee for the bug.=

Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-223276-8>