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>,
45 <command>reboot
</command> may be used to halt, power-off or reboot
51 <title>Options
</title>
53 <para>The following options are understood:
</para>
57 <term><option>--help
</option></term>
59 <xi:include href=
"standard-options.xml" xpointer=
"help-text" />
63 <term><option>--halt
</option></term>
65 <listitem><para>Halt the machine, regardless of which one of
66 the three commands is invoked.
</para></listitem>
70 <term><option>-p
</option></term>
71 <term><option>--poweroff
</option></term>
73 <listitem><para>Power-off the machine, regardless of which one
74 of the three commands is invoked.
</para></listitem>
78 <term><option>--reboot
</option></term>
80 <listitem><para>Reboot the machine, regardless of which one of
81 the three commands is invoked.
</para></listitem>
85 <term><option>-f
</option></term>
86 <term><option>--force
</option></term>
88 <listitem><para>Force immediate halt, power-off, or reboot. When
89 specified once, this results in an immediate but clean shutdown
90 by the system manager. When specified twice, this results in an
91 immediate shutdown without contacting the system manager. See the
92 description of
<option>--force
</option> in
93 <citerefentry><refentrytitle>systemctl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
94 for more details.
</para></listitem>
98 <term><option>-w
</option></term>
99 <term><option>--wtmp-only
</option></term>
101 <listitem><para>Only write wtmp shutdown entry, do not
102 actually halt, power-off, reboot.
</para></listitem>
106 <term><option>-d
</option></term>
107 <term><option>--no-wtmp
</option></term>
109 <listitem><para>Do not write wtmp shutdown
110 entry.
</para></listitem>
114 <term><option>-n
</option></term>
115 <term><option>--no-sync
</option></term>
117 <listitem><para>Don't sync hard disks/storage media before
118 halt, power-off, reboot.
</para></listitem>
122 <term><option>--no-wall
</option></term>
124 <listitem><para>Do not send wall message before halt,
125 power-off, reboot.
</para></listitem>
131 <title>Exit status
</title>
133 <para>On success,
0 is returned, a non-zero failure code
140 <para>These commands are implemented in a way that preserves compatibility with
141 the original SysV commands.
142 <citerefentry><refentrytitle>systemctl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
143 verbs
<command>halt
</command>,
<command>poweroff
</command>,
144 <command>reboot
</command> provide the same functionality with some additional
149 <title>See Also
</title>
151 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
152 <citerefentry><refentrytitle>systemctl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
153 <citerefentry><refentrytitle>shutdown
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
154 <citerefentry project='man-pages'
><refentrytitle>wall
</refentrytitle><manvolnum>1</manvolnum></citerefentry>