HP-UX Reference (11i v1 00/12) - 1M System Administration Commands N-Z (vol 4)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/naaagt.1m
________________________________________________________________
___ ___
s
shutdown(1M) shutdown(1M)
• If the system is a server, the optional -o argument is used to determine if all clients in the
cluster should also be rebooted. The default behavior (command line parameter -o is not
entered) is to reboot all clients using /sbin/reboot; entering -o results in the server
only being rebooted and the clients being left alone. Then /sbin/rc is executed to shut
down subsystems, unmount file systems, and perform other tasks to bring the system to run
level 0.
• If the system is a client, /sbin/rc is executed to bring the system down to run-level 2, and
then /sbin/reboot is executed. Shutdown to the single-user state is not an allowed option
for clients.
• The system is rebooted, halted, or put in the ready to reconfig state by executing /sbin/reboot
if the -h or -r or -R option was chosen. If the system was not a cluster client and the system was
being brought down to single-user state, a signal is sent to the init process to change states (see
init(1M)).
DIAGNOSTICS
device busy
This is the most commonly encountered error diagnostic, and happens when a particular file system
could not be unmounted; see mount(1M).
user not allowed to shut down this system
User is not authorized to shut down the system. User and system must both be included in the
authorization file /etc/shutdown.allow
.
EXAMPLES
Immediately reboot the system and run HP-UX again:
shutdown -r 0
Halt the system in 5 minutes (300 seconds) with no interactive questions and answers:
shutdown -h -y 300
Go to run-level s in 10 minutes:
shutdown 600
Immediately shut down a partition so that it can be deleted:
shutdown -R -H 0
Reboot a partition in 5 minutes so that new cells that have been assigned to the partition become active:
shutdown -R 300
WARNINGS
The user name compared with the entry in the shutdown.allow file is obtained using getlogin()
or, if that fails, using getpwuid() (see getlogin(3C) and getpwent(3C)).
The hostname in /etc/shutdown.allow is compared with the hostname obtained using gethost-
byname()
(see gethostent(3N)).
shutdown must be executed from a directory on the root volume, such as the / directory.
The maximum broadcast message that can be sent is approximately 970 characters.
When executing
shutdown on an NFS diskless cluster server and the -o option is not entered, clients of
the server will be rebooted. No clients should be individually rebooted or shutdown while the cluster is
being shutdown.
FILES
/etc/shutdown.allow
Authorization file.
The file contains lines that consist of a system host name and the login name of a user who is
authorized to reboot or halt the system. A superuser’s login name must be included in this file in
order to execute shutdown. However, if the file is missing or of zero length, the
root user
can run the
shutdown program to bring the system down.
Section 1M−−796 − 2 − HP-UX Release 11i: December 2000
___
___