Files
finit/doc/commands.md
T
Joachim Wiberg 20c422af69 shutdown: add time argument, wall message, and cancel
shutdown ignored everything after its options, so a delayed shutdown
went down right away:

    shutdown -r +10 "Upgrading, back in five"

Take a time, now, +MIN, or the next HH:MM, and an optional message.
Finit keeps the countdown, so it survives logging out:

  - warns logged-in users at 60, 30, 15 and 10 minutes left, then
    every minute from five, and on the console
  - writes the message to /etc/nologin from five minutes before,
    leaving one already in place alone
  - shutdown -c cancels, and a new shutdown TIME replaces it

Without a time, or with now and no message, shutdown acts right away
as before.  An immediate reboot, halt, or power-off, also over D-Bus,
cancels a scheduled one.  The warnings are written by a child, reading
utmp and closing a serial tty can block.

Fixes #149

Signed-off-by: Joachim Wiberg <troglobit@gmail.com>
2026-11-17 11:00:49 +01:00

1.4 KiB

Rebooting & Halting

Traditionally, rebooting and halting a UNIX system is done by switching to the corresponding runlevel (0 or 6). Over time this has changed and Finit comes with its own tooling providing: shutdown, reboot, poweroff, and suspend. These commands are also available from the initctl tool.

For compatibility reasons Finit listens to the same set of signals as BusyBox init. This is not 100% compatible with SysV init, but clearly the more common combination for Finit. For more details, see the Signal section.

Scheduled Shutdown

The shutdown command takes a time, and an optional message to warn logged-in users with:

shutdown -r +10 "Upgrading to v5.0, back in five"
shutdown -h 23:30
shutdown -c

The time is now, +MIN minutes from now, at most a year, or the next HH:MM. Finit keeps track of it, so it survives logging out. It counts down the time left, changing the system clock does not move it. At 60, 30, 15 and 10 minutes left, and then every minute from five, Finit writes the warning to the terminal of every logged-in user. From five minutes before, it also creates /etc/nologin, with the message, to refuse new logins. A /etc/nologin already in place is left alone.

A new shutdown TIME replaces the scheduled one, and shutdown -c cancels it. Without a time, or with now and no message, shutdown acts right away, as before.