摘要
向内核调试日志写入消息。
声明
#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 不严格要求采用任何特定格式，但大多数用户空间工具都会假定内容是无 NUL 终止的有效 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 不是有效的句柄。
ZX_ERR_INVALID_ARGS为 options 或 buffer 指定的值无效
是无效的指针。
ZX_ERR_WRONG_TYPE handle 不是调试日志句柄。