> 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/man1/kenv.1.md).

# kenv.1

`kenv` — 列出或修改内核环境

## 名称

`kenv`

## 概要

`kenv [-l | -s] [-hNq]`

`kenv [-qv] variable[=value]`

`kenv [-q] -u variable`

## 描述

如果不带参数调用，`kenv` 实用程序将列出内核环境中的所有变量。

如果指定了 `-l` 选项，则改为列出由 [loader(8)](/man/man8/loader.8.md) 提供的静态环境。类似地，`-s` 选项将列出由内核配置定义的静态环境。`-l` 和 `-s` 选项都依赖于内核被配置为保留早期内核环境。默认内核配置不保留这些环境。

如果指定了 `-h` 选项，将把报告限制为内核探测提示。如果指定了可选的 `variable` 名称，`kenv` 将仅报告该值。如果指定了 `-N` 选项，`kenv` 将仅显示变量名而不显示其值。如果指定了 `-u` 选项，`kenv` 将删除给定的环境变量。如果环境变量后跟一个可选的 `value`，`kenv` 会将环境变量设置为该值。

如果设置了 `-q` 选项，将抑制因无法执行请求的操作而通常打印的警告信息。

如果设置了 `-v` 选项，当 `kenv` 带变量名执行时，除了值之外还会打印环境变量的变量名。

可以使用 **/boot/loader.conf** 文件将变量添加到内核环境，也可以使用内核配置文件中的以下语句静态编译到内核中：

```sh
env filename
```

该文件可以包含如下形式的行：

```sh
name = "value" # 这是一个注释
```

其中 `name` 和 `=` 周围的空白字符以及 `#` 字符之后的所有内容都会被忽略。除 `=` 外的几乎所有可打印字符都可作为名称的一部分。引号是可选的，仅当值包含空白字符时才需要。

## 实例

显示内核探测提示变量名并过滤 uart 设备：

```sh
$ kenv -h -N | grep uart
hint.uart.0.at
hint.uart.0.flags
hint.uart.0.irq
hint.uart.0.port
hint.uart.1.at
hint.uart.1.irq
hint.uart.1.port
```

显示特定变量的值：

```sh
$ kenv hint.uart.1.at
isa
```

与上面相同，但在报告中添加变量名：

```sh
$ kenv -v hint.uart.1.at
hint.uart.1.at="isa"
```

尝试删除变量并抑制任何警告：

```sh
$ kenv -q -u hint.uart.1.at
```

设置 `verbose_loading` 变量的值：

```sh
$ kenv verbose_loading="YES"
verbose_loading="YES"
```

## 参见

kenv(2), config(5), loader.conf(5), [loader(8)](/man/man8/loader.8.md)

## 历史

`kenv` 实用程序首次出现于 FreeBSD 4.1.1。

## 安全注意事项

请注意，除非 `security.bsd.unprivileged_kenv_read` sysctl 设置为 0，否则允许非特权用户读取内核环境。这包括列出内核环境以及从环境中获取特定 `variable`。


---

# 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/man1/kenv.1.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.