1 <?xml version='
1.0'
?> <!--*-nxml-*-->
2 <!DOCTYPE refentry PUBLIC
"-//OASIS//DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
6 SPDX-License-Identifier: LGPL-2.1+
10 xmlns:
xi=
"http://www.w3.org/2001/XInclude">
14 <productname>systemd
</productname>
18 <contrib>Developer
</contrib>
19 <firstname>Lennart
</firstname>
20 <surname>Poettering
</surname>
21 <email>lennart@poettering.net
</email>
27 <refentrytitle>halt
</refentrytitle>
28 <manvolnum>8</manvolnum>
32 <refname>halt
</refname>
33 <refname>poweroff
</refname>
34 <refname>reboot
</refname>
35 <refpurpose>Halt, power-off or reboot the machine
</refpurpose>
40 <command>halt
</command>
41 <arg choice=
"opt" rep=
"repeat">OPTIONS
</arg>
44 <command>poweroff
</command>
45 <arg choice=
"opt" rep=
"repeat">OPTIONS
</arg>
48 <command>reboot
</command>
49 <arg choice=
"opt" rep=
"repeat">OPTIONS
</arg>
54 <title>Description
</title>
56 <para><command>halt
</command>,
<command>poweroff
</command>,
57 <command>reboot
</command> may be used to halt, power-off or reboot
63 <title>Options
</title>
65 <para>The following options are understood:
</para>
69 <term><option>--help
</option></term>
71 <xi:include href=
"standard-options.xml" xpointer=
"help-text" />
75 <term><option>--halt
</option></term>
77 <listitem><para>Halt the machine, regardless of which one of
78 the three commands is invoked.
</para></listitem>
82 <term><option>-p
</option></term>
83 <term><option>--poweroff
</option></term>
85 <listitem><para>Power-off the machine, regardless of which one
86 of the three commands is invoked.
</para></listitem>
90 <term><option>--reboot
</option></term>
92 <listitem><para>Reboot the machine, regardless of which one of
93 the three commands is invoked.
</para></listitem>
97 <term><option>-f
</option></term>
98 <term><option>--force
</option></term>
100 <listitem><para>Force immediate halt, power-off, or reboot. When
101 specified once, this results in an immediate but clean shutdown
102 by the system manager. When specified twice, this results in an
103 immediate shutdown without contacting the system manager. See the
104 description of
<option>--force
</option> in
105 <citerefentry><refentrytitle>systemctl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
106 for more details.
</para></listitem>
110 <term><option>-w
</option></term>
111 <term><option>--wtmp-only
</option></term>
113 <listitem><para>Only write wtmp shutdown entry, do not
114 actually halt, power-off, reboot.
</para></listitem>
118 <term><option>-d
</option></term>
119 <term><option>--no-wtmp
</option></term>
121 <listitem><para>Do not write wtmp shutdown
122 entry.
</para></listitem>
126 <term><option>-n
</option></term>
127 <term><option>--no-sync
</option></term>
129 <listitem><para>Don't sync hard disks/storage media before
130 halt, power-off, reboot.
</para></listitem>
134 <term><option>--no-wall
</option></term>
136 <listitem><para>Do not send wall message before halt,
137 power-off, reboot.
</para></listitem>
143 <title>Exit status
</title>
145 <para>On success,
0 is returned, a non-zero failure code
152 <para>These commands are implemented in a way that preserves compatibility with
153 the original SysV commands.
154 <citerefentry><refentrytitle>systemctl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
155 verbs
<command>halt
</command>,
<command>poweroff
</command>,
156 <command>reboot
</command> provide the same functionality with some additional
161 <title>See Also
</title>
163 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
164 <citerefentry><refentrytitle>systemctl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
165 <citerefentry><refentrytitle>shutdown
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
166 <citerefentry project='man-pages'
><refentrytitle>wall
</refentrytitle><manvolnum>1</manvolnum></citerefentry>