Filter
Top Products
hpvmstop(1M)
NAME
hpvmstop -- Stop a virtual machine.
SYNOPSIS
hpvmstop {-P vm_name | -p vm_number} [-h | -g] [-F] [-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 or the -p 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 or the -p option.
-g
Performs a graceful shutdown. The guest operating system is notified of an imminent power failure,
which gives it time to performcleanup operations. This is thedefault 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 opportunityto cleanup. In these circumstances,the guest operating system does notcreate
a crashdumpand noautomatic restartis performed.HP recommendsstopping virtualmachines 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).
RETURN VALUES
The hpvmstop command exits with one of the following values:
177