syzkaller syzlang 系统调用描述语言完全指南:从语法到实战
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” 一节):
- 常量提取:用 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。 - 翻译为 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):
- 研究目标接口:检索内核源码、
Documentation/、tools/testing/、相关提交与使用该接口的库/应用; - 参考语法文档与现有描述编写描述:
sys/linux/<subsystem>.txt存放特定子系统调用(如 bpf.txt、socket.txt),sys.txt 存放通用调用;新子系统可新建文件,跨文件时以子系统名作文件前缀; - 运行三步构建:
make extract TARGETOS=linux SOURCEDIR=$KSRC
make generate
make
- 通过覆盖率信息页确认新接口确实被 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 给出以下关键原则:
- 命名沿用内核:尽量使用内核既有名称(枚举、结构体、字段、flags),可保持一致性并支持用 syz-check 做静态检查;syscall/结构体变体在
$后追加变体名,如fcntl$F_GET_RW_HINT、ioctl$FIOCLEX、setsockopt$SO_TIMESTAMP; - 资源驱动排序:资源及其方向(
in/out/inout)隐式约束 syscall 顺序——消费资源的调用一般排在产生资源的调用之后;参数恒为in,返回值恒为out,指针间接方向由ptr属性显式给出,复杂生产者/消费者场景用字段方向属性表达; - 只用官方预期值:不要在描述中堆砌
-1、INT_MAX之类的意外值——这类跨领域特殊情况应由通用 fuzzer 逻辑处理(如比较操作数拦截、魔数列表),逐字段手写既不可维护也不利于 fuzzer 生成正确的复杂调用序列;若某些 flags 值仅是文档遗漏,则应补进描述; - flags 只列有意义的值:
flags覆盖枚举、位标志及两者组合,fuzzer 自行区分并生成相应取值,无需添加“帮助”fuzzer 的特殊值; - 声明顺序:
syzlang不要求先声明后使用(类似 Go),建议按重要性排列——系统调用在前、flags 声明在后,与 C 的习惯相反。
结语
syzlang 用一套紧凑的声明式语法把内核接口的形态、约束与依赖关系精确刻画出来,是 syzkaller 能够自动生成、变异与最小化程序的基础。本文覆盖了官方语法文档的全部类型、属性与规则,并结合 pkg/compiler 源码与 sys/linux 真实描述文件给出了可验证的实现细节。想深入掌握,可以通读 docs/syscall_descriptions.md 及 sys/linux/test 下的测试程序,以真实的 io_uring 测试为范本练习编写自己的描述。