Date: Fri, 16 Nov 2018 14:29:28 +0000 (UTC) From: Mateusz Piotrowski <0mp@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r340478 - head/share/man/man7 Message-ID: <201811161429.wAGETSqh030439@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: 0mp (ports committer) Date: Fri Nov 16 14:29:28 2018 New Revision: 340478 URL: https://svnweb.freebsd.org/changeset/base/340478 Log: 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 Modified: head/share/man/man7/development.7 Modified: head/share/man/man7/development.7 ============================================================================== --- head/share/man/man7/development.7 Fri Nov 16 14:21:57 2018 (r340477) +++ head/share/man/man7/development.7 Fri Nov 16 14:29:28 2018 (r340478) @@ -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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201811161429.wAGETSqh030439>