HP Integrity Virtual Machines 4.3: Installation, Configuration, Administration

hpvmremove(1M)
NAME
hpvmremove -- Remove an Integrity VM 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
The following options can be specified only once.
The hpvmremove command 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).
The -F option is deprecated in Integrity Virtual Machines commands.
-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
The hpvmremove 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 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.
• The vm_name or vm_number argument does not exist, cannot be accessed, is not a virtual
machine, or is corrupt.
321