SHUTDOWN(1M)

NAME

shutdown − terminate all processing

SYNOPSIS

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

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: System III

Remarks: Not supported on the Integral PC.

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 may be used to put the system in single-user mode, for administrative purposes such as backup (see backup(1m)) or file system consistency checking (see fsck(1m)), or to halt or reboot the system, for the purpose of installing peripherals or optional kernel segments (drivers) (see System Administator Manual). 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(1)). This must be done before re-booting the system, to insure file system integrity.

All users logged on the system are notified to log off the system by a broadcasted message. The operator may display his/her own message at this time. Otherwise, a standard warning message is displayed (see wall(1m)).

All currently executing processes, except those essential to the system and associated with the shutdown procedure, are terminated (see killall(1m)).

All file systems are unmounted.

The next step depends on the following options:

−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. (may 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. (may 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).

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

To boot BASIC on a Series 200 or 300 from /dev/lifdisk:
shutdown -r -d /dev/lifdisk -f SYSTEM_BA4 0

DIAGNOSTICS

The most common error diagnostic that will occur is device busy. This diagnostic happens when a particular file system could not be unmounted. See umount(1m).

HARDWARE DEPENDENCIES

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

Museum

Related Articles