x64dbg 中 analxrefs 交叉引用分析命令:从指令扫描到 xref 表的完整实现剖析

原创2026-09-17 09:41:051,361 阅读
文章标签:开发工具调试器逆向工程桌面应用网络安全

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 章节索引。

适用前提:

  1. 已启动调试会话(init 或 attach),目标模块已映射进内存;
  2. 反汇编视图(Disassembly view)的当前光标/选区位于目标模块内部——命令以"选区起始地址所在的内存块"作为分析范围,而不是以"整个模块"为范围,这是理解其行为的关键;
  3. 命令不依赖 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 步:

  1. GuiSelectionGet(GUI_DISASSEMBLY, &sel) 从反汇编视图取得当前选区。文档中"the module selected in the disassembly view"即由此而来——你让反汇编窗口停在哪个模块里,就分析哪个模块所在区域;
  2. MemFindBaseAddr(sel.start, &size) 用选区起始地址反查所属内存块(模块),得到分析基址 base 和块大小 size。因此实际扫描范围是选区所在模块的整个内存块,而非仅选区本身;
  3. 用 (base, size) 构造 XrefsAnalysis 对象,依次执行 Analyse()(收集)与 SetMarkers()(落表);
  4. 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);

两个值得注意的细节(从源码结构看):

  1. 寄存器操作数被解析为 0。传给 ResolveOpValue 的寄存器回调解恒返回 0,意味着寄存器间接寻址(如 jmp [reg])无法在当前静态上下文解析出具体地址,会被自然排除;只有操作数本身携带绝对地址值(典型如绝对地址跳转/调用目标、立即数形式的数据引用)才会产生候选 xref;
  2. 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);
}

两步含义:

  1. 先删后建,保证幂等:XrefDelRange 清除目标地址落在 [mBase, mBase+mSize-1] 区间内的既有 xref,再把本次扫描结果逐条 XrefAdd(addr, from) 写入。因此重复执行 analxrefs 不会累积重复引用,而是用最新扫描结果覆盖该范围的引用表——这与"模块内存内容被修改(如补丁后)重新分析"的场景相配合;
  2. 方向语义: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 表。

实践要点与行为边界

  1. 无参数、无结果变量:调用即分析"光标所在模块块",无法通过参数指定其他地址范围。若想分析非当前模块,需先在反汇编视图中切换到该模块地址,再执行命令;
  2. 只记录绝对引用:从 ResolveOpValue 的寄存器回调解为 0 这一实现细节看,寄存器间接跳转、函数指针调用这类间接引用不会出现在结果中;它们需要结合调用栈、analrecur 等手段补充;
  3. 每条指令最多一条 xref:多个操作数同时命中模块内地址时只记录第一个;
  4. 范围过滤在模块级:inModRange 以模块边界判定,跨模块引用(如跳往 ntdll)不会被记入,这在恶意代码分析中避免了系统库地址的干扰;
  5. 可重复执行:SetMarkers 的"先删后建"策略保证结果与内存当前内容一致,配合补丁(patch)后重跑可刷新引用表;
  6. 与 cfanalyse 配合:GUI 的完整分析流程(cfanalyse + analxrefs)能同时获得基本块/函数边界标记与引用表,脚本化批量分析时建议保留这一顺序。

小结

analxrefs/analx 是 x64dbg 中"轻量但高频"的分析命令:无参数、无结果变量,语义是"把反汇编视图中当前模块块内的直接地址引用重建进 xref 表"。其实现由 x64dbg.cpp 的注册、cmd-analysis.cpp 的回调、xrefsanalysis.cpp 的 Zydis 线性扫描三部分构成,配合 GUI 的 cfanal + analx 组合动作,构成了 x64dbg 模块级静态分析(引用定位)的基础能力。

登录后查看全文
x64dbg