Changeset View
Changeset View
Standalone View
Standalone View
usr.sbin/bhyve/bhyve.8
Show All 18 Lines | |||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd March 18, 2021 | .Dd April 6, 2021 | ||||
.Dt BHYVE 8 | .Dt BHYVE 8 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm bhyve | .Nm bhyve | ||||
.Nd "run a guest operating system inside a virtual machine" | .Nd "run a guest operating system inside a virtual machine" | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Nm | .Nm | ||||
.Op Fl AaCDeHhPSuWwxY | .Op Fl AaCDeHhPSuWwxY | ||||
▲ Show 20 Lines • Show All 92 Lines • ▼ Show 20 Lines | |||||
Include guest memory in core file. | Include guest memory in core file. | ||||
.It Fl D | .It Fl D | ||||
Destroy the VM on guest initiated power-off. | Destroy the VM on guest initiated power-off. | ||||
.It Fl e | .It Fl e | ||||
Force | Force | ||||
.Nm | .Nm | ||||
to exit when a guest issues an access to an I/O port that is not emulated. | to exit when a guest issues an access to an I/O port that is not emulated. | ||||
This is intended for debug purposes. | This is intended for debug purposes. | ||||
.It Fl G Ar port | .It Fl G Xo | ||||
.Sm off | |||||
.Oo Ar w Oc | |||||
.Oo Ar bind_address: Oc | |||||
.Ar port | |||||
.Sm on | |||||
.Xc | |||||
Start a debug server that uses the GDB protocol to export guest state to a | Start a debug server that uses the GDB protocol to export guest state to a | ||||
debugger. | debugger. | ||||
An IPv4 TCP socket will be bound to the supplied | An IPv4 TCP socket will be bound to the supplied | ||||
.Ar bind_address | |||||
and | |||||
.Ar port | .Ar port | ||||
to listen for debugger connections. | to listen for debugger connections. | ||||
Only a single debugger may be attached to the debug server at a time. | Only a single debugger may be attached to the debug server at a time. | ||||
If | If the option begins with | ||||
.Ar port | |||||
begins with | |||||
.Sq w , | .Sq w , | ||||
.Nm | .Nm | ||||
will pause execution at the first instruction waiting for a debugger to attach. | will pause execution at the first instruction waiting for a debugger to attach. | ||||
.It Fl h | .It Fl h | ||||
Print help message and exit. | Print help message and exit. | ||||
.It Fl H | .It Fl H | ||||
Yield the virtual CPU thread when a HLT instruction is detected. | Yield the virtual CPU thread when a HLT instruction is detected. | ||||
If this option is not specified, virtual CPUs will use 100% of a host CPU. | If this option is not specified, virtual CPUs will use 100% of a host CPU. | ||||
▲ Show 20 Lines • Show All 627 Lines • Show Last 20 Lines |