Avatar——守望者

Avatar² 允许用户在编排中hook各种事件。这些hook是用户定义的回调并且允许在事件发生前后改变或检查分析状态。

增加一个hook的接口如下：

from avatar2 import *

def my_callback(avatar, *args, **kwargs):
    print("StateTransfer occured!")

avatar = Avatar()
avatar.watchmen.add_watchmen('StateTransfer', 'after', my_callback)

第一个参数是将要hook的事件，第二个参数指定事件处理之前或之后执行回调，第三个参数指向回调函数。

现在，avatar²支持hook下面这些事件：

事件名	触发事件	可选参数
StateTransfer	将状态从一个目标转移到另一个目标	from_target, to_target, sync_regs, synced_ranges
BreakpointHit	到达一个断点	BreakpointMessage
UpdateState	一个目标状态改变	UpdateStateMessage
RemoteMemoryRead	一个转发内存的读正在发生	RemoteMemoryReadMessage
RemoteMemoryWrite	一个转发内存的写正在发生	RemoteMemoryWriteMessage
AvatarGetStatus	avatar的当前状态被请求	-

所有回调的第一个参数都是avatar实例，可选参数如上表。值得注意的是，许多事件允许检查AvatarMessages。这些是包括所有关于一个指定事件的重要信息的封装。这些消息通常由目标的协议生成并被传递给调度它们的avatar实例。