HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

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 getpwuid()
(see 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.
If the
-R option is used in a virtual partition environment on a partitionable system, then the requested
reconfiguration will not take place until all the virtual partitions on that hard partition are shut down
and the virtual partition monitor is rebooted.
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
Section 1M−−762 Hewlett-Packard Company − 2 − HP-UX 11i Version 2: August 2003