xref: /386bsd/usr/share/man/cat8/shutdown.0 (revision a2142627) 
1SHUTDOWN(8)             386BSD System Manager's Manual             SHUTDOWN(8)
2
3NNAAMMEE
4     sshhuuttddoowwnn - close down the system at a given time
5
6SSYYNNOOPPSSIISS
7     sshhuuttddoowwnn [--] [--ffhhkkrrnn] _t_i_m_e [_w_a_r_n_i_n_g-_m_e_s_s_a_g_e ...]
8
9DDEESSCCRRIIPPTTIIOONN
10     SShhuuttddoowwnn provides an automated shutdown procedure for super-users to
11     nicely notify users when the system is shutting down, saving them from
12     system administrators, hackers, and gurus, who would otherwise not bother
13     with such niceties.
14
15     Available friendlinesses:
16
17     --ff    SShhuuttddoowwnn arranges, in the manner of fastboot(8),  for the file
18           systems _n_o_t _t_o _b_e checked on reboot.
19
20     --hh    The system is halted at the specified _t_i_m_e when sshhuuttddoowwnn execs
21           halt(8).
22
23     --kk    Kick every body off.  The --kk option does not actually halt the
24           system, but leaves the system multi-user with logins disabled (for
25           all but super-user).
26
27     --nn    Prevent the normal sync(2) before stopping.
28
29     --rr    SShhuuttddoowwnn execs reboot(8) at the specified _t_i_m_e.
30
31     _t_i_m_e  _T_i_m_e is the time at which sshhuuttddoowwnn will bring the system down and
32           may be the word _n_o_w (indicating an immediate shutdown) or specify a
33           future time in one of two formats: +_n_u_m_b_e_r, or _y_y_m_m_d_d_h_h_m_m, where
34           the year, month, and day may be defaulted to the current system
35           values.  The first form brings the system down in _n_u_m_b_e_r minutes
36           and the second at the absolute time specified.
37
38     _w_a_r_n_i_n_g-_m_e_s_s_a_g_e
39           Any other arguments comprise the warning message that is broadcast
40           to users currently logged into the system.
41
42     --     If `--' is supplied as an option, the warning message is read from
43           the standard input.
44
45     At intervals, becoming more frequent as apocalypse approaches and
46     starting at ten hours before shutdown, warning messages are displayed on
47     the terminals of all users logged in.  Five minutes before shutdown, or
48     immediately if shutdown is in less than 5 minutes, logins are disabled by
49     creating /_e_t_c/_n_o_l_o_g_i_n and copying the warning message there.  If this
50     file exists when a user attempts to log in, login(1) prints its contents
51     and exits.  The file is removed just before sshhuuttddoowwnn exits.
52
53     At shutdown time a message is written in the system log, containing the
54     time of shutdown, who initiated the shutdown and the reason.  A terminate
55     signal is then sent to init to bring the system down to single-user state
56     (depending on above options).  The time of the shutdown and the warning
57     message are placed in /_e_t_c/_n_o_l_o_g_i_n and should be used to inform the users
58     about when the system will be back up and why it is going down (or
59     anything else).
60
61FFIILLEESS
62     /etc/nologin  tells login not to let anyone log in
63     /fastboot     tells rc(8) not to run fsck when rebooting
64
65SSEEEE AALLSSOO
66     login(1),  wall(1),  fastboot(8),  halt(8),  reboot(8)
67
68BBAACCKKWWAARRDD CCOOMMPPAATTIIBBIILLIITTYY
69     The hours and minutes in the second time format may be separated by a
70     colon (``:'') for backward compatibility.
71
72HHIISSTTOORRYY
73     The sshhuuttddoowwnn command appeared in 4.0BSD.
74
754th Berkeley Distribution       March 16, 1991                               2
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133