SHUTDOWN(8) COMMAND REFERENCE SHUTDOWN(8) NAME shutdown - close down the system at a given time SYNOPSIS shutdown [ -h ] [ -k ] [ -r ] time [ warning-message ... ] DESCRIPTION The shutdown command evokes an automated shutdown procedure which also notifies the users when the system is shutting down; a superuser must invoke the shutdown command. The command is normally run only in multi-user mode and it is the preferred method of shutting down the system when a "soft" power switch is not available. On machines without a "soft" power switch UTek must be prepared for turning off power so that information in disk buffers is not lost. When more than one user is on a machine, the shutdown command allows notification to other users and their processes that the system is going to power down. Users and some processes are then able to save important data before power is shut off. Time is the time at which shutdown will bring the system down and may be the word now (indicating an immediate shutdown) or specify a future time in one of two formats: +number and hour:min. The first form brings the system down in number minutes and the second brings the system down at the time of day indicated (as a 24 hour clock). At intervals which get shorter as shutdown time approaches, warning-messages are displayed at the terminals of all users on the system. Five minutes before shutdown, or immediately, if shutdown is in less than 5 minutes, logins are disabled by creating /etc/nologin and writing a message there; if this file exists when a user attempts to log in, login(1) prints its contents and exits. The file is removed just before shutdown exits. At shutdown time a message is written in the file /usr/adm/shutdownlog, containing the time of shutdown, who ran shutdown and the reason. Then a terminate signal is sent to init to bring the system down to single-user state. The time of the shutdown and the warning message are placed in /etc/nologin and can be used to inform all users about when the system will be back up and why it is going down (or anything else). OPTIONS Without any option shutdown moves the system from multi-user mode to single-user mode. Printed 4/6/89 1
SHUTDOWN(8) COMMAND REFERENCE SHUTDOWN(8) -h Performs its work and stops system operation as described for halt(8). -k Will not shut down the system (-k is to make users think the system is going down). -r Performs its work and reboots UTek as described for reboot(8). EXAMPLES To shut down the workstation (gracefully) at a given time use the command: shutdown -h 20:15 Where 20:15 represents the specified time you want the system to shut down. To shut down the workstation immediately use the command: shutdown -h now To shut down the workstation in a specified amount of minutes use the command: shutdown -h +10 Where 10 is the specified system shut down time in minutes (shut the system down 10 minutes from now). FILES /etc/nologin tells login not to let anyone log in /usr/adm/shutdownlog log file for successful shutdowns /fastboot created during shutdown procedure after successful disk check RETURN VALUE [NO_ERRS] Command completed without error. [USAGE] Incorrect command line syntax. Execution terminated. [NP_WARN] An error warranting a warning message occurred. Execution continues. [P_ERR] A system error occurred. Execution terminated. See intro(2) for more information on system errors. Printed 4/6/89 2
SHUTDOWN(8) COMMAND REFERENCE SHUTDOWN(8) CAVEATS The shutdown command only allows you to kill the system between now and 23:59 if you use the absolute time for shutdown. SEE ALSO login(1), fsck(8), and reboot(8). Printed 4/6/89 3
%%index%% na:336,100; sy:436,330; de:766,2863; op:3629,256;4293,383; ex:4676,613; fi:5289,376; rv:5665,554; ca:6627,295; se:6922,199; %%index%%000000000157