HP-UX Reference (11i v1 05/09) - 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 reconfiguration. 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-reconfigure state and reboot if possible. If the partition
is unable to reboot, it will stop at a ready-to-reconfigure state. However, if the
-H option is
also specified, the system will always stop at ready-to-reconfigure state. This option is
available only on systems that support hardware partitions.
-H Shut down the system to a ready-to-reconfigure 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
0or
now, shutdown runs more quickly, giving users very little time to log out.
If -r (reboot) or -h (halt) or -R (reconfigure) 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 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.
Section 1M−−846 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005