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

s
shutdown(1M) shutdown(1M)
NAME
shutdown - terminate all processing
SYNOPSIS
/sbin/shutdown
[-h-r][-y][
-o][grace]
/sbin/shutdown -R
[-H][-y][
-o][grace]
DESCRIPTION
The
shutdown command is part of the HP-UX system operation procedures. Its primary function is to
terminate all currently running processes in an orderly and cautious manner.
shutdown can be used to
put the system in single-user mode for administrative purposes such as backup or file system consistency
checks (see fsck(1M)), to halt or reboot the system, or to make the partition ready for reconfig. By
default,
shutdown is an interactive program.
Options and Arguments
shutdown recognizes the following options and arguments.
-h Shut down the system and halt.
-r Shut down the system and reboot automatically.
-R Shut down the system to a ready to reconfig state and reboot automatically. However, if
the -H option is also specified, the system will not be rebooted automatically. This option
is available only on systems that support hardware partitions.
-H Shut down the system to a ready to reconfig state and do not reboot. This option can be
used only in combination with the -R option. This option is available only on systems
that support hardware partitions.
-y Do not require any interactive responses from the user. (Respond yes or no as appropri-
ate to all questions, such that the user does not interact with the shutdown process.)
-o When executed on the cluster server in a diskless cluster environment, shutdown the
server only and do not reboot clients. If this argument is not entered the default
behavior is to reboot all clients when the server is shutdown.
grace Either a decimal integer that specifies the duration in seconds of a grace period for users
to log off before the system shuts down, or the word
now. The default is 60. If grace is
either 0 or
now, shutdown runs more quickly, giving users very little time to log out.
If
-r (reboot) or -h (halt) or -R (reconfig) are not specified, standalone and server systems are
placed in single-user state. Either
-r (reboot) or -h (halt) must be specified for a client; shutdown to
single-user state is not allowed for a client. See dcnodes(1M), init (1M).
Shutdown Procedure
shutdown goes through the following steps:
The
PATH environment variable is reset to /usr/bin:/usr/sbin:/sbin.
The
IFS environment variable is reset to space, tab, newline.
The user is checked for authorization to execute the
shutdown command. Only authorized
users can execute the shutdown command. See FILES for more information on the
/etc/shutdown.allow authorization file.
The current working directory is changed to the root directory (
/).
All file systems super blocks are updated; see sync(1M). This must be done before rebooting the
system to ensure file system integrity.
The real user ID is set to that of the superuser.
A broadcast message is sent to all users currently logged in on the system telling them to log out.
The administrator can specify a message at this time; otherwise, a standard warning message is
displayed.
The next step depends on whether a system is standalone,aserver,oraclient.
If the system is standalone,
/sbin/rc is executed to shut down subsystems, unmount file
systems, and perform other tasks to bring the system to run level 0.
HP-UX 11i Version 2: August 2003 1 Hewlett-Packard Company Section 1M761