syzkaller syzlang 系统调用描述语言完全指南:从语法到实战

原创2026-10-09 15:37:331,857 阅读
文章标签:网络安全开发工具质量保障

syzkaller syzlang 系统调用描述语言完全指南:从语法到实战

导读

syzlang 是 syzkaller 内核模糊测试器用于声明式描述系统调用接口的领域特定语言(DSL,读作 <a href="https://link.gitcode.com/i/1abbe89cc25e8e54d4440f03e645f1cd" target="_blank">siːzˈlæŋg])。本文以官方语法文档为骨架,结合 [pkg/compiler 编译器源码与 sys/linux 下的真实描述文件,系统讲解从基础类型、结构体/联合体、资源依赖,到条件字段、类型模板等全部语言特性,并给出可复制的描述编写与编译流程。读完本文,你将能够读懂乃至编写自己的 *.txt 系统调用描述文件,理解 syzkaller 如何把描述编译为可执行程序。

一、语言概览与伪形式文法

syzkaller 使用声明式描述(declarative description)刻画系统调用接口,程序由这些描述翻译后生成、变异、执行、最小化、序列化与反序列化。描述文件存放在 sys/$OS/*.txt,例如 Linux 的 MIDI 接口描述见 sys/linux/dev_snd_midi.txt。

系统调用描述的伪形式文法如下:

syscallname "(" [arg ["," arg]*] ")" [type] ["(" attribute* ")"]
arg = argname type
argname = identifier
type = typename [ "[" type-options "]" ]
typename = "const" | "intN" | "intptr" | "flags" | "array" | "ptr" |
	   "string" | "filename" | "glob" | "len" |
	   "bytesize" | "bytesizeN" | "bitsize" | "vma" | "proc" |
	   "compressed_image"
type-options = [type-opt ["," type-opt]]

一个最简可读的例子(摘自 docs/syscall_descriptions.md):

open(file filename, flags flags[open_flags], mode flags[open_mode]) fd
read(fd fd, buf buffer[out], count len[buf])
close(fd fd)
open_mode = S_IRUSR, S_IWUSR, S_IXUSR, S_IRGRP, S_IWGRP, S_IXGRP, S_IROTH, S_IWOTH, S_IXOTH

其中 filename、buffer[out] 是内置类型别名,fd 是资源类型。syzkaller 据此生成如下的程序(文本表示):

r0 = open(&(0x7f0000000000)="./file0", 0x3, 0x9)
read(r0, &(0x7f0000000000), 42)
close(r0)

二、通用与各类型专属 type-options

所有类型共用的 type-option 是 opt,表示该参数可选(例如 mmap 的 fd 参数、accept 的 peer 参数)。其余 type-options 与具体类型绑定,下表完整覆盖官方文档内容:

类型 语义 type-options
const 整型常量 值;底层类型(intN/intptr)
intN/intptr 无特定含义的整数 可选取值范围(如 5:10、100:200),或 flags 描述引用,或单值;使用范围时可附带对齐参数
flags 一组取值 flags 描述引用;底层整型(如 int32)
array 变长/定长数组 元素类型;可选大小(定长 5 或区间 5:10,边界含端点)
ptr/ptr64 指向对象的指针 方向(in/out/inout);对象类型。ptr64 无论目标指针宽度恒为 8 字节
string 零结尾内存缓冲(不隐含指针间接) 引号内的字符串值(如 "foo",十六进制字面量用反引号如 deadbeef),或字符串 flags 引用(特殊值 filename 生成文件名);可选缓冲大小(字符串以 \x00 填充到该大小)
stringnoz 非零结尾内存缓冲(不隐含指针间接) 同 string,但不支持指定固定大小(见 pkg/compiler/types.go 中 stringnoz 检查)
glob 匹配目标文件的 glob 模式 引号内的模式串(语法见 Go path/filepath.Match,如 "/sys/" 或 "/sys/**/*");也支持排除模式,如 "/sys/**/*:-/sys/power/state"
fmt 整数的字符串表示(非零结尾) 格式(dec/hex/oct)与值(resource、int、flags 或 proc);结果数据定长(分别格式化为 %020llu、0x%016llx、%023llo,对应 20/18/23 字节)
len 另一字段的长度(对数组是元素个数) 对象的 argname
bytesize 类似 len,但恒为字节数 对象的 argname
bitsize 类似 len,但恒为位数 对象的 argname
offsetof 字段相对父结构体起始的偏移 字段
vma/vma64 指向一组页面的指针(用作 mmap/munmap/mremap/madvise 的输入) 可选页数(如 vma[7])或页数范围(如 vma[2-4])。vma64 恒为 8 字节
proc 每进程整数(见下文) 取值范围起点、每进程取值个数、底层类型
compressed_image zlib 压缩磁盘镜像 接受压缩镜像的 syscall 必须标记 no_generate 与 no_minimize 调用属性;若解压内容可由 fsck 类命令检查,使用 fsck syscall 属性
text 指定类型的机器码 文本类型(x86_real、x86_16、x86_32、x86_64、arm64,源码中还支持 ppc64、riscv64、target)
void 静态大小为 0 的类型 主要用于模板与变长联合体内,不能作为 syscall 参数

此外,flags/len/flags 在用于结构体/联合体/指针中时还带有尾部底层类型 type-option。

源码实现佐证

以上类型在编译器中均有对应描述符。例如 pkg/compiler/types.go 中:

  • typeVoid 的 Gen 生成 prog.BufferType 且 TypeSize = 0,是唯一静态大小为 0 的类型;
  • typePtr 中 ptr64 强制 base.TypeSize = 8;
  • typeFmt 的 Gen 按格式设置大小:dec→20、hex→18、oct→23,与文档的格式化字符串一一对应;
  • typeString 的 Gen 遇到 filename 特殊值生成 prog.BufferFilename,遇到 glob 生成 prog.BufferGlob;
  • typeVMA 处理 vma[7] 定长与 vma[2-4] 范围两种形式。

三、Flags 定义与调用属性(Call Attributes)

Flags 定义

整数 flags 描述为:

flagname = const ["," const]*

字符串 flags 描述为:

flagname = "\"" literal "\"" ["," "\"" literal "\""]*

注意 flags 类型同时覆盖三类语义:互斥取值集合(类似 C 枚举)、可按位或组合的位标志(类似 mmap flags),以及二者的任意组合。fuzzer 内部有逻辑区分枚举与位标志(见 pkg/compiler/types.go 的 isBitmask),因此描述时只需枚举有意义的取值即可,不必为迎合 fuzzer 添加“特殊值”。

调用属性

系统调用支持以下属性:

属性 含义
disabled 该调用不参与 fuzzing;用于临时禁用某些调用或禁止特定参数组合
timeout[N] 该调用在默认值之上增加 N 毫秒执行超时
prog_timeout[N] 若程序包含该调用,整个程序增加 N 毫秒执行超时;程序含多个此类调用时取最大值
ignore_return 忽略该 syscall 的返回值在 fallback 反馈中的作用;用于不返回固定错误码而返回其他内容(如当前时间)的调用
breaks_returns 忽略程序中所有后续调用在 fallback 反馈中的返回值(不可信)
no_generate 不尝试生成该 syscall,即仅用种子描述来产生它
no_minimize 最小化崩溃程序时不修改该 syscall 的实例
no_squash 不向该 syscall 传递 squashed 参数;否则 fuzzer 偶尔会把复杂结构替换成字节数组,可能触发有趣的变异,但也使程序难以分析
fsck 该 syscall 的压缩缓冲参数内容是文件系统,字符串参数是用于校验文件系统的 fsck 类命令
remote_cover 为该调用等待更长时间以收集远程覆盖率
kfuzz_test 该调用是 kfuzztest 目标
snapshot 该调用仅在快照 fuzzing 模式下默认启用,但也可在非快照模式中以其完整名称(而非通配符匹配)列入 enable_syscalls 时启用;始终可通过 disable_syscalls 禁用。一般用于标记在非快照模式下不安全执行的调用(可能导致误报或丢失到测试机器的连接)

调用属性并非散落在文档中的死规则,而是以代码为唯一事实源:prog.SyscallAttrs 结构体(见 prog/types.go 第 40-58 行)是解析描述的权威定义,pkg/compiler 与 syz-sysgen 都基于它工作,initCallAttrs 用反射遍历该结构体生成属性表(见 pkg/compiler/attrs.go)。

四、整数类型(Ints)

int8、int16、int32、int64 表示对应大小的整数,intptr 表示指针宽度整数(即 C 的 long)。追加 be 后缀(如 int16be)得到大端序整数。整数可指定取值范围 int32[0:100],或带对齐 int32[0:4096, 512](表示 512 对齐)。整数第一项 type-option 也可以是 flags 引用或单值,此时不支持对齐参数。int64:N 表示 N 位 bitfield。这些整数变体可作为 const、flags、len、proc 的基类型。

官方示例:

example_struct {
	f0	int8			# 随机 1 字节整数
	f1	const[0x42, int16be]	# 常量 2 字节整数,值 0x4200(大端 0x42)
	f2	int32[0:100]		# 0 到 100 闭区间内的随机 4 字节整数
	f3	int32[1:10, 2]		# 取值 {1, 3, 5, 7, 9} 的随机 4 字节整数
	f4	int64:20		# 随机 20 位 bitfield
	f5	int8[10]		# 常量 1 字节整数,值 10
	f6	int32[flagname]		# 从 flagname 引用取值集合中随机选一个 4 字节整数
}

编译器在 pkg/compiler/types.go 的 typeInt.CheckConsts 中做范围合法性检查:范围必须能放入基类型(无符号 [0:MAX_UINT] 或有符号 [-MIN_SINT:MAX_SINT]),对齐值过大会报错;intN[0:-1, align] 是“所有可能值但按 align 对齐”的特殊写法。真实描述示例见 sys/linux/dev_snd_midi.txt 中的 int32:1 位字段。

五、结构体(Structs)

结构体文法:

structname "{" "\n"
	(fieldname type ("(" fieldattribute* ")")? (if[expression])? "\n")+
"}" ("[" attribute* "]")?

字段可以在类型后以圆括号指定属性,独立于其类型。in/out/inout 指定逐字段方向:

foo {
	field0	const[1, int32]	(in)
	field1	int32		(inout)
	field2	fd		(out)
}

字段还可以用 (if[expression]) 指定是否包含的条件(详见条件字段一节)。

out_overlay 属性允许结构体拥有独立的输入与输出布局:out_overlay 字段之前的字段是输入,从它开始的字段是输出;输入与输出字段在内存中重叠(都从结构体内存起点开始):

foo {
	in0	const[1, int32]
	in1	flags[bar, int8]
	in2	ptr[in, string]
	out0	fd	(out_overlay)
	out1	int32
}

结构体属性写在结构体后的方括号中:

  • packed:字段之间无填充、对齐为 1,类似 GNU C __attribute__((packed));结构体对齐可用 align 属性覆盖;
  • align[N]:结构体对齐为 N 并填充到 N 的倍数;填充内容未指定(通常为 0),类似 __attribute__((aligned(N)));
  • size[N]:结构体填充到指定大小 N;填充内容未指定(通常为 0)。

属性在 pkg/compiler/attrs.go 中注册:structAttrs = makeAttrs(attrPacked, attrSize, attrAlign)。其中 size 属性值必须在 [1, 1<<20],align 必须是 2 的幂且不大于 1<<30,否则编译报错。

六、联合体(Unions)

联合体文法:

unionname "[" "\n"
	(fieldname type (if[expression])? "\n")+
"]" ("[" attribute* "]")?

fuzzing 过程中 syzkaller 随机选择联合体的一个选项。联合体属性:

  • varlen:联合体大小为实际选中选项的大小(静态未知);不加该属性时联合体静态取所有选项的最大值(类似 C 联合体);
  • size[N]:联合体填充到指定大小 N;填充内容未指定(通常为 0)。

unionAttrs = makeAttrs(attrVarlen, attrSize),联合体字段仅允许 in 与 if 属性(见 pkg/compiler/attrs.go)。

七、资源(Resources)

资源表示需要从一个 syscall 的输出传递到另一个 syscall 输入的值。例如 close 需要此前 open/pipe 返回的 fd。把 fd 声明为资源,就为 syscall 之间建立了依赖与隐式排序:产生资源的 syscall 一般排在使用该资源的 syscall 之前。

资源文法:

"resource" identifier "[" underlying_type "]" [ ":" const ("," const)* ]

underlying_type 是 int8/int16/int32/int64/intptr 之一,或另一个资源(实现继承,如 socket 是 fd 的子类型)。可选常量集合表示资源特殊值,如 0xffffffffffffffff(-1)表示“无 fd”、AT_FDCWD 表示“当前目录”。特殊值偶尔被用作资源值;若不指定,则使用特殊值 0。

官方示例:

resource fd[int32]: 0xffffffffffffffff, AT_FDCWD, 1000000
resource sock[fd]
resource sock_unix[sock]

socket(...) sock
accept(fd sock, ...) sock
listen(fd sock, backlog int32)

资源不一定要由 syscall 返回,也可以当普通数据类型使用;借助字段属性可建模更复杂的生产者/消费者场景:

resource my_resource_1[int32]
resource my_resource_2[int32]

request_produce1_consume2(..., arg ptr[inout, test_struct])

test_struct {
	...
	field0	my_resource_1	(out)
	field1	my_resource_2	(in)
}

约束:每个资源类型必须至少被一个 syscall“产生”(在联合体和可选指针之外用作输出)并被至少一个 syscall“消费”(用作输入)。编译器在 pkg/compiler/types.go 的 typeResource 中沿资源继承链回溯到最底层基类型以确定大小。

八、类型别名与类型模板

类型别名

高频复用的复杂类型可用 type identifier underlying_type 定义简短别名:

type signalno int32[0:65]
type net_port proc[20000, 4, int16be]

别名可在任何上下文替代底层类型使用,也可用作 syscall 参数。底层类型当前限制为整数类型、ptr、ptr64、const、flags、proc。内置别名包括:

type bool8	int8[0:1]
type bool16	int16[0:1]
type bool32	int32[0:1]
type bool64	int64[0:1]
type boolptr	intptr[0:1]

type fileoff[BASE] BASE

type filename string[filename]

type buffer[DIR] ptr[DIR, array[int8]]

类型模板

类型模板支持参数化声明:

type buffer[DIR] ptr[DIR, array[int8]]
type fileoff[BASE] BASE
type nlattr[TYPE, PAYLOAD] {
	nla_len		len[parent, int16]
	nla_type	const[TYPE, int16]
	payload		PAYLOAD
} [align_4]

使用方式:

syscall(a buffer[in], b fileoff[int64], c ptr[in, nlattr[FOO, int32]])

内置模板 optional 定义为一个变长联合体:

type optional[T] [
	val	T
	void	void
] [varlen]

注意 type buffer[DIR] ptr[DIR, array[int8]] 这类带参数的声明兼具“别名”与“模板”性质,即文档中别名与模板两节共享的示例。

九、长度类型(len/bytesize/bitsize)

可用 len、bytesize、bitsize 指定结构体字段或命名参数的长度:

write(fd fd, buf ptr[in, array[int8]], count len[buf])

sock_fprog {
	len	len[filter, int16]
	filter	ptr[in, array[sock_filter]]
}

若 len 的参数是指针,则使用指针所指对象的长度。bytesizeN 表示以 N 字节字为单位(N 可取 1、2、4、8)。len[parent, int8] 表示父结构体长度;结构体嵌套时可按类型名指定更高层父结构体:

s1 {
    f0      len[s2]  # s2 的长度
}

s2 {
    f0      s1
    f1      array[int32]
    f2      len[parent, int32]
}

len 参数还支持路径表达式,类似 C 字段引用,但也能引用父与兄弟元素;以特殊引用 syscall 开头的路径可直接指向 syscall 参数:

s1 {
	a	ptr[in, s2]
	b	ptr[in, s3]
	c	array[int8]
}

s2 {
	d	array[int8]
}

s3 {
# 引用父结构体 s1 中的数组 c
	e	len[s1:c, int32]
# 引用兄弟结构体 s2 中的数组 d
	f	len[s1:a:d, int32]
# 引用子结构体 s4 中的数组 k
	g	len[i:j, int32]
# 引用 syscall 参数 l
	h	len[syscall:l, int32]
	i	ptr[in, s4]
}

s4 {
	j	array[int8]
}

foo(k ptr[in, s1], l ptr[in, array[int8]])

编译器在 typeLen 中把 bytesize/bytesizeN/bitsize/offsetof 统一映射为 prog.LenType,其中 bytesizeN 的位数由 N 乘 8 计算得出,路径则解析 args[0].Ident 及其冒号分隔的 Colon 段(见 pkg/compiler/types.go)。

十、Proc 类型:每进程整数

proc 用于表示每进程整数:为每个 executor 分配互不干扰的取值区间。最典型的场景是端口号。

proc[20000, 4, int16be] 表示生成 int16be 整数,从 20000 起,每个进程分配 4 个值;因此 executor 编号 n 得到 [20000 + n * 4, 20000 + (n + 1) * 4) 区间内的值。编译器在 pkg/compiler/types.go 的 typeProc.CheckConsts 中校验每进程取值数不为 0,且起始值加步长乘 prog.MaxPids 不溢出基类型。

十一、整数常量

整数常量可写为十进制字面量、0x 前缀十六进制、' 包裹的字符字面量,或从内核头文件提取/由 define 指令定义的符号常量:

foo(a const[10], b const[-10])
foo(a const[0xabcd])
foo(a int8['a':'z'])
foo(a const[PATH_MAX])
foo(a int32[PATH_MAX])
foo(a ptr[in, array[int8, MY_PATH_MAX]])
define MY_PATH_MAX	PATH_MAX + 2

真实示例见 sys/linux/dev_snd_midi.txt:

define SNDRV_RAWMIDI_IOCTL_STATUS32	_IOWR('W', 0x20, char[36])
define SNDRV_RAWMIDI_IOCTL_STATUS64	_IOWR('W', 0x20, char[56])

十二、条件字段(Conditional Fields)

条件字段是描述报文/协议变体结构的关键能力:结构体字段与联合体选项都可以附带 if[expression] 条件。

结构体中的条件字段

header_fields {
  magic       const[0xabcd, int16]
  haveInteger int8
} [packed]

packet {
  header  header_fields
  integer int64  (if[value[header:haveInteger] == 0x1])
  body    array[int8]
} [packed]

some_call(a ptr[in, packet])

当 header.haveInteger == 1 时 packet 才包含 integer 字段,内存布局为 | magic | haveInteger | integer | body |,对应程序 some_call(&AUTO={{AUTO, 0x1}, @value=0xabcd, []});否则 syzkaller 视 integer 不存在,布局为 | magic | haveInteger | body |,对应 some_call(&AUTO={{AUTO, 0x0}, @void, []})。

要点:

  • 每个条件字段都被视为变长,其所属结构体也随之变长;
  • 变长字段出现在结构体中间时,结构体必须标记 [packed];
  • bitfield 上禁止条件(f1 int:3 (if[...]) 无法编译),但条件中可以引用 bitfield 的值。

联合体中的条件字段

struct {
  type int
  body alternatives
}

alternatives [
  int     int64 (if[value[struct:type] == 0x1])
  arr     array[int64, 5] (if[value[struct:type] == 0x2])
  default int32
] [varlen]

some_call(a ptr[in, struct])

type 为 0x1 时可选 int 或 default;为 0x2 时可选 arr 或 default;其他值时只能选 default。为保证联合体总能构造成功,最后一个联合体字段必须无条件——否则如 [int(...0x1), arr(...0x1)] [varlen] 的写法将编译失败。变异与生成过程中,syzkaller 随机选择条件满足的联合体字段。

表达式语法

当前支持的运算符只有 ==、!=、&、||(设计上预留了扩展更多运算符的空间)。表达式按 int64 求值,结果非 0 视为条件满足。引用字段值使用 value[path:to:field],路径语法与 len[] 参数一致:

sub_struct {
  f0 int
  # 引用父结构体字段
  f1 int (if[value[struct:f2]]) # 等价于 if[value[struct:f2] != 0]
}

struct {
  f2 int
  f3 sub_struct
  f4 int (if[value[f2] == 0x2]) # 引用兄弟字段
  f5 int (if[value[f3:f0] == 0x1]) # 引用嵌套字段
  f6 int (if[value[f3:f0] == 0x1 || value[f3:f0] == 0x2])
} [packed]

call(a ptr[in, struct])

约束:被引用字段必须是整数类型,且到它的路径上不能有条件字段(否则不编译);表达式还可引用常量,如 value[f0] & SOME_CONST == OTHER_CONST。

十三、Meta 指令与 Misc 指令

描述文件可包含 meta 指令提供整个文件的元信息:

meta noextract

告诉 make extract 不要为这个文件提取常量(但 syz-extract 仍可手动对该文件运行)。

meta arches["arch1", "arch2"]

将该文件限制到给定架构集合,其他架构上 make extract 与 make generate 均不使用它。

描述文件还包含:

  • include 指令:引用 Linux 内核头文件;
  • incdir 指令:引用自定义 Linux 内核头文件目录;
  • define 指令:定义符号常量值。

例如 sys/linux/dev_snd_midi.txt 开头就包含 4 个 include。

十四、伪系统调用

syzkaller executor 定义了一些伪系统调用,可像普通 syscall 一样用于描述文件。它们展开为字面 C 代码,可执行用户自定义操作,示例见 executor/common_linux.h。

十五、从描述到可执行程序:编译流程与实战

两步编译管线

把文本描述编译成机器可用形式分两步(见 docs/syscall_descriptions.md 的 “Description compilation internals” 一节):

  1. 常量提取:用 syz-extract 生成一个包含 include 引用头文件、按 define 定义宏的小型 C 程序,打印符号常量值,结果按架构存入 *.const 文件(如 sys/linux/dev_ptmx.txt 对应 dev_ptmx.txt.const)。make extract TARGETOS=linux SOURCEDIR=$KSRC 完成该步骤,$KSRC 指向最新内核 checkout;注意它会覆盖 $KSRC 下的 .config 并执行 mrproper。
  2. 翻译为 Go 代码:用 syz-sysgen 将描述与 const 文件翻译为 prog/types.go 中 Syscall 与 Type 的实例(编译器代码在 pkg/ast 与 pkg/compiler),同时为 C++ 端生成 executor/syscalls.h 元数据。Linux/AMD64 的编译产物示例见 sys/linux/gen/amd64.go。make generate 是纯文本处理,不需要内核源码或原生编译器,但会更新 executor/defs.h 中的 SYZ_REVISION(rebase 时需要留意)。

添加新系统调用接口

按官方流程(docs/syscall_descriptions.md):

  1. 研究目标接口:检索内核源码、Documentation/、tools/testing/、相关提交与使用该接口的库/应用;
  2. 参考语法文档与现有描述编写描述:sys/linux/<subsystem>.txt 存放特定子系统调用(如 bpf.txt、socket.txt),sys.txt 存放通用调用;新子系统可新建文件,跨文件时以子系统名作文件前缀;
  3. 运行三步构建:
make extract TARGETOS=linux SOURCEDIR=$KSRC
make generate
make
  1. 通过覆盖率信息页确认新接口确实被 fuzzer 触达。

说明:make extract 需要为所有架构提取常量,要求安装交叉编译器;缺失时运行 sudo make install_prerequisites(即使部分包安装失败也会返回成功,必要时先 sudo apt-get update && sudo apt-get upgrade)。只想本地 fuzz 新子系统时,可用 enable_syscalls 配置定向启用,支持通配符:"ioctl" 启用所有满足条件的 ioctl、"ioctl$UDMABUF_CREATE" 只启用该调用、"write$UHID_*" 启用所有匹配该标识符的 write 调用。对于非主线子系统,可手动运行单文件/单架构的 syz-extract(参数 -os linux -arch $ARCH -sourcedir $KSRC [-builddir $LINUXBLD],$ARCH 取 amd64/386/arm64/arm/ppc64le/mips64le)。

描述测试

描述本身可能有 bug。sys/OS/test/* 中存放直接测试描述正确性的程序(对 syscall 返回值做了断言),AUTO 关键字可用于常量与指针(指针会得到合理的顺序内存分配)。测试可用 syz-manager -mode run-tests 在多个 VM 中运行,开发期更推荐手动起 VM 后执行:

syz-execprog -debug -threaded=0 mytest

-debug 会显示所有 syscall 的执行结果,也便于调试伪系统调用代码。测试语法可用 go test -run=TestParsing ./pkg/runtest 检查。

十六、编写高质量描述的实用建议

官方 tips 与 FAQ 给出以下关键原则:

  1. 命名沿用内核:尽量使用内核既有名称(枚举、结构体、字段、flags),可保持一致性并支持用 syz-check 做静态检查;syscall/结构体变体在 $ 后追加变体名,如 fcntl$F_GET_RW_HINT、ioctl$FIOCLEX、setsockopt$SO_TIMESTAMP;
  2. 资源驱动排序:资源及其方向(in/out/inout)隐式约束 syscall 顺序——消费资源的调用一般排在产生资源的调用之后;参数恒为 in,返回值恒为 out,指针间接方向由 ptr 属性显式给出,复杂生产者/消费者场景用字段方向属性表达;
  3. 只用官方预期值:不要在描述中堆砌 -1、INT_MAX 之类的意外值——这类跨领域特殊情况应由通用 fuzzer 逻辑处理(如比较操作数拦截、魔数列表),逐字段手写既不可维护也不利于 fuzzer 生成正确的复杂调用序列;若某些 flags 值仅是文档遗漏,则应补进描述;
  4. flags 只列有意义的值:flags 覆盖枚举、位标志及两者组合,fuzzer 自行区分并生成相应取值,无需添加“帮助”fuzzer 的特殊值;
  5. 声明顺序:syzlang 不要求先声明后使用(类似 Go),建议按重要性排列——系统调用在前、flags 声明在后,与 C 的习惯相反。

结语

syzlang 用一套紧凑的声明式语法把内核接口的形态、约束与依赖关系精确刻画出来,是 syzkaller 能够自动生成、变异与最小化程序的基础。本文覆盖了官方语法文档的全部类型、属性与规则,并结合 pkg/compiler 源码与 sys/linux 真实描述文件给出了可验证的实现细节。想深入掌握,可以通读 docs/syscall_descriptions.md 及 sys/linux/test 下的测试程序,以真实的 io_uring 测试为范本练习编写自己的描述。

登录后查看全文
syzkaller