> 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_setup_intr.9.md). # BUS\_SETUP\_INTR.9 `BUS_SETUP_INTR` — 创建、附加和拆卸中断处理程序 ## 名称 `BUS_SETUP_INTR`, `bus_setup_intr`, `BUS_TEARDOWN_INTR`, `bus_teardown_intr` ## 概要 ```c #include #include ``` ```c int BUS_SETUP_INTR(device_t dev, device_t child, struct resource *irq, int flags, driver_filter_t *filter, driver_intr_t *ithread, void *arg, void **cookiep) int bus_setup_intr(device_t dev, struct resource *r, int flags, driver_filter_t filter, driver_intr_t ithread, void *arg, void **cookiep) int BUS_TEARDOWN_INTR(device_t dev, device_t child, struct resource *irq, void *cookiep) int bus_teardown_intr(device_t dev, struct resource *r, void *cookiep) ``` ## 描述 `BUS_SETUP_INTR` 方法为先前由资源管理器的 BUS\_ALLOC\_RESOURCE(9) 方法分配的中断创建并附加中断处理程序。`flags` 定义于 `#include ` 用于给出中断的大致类别。`flags` 还告知中断处理程序有关设备驱动程序的某些特性。`INTR_EXCL` 将该处理程序标记为此中断的独占处理程序。`INTR_MPSAFE` 告知调度程序该中断处理程序在抢占式环境中表现良好（"SMP 安全"），不需要由"Giant Lock"互斥锁保护。`INTR_ENTROPY` 将该中断标记为良好的熵源——这可被熵设备 **/dev/random** 使用。 若要定义不会执行任何潜在阻塞操作的时间关键型处理程序，请使用 `filter` 参数。有关编写过滤例程的信息，参见下文的过滤例程小节。否则，使用 `ithread` 参数。所定义的处理程序将以 `arg` 的值作为其唯一参数被调用。有关编写中断处理程序的更多信息，参见下文的 ithread 例程小节。 `cookiep` 参数是一个指向 `void *` 的指针，如果 `BUS_SETUP_INTR` 成功建立中断，它会为父总线的使用写入一个 cookie。驱动程序编写者可以假定此 cookie 非零。nexus 驱动程序在失败时会向 `cookiep` 写入 0。 中断处理程序将通过 `BUS_TEARDOWN_INTR` 分离。需要将 cookie 传递给 `BUS_TEARDOWN_INTR` 以便拆卸正确的中断处理程序。一旦 `BUS_TEARDOWN_INTR` 返回，可以保证中断函数不再活动，也不会再被调用。 在调用这些函数期间不允许持有互斥锁。 ### 过滤例程 过滤例程运行于主中断上下文。在此上下文中，不能使用普通互斥锁。只能使用其自旋锁版本（在初始化互斥锁时通过向 `mtx_init` 传递 `MTX_SPIN` 来指定）。可以调用 wakeup(9) 及类似例程。可以使用 `machine/atomic` 中的原子操作。可以通过 [bus\_space(9)](/man/man9/bus_space.9.md) 读写硬件。可以读写 PCI 配置寄存器。不能使用所有其他内核接口。 在此受限环境中，必须注意处理所有竞态。还应仔细分析竞态。例如，多处理一次中断通常比用自旋锁保护变量更划算。如果其他线程正在访问相同的硬件寄存器，则需要仔细分析硬件寄存器的读-改-写周期。 通常，过滤例程会使用以下两种策略之一。第一种策略是简单地屏蔽硬件中的中断，让 `ithread` 例程从硬件读取状态，然后重新启用中断。`ithread` 在重新启用硬件中的中断源之前也会确认中断。大多数 PCI 硬件可以屏蔽其中断源。 第二种常见方法是使用过滤例程配合多个 [taskqueue(9)](/man/man9/taskqueue.9.md) 任务。在这种情况下，过滤例程确认中断并将工作排入适当的任务队列。当需要复用不同类型的中断源（例如网卡的发送和接收路径）时，这可以减少锁争用并提高性能。 你不应在过滤例程中调用 [malloc(9)](/man/man9/malloc.9.md)。不能调用任何使用普通互斥锁的函数。Witness 可能会对此发出警告。 ### ithread 例程 在 ithread 例程中可以做任何想做的事，但不能睡眠。必须注意不要在 ithread 中睡眠。此外，应尽量减少 ithread 例程中的锁争用，因为争用的锁会波及该中断上的所有其他 ithread 例程。 ### 睡眠 睡眠是指自愿放弃对线程的控制。msleep(9) 中的所有睡眠例程都会睡眠。等待 [condvar(9)](/man/man9/condvar.9.md) 中描述的条件变量属于睡眠。调用执行上述任何操作的函数都属于睡眠。 ## 返回值 成功时返回零，否则返回一个适当的错误。 ## 参见 [random(4)](/man/man4/random.4.md), [device(9)](/man/man9/device.9.md), [driver(9)](/man/man9/driver.9.md), [locking(9)](/man/man9/locking.9.md) ## 作者 本手册页由 Jeroen Ruigrok van der Werven 基于 Doug Rabson 编写的 `BUS_CREATE_INTR` 和 `BUS_CONNECT_INTR` 手册页编写。 --- # 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_setup_intr.9.md?ask=&goal= ``` `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.