development(7): Replace "reboot" with "shutdown -r now"

[0mp]

Summary

Commit message:

We generally document shutdown(8) instead of reboot(8) as it's better for
interactive use.

Reported by: eadler

Do you have any comments on what should be the reason in the commit message? I've got a feeling that the current message is not very informative.

---

Note: I'll bump Dd before committing.

[eadler]

Do you have any comments on what should be the reason in the commit message?

In modern FreeBSD is matterns a lot less, its mostly just convention. One minor thing is that shutdown produces a global message, while reboot does not. I believe that historically, some versions of reboot did not do appropriate safe shutdown checks and just rebooted.

Its also just consistency: for example https://www.freebsd.org/doc/handbook/boot-shutdown.html documents shutdown

[jilles]

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 I 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.

Don't forget to update .Dd.

[0mp]

Thank you, @eadler & @jilles.

@krion, @mat: may I ask you for an approval to commit? Then I'll contact release engineers for the final approval.

[eadler]

In D16843#360383, @jilles wrote:

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).

I completely forgot about this...