1.\" Copyright (c) 1988, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 4. Neither the name of the University nor the names of its contributors 13.\" may be used to endorse or promote products derived from this software 14.\" without specific prior written permission. 15.\" 16.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 17.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 20.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26.\" SUCH DAMAGE. 27.\" 28.\" @(#)shutdown.8 8.2 (Berkeley) 4/27/95 29.\" $FreeBSD$ 30.\" 31.Dd March 19, 2013 32.Dt SHUTDOWN 8 33.Os 34.Sh NAME 35.Nm shutdown , 36.Nm poweroff 37.Nd "close down the system at a given time" 38.Sh SYNOPSIS 39.Nm 40.Op Fl 41.Oo 42.Fl h | Fl p | 43.Fl r | Fl k 44.Oc 45.Oo 46.Fl o 47.Op Fl n 48.Oc 49.Ar time 50.Op Ar warning-message ... 51.Nm poweroff 52.Sh DESCRIPTION 53The 54.Nm 55utility provides an automated shutdown procedure for super-users 56to nicely notify users when the system is shutting down, 57saving them from system administrators, hackers, and gurus, who 58would otherwise not bother with such niceties. 59.Pp 60The following options are available: 61.Bl -tag -width indent 62.It Fl h 63The system is halted at the specified 64.Ar time . 65.It Fl p 66The system is halted and the power is turned off 67(hardware support required) 68at the specified 69.Ar time . 70.It Fl r 71The system is rebooted at the specified 72.Ar time . 73.It Fl k 74Kick everybody off. 75The 76.Fl k 77option 78does not actually halt the system, but leaves the 79system multi-user with logins disabled (for all but super-user). 80.It Fl o 81If one of the 82.Fl h , 83.Fl p 84or 85.Fl r 86options are specified, 87.Nm 88will execute 89.Xr halt 8 90or 91.Xr reboot 8 92instead of sending a signal to 93.Xr init 8 . 94.It Fl n 95If the 96.Fl o 97option is specified, prevent the file system cache from being flushed by passing 98.Fl n 99to 100.Xr halt 8 101or 102.Xr reboot 8 . 103This option should probably not be used. 104.It Ar time 105.Ar Time 106is the time at which 107.Nm 108will bring the system down and 109may be the case-insensitive word 110.Ar now 111(indicating an immediate shutdown) or 112a future time in one of two formats: 113.Ar +number , 114or 115.Ar yymmddhhmm , 116where the year, month, and day may be defaulted 117to the current system values. 118The first form brings the system down in 119.Ar number 120minutes and the second at the absolute time specified. 121.It Ar warning-message 122Any other arguments comprise the warning message that is broadcast 123to users currently logged into the system. 124.It Fl 125If 126.Sq Fl 127is supplied as an option, the warning message is read from the standard 128input. 129.El 130.Pp 131At intervals, becoming more frequent as apocalypse approaches 132and starting at ten hours before shutdown, warning messages are displayed 133on the terminals of all users logged in. 134Five minutes before 135shutdown, or immediately if shutdown is in less than 5 minutes, 136logins are disabled by creating 137.Pa /var/run/nologin 138and copying the 139warning message there. 140If this file exists when a user attempts to 141log in, 142.Xr login 1 143prints its contents and exits. 144The file is 145removed just before 146.Nm 147exits. 148.Pp 149At shutdown time a message is written to the system log, containing the 150time of shutdown, the person who initiated the shutdown and the reason. 151The corresponding signal is then sent to 152.Xr init 8 153to respectively halt, reboot or bring the system down to single-user state 154(depending on the above options). 155The time of the shutdown and the warning message 156are placed in 157.Pa /var/run/nologin 158and should be used to 159inform the users about when the system will be back up 160and why it is going down (or anything else). 161.Pp 162A scheduled shutdown can be canceled by killing the 163.Nm 164process (a 165.Dv SIGTERM 166should suffice). 167The 168.Pa /var/run/nologin 169file that 170.Nm 171created will be removed automatically. 172.Pp 173When run without options, the 174.Nm 175utility will place the system into single user mode at the 176.Ar time 177specified. 178.Pp 179Calling 180.Dq Nm poweroff 181is equivalent to running: 182.Bd -literal -offset indent 183shutdown -p now 184.Ed 185.Sh FILES 186.Bl -tag -width /var/run/nologin -compact 187.It Pa /var/run/nologin 188tells 189.Xr login 1 190not to let anyone log in 191.El 192.Sh EXAMPLES 193Reboot the system in 30 minutes and display a warning message on the terminals 194of all users currently logged in: 195.Pp 196.Dl # shutdown -r +30 \&"System will reboot\&" 197.Sh COMPATIBILITY 198The hours and minutes in the second time format may be separated by 199a colon (``:'') for backward compatibility. 200.Sh SEE ALSO 201.Xr kill 1 , 202.Xr login 1 , 203.Xr wall 1 , 204.Xr nologin 5 , 205.Xr halt 8 , 206.Xr init 8 , 207.Xr reboot 8 208.Sh HISTORY 209The 210.Nm 211utility appeared in 212.Bx 4.0 . 213