HP Integrity Virtual Machines 4.3: Installation, Configuration, Administration
hpvmsuspend(1M)
NAME
hpvmsuspend -- Suspend a virtual machine.
SYNOPSIS
hpvmsuspend { -P vm-name | -p vm-number } [-F] [-n] [-q] [-Q] [-s]
hpvmsuspend -A { -P vm-name | -p vm-number }
hpvmsuspend -v
hpvmsuspend -H
DESCRIPTION
The hpvmsuspend command suspends a virtual machine. A virtual machine that is suspended
does not use CPU or memory resources.
The resources that are defined in the virtual machine's configuration file are checked to determine
whether the migrated virtual machine can be suspended. You can specify the -F option (force)
to suppress the errors and force the virtual machine to be suspended.
NOTE: Use the -F option with caution, because the suspended virtual machine might not be
able to resume safely.
Only superusers can execute the hpvmsuspend command.
Options
The hpvmsuspend command recognizes the following command-line options and arguments:
-P source-vm-name
Specifies the unique name of the virtual machine to be suspended.
You must specify either the -P option or the -p option.
-p source-vm-name
Specifies the unique number of the virtual machine to be suspended.
The vm_number is reported by the hpvmstatus command.
You must specify either the -P option or the -p option.
-A
Aborts the suspension in progress.
-s
Indicates that the guest should not be suspended but that the
hpvmsuspend command should check whether or not the suspend
is possible.
-F
Forces the suspension of a virtual machine, whether or not there are
resources that prevent suspension.
Use the -F option rarely and with caution.
The -F option is deprecated in Integrity Virtual Machines commands.
-q
Sets the quiet flag, which slightly reduces the messages.
-Q
Displays fewer informative messages. Some potential error conditions
are still reported.
-n Quits after starting the suspension. If not specified, the hpvmsuspend
command continues to run and reports the suspension status.
-v Displays the version number of the hpvmsuspend command.
-H Displays the usage of the hpvmsuspend command.
RETURN VALUES
The hpvmsuspend command exits with one of the following values:
356