github.com/google/syzkaller@v0.0.0-20251211124644-a066d2bc4b02/docs/translations/zh_CN/executing_syzkaller_programs.md (about)

     1  > [!WARNING]
     2  >
     3  > **请注意，这是社区驱动的官方 syzkaller 文档翻译。当前文档的最新版本（英文版）可在 [docs/reproducing_crashes.md](/docs/reproducing_crashes.md) 找到。**
     4  
     5  # 运行 syzkaller 程序
     6  
     7  本文描述了如何执行现有的 syzkaller 程序用以复现 bug。通过这种方式，你可以重放一个单独的程序或一个包含多个程序的完整执行日志。
     8  
     9  1. 安装 Go 工具链（要求 Go 的版本不低于1.16）：
    10  从[官网](https://golang.org/dl/)下载最新的 Go 发行版，并将其解压到 `$HOME/goroot`。
    11  
    12  ``` bash
    13  export GOROOT=$HOME/goroot
    14  export GOPATH=$HOME/gopath
    15  ```
    16  
    17  2. 下载 syzkaller 源码:
    18  
    19  ``` bash
    20  git clone https://github.com/google/syzkaller
    21  ```
    22  
    23  请注意，你的 syzkaller 版本必须和生成待执行程序的 syzkaller 版本一致。
    24  
    25  3. 构建需要的 syzkaller 二进制文件:
    26  
    27  ``` bash
    28  cd syzkaller
    29  make
    30  ```
    31  
    32  4. 将构建好的二进制文件和程序复制到待测试机器上（根据待测试机器，替换命令中的 `linux_amd64`）
    33  
    34  ``` bash
    35  scp -P 10022 -i trixie.img.key bin/linux_amd64/syz-execprog bin/linux_amd64/syz-executor program root@localhost:
    36  ```
    37  
    38  5. 在待测试机器上运行程序
    39  
    40  ``` bash
    41  ./syz-execprog -repeat=0 -procs=8 program
    42  ```
    43  
    44  下面是几个实用的 `syz-execprog` 参数：
    45  
    46  ```
    47    -procs int
    48        执行程序的并发进程数（默认值为 1）
    49    -repeat int
    50        重复执行的次数（0 代表无限执行）（默认值为 1）
    51    -sandbox string
    52        模糊测试的沙盒模式（none/setuid/namespace）（默认为 "setuid" 模式）
    53    -threaded
    54        是否使用线程模式（默认为 是）
    55  ```
    56  
    57  `-threaded=0` 参数将会使程序作为一个简单的单线程系统调用序列来执行；
    58  而 `-threaded=1` 强制每个系统调用使用单独的线程，这样就可以在阻塞的系统调用上继续执行。
    59  
    60  而较老版本的 syzkaller 还有如下参数：
    61  
    62  ```
    63    -collide
    64        是否使用冲突系统调用以引发数据竞争（默认为是）
    65  ```
    66  
    67  `-collide=1` 参数的作用是当很多系统调用并发执行时，强制执行第二轮系统调用。
    68  当你使用较老版本的复现程序时，可能需要用到这个参数。
    69  
    70  如果想要重放一个开头包含如下内容的复现程序：
    71  
    72  ```
    73  # {Threaded:true Repeat:true RepeatTimes:0 Procs:8 Slowdown:1 Sandbox:none Leak:false NetInjection:true NetDevices:true NetReset:true Cgroups:true BinfmtMisc:true CloseFDs:true KCSAN:false DevlinkPCI:false USB:true VhciInjection:true Wifi:true IEEE802154:true Sysctl:true UseTmpDir:true HandleSegv:true Repro:false Trace:false LegacyOptions:{Collide:false Fault:false FaultCall:0 FaultNth:0}}
    74  ```
    75  
    76  你需要基于文件头中的值调整对应的参数。其中，`Threaded`/`Procs`/`Sandbox` 与 `-threaded`/`-procs`/`-sandbox` 参数对应。如果 `Repeat` 的值为 `true`，则在 `syz-execprog` 的参数中添加 `-repeat=0`。