x64dbg 中 analxrefs 交叉引用分析命令:从指令扫描到 xref 表的完整实现剖析
x64dbg 中 analxrefs 交叉引用分析命令:从指令扫描到 xref 表的完整实现剖析
analxrefs(别名 analx)是 x64dbg 指令集中用于逆向分析的核心命令:它在反汇编视图中选定模块的内存区域内做一次线性指令扫描,将其中指向模块内部的直接地址引用全部写入调试器的 xref 表,从而为"References from(被引用处)"视图提供数据。读完本文,你将了解该命令的注册入口、执行链路、XrefsAnalysis 的扫描与过滤逻辑、xref 表的写入语义,以及它与 GUI"分析模块"动作的关系。
命令概述
根据官方命令文档 analxrefs.md,该命令的行为定义为:
- 功能:对反汇编视图中当前选中的模块做交叉引用(xref)分析;
- 参数:无参数(This command has no arguments);
- 结果变量:不设置任何结果变量(does not set any result variables)。
它归属于分析类命令组,与 analyse、exanalyse、cfanalyse、analrecur、analadv 等命令并列,命令目录见 analysis 章节索引。
适用前提:
- 已启动调试会话(
init或attach),目标模块已映射进内存; - 反汇编视图(Disassembly view)的当前光标/选区位于目标模块内部——命令以"选区起始地址所在的内存块"作为分析范围,而不是以"整个模块"为范围,这是理解其行为的关键;
- 命令不依赖 PDB 符号,纯靠指令编码中的立即数/绝对地址运算。
命令注册与执行链路
命令在调试器启动阶段注册进命令表,入口在 x64dbg.cpp#L373:
dbgcmdnew("analxrefs,analx", cbInstrAnalxrefs, true); //analyze xrefs
"analxrefs,analx" 的逗号写法表示两个名称指向同一个回调 cbInstrAnalxrefs,因此在控制台输入 analxrefs 或简写 analx 效果完全一致。
回调实现位于 cmd-analysis.cpp#L74-L85:
bool cbInstrAnalxrefs(int argc, char* argv[])
{
SELECTIONDATA sel;
GuiSelectionGet(GUI_DISASSEMBLY, &sel); // 1. 取反汇编视图选区
duint size = 0;
auto base = MemFindBaseAddr(sel.start, &size); // 2. 定位选区所在的内存块基址与大小
XrefsAnalysis anal(base, size); // 3. 构造分析器
anal.Analyse(); // 4. 线性扫描,收集 xref
anal.SetMarkers(); // 5. 写入 xref 表
GuiUpdateAllViews(); // 6. 刷新所有视图
return true;
}
整个调用链只有五步,核心逻辑集中在第 3~5 步:
GuiSelectionGet(GUI_DISASSEMBLY, &sel)从反汇编视图取得当前选区。文档中"the module selected in the disassembly view"即由此而来——你让反汇编窗口停在哪个模块里,就分析哪个模块所在区域;MemFindBaseAddr(sel.start, &size)用选区起始地址反查所属内存块(模块),得到分析基址base和块大小size。因此实际扫描范围是选区所在模块的整个内存块,而非仅选区本身;- 用
(base, size)构造XrefsAnalysis对象,依次执行Analyse()(收集)与SetMarkers()(落表); GuiUpdateAllViews()刷新界面,使引用表、反汇编高亮等同步更新。
XrefsAnalysis 的扫描原理
分析器实现在 xrefsanalysis.cpp,头文件 xrefsanalysis.h 中可以看到其内部结构:
struct XREF
{
duint addr; // 被引用的目标地址(operand 解析出的值)
duint from; // 含该引用的指令地址
};
std::vector<XREF> mXrefs;
duint modbase = 0;
duint modsize = 0;
构造时记录所在模块的边界,用于后续范围过滤:
XrefsAnalysis::XrefsAnalysis(duint base, duint size)
: Analysis(base, size)
{
modbase = ModBaseFromAddr(base);
modsize = ModSizeFromAddr(modbase);
}
逐条指令线性扫描
Analyse() 从 mBase 走到 mBase + mSize,典型的线性反汇编遍历:
for(auto addr = mBase; addr < mBase + mSize;)
{
if(!mZydis.Disassemble(addr, translateAddr(addr)))
{
addr++; // 解码失败:跳过一个字节继续
continue;
}
addr += mZydis.Size(); // 解码成功:跳过整条指令
...
}
- 解码失败时只前进一个字节,保证数据区/混淆字节也能被逐个跳过,不会漏掉后面紧邻的有效指令;
- 解码成功则前进
mZydis.Size()字节,避免把指令的操作数误当作指令起点。
操作数解析与模块范围过滤
对每条成功解码的指令,遍历其全部操作数:
for(auto i = 0; i < mZydis.OpCount(); i++)
{
auto dest = (duint)mZydis.ResolveOpValue(i, [](ZydisRegister) -> uint64_t
{
return 0;
});
if(inModRange(dest))
{
xref.addr = dest;
break; // 一条指令最多只记录一个 xref
}
}
if(xref.addr)
mXrefs.push_back(xref);
两个值得注意的细节(从源码结构看):
- 寄存器操作数被解析为 0。传给
ResolveOpValue的寄存器回调解恒返回 0,意味着寄存器间接寻址(如jmp [reg])无法在当前静态上下文解析出具体地址,会被自然排除;只有操作数本身携带绝对地址值(典型如绝对地址跳转/调用目标、立即数形式的数据引用)才会产生候选 xref; inModRange过滤。头文件中的定义是:
bool inModRange(duint addr) const
{
return modbase ? (addr >= modbase && addr < modbase + modsize) : inRange(addr);
}
即目标值必须落在指令所在模块的地址范围内才算数(模块基址未知时退化为落在分析区间内)。这一设计让 analxrefs 的结果聚焦于"模块内部交叉引用",跨模块或外部地址引用(如指向系统 DLL 的跳转)不会污染结果集。
另外注意 break:每条指令即使多个操作数都指向模块内部,也只记录第一个命中的目标。
控制台输出
Analyse() 的首尾各有一条日志,可用于判断执行进度与规模:
Starting xref analysis...
< N> xrefs found in < T>ms!
N 为收集到的 xref 数量,T 为耗时(毫秒),对超大模块可据此感知分析负载。
xref 表的写入语义(SetMarkers)
收集完成后,SetMarkers() 负责把结果落入 xref 数据库:
void XrefsAnalysis::SetMarkers()
{
XrefDelRange(mBase, mBase + mSize - 1);
for(const auto & xref : mXrefs)
XrefAdd(xref.addr, xref.from);
}
两步含义:
- 先删后建,保证幂等:
XrefDelRange清除目标地址落在[mBase, mBase+mSize-1]区间内的既有 xref,再把本次扫描结果逐条XrefAdd(addr, from)写入。因此重复执行analxrefs不会累积重复引用,而是用最新扫描结果覆盖该范围的引用表——这与"模块内存内容被修改(如补丁后)重新分析"的场景相配合; - 方向语义:
from是含引用指令的地址,addr是被引用的目标。写入后,在 GUI 中右键目标地址选择"References from",即可看到所有"引用该地址的指令位置",这正是逆向中定位调用点、数据引用点的标准入口。xref 底层存取实现在 xrefs.cpp。
与 GUI"分析模块"动作的关系
在反汇编视图的 GUI 动作中,analxrefs 并不是孤立使用的。CPUDisassembly.cpp#L2090-L2094 中 GUI 的"分析模块"槽函数为:
void CPUDisassembly::analyzeModuleSlot()
{
DbgCmdExec("cfanal");
DbgCmdExec("analx");
}
也就是说,GUI 的完整分析动作是先执行 cfanalyse(控制流分析)再执行 analx(交叉引用分析),两条命令串行完成"函数边界标记 + 引用表构建"。在脚本或控制台手动复现 GUI 行为时,可以按同样顺序执行:
cfanalyse
analxrefs
对比同目录下的其他分析命令(均见 cmd-analysis.cpp):
| 命令 | 回调 | 作用 |
|---|---|---|
analyse |
cbInstrAnalyse |
线性分析(LinearAnalysis) |
cfanalyse |
cbInstrCfanalyse |
控制流分析(ControlFlowAnalysis),可选附加异常目录参数 |
exanalyse |
cbInstrExanalyse |
异常目录分析 |
analxrefs |
cbInstrAnalxrefs |
交叉引用分析(本文主题) |
analrecur |
cbInstrAnalrecur |
从给定地址递归分析 |
analadv |
cbInstrAnalyseadv |
高级组合分析 |
这些命令共享同一模式:取选区 → MemFindBaseAddr 定位内存块 → 构造对应的 Analysis 子类 → Analyse() + SetMarkers(),区别仅在各自的分析策略。analxrefs 的特殊性在于它的输出不体现在反汇编标记上,而是进入全局 xref 表。
实践要点与行为边界
- 无参数、无结果变量:调用即分析"光标所在模块块",无法通过参数指定其他地址范围。若想分析非当前模块,需先在反汇编视图中切换到该模块地址,再执行命令;
- 只记录绝对引用:从
ResolveOpValue的寄存器回调解为 0 这一实现细节看,寄存器间接跳转、函数指针调用这类间接引用不会出现在结果中;它们需要结合调用栈、analrecur等手段补充; - 每条指令最多一条 xref:多个操作数同时命中模块内地址时只记录第一个;
- 范围过滤在模块级:
inModRange以模块边界判定,跨模块引用(如跳往 ntdll)不会被记入,这在恶意代码分析中避免了系统库地址的干扰; - 可重复执行:
SetMarkers的"先删后建"策略保证结果与内存当前内容一致,配合补丁(patch)后重跑可刷新引用表; - 与
cfanalyse配合:GUI 的完整分析流程(cfanalyse+analxrefs)能同时获得基本块/函数边界标记与引用表,脚本化批量分析时建议保留这一顺序。
小结
analxrefs/analx 是 x64dbg 中"轻量但高频"的分析命令:无参数、无结果变量,语义是"把反汇编视图中当前模块块内的直接地址引用重建进 xref 表"。其实现由 x64dbg.cpp 的注册、cmd-analysis.cpp 的回调、xrefsanalysis.cpp 的 Zydis 线性扫描三部分构成,配合 GUI 的 cfanal + analx 组合动作,构成了 x64dbg 模块级静态分析(引用定位)的基础能力。