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

# devctl(4)

`devctl` — 设备事件报告与设备控制接口

## 名称

`devctl`

## 概要

`devctl 驱动会自动包含在内核中。`

## 描述

`devctl` 设备用于从内核报告设备事件。未来版本还将允许进行某些设备控制。

## 实现说明

此设计只允许 **/dev/devctl** 有一个读取者。从长远来看这并不理想，但能从本实现中去掉许多复杂之处。也许我们应该将此设备设为可克隆设备。

还需注意：我们特意不将设备附加到 `device_t` 树中，以避免潜在的鸡生蛋蛋生鸡问题。有人可能会争辩说这一切都属于根节点。还可以进一步争辩说，我们现在拥有的 sysctl(3) 接口可能更适合作为 ioctl(2) 接口。

驱动中包含 `SIGIO` 支持。但是，作者并不确定 `SIGIO` 支持是否正确实现。它是从一个具有 `SIGIO` 支持的驱动中复制的，而该驱动的 `SIGIO` 支持可能自 FreeBSD 3.4 或 FreeBSD 2.2.8 以来就未经测试！

此设备的读取通道用于实时向用户空间报告更改。我们一次返回一条记录。如果你尝试逐字符读取此设备，将丢失其余数据。监听程序需要自行处理这种情况。

sysctl `hw.bus.devctl_queue` 可用于控制队列长度。当没有 devd(8) 运行时，可将其设为 0 以禁用 `devctl`。

## 协议

`devctl` 设备使用 ASCII 协议。驱动一次向其读取者返回一条记录。每条记录以换行符终止。记录的第一个字符是事件类型。

| 类型 | 描述            |
| -- | ------------- |
| !  | 通知事件，如链路状态变化。 |
| +  | 设备树中的设备节点已附加。 |
| -  | 设备树中的设备节点已分离。 |
| ?  | 检测到未知设备。      |

### 消息格式

除记录中的第一个字符外，附加和分离消息具有相同的格式。

> `T``dev` `at` `parent` `on` `location`

| 部分         | 描述             |
| ---------- | -------------- |
| `T`        | + 或 -          |
| `dev`      | 被附加/分离的设备名称。   |
| `parent`   | 附加该设备的父总线设备名称。 |
| `location` | 总线特定的位置信息。     |

nomatch 消息可用于加载设备驱动。如果加载了一个设备驱动，则可能发生两种情况之一。如果该设备驱动附加到了某个设备，你将收到设备附加消息。如果没有，则什么也不会发生。

附加和分离消息在事件发生后到达。这意味着不能使用附加消息来加载替代驱动。附加消息所属的驱动已经占用了此设备。也不能使用分离消息将数据刷新到设备。设备已经不存在了。

所有返回的值均采用"key=value"或"key="value""的形式。对于后者，字符串"value"中的任何内部反斜杠必须加倍。任何内部双引号字符也必须以反斜杠作为前缀。所有其他字符应原样传递。

## 参见

devd(8)