NAME
hpvmremove — Remove an Integrity VM 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
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).
- -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.
The vm_name argument is in some state other than Off.
The hpvmremove command and Integrity VM are at different revision levels.
AUTHORS
The hpvmremove command was
developed by HP.
SEE ALSO
On the VM Host:
hpvm(5), hpvmclone(1M), hpvmcollect(1M), hpvmconsole(1M), hpvmcreate(1M), hpvmdevmgmt(1M), hpvmdevtranslate(1M), hpvmhostrdev(1M), hpvminfo(1M), hpvmmigrate(1M), hpvmmodify(1M), hpvmnet(1M), hpvmpubapi(3), hpvmresources(5), hpvmsar(1M), hpvmstart(1M), hpvmstatus(1M), hpvmstop(1M), hpvmupgrade(1M), p2vassist(1M)
On the Integrity VM guest:
hpvmcollect(1M), hpvminfo(1M), hpvmmgmt(1M), hpvmpubapi(3)
Printable version
