shutdown(8) — Linux manual page


SHUTDOWN(8)                       shutdown                       SHUTDOWN(8)

NAME         top

       shutdown - Halt, power-off or reboot the machine

SYNOPSIS         top

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

DESCRIPTION         top

       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,

       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         top

       The following options are understood:

           Print a short help text and exit.

       -H, --halt
           Halt the machine.

       -P, --poweroff
           Power-off the machine (the default).

       -r, --reboot
           Reboot the machine.

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

           Do not halt, power-off, reboot, just write wall message.

           Do not send wall message before halt, power-off, reboot.

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

EXIT STATUS         top

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

SEE ALSO         top

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

COLOPHON         top

       This page is part of the systemd (systemd system and service manager)
       project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug
       report for this manual page, see
       ⟨⟩.  This
       page was obtained from the project's upstream Git repository
       ⟨⟩ on 2020-09-18.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2020-09-18.)  If you discover any rendering problems in
       this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to

systemd 246                                                      SHUTDOWN(8)

Pages that refer to this page: last(1@@util-linux)login(1)wall(1)reboot(2)nologin(5)30-systemd-environment-d-generator(7)boot(7)systemd.directives(7)systemd.index(7)halt(8)kexec(8)poweroff(8)reboot(8)