2 .\" Copyright (c) 2012 NetApp Inc
3 .\" All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in the
12 .\" documentation and/or other materials provided with the distribution.
14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35 guest inside a bhyve virtual machine
42 .Op Fl e Ar name=value
45 .Op Fl m Ar memsize Ns Op Ar K|k|M|m|G|g|T|t
58 and will present an interface identical to the
60 loader on the user's terminal.
61 This behavior can be changed by specifying a different OS loader.
63 The virtual machine is identified as
65 and will be created if it does not already exist.
67 The following options are available:
68 .Bl -tag -width indent
77 The text string "stdio" is also accepted and selects the use of
78 unbuffered standard I/O. This is the default value.
82 is the pathname of the guest's boot disk image.
83 .It Fl e Ar name=value
86 loader environment variable
91 The option may be used more than once to set more than one environment
96 is the directory at the top of the guest's boot filesystem.
98 Specify a different OS loader.
102 .Pa /boot/userboot.so ,
103 which presents a standard
106 .It Fl m Ar memsize Ns Op Ar K|k|M|m|G|g|T|t
108 is the amount of memory allocated to the guest.
112 argument may be suffixed with one of
118 (either upper or lower case) to indicate a multiple of
119 Kilobytes, Megabytes, Gigabytes or Terabytes
125 Include guest memory in the core file when
128 This is intended for debugging an OS loader as it allows inspection of
134 To create a virtual machine named
136 that boots off the ISO image
137 .Pa /freebsd/release.iso
138 and has 1GB memory allocated to it:
140 .Dl "bhyveload -m 1G -d /freebsd/release.iso freebsd-vm"
142 To create a virtual machine named
144 with 256MB of memory allocated, the guest root filesystem under the host
146 .Pa /user/images/test
147 and terminal I/O sent to the
152 .Dl "bhyveload -m 256MB -h /usr/images/test -c /dev/nmdm1B test-vm"
163 and was developed at NetApp Inc.
168 .An Neel Natu Aq Mt neel@FreeBSD.org
169 at NetApp Inc with a lot of help from
170 .An Doug Rabson Aq Mt dfr@FreeBSD.org .