DriverKit 中可以将哪些选项传递给 IOService::Terminate

Question

virtual kern_return_t IOService::Terminate(uint64_t options) 表示您可以通过选项传递参数。我想知道有什么不同的选择？文档什么也没说。

Answer 1

XNU 源代码包（7195.50.7.100.1，macOS 11.0.1）中的IOService.iig 文件包含以下内容：

    /*!
     * @brief       Start an IOService termination.
     * @discussion  An IOService object created with Create() may be removed by calling Terminate().
     *              The termination is asynchronous and will later call Stop() on the service.
     * @param       options No options are currently defined, pass zero.
     * @return      kIOReturnSuccess on success. See IOReturn.h for error codes.
     */
    virtual kern_return_t
    Terminate(
        uint64_t             options);

选项 当前没有定义任何选项，传递零。

在内核方面，IOService::terminate 确实有一些有效的选项。但是，我不知道您是否可以从 DriverKit 传递这些信息。它们可能会被过滤：

• kIOServiceSynchronous:

kIOServiceSynchronous 可能被传递，导致terminate 在服务完成之前不会返回。

• kIOServiceRequired:

默认情况下，如果任何客户端打开了服务，terminate 就会失败。但是，如果 kIOServiceRequired 标志被传递，terminate 将是 成功，但在销毁方面取得了进一步的进展 IOService 对象在最后一个客户端关闭之前不会继续 它。

• kIOServiceTerminateWithRematch：这个我不太清楚，没有文档记录，但是粗略阅读相关代码表明，当一个对象以这种方式终止时，它的提供者将重新触发 I/O Kit 匹配。李>

还有一些其他的，例如 kIOServiceRecursing，它们在从 terminate() 本身转发到各种终止阶段函数以跟踪终止状态时在内部使用。这些通常不应该在 kext 代码中使用，而且我非常怀疑如果您在 DriverKit 中使用它们是否会被传递。