rc: add a manual entry for ${name}_setup

${name}_prepend is suboptimal as it is prepended to the actual
command being run. Therefore the term "commandS to prepend"
is misleading and no clear separation takes place for setup tasks
that may be required like changing a config file permission or
generating a configuration file prior to service start.

The other reason is that {argument}_precmd is a service-side
variable and cannot be repurposed from the user-side.

Reviewed by:	pauamma
Differential Revision:	https://reviews.freebsd.org/D36210
This commit is contained in:
Franco Fichtner 2022-11-11 22:20:13 +01:00 committed by Mariusz Zaborski
parent 11ed0a95bf
commit b05e7e7022

View file

@ -29,7 +29,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd March 18, 2022
.Dd August 16, 2022
.Dt RC.SUBR 8
.Os
.Sh NAME
@ -685,6 +685,9 @@ This is a generic version of
.Va ${name}_fib ,
or
.Va ${name}_nice .
.It Va ${name}_setup
Command to be run prior to
.Va command .
.It Ar argument Ns Va _cmd
Shell commands which override the default method for
.Ar argument .