poweroff(8) — Linux manual page


POWEROFF(8)                     poweroff                     POWEROFF(8)

NAME         top

       poweroff, reboot, halt - Power off, reboot, or halt the machine

SYNOPSIS         top

       poweroff [OPTIONS...]

       reboot [OPTIONS...]

       halt [OPTIONS...]

DESCRIPTION         top

       poweroff, reboot, and halt may be used to power off, reboot, or
       halt 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, when either halt or poweroff is
           invoked. This option is ignored when reboot is invoked.

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

       -f, --force
           Force immediate power-off, halt, or reboot. If specified, the
           command does not contact the init system. In most cases,
           filesystems are not properly unmounted before shutdown. For
           example, the command reboot -f is mostly equivalent to
           systemctl reboot -ff, instead of systemctl reboot -f.

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

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

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

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

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 poweroff, reboot, halt 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 2023-06-23.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2023-06-23.)  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 253                                                  POWEROFF(8)

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