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 This file is part of systemd.
8 Copyright 2010 Lennart Poettering
10 systemd is free software; you can redistribute it and/or modify it
11 under the terms of the GNU Lesser General Public License as published by
12 the Free Software Foundation; either version 2.1 of the License, or
13 (at your option) any later version.
15 systemd is distributed in the hope that it will be useful, but
16 WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 Lesser General Public License for more details.
20 You should have received a copy of the GNU Lesser General Public License
21 along with systemd; If not, see <http://www.gnu.org/licenses/>.
28 <productname>systemd</productname>
32 <contrib>Developer</contrib>
33 <firstname>Lennart</firstname>
34 <surname>Poettering</surname>
35 <email>lennart@poettering.net</email>
41 <refentrytitle>halt</refentrytitle>
42 <manvolnum>8</manvolnum>
46 <refname>halt</refname>
47 <refname>poweroff</refname>
48 <refname>reboot</refname>
49 <refpurpose>Halt, power-off or reboot the machine</refpurpose>
54 <command>halt <arg choice="opt" rep="repeat">OPTIONS</arg></command>
57 <command>poweroff <arg choice="opt" rep="repeat">OPTIONS</arg></command>
60 <command>reboot <arg choice="opt" rep="repeat">OPTIONS</arg></command>
65 <title>Description</title>
67 <para><command>halt</command>,
68 <command>poweroff</command>, <command>reboot</command>
69 may be used to halt, power-off or reboot the
75 <title>Options</title>
77 <para>The following options are understood:</para>
81 <term><option>--help</option></term>
83 <listitem><para>Prints a short help
84 text and exits.</para></listitem>
88 <term><option>--halt</option></term>
90 <listitem><para>Halt the machine,
91 regardless which one of the three
92 commands is invoked.</para></listitem>
96 <term><option>-p</option></term>
97 <term><option>--poweroff</option></term>
99 <listitem><para>Power-off the machine,
100 regardless which one of the three
101 commands is invoked.</para></listitem>
105 <term><option>--reboot</option></term>
107 <listitem><para>Reboot the machine,
108 regardless which one of the three
109 commands is invoked.</para></listitem>
113 <term><option>-f</option></term>
114 <term><option>--force</option></term>
116 <listitem><para>Force immediate halt,
117 power-off, reboot. Don't contact the
118 init system.</para></listitem>
122 <term><option>-w</option></term>
123 <term><option>--wtmp-only</option></term>
125 <listitem><para>Only write wtmp
126 shutdown entry, don't actually halt,
127 power-off, reboot.</para></listitem>
131 <term><option>-d</option></term>
132 <term><option>--no-wtmp</option></term>
134 <listitem><para>Don't write wtmp
135 shutdown entry.</para></listitem>
139 <term><option>-n</option></term>
140 <term><option>--no-sync</option></term>
142 <listitem><para>Don't sync hard disks/storage media before
144 reboot.</para></listitem>
148 <term><option>--no-wall</option></term>
150 <listitem><para>Don't send wall
152 halt, power-off, reboot.</para></listitem>
158 <title>Exit status</title>
160 <para>On success 0 is returned, a non-zero failure
161 code otherwise.</para>
167 <para>These are legacy commands available for
168 compatibility only.</para>
172 <title>See Also</title>
174 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
175 <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
176 <citerefentry><refentrytitle>shutdown</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
177 <citerefentry><refentrytitle>wall</refentrytitle><manvolnum>1</manvolnum></citerefentry>