HP Integrity Virtual Machines 4.3: Installation, Configuration, Administration

hpvmstop(1M)
NAME
hpvmstop -- Stop a virtual machine.
SYNOPSIS
hpvmstop { -P vm-name | -p vm-number | -a } [ -h | -g ] [-F] [-q] [-Q]
DESCRIPTION
The hpvmstop command stops a running virtual machine by simulating the operations performed
at the system console on a physical system. The command can perform a hard stop, which
functions like a power failure, or a graceful stop, in which the guest operating system receives
notification and time to perform cleanup operations before the stop.
If the hpvmstop command returns an error message, the specified virtual machine is shut down.
The hpvmstop command does not create a crash dump, and automatic restart is not performed.
Unintentional use of the hpvmstop command has serious consequences; therefore, the user is
prompted to confirm the operation unless the -F (force) option is specified.
Only superusers can execute the hpvmstop command.
Options
The following options can be specified only once.
The hpvmstop command recognizes the following command-line option and argument:
-P vm-name
Specifies the unique name of the virtual machine to be stopped.
You must specify the -P , -p, or -a option.
-p vm-number
Specifies the unique number of the virtual machine to be stopped. The
vm_number is displayed by the hpvmstatus command.
You must specify the -P , -p, or -a option.
-a
Stops all active guests.
You must specify the -P , -p, or -a option. When you specify the -a option,
you must also specify the -F option.
-g
Specifies that a graceful shutdown be performed within the specified or
default graceful_stop_timeout period. If the timeout period expires before the
graceful shutdown is complete, a hard stop is performed. The guest operating
system is notified of an imminent power failure, which gives it time to
perform cleanup operations. HP recommends stopping virtual machines
using their native operating system commands.
NOTE: To set a graceful shutdown, use the hpvmmodify -x
graceful_stop_timeout={0|number} command. See hpvmmodify(1)
for more information.
The -h and -g options are mutually exclusive.
-h
Performs a hard stop, which is equivalent to a power failure. This is the
default action. The guest operating system receives no notice and thus no
opportunity to clean up. In these circumstances, the guest operating system
does not create a crash dump, and automatic restart is not performed. HP
recommends that you stop virtual machines by using their native operating
system commands.
353