Go 接口与 SwissMap 反汇编识别:eface/iface/itab、slice interface 与 runtime.mapassign/mapaccess
code-analysis/reverse · verified
一句话结论
在 IDA 伪代码里看到 runtime_eface/runtime_iface、_slice_interface_、runtime_convTstring、runtime_mapassign_fast64/mapassign_faststr 等符号时,可以按 Go 运行时的固定布局还原接口与 map 语义:空接口是 {_type, data} 两字,非空接口是 {itab, data} 两字,[]interface{} 是三字切片头,Go 1.24+ 的 map 是使用 used/seed/dirPtr/globalDepth 的 SwissMap;识别这些结构后能把大量“看不懂的间接调用/写屏障”还原成正常的赋值与输出逻辑。
原理
- 空接口
interface{}(eface):runtime_eface为{internal_abi_Type *_type; void *data},共 16 字节。_type描述动态类型(Size_、PtrBytes、Hash、TFlag、Align_、FieldAlign_、Kind_、Equal、GCData、Str、PtrToThis等),data指向实际值。 - 非空接口(iface):
runtime_iface为{internal_abi_ITab *tab; void *data}。itab是接口方法表,包含动态类型信息与接口所有方法的函数指针,作用类似 C++ 虚表;例如fmt.Println的io.Writer参数使用go_itab__ptr_os_File_comma_io_Writer作为tab、os_Stdout作为data。 _slice_interface_:[]interface{}的切片头是{interface *array; int len; int cap},24 字节。fmt_Fprintln(writer, slice)的第二个参数就是它;fmt_Fprintf则多一个string格式化串。识别这两组参数(io_Writer+_slice_interface_,或再加string)可以快速区分 Print/Printf 系列调用。runtime_convTstring:把栈上的 string 值复制到堆上并返回string*,再把RTYPE_string_0与该指针组成 eface。这样做的原因是栈帧销毁后栈上数据可能失效,接口值必须拥有稳定的副本;伪代码里表现为“先取类型&RTYPE_string_0,再调用runtime_convTstring,然后填两个 qword”。- 输入路径:
fmt.Scanln(&a)先runtime_newobject(&RTYPE_string_0)在堆上分配 string 对象,再用RTYPE__ptr_string构造*string的 eface;io.Reader同样用go_itab__ptr_os_File_comma_io_Reader+os_Stdin。输出/输入结构几乎对称,只是 Writer 换成 Reader。 - 切片扩容:
make([]T, len)后append会调用runtime_growslice(et, old, cap);返回的runtime_slice是{void *array; int len; int cap}。Go 在向含指针的元素写值时插入runtime_gcWriteBarrier1慢路径;伪代码里if (runtime_writeBarrier.enabled) { ... }通常可视为“正常赋值 + GC 写屏障”,不是业务分支。 - SwissMap(Go 1.24+):
internal_runtime_maps_Map的关键字段为used(+0x00,元素个数)、seed(+0x08,哈希种子)、dirPtr(+0x10,目录数组指针)、dirLen(+0x18)、globalDepth(+0x20)、globalShift(+0x21)、writing(+0x22)、clearSeq(+0x28)。初始化时用runtime_duffzero清零目录、m.dirPtr = ...、m.seed = runtime_rand()。 - 类型专用 map 函数:
runtime_mapassign_fast64/mapaccess1_fast64对应 64 位整数键(如map[int]string),runtime_mapassign_faststr/mapaccess1_faststr对应字符串键;函数名里的fast64/faststr和RTYPE_map_int_string/RTYPE_map_string_string直接暴露键值类型。mapassign_*返回 value 槽指针,因此伪代码常见v2[1] = 长度; *v2 = 数据指针的两次写;mapaccess1_*返回 value 的副本。 - 为什么可复用:Go 编译器把接口、切片、map 语法全部降级为固定的运行时调用与内存布局,符号名和结构偏移在同类版本的二进制中稳定;掌握这套映射后,即使
-ldflags="-w -s"去符号,也能靠RTYPE_*、runtime_*和结构形态恢复变量类型与控制流。
触发条件
- 目标是 Go 编译的二进制,反汇编器为 IDA/Ghidra 等,能看到
runtime_*/go_itab_*/RTYPE_*符号或类型信息。 - 伪代码中出现接口调用、
fmt系列调用、make(map)/mapassign/mapaccess、append/growslice等模式。 - 需要还原结构体字段、函数参数类型或 map 的键值类型,以便继续逆向业务逻辑或漏洞点。
- 目标 Go 版本为 1.24+ 时使用 SwissMap 布局;较早版本是
hmap(count/flags/B/buckets等),字段名与偏移不同,需先确认版本。
利用步骤
- 确认 Go 二进制与版本:查
.gopclntab、Go build ID、runtime.main,必要时用go version -m或字符串中的go1.x判断是否为 SwissMap。 - 在 IDA 中运行
go_parser/redress恢复符号与类型;若已去符号,仍可用RTYPE_*字符串和runtime_*调用定位。 - 遇到 16 字节结构体且第一个字段指向
RTYPE_*:按 eface 解读为{type, data};若第一个字段指向go_itab_*:按 iface 解读为{itab, data}。 - 遇到 24 字节的
{array, len, cap}且 array 元素是 interface:按[]interface{}解读;遇到同样三字但元素是 string:按普通[]string解读。 - 遇到
runtime_mapassign_fast64/faststr:第一个参数是SwissMapType*(或RTYPE_map_*),第二个是 map 头&m,第三个是 key,返回值是 value 槽指针;mapaccess1_*同样三参,返回 value 副本。 - 按
internal_runtime_maps_Map的偏移注解m,忽略runtime_duffzero的清零块与gcWriteBarrier慢路径,聚焦dirPtr/used的变化,即可还原 map 的插入、查询与遍历逻辑。 - 对
fmt_Fprintln/fmt_Fprintf等调用,按“writer iface + slice interface(+ format string)”的顺序回填参数,伪代码中的v10.array/v10.len/v10.cap就是可变参数列表。
PoC
// IDA 中可直接套用的类型定义(64 位)
struct runtime_eface { void *_type; void *data; }; // interface{}
struct runtime_iface { void *tab; void *data; }; // io.Writer / io.Reader 等非空接口
struct slice_interface { void *array; long len; long cap; }; // []interface{}
struct go_slice { void *array; long len; long cap; }; // []T
// fmt.Println(a) 的典型降级
// v5[0] = &RTYPE_string_0; v5[1] = runtime_convTstring(a);
// v10 = {&v5, 1, 1}; fmt_Fprintln(writer_iface, v10);
// map[int]string 的写入与读取
// v = runtime_mapassign_fast64(&RTYPE_map_int_string, &m, key);
// v[1] = len; *v = data_ptr; // 写 value 槽
// s = *(string *)runtime_mapaccess1_fast64(&RTYPE_map_int_string, &m, key);
// SwissMap 头(Go 1.24+),按 IDA 结构体偏移注解
struct internal_runtime_maps_Map {
unsigned long long used; // +0x00
unsigned long long seed; // +0x08
void *dirPtr; // +0x10
int dirLen; // +0x18
unsigned char globalDepth; // +0x20
unsigned char globalShift; // +0x21
unsigned char writing; // +0x22
unsigned long long clearSeq; // +0x28
};
变体与关联
- Go 1.24 之前是
hmap布局(count、flags、B、noverflow、hash0、buckets、oldbuckets等),mapassign/mapaccess的桶结构与 SwissMap 不同;先确定版本再套偏移。 - Go 1.17+ 部分平台改为寄存器传参(register ABI),栈传参的伪代码形态会变化;接口与 map 的运行时结构不变,但参数位置需按 ABI 重新确认。
- 与 [[code-analysis-reverse-go-binary-layout-symbol-recovery]] 互补:该卡讲 string/slice/map 基础布局与 stripped 符号恢复,本卡补充 eface/iface/itab、
[]interface{}和 SwissMap 的具体字段与类型专用 map 函数。 - 与 [[binary-pwn-stack-go-stack-overflow-rop]] 关联:识别
runtime_convTstring等运行时调用有助于理解 Go 栈溢出 payload 为什么必须保留字符串指针。
检测与防御
- 逆向方:优先用
go_parser/redress恢复类型;对去符号二进制,先搜RTYPE_/go_itab_字符串,再按结构形态手工注解。 - 开发方:发布时使用
-ldflags="-w -s",必要时用 garble 混淆标识符与字符串;但 Go 运行时依赖类型信息,完全去除会影响反射与接口,防御目标是提高分析成本。 - 注意:本卡是逆向分析技巧,不是可直接利用的漏洞;severity 标 low。