shutdown(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | SEE ALSO | COLOPHON

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, 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         top

       The following options are understood:

       --help
           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.

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

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

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

       -c
           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
       ⟨http://www.freedesktop.org/wiki/Software/systemd⟩.  If you have
       a bug report for this manual page, see
       ⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.
       This page was obtained from the project's upstream Git repository
       ⟨https://github.com/systemd/systemd.git⟩ on 2020-12-18.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2020-12-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
       man-pages@man7.org

systemd 247                                                  SHUTDOWN(8)

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