SHUTDOWN(1M) — HP-UX

NAME

shutdown − terminate all processing

SYNOPSIS

/etc/shutdown [ −h | −r ] [ −d device ] [ −f lif_file ] [ grace ]

DESCRIPTION

Shutdown 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)), and to halt or reboot the system. The procedure is designed to interact with the operator, i.e., the person who invoked shutdown. Shutdown may instruct the operator to perform some specific tasks or to supply certain responses before execution can resume.

Shutdown goes through the following steps:

All file systems’ super blocks are updated; see sync(1M). This must be done before rebooting the system to ensure file system integrity.

All users logged on the system are notified to log out by a broadcast message. The operator may display his/her own message at this time. Otherwise, a standard warning message is displayed.

All currently executing processes are terminated except those essential to the system or associated with the shutdown procedure.

All file systems are unmounted.

The next step depends on which of the following options are selected:

−h Shutdown the system and halt.

−r Shutdown the system and reboot automatically.

−d device Reboot from the specified device. The device must be a lif volume. The −d option can only be used with the −r option.

−f lif_file Reboot from the specified file. If the filename is the NULL string, the power-up search sequence will be made for a system. Otherwise, the filename has to follow the lif filename convention. The −f option can only be used with the −r option.

grace Grace specifies, in seconds, a grace period for users to log off before shutting down. The default is 60 seconds. If grace is zero, shutdown runs more quickly, but gives users very little time to log out.

If neither −r or −h is specified, the system will be placed in "run-level s" ; see init(1M).

RETURN VALUE

The most common error diagnostic that will occur is device busy. This happens when a particular file system could not be unmounted; see mount(1M).

EXAMPLES

To immediately reboot the system and run HP−UX again:
shutdown -r 0

To halt the system in 5 minutes:
shutdown -h 300

To go to init run−level s in 10 minutes:
shutdown 600

DEPENDENCIES

Series 800
The -d and -f options and device and lif_file parameters are not supported.

Series 300 Diskless
When shutdown is executed on the root server of a cluster, all of the cluster nodes will be shut down. Each cluster node will be shut down by a shutdown command executing locally. The arguments for these local shutdown commands will be copied over from the root server’s shutdown command, with the exception of the −d and −f options.

If neither −h nor −r is specified from the root server, the local shutdown commands will use −r when executing. Note that prior to executing shutdown on each of the cluster nodes, the root server’s shutdown command will disable the boot server. Thus, the non-root server cluster nodes will not actually reboot until the boot server is enabled on the root server.

Executing shutdown on a non-root server cluster node will only affect that node.

Museum

Related Articles