1
'\" -*- coding: UTF-8 -*-
2
.\" Copyright (C) 1998-2003 Miquel van Smoorenburg.
4
.\" This program is free software; you can redistribute it and/or modify
5
.\" it under the terms of the GNU General Public License as published by
6
.\" the Free Software Foundation; either version 2 of the License, or
7
.\" (at your option) any later version.
9
.\" This program is distributed in the hope that it will be useful,
10
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
11
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
.\" GNU General Public License for more details.
14
.\" You should have received a copy of the GNU General Public License
15
.\" along with this program; if not, write to the Free Software
16
.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20
.TH SHUTDOWN 8 "November 12, 2003" "" "Linux System Administrator's Manual"
24
shutdown \- bring the system down
33
.RI [ "warning message" ]
37
\fBshutdown\fP brings the system down in a secure way. All logged-in users are
38
notified that the system is going down, and \fBlogin\fP(1) is blocked.
39
It is possible to shut the system down immediately or after a specified delay.
40
All processes are first notified that the system is going down by the
41
signal \s-2SIGTERM\s0. This gives programs like \fBvi\fP(1)
42
the time to save the file being edited,
43
mail and news processing programs a chance to exit cleanly, etc.
44
\fBshutdown\fP does its job by signalling the \fBinit\fP process,
45
asking it to change the runlevel.
46
Runlevel \fB0\fP is used to halt the system, runlevel \fB6\fP is used
47
to reboot the system, and runlevel \fB1\fP is used to put to system into
48
a state where administrative tasks can be performed; this is the default
49
if neither the \fI-h\fP or \fI-r\fP flag is given to \fBshutdown\fP.
50
To see which actions are taken on halt or reboot see the appropriate
51
entries for these runlevels in the file \fI/etc/inittab\fP.
57
Use \fB/etc/shutdown.allow\fP.
61
Don't really shutdown; only send the warning messages to everybody.
65
Reboot after shutdown.
69
Halt or power off after shutdown.
73
Halt action is to turn off the power.
77
Modifier to the -h flag. Halt action is to halt or drop into boot
78
monitor on systems that support it. Must be used with the -h flag.
90
[DEPRECATED] Don't call \fBinit\fP(8) to do the shutdown but do it ourself.
91
The use of this option is discouraged, and its results are not always what
96
Cancel a waiting shutdown. ("shutdown now" is no longer waiting.) With
97
this option it is of course not possible to give the time argument, but
98
you can enter explanatory message arguments on the command line that
99
will be sent to all users.
102
.IP "\fB\-t\fP \fIsec\fP"
103
Tell \fBinit\fP(8) to wait \fIsec\fP seconds between sending processes the
104
warning and the kill signal, before changing to another runlevel.
110
.\"{{{ warning-message
111
.IP "\fIwarning message\fP"
112
Message to send to all users.
115
The \fItime\fP argument can have different formats. First, it can be an
116
absolute time in the format \fIhh:mm\fP, in which \fIhh\fP is the hour
117
(1 or 2 digits) and \fImm\fP is the minute of the hour (in two digits).
118
Second, it can be in the format \fB+\fP\fIm\fP, in which \fIm\fP is the
119
number of minutes to wait. The word \fBnow\fP is an alias for \fB+0\fP.
121
If shutdown is called with a delay, it will create the advisory file
123
which causes programs such as \fIlogin(1)\fP to not allow new user
124
logins. This file is created five minutes before the shutdown sequence
125
starts. Shutdown removes this file if it is stopped before it
126
can signal init (i.e. it is cancelled or something goes wrong).
127
It also removes it before calling init to change the runlevel.
129
The \fB\-f\fP flag means `reboot fast'. This only creates an advisory
130
file \fI/fastboot\fP which can be tested by the system when it comes
131
up again. The boot rc file can test if this file is present, and decide not
132
to run \fBfsck\fP(1) since the system has been shut down in the proper way.
133
After that, the boot process should remove \fI/fastboot\fP.
135
The \fB\-F\fP flag means `force fsck'. This only creates an advisory
136
file \fI/forcefsck\fP which can be tested by the system when it comes
137
up again. The boot rc file can test if this file is present, and decide
138
to run \fBfsck\fP(1) with a special `force' flag so that even properly
139
unmounted file systems get checked.
140
After that, the boot process should remove \fI/forcefsck\fP.
142
The \fB-n\fP flag causes \fBshutdown\fP not to call \fBinit\fP,
143
but to kill all running processes itself.
144
\fBshutdown\fP will then turn off quota, accounting, and swapping
145
and unmount all file systems.
149
\fBshutdown\fP can be called from \fBinit\fP(8) when the magic keys
150
\fBCTRL-ALT-DEL\fP are pressed, by creating an appropriate entry in
151
\fI/etc/inittab\fP. This means that everyone who has physical access
152
to the console keyboard can shut the system down. To prevent this,
153
\fBshutdown\fP can check to see if an authorized user is logged in on
154
one of the virtual consoles. If \fBshutdown\fP is called with the \fB-a\fP
155
argument (add this to the invocation of shutdown in /etc/inittab),
156
it checks to see if the file \fI/etc/shutdown.allow\fP is present.
157
It then compares the login names in that file with the list of people
158
that are logged in on a virtual console (from \fI/var/run/utmp\fP). Only
159
if one of those authorized users \fBor root\fP is logged in, it will
160
proceed. Otherwise it will write the message
163
\fBshutdown: no authorized users logged in\fP
166
to the (physical) system console. The format of \fI/etc/shutdown.allow\fP
167
is one user name per line. Empty lines and comment lines (prefixed by a
168
\fB#\fP) are allowed. Currently there is a limit of 32 users in this file.
170
Note that if \fI/etc/shutdown.allow\fP is not present, the \fB-a\fP
173
The \fB-H\fP option just sets the \fIinit\fP environment variable
174
\fIINIT_HALT\fP to \fIHALT\fP, and the \fB-P\fP option just sets
175
that variable to \fIPOWEROFF\fP. The shutdown script that calls
176
\fBhalt\fP(8) as the last thing in the shutdown sequence should
177
check these environment variables and call \fBhalt\fP(8) with
178
the right options for these options to actually have any effect.
179
Debian 3.1 (sarge) supports this.
190
A lot of users forget to give the \fItime\fP argument
191
and are then puzzled by the error message \fBshutdown\fP produces. The
192
\fItime\fP argument is mandatory; in 90 percent of all cases this argument
193
will be the word \fBnow\fP.
195
Init can only capture CTRL-ALT-DEL and start shutdown in console mode.
196
If the system is running the X window System, the X server processes
197
all key strokes. Some X11 environments make it possible to capture
198
CTRL-ALT-DEL, but what exactly is done with that event depends on
201
Shutdown wasn't designed to be run setuid. /etc/shutdown.allow is
202
not used to find out who is executing shutdown, it ONLY checks who
203
is currently logged in on (one of the) console(s).
206
Miquel van Smoorenburg, miquels@cistron.nl