用途:当用户尚不清楚要查找的对象属于哪类实体,只掌握一个名称或名称片段,并希望找出二进制中所有匹配位置时,可使用 grep 技能。若只需按类型查询(仅函数、仅字符串、仅导入),应优先使用专门的 disassembly/data 技能;若要查找调用者或被调用者,应使用 xrefs。
数据表:grep 是覆盖 funcs、flags、imports、entries、sections 和 comments 的虚拟复合表。其列包括 kind、name、full_name、parent_name、addr 和 pattern*。kind 表示来源表,使用单数形式:func、flag、import、export、section、comment。full_name 对导入采用 parent!name 形式(如 kernel32.dll!CreateFileW),其他类型等于 name。parent_name 对导入表示所属库(来自 module),其他类型为空。entities 是 grep 上的只读视图,列包括 kind、name、full_name、parent_name、addr,不含 pattern。
模式语义:pattern 是仅供输入的伪列,普通 SELECT * 时为空,在 WHERE 中用于按名称过滤。WHERE pattern = 'Create%' 为 SQL LIKE 前缀匹配;WHERE pattern = '%Decrypt%' 为 SQL LIKE 子串匹配;WHERE pattern = 'foo' 为不区分大小写的子串匹配;也可使用显式的逐列条件 name LIKE ... OR name = ...。r2xsql 会将模式不区分大小写地同时匹配 name 与 full_name;不含通配符的值按子串处理,含 % 或 _ 的值按 SQL-LIKE 通配处理。过滤在 r2xsql 的迭代器内执行,无需将完整复合表物化到 SQLite 缓存。
常用查询示例:查找所有提及 decrypt 的实体:SELECT kind, name, addr FROM grep WHERE pattern = '%decrypt%'; 仅查以 sub_ 开头的函数:SELECT kind, name FROM grep WHERE pattern = 'sub_%' AND kind = 'func'; 查导入和导出中与 Crypt 相关项:SELECT kind, name, parent_name FROM grep WHERE pattern = '%Crypt%' AND kind IN ('import','export'); 查某库的全部导入:SELECT addr, name FROM grep WHERE kind = 'import' AND parent_name = 'kernel32.dll'。排序与计数示例:SELECT kind, COUNT(*) AS n FROM grep WHERE pattern = '%http%' GROUP BY kind;。也可在 entities 视图上查询全部命名实体:SELECT kind, name, addr FROM entities ORDER BY kind, name; 或只查函数:SELECT name, addr FROM entities WHERE kind = 'func';。
注意事项:对于不绑定位置的实体,addr 为 0;例如无头段的节区其 start_addr 可能为 0,对应 grep 行的 addr 也为 0。复合表不支持 UPDATE/DELETE,写操作应通过类型化表(flags、comments)并配合 annotations 技能完成。entities 是只读视图,行与 grep 相同,但无 pattern 伪列;它存在是为了让期望名为 entities 的查询也能在此找到对应表。这是 r2xsql 自己的术语,并非工具族统一约定,kind 取值与 grep 相同(func/flag/import/export/section/comment),尚未有跨工具统一词汇;使用兄弟工具 spelling(function、symbol、segment、string、type 等)的查询在此会返回零行,应始终使用 r2xsql 自身的值。需要 pattern 下推时直接查询 grep,entities 不携带该伪列。