BHYVECTL(8) System Manager's Manual BHYVECTL(8) NAME bhyvectl -- control utility for bhyve instances SYNOPSIS bhyvectl --vm=<vmname> [--create] [--destroy] [--get-stats] [--inject-nmi] [--force-reset] [--force-poweroff] [--checkpoint=<file>] [--suspend=<file>] DESCRIPTION The bhyvectl command is a control utility for active bhyve(8) virtual ma- chine instances. 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=<file> Save a snapshot of a virtual machine. The guest mem- ory contents are saved in the file given in <file>. The guest device and vCPU state are saved in the file <file>.kern. --suspend=<file> Save a snapshot of a virtual machine similar to --checkpoint. The virtual machine will terminate af- ter the snapshot has been saved. Note: Most bhyvectl flags are intended for querying and setting the state of an active instance. These commands are intended for development pur- poses, and are not documented here. A complete list can be obtained by ex- ecuting bhyvectl without any arguments. 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 Running VMs will be visible in /dev/vmm/. 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 bhyve(8), bhyveload(8) HISTORY The bhyvectl command first appeared in FreeBSD 10.1. AUTHORS The bhyvectl utility was written by Peter Grehan and Neel Natu. FreeBSD 15.1 May 8, 2025 BHYVECTL(8)
NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | EXAMPLES | COMPATIBILITY | SEE ALSO | HISTORY | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bhyvectl&sektion=8&manpath=FreeBSD+15.1-RELEASE>