zx_debuglog_create

摘要

创建一个允许访问内核调试日志的对象。

声明

#include <zircon/syscalls.h>

zx_status_t zx_debuglog_create(zx_handle_t resource,
                               uint32_t options,
                               zx_handle_t* out);

说明

zx_debuglog_create() 会创建一个允许使用 zx_debuglog_read() 和 zx_debuglog_write() 系统调用访问内核调试日志的对象。

如果 options 设置为 0，返回的句柄将具有 ZX_RIGHT_WRITE 右侧，从而授予对内核调试日志的只写访问权限。如果 options 设置为 ZX_LOG_FLAG_READABLE，返回的句柄还将具有 ZX_RIGHT_READ，从而授予对内核调试日志的读写权限。

权限

resource 必须具有资源种类 ZX_RSRC_KIND_SYSTEM 和基 ZX_RSRC_SYSTEM_DEBUGLOG_BASE。

返回值

zx_debuglog_create() 会在成功时返回 ZX_OK，并在 out 中返回所创建对象的句柄。

如果失败，则返回负的错误值。

错误

ZX_ERR_INVALID_ARGS 选项包含内核无法理解的值

ZX_ERR_WRONG_TYPE resource 不是 ZX_RSRC_KIND_SYSTEM 和基础 ZX_RSRC_SYSTEM_DEBUGLOG_BASE 的种类。

ZX_ERR_NO_MEMORY因内存不足而失败。

另请参阅