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.allowis currently logged in (as tracked by utmp)./etc/66/shutdown.allowis 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
-fbut 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
SIGTERMand theSIGKILLat the end of the halt sequence when it is time to kill all processes (allows processes to receiveSIGTERMto exit cleanly). The default is3seconds. - -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.beginevent, which a service can react to in order to flush or quiesce cleanly during the grace period.