GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  BHYVELOAD (8)

NAME

bhyveload - load a
.Fx guest inside a bhyve virtual machine

CONTENTS

Synopsis
Description
Options
Examples
See Also
History
Authors
Bugs

SYNOPSIS

bhyveload [-S] [-c cons-dev] [-d disk-path] [-e name=value] [-h host-path] [-l os-loader] [-m mem-size] vmname

DESCRIPTION

bhyveload is used to load a
.Fx guest inside a bhyve(4) virtual machine.

bhyveload is based on loader(8) and will present an interface identical to the
.Fx loader on the user’s terminal. This behavior can be changed by specifying a different OS loader.

The virtual machine is identified as vmname and will be created if it does not already exist.

OPTIONS

The following options are available:
-c cons-dev
  cons-dev is a tty(4) device to use for bhyveload terminal I/O.

The text string "stdio" is also accepted and selects the use of unbuffered standard I/O. This is the default value.

-d disk-path
  The disk-path is the pathname of the guest’s boot disk image.
-e name=value
  Set the
.Fx loader environment variable name to value.

The option may be used more than once to set more than one environment variable.

-h host-path
  The host-path is the directory at the top of the guest’s boot filesystem.
-l os-loader
  Specify a different OS loader. By default bhyveload will use /boot/userboot.so, which presents a standard
.Fx loader.
-m mem-size Xo
 
.Sm off [K | k | M | m | G | g | T | t]
 
.Sm on mem-size is the amount of memory allocated to the guest.

The mem-size argument may be suffixed with one of K, M, G or T (either upper or lower case) to indicate a multiple of Kilobytes, Megabytes, Gigabytes or Terabytes respectively.

The default value of mem-size is 256M.

-S Wire guest memory.

EXAMPLES

To create a virtual machine named freebsd-vm that boots off the ISO image /freebsd/release.iso and has 1GB memory allocated to it:

    bhyveload -m 1G -d /freebsd/release.iso freebsd-vm

To create a virtual machine named test-vm with 256MB of memory allocated, the guest root filesystem under the host directory /user/images/test and terminal I/O sent to the nmdm(4) device /dev/nmdm1B

    bhyveload -m 256MB -h /usr/images/test -c /dev/nmdm1B test-vm

SEE ALSO

bhyve(4), nmdm(4), vmm(4), bhyve(8), loader(8)

HISTORY

bhyveload first appeared in
.Fx 10.0 , and was developed at NetApp Inc.

AUTHORS

bhyveload was developed by
.An -nosplit
.An Neel Natu Aq neel@FreeBSD.org at NetApp Inc with a lot of help from
.An Doug Rabson Aq dfr@FreeBSD.org

BUGS

bhyveload can only load
.Fx as a guest.
Search for    or go to Top of page |  Section 8 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.