Skip to content

halt

This command triggers the halt procedure.

Interface

halt [ -h ] [ -a ] [ -c ] [ -f|F ] [ -m message ] [ -t time ] [ -W ] when

This command triggers the halt procedure immediately if when is omitted.

The when provided must be on these formats:

  • now: triggers the halt sequence immediately. This is the default
  • mins or +mins : relative time; triggers the halt sequence after mins minutes.
  • hh:mm : absolute time; triggers the halt sequence when the time hh:mm occurs. If that time has passed for the current day, it will wait for the next day. hh can have 1 or 2 digits; mm must have 2 digits.

Options

  • -h, --help: print this help.
  • -a, --access: use access control. The halt sequence will only be launched if one of the users listed in /etc/66/shutdown.allow is currently logged in (as tracked by utmp). /etc/66/shutdown.allow is a text file which accepts one user per line. Lines starting with # are commented out.
  • -c, --cancel: cancel a planned halt. Any when argument is ignored.
  • -f, --force: do not trigger a clean shutdown procedure; it will just sync the filesystems then tell the kernel to immediately halt. This should be the last step in the lifetime of the machine.
  • -F, --force-nosync: same as -f but do not sync the filesystems.
  • -m, --message message: replace the default message by message. message is broadcast to all logged in users (as tracked by utmp).
  • -t, --timeout time: have a grace time period of time seconds between the SIGTERM and the SIGKILL at the end of the halt sequence when it is time to kill all processes (allows processes to receive SIGTERM to exit cleanly). The default is 3 seconds.
  • -W, --no-wall: do not send a wall message to users.

Usage examples

Halts the system.

66 halt

Halts a broken system

66 halt -f

Halts the system after 10 minutes

66 halt 10

Sends a "system will be halted in 10 minutes" message to connected accounts and halts the system after 10 minutes

66 halt -m "system will be halted in 10 minutes" 10

See also

  • the event system: when the halt is scheduled — before any service is stopped — 66 raises the shutdown.begin event, which a service can react to in order to flush or quiesce cleanly during the grace period.