1 <?xml version='
1.0'
?> <!--*-nxml-*-->
2 <!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4 <!-- SPDX-License-Identifier: LGPL-2.1+ -->
7 xmlns:
xi=
"http://www.w3.org/2001/XInclude">
11 <productname>systemd
</productname>
15 <refentrytitle>halt
</refentrytitle>
16 <manvolnum>8</manvolnum>
20 <refname>halt
</refname>
21 <refname>poweroff
</refname>
22 <refname>reboot
</refname>
23 <refpurpose>Halt, power-off or reboot the machine
</refpurpose>
28 <command>halt
</command>
29 <arg choice=
"opt" rep=
"repeat">OPTIONS
</arg>
32 <command>poweroff
</command>
33 <arg choice=
"opt" rep=
"repeat">OPTIONS
</arg>
36 <command>reboot
</command>
37 <arg choice=
"opt" rep=
"repeat">OPTIONS
</arg>
42 <title>Description
</title>
44 <para><command>halt
</command>,
<command>poweroff
</command>,
<command>reboot
</command> may be used to
45 halt, power-off, or reboot the machine. All three commands take the same options.
</para>
50 <title>Options
</title>
52 <para>The following options are understood:
</para>
56 <term><option>--help
</option></term>
58 <xi:include href=
"standard-options.xml" xpointer=
"help-text" />
62 <term><option>--halt
</option></term>
64 <listitem><para>Halt the machine, regardless of which one of
65 the three commands is invoked.
</para></listitem>
69 <term><option>-p
</option></term>
70 <term><option>--poweroff
</option></term>
72 <listitem><para>Power-off the machine, regardless of which one
73 of the three commands is invoked.
</para></listitem>
77 <term><option>--reboot
</option></term>
79 <listitem><para>Reboot the machine, regardless of which one of
80 the three commands is invoked.
</para></listitem>
84 <term><option>-f
</option></term>
85 <term><option>--force
</option></term>
87 <listitem><para>Force immediate halt, power-off, or reboot. When
88 specified once, this results in an immediate but clean shutdown
89 by the system manager. When specified twice, this results in an
90 immediate shutdown without contacting the system manager. See the
91 description of
<option>--force
</option> in
92 <citerefentry><refentrytitle>systemctl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
93 for more details.
</para></listitem>
97 <term><option>-w
</option></term>
98 <term><option>--wtmp-only
</option></term>
100 <listitem><para>Only write wtmp shutdown entry, do not
101 actually halt, power-off, reboot.
</para></listitem>
105 <term><option>-d
</option></term>
106 <term><option>--no-wtmp
</option></term>
108 <listitem><para>Do not write wtmp shutdown
109 entry.
</para></listitem>
113 <term><option>-n
</option></term>
114 <term><option>--no-sync
</option></term>
116 <listitem><para>Don't sync hard disks/storage media before
117 halt, power-off, reboot.
</para></listitem>
121 <term><option>--no-wall
</option></term>
123 <listitem><para>Do not send wall message before halt,
124 power-off, reboot.
</para></listitem>
130 <title>Exit status
</title>
132 <para>On success,
0 is returned, a non-zero failure code
139 <para>These commands are implemented in a way that preserves basic compatibility with the original SysV
140 commands.
<citerefentry><refentrytitle>systemctl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
141 verbs
<command>halt
</command>,
<command>poweroff
</command>,
<command>reboot
</command> provide the same
142 functionality with some additional features.
</para>
144 <para>Note that on many SysV systems
<command>halt
</command> used to be synonymous to
145 <command>poweroff
</command>, i.e. both commands would equally result in powering the machine off. systemd
146 is more accurate here, and
<command>halt
</command> results in halting the machine only (leaving power
147 on), and
<command>poweroff
</command> is required to actually power it off.
</para>
151 <title>See Also
</title>
153 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
154 <citerefentry><refentrytitle>systemctl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
155 <citerefentry><refentrytitle>shutdown
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
156 <citerefentry project='man-pages'
><refentrytitle>wall
</refentrytitle><manvolnum>1</manvolnum></citerefentry>