halt(8) — Linux manual page


HALT(8)                           halt                           HALT(8)

NAME         top

       halt, poweroff, reboot - Halt, power-off or reboot the machine

SYNOPSIS         top

       halt [OPTIONS...]

       poweroff [OPTIONS...]

       reboot [OPTIONS...]

DESCRIPTION         top

       halt, poweroff, reboot may be used to halt, power-off, or reboot
       the machine. All three commands take the same options.

OPTIONS         top

       The following options are understood:

           Print a short help text and exit.

           Halt the machine, regardless of which one of the three
           commands is invoked.

       -p, --poweroff
           Power-off the machine, regardless of which one of the three
           commands is invoked.

           Reboot the machine, regardless of which one of the three
           commands is invoked.

       -f, --force
           Force immediate halt, power-off, or reboot. When specified
           once, this results in an immediate but clean shutdown by the
           system manager. When specified twice, this results in an
           immediate shutdown without contacting the system manager. See
           the description of --force in systemctl(1) for more details.

       -w, --wtmp-only
           Only write wtmp shutdown entry, do not actually halt,
           power-off, reboot.

       -d, --no-wtmp
           Do not write wtmp shutdown entry.

       -n, --no-sync
           Don't sync hard disks/storage media before halt, power-off,

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

EXIT STATUS         top

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

NOTES         top

       These commands are implemented in a way that preserves basic
       compatibility with the original SysV commands.  systemctl(1)
       verbs halt, poweroff, reboot provide the same functionality with
       some additional features.

       Note that on many SysV systems halt used to be synonymous to
       poweroff, i.e. both commands would equally result in powering the
       machine off. systemd is more accurate here, and halt results in
       halting the machine only (leaving power on), and poweroff is
       required to actually power it off.

SEE ALSO         top

       systemd(1), systemctl(1), shutdown(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
       This page was obtained from the project's upstream Git repository
       ⟨https://github.com/systemd/systemd.git⟩ on 2021-08-27.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2021-08-27.)  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 249                                                      HALT(8)

Pages that refer to this page: reboot(2)fsck.minix(8)mkfs.minix(8)shutdown(8)