shutdown.1m (2012 03)

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]

/sbin/shutdown -S

[-r][-y][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.

-S This option is supported with SoftReboot new core functionality product installed on

Itanium-based systems. It reduces the system downtime as compared to normal reboot. If

SoftReboot is not installed on the system, this option is invalid.

-r (reboot) or -h (halt) or -R (reconﬁgure) or -S (soft reboot) 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.

HP-UX 11i Version 3: March 2012 − 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 ] /sbin/shutdown -S [-r] [-y] [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 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, a server, or a client.
PAGE 3
shutdown(1M) shutdown(1M) 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.
PAGE 4
(Notes) A (Notes) sA 4 Hewlett-Packard Company −1− HP-UX 11i Version 3: March 2012