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
Performs a graceful shutdown.
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.
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.
 |
| |
|
 | NOTE: If neither -g nor -h are specified, a hard stop is performed. |
|
| |
|
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.
RETURN VALUES
The hpvmstop command exits
with one of the following values:
- 0: Successful completion.
- 1: One or more error
conditions occurred.
DIAGNOSTICS
The hpvmstop command displays
error messages on stderr for any of the following conditions:
An invalid option is specified.
An invalid value is specified
for an option.
The vm-name or vm-number does not exist, cannot be
accessed, is not a virtual machine, or is corrupt.
A value was omitted for
an argument that requires one, or a value was supplied for an argument
that does not take one.
The hpvmstop command and Integrity VM software are at different revision levels.
The specified guest is
a distributed guest.
AUTHORS
The hpvmstop command was developed
by the HP.
SEE ALSO
On the VM Host:
hpvm(5), hpvmclone(1M), hpvmcollect(1M), hpvmconsole(1M), hpvmcreate(1M), hpvmdevmgmt(1M), hpvminfo(5), hpvmmigrate(1M), hpvmmodify(1M), hpvmnet(1M), hpvmpubapi(3), hpvmremove(1M), hpvmresources(5), hpvmstart(1M), hpvmstatus(1M), p2vassist(1M)
On the Integrity VM guest:
hpvmcollect(1M), hpvminfo(1M), hpvmmgmt(1M), hpvmpubapi(3)
Printable version
