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 handle 不是有效的 handle。

ZX_ERR_INVALID_ARGS 为 options 指定的值无效，或者 buffer 是无效的指针。

ZX_ERR_WRONG_TYPE handle 不是调试日志句柄。

另请参阅