HP Integrity Virtual Machines Installation, Configuration, and Administration

hpvmremove(1M)
NAME
hpvmremove -- Remove an Integrity Virtual Machines virtual machine.
SYNOPSIS
hpvmremove { -P vm-name | -p vm-number } [-F] [-Q]
DESCRIPTION
The hpvmremove command deletes a virtual machine's configuration information and frees any
resources associated with it. Once the virtual machine has been removed all resources associated
with the virtual machine become available for allocation to other virtual machines.
Unintentional use of this command has serious consequences; therefore, the user is prompted
to confirm this operation unless the -F(force) option is specified.
The virtual machine must be in the Off state to be removed: It is an error to remove a running
virtual machine.
Only superusers can execute the hpvmremove command.
Options
No options can be specified more than once.
hpvmremove recognizes the following command-line options and arguments:
-P vm-name
Specifies the unique name of the virtual machine to be removed.
You must specify either the -P or the -p option.
-p vm-number
Specifies the unique number of the virtual machine to be removed. The vm_number is reported
via the hpvmstatus command.
You must specify either the -P or the -p option.
-F
Omits the confirmation dialog before removing the virtual machine. This option is intended
for use by scripts and other noninteractive applications (Force mode).
-Q
Quietly performs the command. The default is to prompt for confirmation of the command
before performing it.
RETURN VALUES
The hpvmremove command exits with one of the following values:
0: Successful completion.
1: One or more error conditions occurred.
DIAGNOSTICS
hpvmremove displays error messages on stderr for any of the following conditions:
• An invalid option is specified.
• An invalid value is specified for an option or value is omitted.
• A value was omitted for an argument that requires one, or a value was supplied for an
argument that does not take one.
• vm-name or vm-number does not exist, cannot be accessed, is not a virtual machine, or is
corrupt.
211