diff options
author | Mateusz Piotrowski <0mp@FreeBSD.org> | 2018-11-16 14:29:28 +0000 |
---|---|---|
committer | Mateusz Piotrowski <0mp@FreeBSD.org> | 2018-11-16 14:29:28 +0000 |
commit | 03840eefd7023487e22cab34d7cb17dafa4857a9 (patch) | |
tree | 0a106f9d607b5794784b5bd9800c351c6418abc7 /share | |
parent | ad43bf348bfd3ef395352e42544133860dbeaa9f (diff) | |
download | src-03840eefd7023487e22cab34d7cb17dafa4857a9.tar.gz src-03840eefd7023487e22cab34d7cb17dafa4857a9.zip |
development(7): Replace "reboot" with "shutdown -r now"
We generally document shutdown(8) instead of reboot(8) as it's better for
interactive use.
In modern FreeBSD is matters a lot less, it's mostly just convention. One
minor thing is that shutdown(8) produces a global message, while reboot(8)
does not. It is believed that historically, some versions of reboot did not
do appropriate safe shutdown checks and just rebooted.
It's also just consistency: for example the handbook[1] documents shutdown.
There is actually another important difference between reboot and shutdown
-r now: reboot does not run /etc/rc.shutdown. This is because reboot has
its own shutdown procedure and does not signal init like init 6 and
shutdown -r now do (except in the case of rerooting via reboot -r).
A few years ago jilles@ proposed changing reboot's default to signalling
init (preserving reboot -q which just invokes the reboot system call), but
this was not accepted. Perhaps this can be tried again for 13.0.
[1]: https://www.freebsd.org/doc/handbook/boot-shutdown.html
Reported by: eadler
Reviewed by: eadler, jilles
Approved by: krion (mentor)
Differential Revision: https://reviews.freebsd.org/D16843
Notes
Notes:
svn path=/head/; revision=340478
Diffstat (limited to 'share')
-rw-r--r-- | share/man/man7/development.7 | 4 |
1 files changed, 2 insertions, 2 deletions
diff --git a/share/man/man7/development.7 b/share/man/man7/development.7 index 32365fe36314..1b871fc0fa0a 100644 --- a/share/man/man7/development.7 +++ b/share/man/man7/development.7 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd August 22, 2018 +.Dd November 16, 2018 .Dt DEVELOPMENT 7 .Os .Sh NAME @@ -110,7 +110,7 @@ system: svnlite co https://svn.FreeBSD.org/base/head src cd src make -j8 buildworld buildkernel installkernel -reboot +shutdown -r now .Ed .Pp After reboot: |