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

FreeBSD Manual Pages

  
 
  

home | help
BHYVELOAD(8)		  BSD System Manager's Manual		  BHYVELOAD(8)

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

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

DESCRIPTION
     bhyveload is used to load a FreeBSD guest inside a	bhyve(4) virtual ma-
     chine.

     bhyveload is based	on loader(8) and will present an interface identical
     to	the FreeBSD loader on the user's terminal.

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

OPTIONS
     The following options are available:

     -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.

     -d	disk-path
	     The disk-path is the pathname of the guest's boot disk image.

     -h	host-path
	     The host-path is the directory at the top of the guest's boot
	     filesystem.

     -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.

     -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.

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), bhyve(8), loader(8), nmdm(4,) vmm(4)

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.

BSD				January	7, 2012				   BSD

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&manpath=FreeBSD+10.0-RELEASE>

home | help