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

时间:2021-01-15 14:11:05

标签: macos iokit driverkit macos-system-extension

virtual kern_return_t IOService::Terminate(uint64_t options) 表示您可以传递带有选项的参数。我想知道有哪些不同的选择?该文档没有说明任何内容。

1 个答案:

答案 0 :(得分: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);
<块引用>

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

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

  • kIOServiceSynchronous
<块引用>

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

  • kIOServiceRequired
<块引用>

默认情况下,如果任何客户端打开了该服务,terminate 将失败。但是,如果传递了 kIOServiceRequired 标志,则 terminate 将是 在销毁 IOService 对象在最后一个客户端关闭之前不会继续

  • kIOServiceTerminateWithRematch:这个我不是很清楚,没有文档说明,但粗略阅读相关代码表明,当一个对象以这种方式终止时,它的提供者将重新触发 I/O套件匹配。

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

相关问题