Annotation of 43BSDReno/sbin/shutdown/shutdown.8, revision 1.1.1.1

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: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.