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+
8 This file is part of systemd.
10 Copyright 2010 Lennart Poettering
12 systemd is free software; you can redistribute it and/or modify it
13 under the terms of the GNU Lesser General Public License as published by
14 the Free Software Foundation; either version 2.1 of the License, or
15 (at your option) any later version.
17 systemd is distributed in the hope that it will be useful, but
18 WITHOUT ANY WARRANTY; without even the implied warranty of
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 Lesser General Public License for more details.
22 You should have received a copy of the GNU Lesser General Public License
23 along with systemd; If not, see <http://www.gnu.org/licenses/>.
27 xmlns:
xi=
"http://www.w3.org/2001/XInclude">
31 <productname>systemd
</productname>
35 <contrib>Developer
</contrib>
36 <firstname>Lennart
</firstname>
37 <surname>Poettering
</surname>
38 <email>lennart@poettering.net
</email>
44 <refentrytitle>halt
</refentrytitle>
45 <manvolnum>8</manvolnum>
49 <refname>halt
</refname>
50 <refname>poweroff
</refname>
51 <refname>reboot
</refname>
52 <refpurpose>Halt, power-off or reboot the machine
</refpurpose>
57 <command>halt
</command>
58 <arg choice=
"opt" rep=
"repeat">OPTIONS
</arg>
61 <command>poweroff
</command>
62 <arg choice=
"opt" rep=
"repeat">OPTIONS
</arg>
65 <command>reboot
</command>
66 <arg choice=
"opt" rep=
"repeat">OPTIONS
</arg>
71 <title>Description
</title>
73 <para><command>halt
</command>,
<command>poweroff
</command>,
74 <command>reboot
</command> may be used to halt, power-off or reboot
80 <title>Options
</title>
82 <para>The following options are understood:
</para>
86 <term><option>--help
</option></term>
88 <xi:include href=
"standard-options.xml" xpointer=
"help-text" />
92 <term><option>--halt
</option></term>
94 <listitem><para>Halt the machine, regardless of which one of
95 the three commands is invoked.
</para></listitem>
99 <term><option>-p
</option></term>
100 <term><option>--poweroff
</option></term>
102 <listitem><para>Power-off the machine, regardless of which one
103 of the three commands is invoked.
</para></listitem>
107 <term><option>--reboot
</option></term>
109 <listitem><para>Reboot the machine, regardless of which one of
110 the three commands is invoked.
</para></listitem>
114 <term><option>-f
</option></term>
115 <term><option>--force
</option></term>
117 <listitem><para>Force immediate halt, power-off, or reboot. When
118 specified once, this results in an immediate but clean shutdown
119 by the system manager. When specified twice, this results in an
120 immediate shutdown without contacting the system manager. See the
121 description of
<option>--force
</option> in
122 <citerefentry><refentrytitle>systemctl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>
123 for more details.
</para></listitem>
127 <term><option>-w
</option></term>
128 <term><option>--wtmp-only
</option></term>
130 <listitem><para>Only write wtmp shutdown entry, do not
131 actually halt, power-off, reboot.
</para></listitem>
135 <term><option>-d
</option></term>
136 <term><option>--no-wtmp
</option></term>
138 <listitem><para>Do not write wtmp shutdown
139 entry.
</para></listitem>
143 <term><option>-n
</option></term>
144 <term><option>--no-sync
</option></term>
146 <listitem><para>Don't sync hard disks/storage media before
147 halt, power-off, reboot.
</para></listitem>
151 <term><option>--no-wall
</option></term>
153 <listitem><para>Do not send wall message before halt,
154 power-off, reboot.
</para></listitem>
160 <title>Exit status
</title>
162 <para>On success,
0 is returned, a non-zero failure code
169 <para>These are legacy commands available for compatibility
174 <title>See Also
</title>
176 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
177 <citerefentry><refentrytitle>systemctl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
178 <citerefentry><refentrytitle>shutdown
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
179 <citerefentry project='man-pages'
><refentrytitle>wall
</refentrytitle><manvolnum>1</manvolnum></citerefentry>