> 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/man9/bus_attach_children.9.md).

# bus\_attach\_children.9

`bus_attach_children` — 管理总线设备的子设备

## 名称

`bus_attach_children`, `bus_delayed_attach_children`, `bus_detach_children`, `bus_enumerate_hinted_children`, `bus_identify_children`

## 概要

```c
#include <sys/param.h>
#include <sys/bus.h>

void
bus_attach_children(device_t dev)

void
bus_delayed_attach_children(device_t bus)

int
bus_detach_children(device_t dev)

void
bus_enumerate_hinted_children(device_t bus)

void
bus_identify_children(device_t dev)
```

## 描述

这些函数管理 `dev` 的子设备的状态转换。

`bus_enumerate_hinted_children` 遍历内核环境以识别描述附加到 `dev` 的设备的任何设备提示。对于每组匹配的提示，调用 [BUS\_HINTED\_CHILD(9)](/man/man9/bus_hinted_child.9.md) 方法。此函数通常从总线驱动程序的 [DEVICE\_ATTACH(9)](/man/man9/device_attach.9.md) 方法中调用以添加提示设备。注意，大多数总线驱动程序不使用提示来识别子设备。这通常用于不提供设备枚举机制的旧式总线，如 ISA。

`bus_identify_children` 遍历 `dev` 子设备的所有合格设备驱动程序，调用 [DEVICE\_IDENTIFY(9)](/man/man9/device_identify.9.md) 方法。这允许设备驱动程序添加通过替代机制（如固件表）枚举的子设备。此函数通常从总线驱动程序的 [DEVICE\_ATTACH(9)](/man/man9/device_attach.9.md) 方法中调用。

`bus_attach_children` 将设备驱动程序附加到 `dev` 的所有子设备。此函数在每个子设备上调用 [device\_probe\_and\_attach(9)](/man/man9/device_probe_and_attach.9.md) 并忽略错误。它尽最大努力将设备驱动程序附加到所有子设备。子设备按递增顺序附加。具有相同顺序的子设备按通过 [device\_add\_child(9)](/man/man9/device_add_child.9.md) 创建设备时的 FIFO 顺序附加。此函数通常从总线驱动程序的 [DEVICE\_ATTACH(9)](/man/man9/device_attach.9.md) 方法中在添加设备后调用。

`bus_delayed_attach_children` 在中断启用后将设备驱动程序附加到 `dev` 的所有子设备。此函数通过 config\_intrhook\_establish(9) 在中断启用后调度调用 `bus_attach_children`。如果中断已启用（例如，启动后加载设备驱动程序时），立即调用 `bus_attach_children`。

`bus_detach_children` 通过在每个子设备上调用 device\_detach(9) 从 `dev` 的所有子设备分离设备驱动程序。与 `bus_attach_children` 不同，此函数不进行尽力而为的遍历。如果子设备分离失败，`bus_detach_children` 立即失败并返回子设备分离失败的错误。子设备以与 `bus_attach_children` 相反的顺序分离。即，子设备按递减顺序分离，具有相同顺序的子设备按 LIFO 顺序分离。分离的设备不会被删除。

`bus_detach_children` 通常在总线驱动程序的 [DEVICE\_DETACH(9)](/man/man9/device_detach.9.md) 方法开始时调用，让子设备有机会否决分离请求。它通常与稍后调用 `device_delete_children(9)` 删除子设备配对使用。如果两个函数调用之间不需要额外逻辑，总线驱动程序可以使用 [bus\_generic\_detach(9)](/man/man9/bus_generic_detach.9.md) 分离和删除子设备。

## 参见

config\_intrhook\_establish(9), [device\_add\_child(9)](/man/man9/device_add_child.9.md), [DEVICE\_ATTACH(9)](/man/man9/device_attach.9.md), [device\_delete\_children(9)](/man/man9/device_delete_children.9.md), [DEVICE\_DETACH(9)](/man/man9/device_detach.9.md), device\_detach(9), [DEVICE\_IDENTIFY(9)](/man/man9/device_identify.9.md), [device\_probe\_and\_attach(9)](/man/man9/device_probe_and_attach.9.md)

## 历史

`bus_enumerate_hinted_children` 首次出现于 FreeBSD 6.2。

`bus_delayed_attach_children` 首次出现于 FreeBSD 12.2。

`bus_identify_children` 首次出现于 FreeBSD 15.0。其功能在旧版本中通过已弃用的 `bus_generic_probe` 提供。

`bus_attach_children` 首次出现于 FreeBSD 15.0。其功能在旧版本中通过已弃用的 `bus_generic_attach` 提供。

`bus_detach_children` 首次出现于 FreeBSD 15.0。其功能在旧版本中通过 `bus_generic_detach` 提供。


---

# 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/man9/bus_attach_children.9.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.