zx_debug_resume

摘要

在成功执行 zx_debug_suspend() 后,允许访问调试串行端口硬件。

声明

#include <zircon/syscalls-next.h>

zx_status_t zx_debug_resume(zx_handle_t resource);

说明

zx_debug_resume() 会撤消之前调用 zx_debug_suspend() 的效果。调用方必须确保在调用 zx_debug_resume() 之前,调试串行端口硬件已通电并已计时。

恢复后,对 zx_debug_write() 的任何被阻止的调用都将继续,并且系统会发出在端口暂停期间记录的所有日志消息。

权限

resource 必须具有资源种类 ZX_RSRC_KIND_SYSTEM,其基数为 ZX_RSRC_SYSTEM_DEBUG_BASE。

返回值

成功时返回 ZX_OK。

错误

ZX_ERR_BAD_HANDLE 资源不是有效的句柄。

ZX_ERR_WRONG_TYPE resource 不是资源句柄。

ZX_ERR_OUT_OF_RANGE 资源不是调试系统资源。

ZX_ERR_NOT_SUPPORTED 系统没有调试串行端口,或者内核已配置为绕过调试日志 (kernel.bypass-debuglog=true)。

ZX_ERR_BAD_STATE 调试串行端口未暂停(包括对 zx_debug_suspend() 的调用仍在进行中)。

另请参阅