|
|
1.1 root 1: .\" Copyright (c) 1988 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)shutdown.8 6.7 (Berkeley) 6/24/90
19: .\"
20: .TH SHUTDOWN 8 "June 24, 1990"
21: .UC 4
22: .SH NAME
23: shutdown \- close down the system at a given time
24: .SH SYNOPSIS
25: .B shutdown
26: [
27: .B -
28: ] [
29: .B \-fhkrn
30: ]
31: time [ warning-message ... ]
32: .SH DESCRIPTION
33: .I Shutdown
34: provides an automated shutdown procedure which a super-user
35: can use to notify users nicely when the system is shutting down,
36: saving them from system administrators, hackers, and gurus, who
37: would otherwise not bother with such niceties.
38: .PP
39: .I Time
40: is the time at which \fIshutdown\fP will bring the system down and
41: may be the word \fInow\fP (indicating an immediate shutdown) or
42: specify a future time in one of two formats: \fI+number\fP, or
43: \fIyymmddhhmm\fP, where the year, month, and day may be defaulted
44: to the current system values. The first form brings the system down in
45: \fInumber\fP minutes and the second at the absolute time specified.
46: .PP
47: Any other arguments comprise the warning message that is broadcast
48: to users currently logged into the system; if a single dash (``-'')
49: is supplied as an option, the warning message is read from the standard
50: input.
51: .PP
52: At intervals, which get closer together as apocalypse approaches,
53: starting at ten hours before shutdown, warning messages are displayed
54: at the terminals of all users on the system. Five minutes before
55: shutdown, or immediately if shutdown is in less than 5 minutes,
56: logins are disabled by creating \fI/etc/nologin\fP and copying the
57: warning message there. If this file exists when a user attempts to
58: log in, \fIlogin\fP(1) prints its contents and exits. The file is
59: removed just before \fIshutdown\fP exits.
60: .PP
61: At shutdown time a message is written in the system log, containing the
62: time of shutdown, who ran shutdown and the reason. Then a terminate
63: signal is sent to \fIinit\fP to bring the system down to single-user state.
64: Alternatively, if
65: .B \-r,
66: .B \-h,
67: or
68: .B \-k
69: is used, then
70: .I shutdown
71: will exec
72: .IR reboot (8),
73: .IR halt (8),
74: or avoid shutting the system down (respectively).
75: (If it isn't obvious,
76: .B \-k
77: is to make people
78: .I think
79: the system is going down!)
80: .PP
81: With the
82: .B \-f
83: option,
84: .I shutdown
85: arranges, in the manner of
86: .IR fastboot (8),
87: that when the system is rebooted the file systems will not
88: be checked. The
89: .B \-n
90: option prevents the normal
91: .IR sync (2)
92: before stopping.
93: .PP
94: The time of the shutdown and the warning message
95: are placed in \fI/etc/nologin\fP and should be used to
96: inform the users about when the system will be back up
97: and why it is going down (or anything else).
98: .SH FILES
99: .TP 15
100: /etc/nologin
101: tells login not to let anyone log in
102: .TP 15
103: /fastboot
104: tells /etc/rc not to run fsck when rebooting
105: .SH "SEE ALSO"
106: login(1), wall(1), fastboot(8), halt(8), reboot(8)
107: .SH "BACKWARD COMPATIBILITY"
108: The hours and minutes in the second time format may be separated by
109: a colon (``:'') for backward compatibility.
110:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.