zx_debuglog_write

摘要

將訊息寫入核心偵錯記錄。

宣告

#include <zircon/syscalls.h>

zx_status_t zx_debuglog_write(zx_handle_t handle,
                              uint32_t options,
                              const void* buffer,
                              size_t buffer_size);

說明

zx_debuglog_write() 會嘗試寫入大小 buffer_size 個位元組的 buffer 加入核心偵錯記錄檔記錄項目的嚴重性為 ZX_LOG_INFO。

buffer 不需要任何特定格式，但大部分使用者空間 工具會假設內容是有效的 UTF-8 字串，不含任何 空終止。buffer 可能會截斷為小於或剛好的一部分 ZX_LOG_RECORD_MAX 後即可插入 zx_log_record_t 的 data 欄位。

options 必須設為 0。

權限

handle 必須是 ZX_OBJ_TYPE_LOG 類型，且具有 ZX_RIGHT_WRITE。

傳回值

zx_debuglog_write() 會在成功時傳回 ZX_OK。如果失敗，系統會傳回負數錯誤值。

錯誤

ZX_ERR_ACCESS_DENIED 帳號代碼沒有 ZX_RIGHT_WRITE。

ZX_ERR_BAD_HANDLE 帳號代碼不是有效的帳號代碼。

ZX_ERR_INVALID_ARGS 為 options 輸入的值無效，或 buffer 是無效的指標

ZX_ERR_WRONG_TYPE handle 不是 debuglog handle。

另請參閱