HP Integrity Virtual Machines Installation, Configuration, and Administration Version A.03.50

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. It 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.
Unless the hpvmstop command returns an error message, the specified virtual machine is shut
down.
The hpvmstop command does not create a crash dump, and no automatic restart is 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
No options can be specified more than 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 either 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 either the -P , -p or -a option.
-a
Stops all active guests.
You must specify either the -P , -p or -a option. When you specify the -a
option, you must also specify the -F option.
-g
Performs a graceful shutdown. The guest operating system is notified of an
imminent power failure, which gives it time to perform cleanup operations.
This is the default action. HP recommends stopping virtual machines using
their native operating system commands.
The -h and -g options are mutually exclusive.
-h
Performs a hard stop, equivalent to a power failure. The guest operating
system receives no notice and thus no opportunity to cleanup. In these
circumstances, the guest operating system does not create a crashdump and
no automatic restart is performed. HP recommends stopping virtual machines
using their native operating system commands.
The -h and -g options are mutually exclusive.
-F
Specifies the force option. Omits the confirmation dialog before resetting the
virtual machine. This option is intended for use by scripts and other
noninteractive applications.
-q
Makes certain scripted operations less verbose (quiet mode).
-Q
Quietly performs the command. The default is to prompt for confirmation
of the command before performing it.
244