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 资源不是 ZX_RSRC_KIND_SYSTEM 种类和基本 ZX_RSRC_SYSTEM_DEBUGLOG_BASE 类型。

ZX_ERR_NO_MEMORY 因内存不足而失败。

另请参阅