shutdown.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

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 ﬁle system consistency

checks (see fsck (1M)), to halt or reboot the system, or to make the partition ready for reconﬁguration. 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-reconﬁgure state and reboot if possible. If the parti-

tion is unable to reboot, it will stop at a ready-to-reconﬁgure state. However, if the

-H

option is also speciﬁed, the system will always stop at ready-to-reconﬁgure state. This

option is available only on systems that support hardware partitions.

-H Shut down the system to a ready-to-reconﬁgure 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 speciﬁes 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.

-r (reboot) or -h (halt) or -R (reconﬁgure) are not speciﬁed, standalone and server systems are

placed in single-user state. Either

-r (reboot) or -h (halt) must be speciﬁed for a client; shutdown to

single-user state is not allowed for a client. See init (1M).

If the optional

HP-UX RCEnhancement

bundle is installed on the system, the system reboot time may

improve for the

-r (reboot), the -h (halt), and the -R (reconﬁgure) options.

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 ﬁle.

• The current working directory is changed to the root directory (

/).

• All ﬁle systems’ super blocks are updated; see sync (1M). This must be done before rebooting the

system to ensure ﬁle 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.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
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.
PAGE 2
shutdown(1M) • • shutdown(1M) The next step depends on whether a system is standalone, a server, or a client. • 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. • If the system is a server, the optional -o argument is used to determine if all clients in the cluster should also be rebooted.
PAGE 3
shutdown(1M) shutdown(1M) 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.
PAGE 4
(Notes) A (Notes) sA 4 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010