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() Syscall 偵錯記錄。

如果 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 因記憶體不足而失敗。

另請參閱