| 1 | .TH SHUTDOWN 8
|
|---|
| 2 | .SH NAME
|
|---|
| 3 | shutdown \- graciously close the system down
|
|---|
| 4 | .SH SYNOPSIS
|
|---|
| 5 | .B shutdown
|
|---|
| 6 | .RB [ \-hrRmk ]
|
|---|
| 7 | .RB [ \-x
|
|---|
| 8 | .IR code ]
|
|---|
| 9 | .RI [ time-specification
|
|---|
| 10 | .RI [ message ]]
|
|---|
| 11 | .SH DESCRIPTION
|
|---|
| 12 | .B Shutdown
|
|---|
| 13 | is a program which allows a system operator to close down the system
|
|---|
| 14 | in an nice way.
|
|---|
| 15 | .B Shutdown
|
|---|
| 16 | informs the users why and when the system is going down. This warning
|
|---|
| 17 | is issued 10 minutes before shutdown time and every minute in the last
|
|---|
| 18 | 5 minutes. At this time (5 minutes),
|
|---|
| 19 | .B shutdown
|
|---|
| 20 | creates a file
|
|---|
| 21 | .B /etc/nologin
|
|---|
| 22 | to prevent new users from logging in.
|
|---|
| 23 | .PP
|
|---|
| 24 | .B Shutdown
|
|---|
| 25 | keeps a logfile of shutdowns. Every shutdown is registered in
|
|---|
| 26 | .BR /usr/adm/wtmp ,
|
|---|
| 27 | if this file exists, and by
|
|---|
| 28 | .BR syslog (3)
|
|---|
| 29 | (level
|
|---|
| 30 | .BR auth . notice ).
|
|---|
| 31 | After these actions, a call is done to
|
|---|
| 32 | .BR reboot (2)
|
|---|
| 33 | which actually brings the system down.
|
|---|
| 34 | .PP
|
|---|
| 35 | .I Time-specification
|
|---|
| 36 | may be something like
|
|---|
| 37 | .BR 15:00 ,
|
|---|
| 38 | .BR 15.00 ,
|
|---|
| 39 | .BR +15 ,
|
|---|
| 40 | or
|
|---|
| 41 | .B now
|
|---|
| 42 | for a shutdown at 3pm (twice), 15 minutes from now, or immediately.
|
|---|
| 43 | .PP
|
|---|
| 44 | The message may be used to describe why the system is going down, it may
|
|---|
| 45 | also be typed on standard input with the
|
|---|
| 46 | .B \-m
|
|---|
| 47 | option.
|
|---|
| 48 | .SH OPTIONS
|
|---|
| 49 | .TP
|
|---|
| 50 | .B \-h
|
|---|
| 51 | This flag prevents the system from rebooting after the shutdown. The
|
|---|
| 52 | system can now be powered off. This is the default.
|
|---|
| 53 | .TP
|
|---|
| 54 | .B \-r
|
|---|
| 55 | This flag indicates that the system should reboot after shutting down.
|
|---|
| 56 | .TP
|
|---|
| 57 | .B \-R
|
|---|
| 58 | Reboot the system by resetting it. Normally the kernel will try to return
|
|---|
| 59 | to the Boot Monitor. With
|
|---|
| 60 | .B \-R
|
|---|
| 61 | the system will receive a hardware reset.
|
|---|
| 62 | .TP
|
|---|
| 63 | .BI \-x " code"
|
|---|
| 64 | Halt the system and let the Monitor execute the given code as if typed at
|
|---|
| 65 | the monitor prompt. You can for instance use
|
|---|
| 66 | .B "\-x 'boot hd0'"
|
|---|
| 67 | as a very fast way to reboot "from the top."
|
|---|
| 68 | .TP
|
|---|
| 69 | .B \-m
|
|---|
| 70 | Allows the operator to type a shutdown message on standard input, that will
|
|---|
| 71 | be added to the messages displayed on all terminals.
|
|---|
| 72 | .TP
|
|---|
| 73 | .B \-k
|
|---|
| 74 | This option gives the possibility of terminating an already started
|
|---|
| 75 | shutdown. This is only possible if shutdown time has not yet arrived.
|
|---|
| 76 | .TP
|
|---|
| 77 | .B \-C
|
|---|
| 78 | Check if the system crashed. This option is not used at shutdown time,
|
|---|
| 79 | but at reboot time. It tells if the file systems should be checked by
|
|---|
| 80 | testing if the last entry in the wtmp file is a shutdown entry. (A
|
|---|
| 81 | crude replacement for a file system clean flag.)
|
|---|
| 82 | .SH "SEE ALSO"
|
|---|
| 83 | .BR reboot (2),
|
|---|
| 84 | .BR syslog (3),
|
|---|
| 85 | .BR halt (8),
|
|---|
| 86 | .BR boot (8).
|
|---|
| 87 | .SH AUTHOR
|
|---|
| 88 | Edvard Tuinder (v892231@si.hhs.NL)
|
|---|
