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+ -->
6 <refentry id=
"shutdown"
7 xmlns:
xi=
"http://www.w3.org/2001/XInclude">
10 <title>shutdown
</title>
11 <productname>systemd
</productname>
15 <refentrytitle>shutdown
</refentrytitle>
16 <manvolnum>8</manvolnum>
20 <refname>shutdown
</refname>
21 <refpurpose>Halt, power-off or reboot the machine
</refpurpose>
26 <command>shutdown
</command>
27 <arg choice=
"opt" rep=
"repeat">OPTIONS
</arg>
28 <arg choice=
"opt">TIME
</arg>
29 <arg choice=
"opt" rep=
"repeat">WALL
</arg>
34 <title>Description
</title>
36 <para><command>shutdown
</command> may be used to halt, power-off
37 or reboot the machine.
</para>
39 <para>The first argument may be a time string (which is usually
40 <literal>now
</literal>). Optionally, this may be followed by a
41 wall message to be sent to all logged-in users before going
44 <para>The time string may either be in the format
45 <literal>hh:mm
</literal> for hour/minutes specifying the time to
46 execute the shutdown at, specified in
24h clock format.
47 Alternatively it may be in the syntax
<literal>+m
</literal>
48 referring to the specified number of minutes m from now.
49 <literal>now
</literal> is an alias for
<literal>+
0</literal>, i.e.
50 for triggering an immediate shutdown. If no time argument is
51 specified,
<literal>+
1</literal> is implied.
</para>
53 <para>Note that to specify a wall message you must specify a time
56 <para>If the time argument is used,
5 minutes before the system
57 goes down the
<filename>/run/nologin
</filename> file is created to
58 ensure that further logins shall not be allowed.
</para>
62 <title>Options
</title>
64 <para>The following options are understood:
</para>
68 <term><option>--help
</option></term>
70 <xi:include href=
"standard-options.xml" xpointer=
"help-text" />
74 <term><option>-H
</option></term>
75 <term><option>--halt
</option></term>
77 <listitem><para>Halt the machine.
</para></listitem>
81 <term><option>-P
</option></term>
82 <term><option>--poweroff
</option></term>
84 <listitem><para>Power-off the machine (the
85 default).
</para></listitem>
89 <term><option>-r
</option></term>
90 <term><option>--reboot
</option></term>
92 <listitem><para>Reboot the
93 machine.
</para></listitem>
97 <term><option>-h
</option></term>
99 <listitem><para>Equivalent to
<option>--poweroff
</option>,
100 unless
<option>--halt
</option> is specified.
</para></listitem>
104 <term><option>-k
</option></term>
106 <listitem><para>Do not halt, power-off, reboot, just write
107 wall message.
</para></listitem>
111 <term><option>--no-wall
</option></term>
113 <listitem><para>Do not send wall
115 halt, power-off, reboot.
</para></listitem>
119 <term><option>-c
</option></term>
121 <listitem><para>Cancel a pending shutdown. This may be used
122 to cancel the effect of an invocation of
123 <command>shutdown
</command> with a time argument that is not
124 <literal>+
0</literal> or
125 <literal>now
</literal>.
</para></listitem>
132 <title>Exit status
</title>
134 <para>On success,
0 is returned, a non-zero failure code
139 <title>See Also
</title>
141 <citerefentry><refentrytitle>systemd
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
142 <citerefentry><refentrytitle>systemctl
</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
143 <citerefentry><refentrytitle>halt
</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
144 <citerefentry project='man-pages'
><refentrytitle>wall
</refentrytitle><manvolnum>1</manvolnum></citerefentry>