NAME
bhyvectl
—
control utility for bhyve
instances
SYNOPSIS
bhyvectl |
--vm= <vmname>
[--create ] [--destroy ]
[--get-stats ]
[--inject-nmi ]
[--force-reset ]
[--force-poweroff ]
[--checkpoint= <filename>]
[--suspend= <filename>] |
DESCRIPTION
Thebhyvectl
command is a control utility for active
bhyve(8) virtual machine instances.
Note:
Most bhyvectl
flags are intended for querying and
setting the state of an active instance. These commands are intended for
development purposes, and are not documented here. A complete list can be
obtained by executing bhyvectl
without any
arguments.
The user-facing options are as follows:
--vm=
<vmname>- Operate on the virtual machine <vmname>.
--create
- Create the specified VM.
--destroy
- Destroy the specified VM.
--get-stats
- Retrieve statistics for the specified VM.
--inject-nmi
- Inject a non-maskable interrupt (NMI) into the VM.
--force-reset
- Force the VM to reset.
--force-poweroff
- Force the VM to power off.
--checkpoint=
<filename>- Save a snapshot of a virtual machine. The guest memory contents are saved in the file given in <filename>. The guest device and vCPU state are saved in the file <filename>.kern.
--suspend=
<filename>- Save a snapshot of a virtual machine similar to
--checkpoint
. The virtual machine will terminate after the snapshot has been saved.
EXIT STATUS
The bhyvectl
utility exits 0 on
success, and >0 if an error occurs.
EXAMPLES
Destroy the VM called fbsd10:
bhyvectl --vm=fbsd10
--destroy
COMPATIBILITY
The snapshot file format is not yet stable and is subject to future changes. Backwards compatibility support for the current snapshot file format is not guaranteed when future changes are made.
SEE ALSO
HISTORY
The bhyvectl
command first appeared in
FreeBSD 10.1.
AUTHORS
The bhyvectl
utility was written by
Peter Grehan and Neel
Natu.