摘要
在成功执行 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() 的调用仍在进行中)。