> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man8/bhyveload.8.md).

# bhyveload.8

`bhyveload` — 在 bhyve 虚拟机中加载 FreeBSD 客户机

## 名称

`bhyveload`

## 概要

`bhyveload [-C] [-S] [-c cons-dev] [-d disk-path] [-e name=value] [-h host-path] [-l os-loader] [-m memsize[K|k|M|m|G|g|T|t]] vmname`

## 描述

`bhyveload` 用于在 [bhyve(4)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man4/bhyve.4.md) 虚拟机中加载 FreeBSD 客户机。

`bhyveload` 基于 [loader(8)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man8/loader.8.md)，会在用户终端上呈现与 FreeBSD loader 完全一致的界面。可以通过指定不同的 OS loader 来改变此行为。

虚拟机由 `vmname` 标识；如果该虚拟机不存在，则会创建它。

## 选项

可用选项如下：

**`-c`** `cons-dev` `cons-dev` 是一个 [tty(4)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man4/tty.4.md) 设备，用于 `bhyveload` 的终端 I/O。字符串 "stdio" 也被接受，表示使用无缓冲的标准 I/O。这是默认值。

**`-d`** `disk-path` `disk-path` 是客户机启动磁盘镜像的路径名。

**`-e`** `name=value` 将 FreeBSD loader 环境变量 `name` 设置为 `value`。此选项可多次使用以设置多个环境变量。

**`-h`** `host-path` `host-path` 是客户机启动文件系统根目录在主机上的目录。

**`-l`** `os-loader` 指定不同的 OS loader。默认情况下 `bhyveload` 使用 **/boot/userboot.so**，它提供标准的 FreeBSD loader。

**`-m`** `memsize`\[`K|k|M|m|G|g|T|t`] `memsize` 是分配给客户机的内存大小。`memsize` 参数可以后跟 `K`、`M`、`G` 或 `T` 之一（大小写均可），分别表示千字节、兆字节、吉字节或太字节的倍数。`memsize` 默认为 256M。

**`-C`** 当 `bhyveload` 生成核心转储时，将客户机内存包含在核心文件中。此选项用于调试 OS loader，便于检查客户机内存。

**`-S`** 锁定客户机内存。

## 实例

创建名为 `freebsd-vm` 的虚拟机，从 ISO 镜像 **/freebsd/release.iso** 启动，并分配 1GB 内存：

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

创建名为 `test-vm` 的虚拟机，分配 256MB 内存，客户机根文件系统位于主机目录 **/user/images/test** 下，终端 I/O 发送至 [nmdm(4)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man4/nmdm.4.md) 设备 **/dev/nmdm1B**：

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

## 参见

[bhyve(4)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man4/bhyve.4.md), [nmdm(4)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man4/nmdm.4.md), [vmm(4)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man4/vmm.4.md), [bhyve(8)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man8/bhyve.8.md), [loader(8)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man8/loader.8.md)

## 历史

`bhyveload` 首次出现在 FreeBSD 10.0 中，由 NetApp Inc. 开发。

## 作者

`bhyveload` 由 NetApp Inc. 的 Neel Natu <neel@FreeBSD.org> 在 Doug Rabson <dfr@FreeBSD.org> 的大力帮助下开发。

## 缺陷

`bhyveload` 只能加载 FreeBSD 作为客户机。

## 安全注意事项

请注意，在某些配置下，`bhyveload` 会在主机环境中执行客户机 loader 脚本。但 `bhyveload` 在加载 `os-loader` 或执行任何 loader 脚本之前，会进入 [capsicum(4)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man4/capsicum.4.md) 沙箱。在主机文件系统上，沙箱仅能访问由 `-h` 标志指定的路径、未指定 `-l` 时 **/boot** 目录的内容，以及所选的控制台设备。

请注意，客户机 loader 脚本本身已受到一些限制，这些限制不会仅因为运行在用户态而放宽。例如，loader 脚本中对 loader “host” 设备的任何 I/O 操作都受限于 `bhyveload` 提供的接口，而 `bhyveload` 本身会将可访问的路径限制在指定的 `-h` 目录内（如果指定了的话）。在沙箱中访问 **/boot** 内的文件需要 userboot 中的任意代码执行，而 userboot 通常由主机提供，并非客户机镜像的一部分。沙箱中对 `-h` 目录以及 **/boot** 的所有访问均严格只读。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/man/man8/bhyveload.8.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.