POWEROFF(8) poweroff POWEROFF(8)

.SH "NAME" poweroff, reboot, halt - Power off, reboot, or halt the machine

.SH "SYNOPSIS"

.HP 216u

**poweroff**  
\[OPTIONS...]

.HP 168u

**reboot**  
\[OPTIONS...]

.HP 120u

**halt**  
\[OPTIONS...]

.SH "DESCRIPTION"

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

.SH "OPTIONS"

.PP The following options are understood:

.PP **--help**

Print a short help text and exit.

Added in version 253.

.RE

.PP **--halt**

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

Added in version 253.

.RE

.PP **-p**, **--poweroff**

Power off the machine, when either **halt** or **poweroff** is invoked. This option is ignored when **reboot** is invoked.

Added in version 253.

.RE

.PP **--reboot**

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

Added in version 253.

.RE

.PP **-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**.

Added in version 253.

.RE

.PP **-w**, **--wtmp-only**

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

Added in version 253.

.RE

.PP **-d**, **--no-wtmp**

Do not write wtmp shutdown entry.

Added in version 253.

.RE

.PP **-n**, **--no-sync**

Do not sync hard disks/storage media before power-off, reboot, or halt.

Added in version 253.

.RE

.PP **--no-wall**

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

Added in version 253.

.RE

.SH "EXIT STATUS"

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

.SH "NOTES"

.PP These commands are implemented in a way that preserves basic compatibility with the original SysV commands. [**systemctl**(1)](/man/os/systemd/systemctl.1) verbs **poweroff**, **reboot**, **halt** provide the same functionality with some additional features.

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

.SH "SEE ALSO"

.PP [**systemd**(1)](/man/os/systemd/systemd.1), [**systemctl**(1)](/man/os/systemd/systemctl.1), [**shutdown**(8)](/man/os/systemd/shutdown.8), [**wall**(1)](/man/os/systemd/wall.1)

systemd 262.2

---

Document: poweroff(8) from systemd 262.2-r1 (Chainguard OS)
Source: https://github.com/systemd/systemd