Index · Directives · Python · libudev · gudev systemd 204

Name

shutdown — Halt, power-off or reboot the machine

Synopsis

shutdown [OPTIONS...] [TIME] [WALL...]

Description

shutdown may be used to halt, power-off or reboot the machine.

The first argument may be a time string (which is usually now). Optionally, this may be followed by a wall message to be sent to all logged-in users before going down.

The time string may either be in the format hh:mm for hour/minutes specifying the time to execute the shutdown at, specified in 24h clock format. Alternatively it may be in the syntax +m referring to the specified number of minutes m from now. now is an alias for +0, i.e. for triggering an immediate shutdown. If no time argument is specified, +1 is implied.

Note that to specify a wall message you must specify a time argument, too.

If the time argument is used, 5 minutes before the system goes down the /run/nologin file is created to ensure that further logins shall not be allowed.

Options

The following options are understood:

--help

Prints a short help text and exits.

-H, --halt

Halt the machine.

-P, --poweroff

Power-off the machine (the default).

-r, --reboot

Reboot the machine.

-h

Equivalent to --poweroff, unless --halt is specified.

-k

Don't halt, power-off, reboot, just write wall message.

--no-wall

Don't send wall message before halt, power-off, reboot.

-c

Cancel a pending shutdown. This may be used cancel the effect of an invocation of shutdown with a time argument that is not +0 or now.

Exit status

On success 0 is returned, a non-zero failure code otherwise.

Notes

This is a legacy command available for compatibility only.

See Also

systemd(1), systemctl(1), halt(8), wall(1)