rc(8): more foo.sh clarification

- 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@

Clarify foo.sh behaviour

Improve wording of the warning for "foo.sh" behaviour,
to reduce ambiguity.
Per feedback from Sascha Wildner.

Reference dhcpcd as the sole DHCP client in general man pages.

We'd rather have new users use dhcpcd. hopefully this eliminates some
unnecessary confusion about there being two clients.

branches: 1.36.28;
Briefly note /etc/rc.local in rc(8).

Join URL.

Add the USENIX paper of the author to SEE ALSO.

Bump date for previous.

Add a postprocessor to /etc/rc, which logs messages to /var/run/rc.log,
and which can suppress output in silent mode. Silent mode is enabled
via the new rc_silent variable, which defaults to a value that depends
on the kern.boothowto sysctl.

Part of the /etc/rc silent changes requested in PR 41946
and proposed in tech-userlevel.

Convert TNF licenses to new 2 clause variant

branches: 1.30.10; 1.30.12;
* Add a stop_boot() function in rc.subr, to terminate a multi-user boot
by killing the parent process. The parent's PID is saved in $RC_PID.
* In all rc.d/* scripts that previously tried to stop the boot,
replace in-line code with "stop_boot".
* Document this.

This should fix PR 29822.

Use ".Fn" markup for the names of shell functions.

Grammar consistency fix for previous.

Implement ``one'' prefix to allow a "one shot" operation as if
${rcvar}=yes yet all the other prerequisite tests are still performed.
The existing ``force'' prefix is a sledgehammer that ignores all the
prerequisite checks and always returns a zero exit status; this is a
more gentle approach to the problem of "manipulate this disabled
service without editing rc.conf(5)".

Add some Ns.

The correct capitalisation of 'NetBSD.org' is (you
guessed it) 'NetBSD.org'.

some mdoc fixes.

minor improvements, including consistency in how variables are formatted.

add more rc.subr(8) and rc.conf(5) references

rc.subr(8) - functions used by system shell scripts. Closes PR [misc/10828].

Drop trailing space.

explicitly mention that rc.d contains sh(1) scripts

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

rename NETWORK to NETWORKING

Drop an unnecessary .Pp.

Boring whitespace fixes.

enhance description of placeholder scripts and default arguments

use `service' instead of `program'

display dummy dependancies in the order that they're actually started
in, to be slighly more helpful: (i.e, NETWORK, SERVERS, DAEMON, LOGIN)

- document `nostart' support for /etc/rc
- use bootconf.sh instead of fsck.sh as the `foo.sh' example
- add information how a normal script can stop the boot with kill -TERM $$
- update history

describe rc.d/NETWORK. xref rcorder -k for keywork explanation

rc.shutdown now only calls scripts that have a ``shutdown'' keyword.

remove extra period in SEE ALL section

branches: 1.8.4;
minor typo

update NAME

Total rewrite post rc.d implementation.

Xref rc.conf(5).

branches: 1.4.6;
More and more .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.

Add RCS identifiers.

branches: 1.1.1;
Initial revision

Clarify foo.sh behaviour

Improve wording of the warning for "foo.sh" behaviour,
to reduce ambiguity.
Per feedback from Sascha Wildner.

Reference dhcpcd as the sole DHCP client in general man pages.

We'd rather have new users use dhcpcd. hopefully this eliminates some
unnecessary confusion about there being two clients.

branches: 1.36.28;
Briefly note /etc/rc.local in rc(8).

Join URL.

Add the USENIX paper of the author to SEE ALSO.

Bump date for previous.

Add a postprocessor to /etc/rc, which logs messages to /var/run/rc.log,
and which can suppress output in silent mode. Silent mode is enabled
via the new rc_silent variable, which defaults to a value that depends
on the kern.boothowto sysctl.

Part of the /etc/rc silent changes requested in PR 41946
and proposed in tech-userlevel.

Convert TNF licenses to new 2 clause variant

branches: 1.30.10; 1.30.12;
* Add a stop_boot() function in rc.subr, to terminate a multi-user boot
by killing the parent process. The parent's PID is saved in $RC_PID.
* In all rc.d/* scripts that previously tried to stop the boot,
replace in-line code with "stop_boot".
* Document this.

This should fix PR 29822.

Use ".Fn" markup for the names of shell functions.

Grammar consistency fix for previous.

Implement ``one'' prefix to allow a "one shot" operation as if
${rcvar}=yes yet all the other prerequisite tests are still performed.
The existing ``force'' prefix is a sledgehammer that ignores all the
prerequisite checks and always returns a zero exit status; this is a
more gentle approach to the problem of "manipulate this disabled
service without editing rc.conf(5)".

Add some Ns.

The correct capitalisation of 'NetBSD.org' is (you
guessed it) 'NetBSD.org'.

some mdoc fixes.

minor improvements, including consistency in how variables are formatted.

add more rc.subr(8) and rc.conf(5) references

rc.subr(8) - functions used by system shell scripts. Closes PR [misc/10828].

Drop trailing space.

explicitly mention that rc.d contains sh(1) scripts

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

rename NETWORK to NETWORKING

Drop an unnecessary .Pp.

Boring whitespace fixes.

enhance description of placeholder scripts and default arguments

use `service' instead of `program'

display dummy dependancies in the order that they're actually started
in, to be slighly more helpful: (i.e, NETWORK, SERVERS, DAEMON, LOGIN)

- document `nostart' support for /etc/rc
- use bootconf.sh instead of fsck.sh as the `foo.sh' example
- add information how a normal script can stop the boot with kill -TERM $$
- update history

describe rc.d/NETWORK. xref rcorder -k for keywork explanation

rc.shutdown now only calls scripts that have a ``shutdown'' keyword.

remove extra period in SEE ALL section

branches: 1.8.4;
minor typo

update NAME

Total rewrite post rc.d implementation.

Xref rc.conf(5).

branches: 1.4.6;
More and more .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.

Add RCS identifiers.

branches: 1.1.1;
Initial revision

Reference dhcpcd as the sole DHCP client in general man pages.

We'd rather have new users use dhcpcd. hopefully this eliminates some
unnecessary confusion about there being two clients.

Briefly note /etc/rc.local in rc(8).

Join URL.

Add the USENIX paper of the author to SEE ALSO.

Bump date for previous.

Add a postprocessor to /etc/rc, which logs messages to /var/run/rc.log,
and which can suppress output in silent mode. Silent mode is enabled
via the new rc_silent variable, which defaults to a value that depends
on the kern.boothowto sysctl.

Part of the /etc/rc silent changes requested in PR 41946
and proposed in tech-userlevel.

Convert TNF licenses to new 2 clause variant

branches: 1.30.10; 1.30.12;
* Add a stop_boot() function in rc.subr, to terminate a multi-user boot
by killing the parent process. The parent's PID is saved in $RC_PID.
* In all rc.d/* scripts that previously tried to stop the boot,
replace in-line code with "stop_boot".
* Document this.

This should fix PR 29822.

Use ".Fn" markup for the names of shell functions.

Grammar consistency fix for previous.

Implement ``one'' prefix to allow a "one shot" operation as if
${rcvar}=yes yet all the other prerequisite tests are still performed.
The existing ``force'' prefix is a sledgehammer that ignores all the
prerequisite checks and always returns a zero exit status; this is a
more gentle approach to the problem of "manipulate this disabled
service without editing rc.conf(5)".

Add some Ns.

The correct capitalisation of 'NetBSD.org' is (you
guessed it) 'NetBSD.org'.

some mdoc fixes.

minor improvements, including consistency in how variables are formatted.

add more rc.subr(8) and rc.conf(5) references

rc.subr(8) - functions used by system shell scripts. Closes PR [misc/10828].

Drop trailing space.

explicitly mention that rc.d contains sh(1) scripts

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

rename NETWORK to NETWORKING

Drop an unnecessary .Pp.

Boring whitespace fixes.

enhance description of placeholder scripts and default arguments

use `service' instead of `program'

display dummy dependancies in the order that they're actually started
in, to be slighly more helpful: (i.e, NETWORK, SERVERS, DAEMON, LOGIN)

- document `nostart' support for /etc/rc
- use bootconf.sh instead of fsck.sh as the `foo.sh' example
- add information how a normal script can stop the boot with kill -TERM $$
- update history

describe rc.d/NETWORK. xref rcorder -k for keywork explanation

rc.shutdown now only calls scripts that have a ``shutdown'' keyword.

remove extra period in SEE ALL section

branches: 1.8.4;
minor typo

update NAME

Total rewrite post rc.d implementation.

Xref rc.conf(5).

branches: 1.4.6;
More and more .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.

Add RCS identifiers.

branches: 1.1.1;
Initial revision