Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
BHYVELOAD(8)		FreeBSD	System Manager's Manual		  BHYVELOAD(8)

NAME
     bhyveload -- load a FreeBSD guest inside a	bhyve virtual machine

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 FreeBSD guest inside a	bhyve(4) virtual
     machine.

     bhyveload is based	on loader(8) and will present an interface identical
     to	the FreeBSD 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 FreeBSD loader environment	variable name to value.

	     The option	may be used more than once to set more than one	envi-
	     ronment 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 FreeBSD loader.

     -m	mem-size [K|k|M|m|G|g|T|t]
	     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 FreeBSD 10.0, and was developed at NetApp
     Inc.

AUTHORS
     bhyveload was developed by	Neel Natu <neel@FreeBSD.org> at	NetApp Inc
     with a lot	of help	from Doug Rabson <dfr@FreeBSD.org>

BUGS
     bhyveload can only	load FreeBSD as	a guest.

FreeBSD	10.3			October	7, 2015			  FreeBSD 10.3

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | HISTORY | AUTHORS | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=bhyveload&sektion=8&manpath=FreeBSD+10.3-RELEASE+and+Ports>

home | help