tail head cat sleep
QR code linking to this page

Manual Pages  — BHYVECTL

NAME

bhyvectl – control utility for bhyve instances

CONTENTS

SYNOPSIS


bhyvectl --vm= <vmname> [--create] [--destroy] [--get-stats] [--inject-nmi] [--force-reset] [--force-poweroff] [--checkpoint= <filename>] [--suspend= <filename>]

DESCRIPTION

The bhyvectl 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 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

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.

BHYVECTL (8) May 4, 2020

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.