Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

rc(8): more foo.sh clarification

Browse Source 
- Use "inline.sh" instead of "foo.sh".
- Clarify that "inline.sh" scripts will terminate the boot if
  the script causes trhe current shell process to terminate.
- Use "service" instead of "bar.
- Use "sub-shell" instead of "subshell".

Inspired by feedback from kre@
This commit is contained in:
lukem 2017-10-14 21:21:51 +00:00
parent 837bece478
commit 96a9fff146
1 changed files with 9 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
share/man/man8/rc.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: rc.8,v 1.38 2017/10/11 23:42:33 lukem Exp $
.\" $NetBSD: rc.8,v 1.39 2017/10/14 21:21:51 lukem Exp $
.\"
.\" Copyright (c) 2000-2017 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd October 12, 2017
.Dd October 15, 2017
.Dt RC 8
.Os
.Sh NAME
@ -120,7 +120,7 @@ which sets
.Dv $1
to
.Sq start ,
and sources the script in a subshell.
and sources the script in a sub-shell.
If the script has a
.Sq .sh
suffix then it is sourced directly into the current shell.
@ -175,7 +175,7 @@ which sets
.Dv $1
to
.Sq stop ,
and sources the script in a subshell.
and sources the script in a sub-shell.
If the script has a
.Sq .sh
suffix then it is sourced directly into the current shell.
@ -231,20 +231,20 @@ as well as before services which might run commands as users
and
.Pa sendmail ) .
.El
.It Pa foo.sh
Scripts that are to be sourced into the current shell rather than a subshell
.It Pa inline.sh
Scripts that are sourced into the current shell rather than a sub-shell
have a
.Sq Pa .sh
suffix.
Extreme care must be taken in using this, as the startup sequence will
terminate if the script terminates.
terminate if the script causes the current shell process to terminate.
.Pa /etc/rc.d/bootconf.sh
uses this behaviour to allow the user to select a different
configuration (including
.Pa /etc/rc.conf )
early in the boot.
.It Pa bar
Scripts that are sourced in a subshell.
.It Pa service
Scripts that are sourced in a sub-shell.
The boot does not stop if such a script terminates with a non-zero status,
but a script can stop the boot if necessary by invoking the
.Fn stop_boot