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

hpvmremove(1M)
NAME
hpvmremove -- Remove an Integrity Virtual Machines virtual machine.
SYNOPSIS
hpvmremove { -P vm_name | -p vm_number } [-F]
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 by 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.
• vm_name is in some state other than Off.
• Thehpvmremove command and Integrity Virtual Machines are at different revision levels.
232