From caf8b78f3e9026c41e4d608caa413ffc818fceb1 Mon Sep 17 00:00:00 2001
From: ss <shishi.dong@deltaww.com>
Date: Thu, 10 Oct 2024 13:10:23 +0800
Subject: [PATCH] Site updated: 2024-10-10 13:10:15

---
 .../index.html"                               |   4 +-
 .../index.html"                               |   4 +-
 .../index.html"                               |   4 +-
 .../index.html"                               |   4 +-
 .../index.html"                               |   6 +-
 .../index.html"                               |   6 +-
 .../index.html"                               |  10 +--
 .../index.html"                               |   4 +-
 .../overview.png"                             | Bin 39070 -> 0 bytes
 .../task.png"                                 | Bin 77713 -> 0 bytes
 .../index.html"                               |  20 ++---
 .../index.html"                               |   4 +-
 .../index.html"                               |   4 +-
 all-archives/index.html                       |   2 +-
 all-categories/index.html                     |   2 +-
 all-tags/index.html                           |   6 +-
 archives/2024/10/index.html                   |   8 +-
 archives/2024/index.html                      |   8 +-
 archives/index.html                           |   8 +-
 baidusitemap.xml                              |   2 +-
 .../\345\256\211\345\205\250/index.html"      |   8 +-
 .../index.html"                               |   8 +-
 index.html                                    |   8 +-
 sitemap.xml                                   |  56 +++++++-------
 tags/AFL/index.html                           |  69 ++++++++++++++----
 tags/Fuzz/index.html                          |   8 +-
 tags/python/index.html                        |  61 +++-------------
 "tags/\345\256\211\345\205\250/index.html"    |   8 +-
 "tags/\345\267\245\345\205\267/index.html"    |   8 +-
 29 files changed, 170 insertions(+), 170 deletions(-)
 delete mode 100644 "2024/ClusterFuzz\346\236\266\346\236\204\345\210\206\346\236\220/overview.png"
 delete mode 100644 "2024/ClusterFuzz\346\236\266\346\236\204\345\210\206\346\236\220/task.png"
 rename "2024/ClusterFuzz\346\236\266\346\236\204\345\210\206\346\236\220/index.html" => "2024/ClusterFuzz\346\272\220\347\240\201\345\210\206\346\236\220\357\274\210\344\270\200\357\274\211/index.html" (96%)

diff --git "a/2023/AFL\345\216\237\347\220\206\344\270\216\345\256\236\350\267\265/index.html" "b/2023/AFL\345\216\237\347\220\206\344\270\216\345\256\236\350\267\265/index.html"
index 9aa3ef4..82c42b0 100644
--- "a/2023/AFL\345\216\237\347\220\206\344\270\216\345\256\236\350\267\265/index.html"
+++ "b/2023/AFL\345\216\237\347\220\206\344\270\216\345\256\236\350\267\265/index.html"
@@ -14,7 +14,7 @@
     
     
     
-    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n\n在软件开发的世界里，质量和安全性是评估产品成败的重要指标。模糊测试作为一种高效的自动化测试方法，专门用来发现程序中的错误和安全漏洞。本文旨在详细介绍 AFL（American Fuzzy Lop）的基本原理和使用方法。\n一、AFL 的原理介绍  模糊测试是一种通过向软件输入异常或随机数据的自动化技术，目的是发现程序在处理意外或边缘情况输入时的错误。AFL 是这一测试策略中的杰出代表，它通过不断学习程序反应来改进测试用例，提高测试的覆盖率和发现漏洞的概率。\nAFL 利用遗传算法，不断生成测试用例，并通过动态插桩技术监控程序的行为，特别是程序的代码覆盖情况。当新的输入能触发新的代码路径时，这个输入会被保存以供进一步的测试。该过程可以形成一个反馈循环，不断优化测试用例以探索更多程序状态。\n下面是 AFL 工作流程图，展示了从准备测试用例到监控程序行为的步骤：\ngraph TD\n    A[Compile with afl-gcc] --> B[Initialize seed corpus] --> C[Fuzzing loop] --> D[Select seed from corpus queue]\n    D[Select seed from corpus queue] --> E[Mutate selected seed] --> F[Execute with mutated testcase]\n    F[Execute with mutated testcase] --> G[Monitor for crashes and coverage update] --> H{Check for new coverage}\n    H{Check for new coverage} -- YES --> I[Save mutated testcase to queue] --> D\n    H{Check for new coverage} -- NO --> D\n\n流程图详细展示了 AFL 在模糊测试中的核心步骤：\n\n编译（Compile with afl-gcc） - 使用 AFL 提供的编译器 afl-gcc，对目标程序进行编译，实现程序的动态插桩。\n\n初始化种子库（Initialize seed corpus） - 创建初始测试用例集（种子库），这些测试用例将作为模糊测试的起点。\n\n模糊测试循环（Fuzzing loop） - 一个不断循环的过程，根据测试结果更新种子库，并反复执行下列子步骤：a. 选择种子（Select seed from corpus queue） - 从种子库中选择一个种子文件作为当前测试的输入。b. 突变种子（Mutate selected seed） - 对选中的种子文件应用突变算法，生成新的测试用例。c. 执行测试（Execute with mutated test case） - 将变异后的测试用例作为输入执行已插桩的目标程序。d. 监控结果（Monitor for crashes and coverage update） - 监控程序的执行情况，记录崩溃和代码覆盖率的变化。\n\n覆盖率检查（Check for new coverage） - 判断是否出现新的代码覆盖，如果有，则将其保存为新测试用例。\n\n保存新测试用例（Save new testcase to queue） - 将触发新代码覆盖的测试用例保存到队列中，用于后续的测试。\n\n\nAFL 采用了 fork 的运行模式，这使得当待测程序出现崩溃时，fuzz 进程不会终止，这一点相较于 LibFuzzer 更具优势。然而，频繁的 fork 操作也导致了 AFL 的效率不如 LibFuzzer。\n二、AFL 安装和运行1. 支持的系统和架构AFL 设计之初主要针对 UNIX-like 系统，其在 Linux 系统上有最好的支持。然而，在社区的努力下，也有 Windows 版本的 AFL，如 winafl，其可以在 Windows 进行模糊测试。\nAFL 还支持多种 CPU 架构，其中对 x86 和 x64 架构的支持最好。如果要支持 ARM 架构，则需要使用 AFL 的 QEMU 模式。\n2. 安装步骤AFL 可以通过源码进行安装：\n123apt install git make gccgit clone https://github.com/google/AFL.git cd AFL &amp;&amp; make\n\n3. 运行参数  在安装并编译完 AFL 之后，可以使用 afl-fuzz 命令来启动模糊测试。一个基本的 AFL fuzz 命令如下：\n1afl-fuzz -i input_dir -o output_dir -- /path/to/program [options] @@\n\n这里：\n\nafl-fuzz 是启动 AFL 模糊测试的程序。\n-i input_dir 指定包含初始化测试用例的目录。\n-o output_dir 指定存放的 fuzzing 结果的目录。\n\n-- 之后的部分是运行被测试程序的命令行，其中 /path/to/program 替换为需要进行模糊测试的程序的路径，[options] 是运行该程序的任何选项或参数。\n如果测试程序需要从文件中读取输入，可以在实际输入文件路径的位置使用 @@ 占位符。AFL 将替换 @@ 来插入它正在测试的输入文件。如果省略这个占位符，AFL 将会把模糊测试用例通过 stdin 传递给测试程序。\n三、AFL 的使用示例  本节使用一个简单的示例，演示 AFL 的操作步骤。\n这是待测源码，其功能是接受一行命令行输入，进行四则运算。其中使用了不安全的 gets 函数，可能导致缓冲区溢出：\n1234567891011121314151617181920212223242526272829303132#include &lt;stdio.h&gt;#include &lt;string.h&gt;int calculate(int a, int b, char op) &#123;    switch (op) &#123;        case &#x27;+&#x27;: return a + b;        case &#x27;-&#x27;: return a - b;        case &#x27;x&#x27;: return a * b;        case &#x27;/&#x27;: return b ? a / b : 0;        default: return 0;    &#125;&#125;int main() &#123;    char input[100];    // unsafe method that may cause buffer overflow    gets(input);    int a, b, result;    char op;    if (sscanf(input, &quot;%d %c %d&quot;, &amp;a, &amp;op, &amp;b) != 3)        return 1;    result = calculate(a, b, op);    printf(&quot;Result: %d\\n&quot;, result);    return 0;&#125;\n\n1. 编译源码  使用 AFL 的编译器 afl-gcc 或afl-clang对源文件 hello.c 进行编译，添加所需要的代码覆盖插桩。afl-gcc或 afl-clang 实际上是对常规的 gcc 或clang编译器进行了封装，通过在编译时进行插桩，来统计 fuzz 过程中的代码覆盖率：\n1afl-gcc -o hello hello.c\n\n2. 准备种子语料库  不论程序是从 file 还是从 stdin 获取数据，AFL 都需要一个初始语料库来启动模糊测试过程。输入（无论是来自 file 或 stdin）是 AFL 用来开始探索程序行为的基础。初始语料库（seed corpus）是一组文件，其中包含了各种有效的输入示例，这些输入会被 AFL 用作模糊测试的起始点。\n从 stdin 读取输入时，AFL 会将语料库中的每个文件内容作为输入在每次测试运行时送到程序的标准输入流中。使用 AFL 时，必须要有初始语料库。注意这一点 AFL 与 Libfuzzer 不同，Libfuzzer 只接受 stdin，不接受 file，初始语料库为可选项。\n12mkdir inecho &#x27;abc&#x27; &gt; in/seed\n\n3. 执行测试  在运行 AFL 之前，需要执行下面的系统设置命令，将字符串”core”写入到文件 /proc/sys/kernel/core_pattern 中。\n在 Linux 系统中，/proc/sys/kernel/core_pattern 文件用于指定当程序崩溃时，内核转储文件（core dump）的文件名模式。通过修改这个文件，可以控制内核生成 core 文件的行为。\n通过执行这个命令，生成的核心转储文件将以”core”命名，这使得 AFL 更容易检测和处理目标程序的崩溃情况，从而更好地进行模糊测试。\n1echo core | tee /proc/sys/kernel/core_pattern\n\n在 hello 中使用 gets 函数从 stdin 中读取数据，因此在运行 AFL 时，不需要添加 @@。是否使用@@ 取决于待测程序接受的输入来自 file 还是 stdin。\n1afl-fuzz -i in -o out -- ./hello\n\n4. 结果解读AFL 开始运行后，将会看到如下的界面显示：\n\n\n从这个界面上可以看到 AFL 找到了多少 crash，但还不能直观地显示覆盖率。pythia是一款 AFL 的扩展工具，可以查看代码覆盖率的情况。\nAFL 在运行过程中，会不断地产生输出。输出目录结构如下：\n123456789101112131415161718192021222324out|-- crashes|   |-- README.txt|   |-- id:000000,sig:06,src:000000,op:havoc,rep:64|   |-- id:000001,sig:06,src:000002+000003,op:splice,rep:128|   |-- id:000002,sig:06,src:000003,op:havoc,rep:32|   |-- id:000003,sig:06,src:000002+000003,op:splice,rep:16|   |-- id:000004,sig:06,src:000004,op:havoc,rep:32|   |-- id:000005,sig:11,src:000003+000002,op:splice,rep:64|   `-- id:000006,sig:06,src:000004+000005,op:splice,rep:2|-- fuzz_bitmap|-- fuzzer_stats|-- hangs|-- plot_data`-- queue    |-- id:000000,orig:seed    |-- id:000001,src:000000,op:havoc,rep:16,+cov    |-- id:000002,src:000000+000001,op:splice,rep:4,+cov    |-- id:000003,src:000001,op:arith8,pos:1,val:-5,+cov    |-- id:000004,src:000001,op:arith8,pos:1,val:-9,+cov    `-- id:000005,src:000002+000003,op:splice,rep:4,+cov3 directories, 17 files\n\n\nqueue&#x2F; - 存放 AFL 生成的触发新代码路径的测试样本\n\ncrashes&#x2F; - 存放能触发待测程序崩溃的测试样本\n\nhangs&#x2F; - 存发导致待测程序超时的测试样本\n\nfuzzer_stats - 文本文件，包含了 fuzzer 的实时统计信息，如执行速度、路径覆盖等度量指标。这个文件不断更新以反映当前的 fuzzing 状态。\n\nplot_data - 文本文件，包含了 AFL 执行过程中的统计数据。使用 AFL 的 afl-plot 工具处理 plot_data 文件，可以生成 fuzz 过程的可视化图像。\n\nfuzz_bitmap - 这是用来记录路径覆盖率的位图（coverage bitmap），非人类可读。AFL 使用这个位图来跟踪程序在处理不同输入时执行的不同分支，用来帮助 AFL 识别新的、唯一的代码路径，以便后续生成更具有探索性的测试样本。\n\n\n四、AFL 的 QEMU 模式  前面的例子中，AFL 在对待测程序的源码进行编译时插桩。实际中，我们不一定能拿到待测源码，我们要测的可能是一个已经编译好的二进制文件。这种情况下 Libfuzzer 就无能为力了，但 AFL 还能用，这依赖于 AFL 的 QEMU 模式。\nAFL 的 QEMU 模式，也称为 AFL-QEMU，允许你在二进制模糊测试中使用 AFL，即使源代码不可用。这在对闭源应用进行模糊测试时非常有用。这种模式使用 QEMU 的用户模式仿真，来运行并分析非原生的二进制文件。以下是安装 AFL 的 QEMU 模式和使用步骤的指南：\n1. 编译 QEMU 支持  在 AFL 主目录下有一个专门的 QEMU 模式目录。进入该目录并编译 QEMU 模式，过程中可能缺少依赖项，根据提示进行安装即可：\n12cd qemu_mode./build_qemu_support.sh\n\n2. AFL-QEMU 使用步骤  用法很简单，在 AFL 运行命令中添加 -Q 参数即可：\n1afl-fuzz -i input -o output -Q -- /path/to/binary @@\n\n\n五、AFL 的升级版——AFL++AFL++ 可以看作是原始 AFL 的”增强版”，对 AFL 的调度策略和变异算法进行了很多改进，同时还引入了很多新特性，如 CMPLOG 和持久化这样的特性。\n1. CMPLOGCMPLOG 是 AFL++ 引入的一个新功能，类似于 Libfuzzer 中的 trace-cmp，它可以极大地提高代码覆盖率。CMPLOG 的主要作用是对程序中的所有比较操作进行记录，包括等于、不等于、小于等逻辑比较。当 fuzzer 执行时，CMPLOG 能够捕获比较操作的参数，并将对应的值添加到 fuzzer 的输入测试用例中。这个过程实际上帮助 fuzzer 更好地理解代码中期待的输入，特别是那些用于逻辑分支的字面值和魔法数字。这种理解能够导向更深入的路径覆盖，进而揭露隐藏更深的潜在缺陷。\n2. 持久化模式AFL 的持久化（persistent）模式允许目标程序在单个进程周期内重复执行多次模糊测试用例。这对性能产生了显著的提升，因为它减少了程序启动和终止的开销，特别是当测试的目标程序需要很大的初始化成本时。在 AFL++ 中，持久化模式的执行更为高效，它允许模糊器在目标程序中一次性执行多个测试用例，而非每次执行一个用例都重启目标程序。有了持久化模式，AFL++ 能够在相同的时间内执行更多的测试迭代，从而提高漏洞检测的速度。\n六、小结AFL 是一款强大的模糊测试工具，实践中 AFL++ 的应用非常广泛。相比 Libfuzzer，AFL++ 不局限于源码，并且支持多种 cpu 架构，还有丰富的插件生态可以使用。\n但模糊测试本身存在覆盖率瓶颈的问题，难以探索复杂的程序路径，这时候可以结合其他的技术，如符号执行来突破。","dateCreated":"2023-10-15T11:23:55+08:00","dateModified":"2024-05-30T16:11:03+08:00","datePublished":"2023-10-15T11:23:55+08:00","description":"模糊测试工具 AFL（American Fuzzy Lop）的原理介绍与实践应用","headline":"AFL 原理与实践","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2023/AFL%E5%8E%9F%E7%90%86%E4%B8%8E%E5%AE%9E%E8%B7%B5/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2023/AFL%E5%8E%9F%E7%90%86%E4%B8%8E%E5%AE%9E%E8%B7%B5/","keywords":"Fuzz, 安全, 工具, AFL"}</script>
+    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n\n在软件开发的世界里，质量和安全性是评估产品成败的重要指标。模糊测试作为一种高效的自动化测试方法，专门用来发现程序中的错误和安全漏洞。本文旨在详细介绍 AFL（American Fuzzy Lop）的基本原理和使用方法。\n一、AFL 的原理介绍  模糊测试是一种通过向软件输入异常或随机数据的自动化技术，目的是发现程序在处理意外或边缘情况输入时的错误。AFL 是这一测试策略中的杰出代表，它通过不断学习程序反应来改进测试用例，提高测试的覆盖率和发现漏洞的概率。\nAFL 利用遗传算法，不断生成测试用例，并通过动态插桩技术监控程序的行为，特别是程序的代码覆盖情况。当新的输入能触发新的代码路径时，这个输入会被保存以供进一步的测试。该过程可以形成一个反馈循环，不断优化测试用例以探索更多程序状态。\n下面是 AFL 工作流程图，展示了从准备测试用例到监控程序行为的步骤：\ngraph TD\n    A[Compile with afl-gcc] --> B[Initialize seed corpus] --> C[Fuzzing loop] --> D[Select seed from corpus queue]\n    D[Select seed from corpus queue] --> E[Mutate selected seed] --> F[Execute with mutated testcase]\n    F[Execute with mutated testcase] --> G[Monitor for crashes and coverage update] --> H{Check for new coverage}\n    H{Check for new coverage} -- YES --> I[Save mutated testcase to queue] --> D\n    H{Check for new coverage} -- NO --> D\n\n流程图详细展示了 AFL 在模糊测试中的核心步骤：\n\n编译（Compile with afl-gcc） - 使用 AFL 提供的编译器 afl-gcc，对目标程序进行编译，实现程序的动态插桩。\n\n初始化种子库（Initialize seed corpus） - 创建初始测试用例集（种子库），这些测试用例将作为模糊测试的起点。\n\n模糊测试循环（Fuzzing loop） - 一个不断循环的过程，根据测试结果更新种子库，并反复执行下列子步骤：a. 选择种子（Select seed from corpus queue） - 从种子库中选择一个种子文件作为当前测试的输入。b. 突变种子（Mutate selected seed） - 对选中的种子文件应用突变算法，生成新的测试用例。c. 执行测试（Execute with mutated test case） - 将变异后的测试用例作为输入执行已插桩的目标程序。d. 监控结果（Monitor for crashes and coverage update） - 监控程序的执行情况，记录崩溃和代码覆盖率的变化。\n\n覆盖率检查（Check for new coverage） - 判断是否出现新的代码覆盖，如果有，则将其保存为新测试用例。\n\n保存新测试用例（Save new testcase to queue） - 将触发新代码覆盖的测试用例保存到队列中，用于后续的测试。\n\n\nAFL 采用了 fork 的运行模式，这使得当待测程序出现崩溃时，fuzz 进程不会终止，这一点相较于 LibFuzzer 更具优势。然而，频繁的 fork 操作也导致了 AFL 的效率不如 LibFuzzer。\n二、AFL 安装和运行1. 支持的系统和架构AFL 设计之初主要针对 UNIX-like 系统，其在 Linux 系统上有最好的支持。然而，在社区的努力下，也有 Windows 版本的 AFL，如 winafl，其可以在 Windows 进行模糊测试。\nAFL 还支持多种 CPU 架构，其中对 x86 和 x64 架构的支持最好。如果要支持 ARM 架构，则需要使用 AFL 的 QEMU 模式。\n2. 安装步骤AFL 可以通过源码进行安装：\n123apt install git make gccgit clone https://github.com/google/AFL.git cd AFL &amp;&amp; make\n\n3. 运行参数  在安装并编译完 AFL 之后，可以使用 afl-fuzz 命令来启动模糊测试。一个基本的 AFL fuzz 命令如下：\n1afl-fuzz -i input_dir -o output_dir -- /path/to/program [options] @@\n\n这里：\n\nafl-fuzz 是启动 AFL 模糊测试的程序。\n-i input_dir 指定包含初始化测试用例的目录。\n-o output_dir 指定存放的 fuzzing 结果的目录。\n\n-- 之后的部分是运行被测试程序的命令行，其中 /path/to/program 替换为需要进行模糊测试的程序的路径，[options] 是运行该程序的任何选项或参数。\n如果测试程序需要从文件中读取输入，可以在实际输入文件路径的位置使用 @@ 占位符。AFL 将替换 @@ 来插入它正在测试的输入文件。如果省略这个占位符，AFL 将会把模糊测试用例通过 stdin 传递给测试程序。\n三、AFL 的使用示例  本节使用一个简单的示例，演示 AFL 的操作步骤。\n这是待测源码，其功能是接受一行命令行输入，进行四则运算。其中使用了不安全的 gets 函数，可能导致缓冲区溢出：\n1234567891011121314151617181920212223242526272829303132#include &lt;stdio.h&gt;#include &lt;string.h&gt;int calculate(int a, int b, char op) &#123;    switch (op) &#123;        case &#x27;+&#x27;: return a + b;        case &#x27;-&#x27;: return a - b;        case &#x27;x&#x27;: return a * b;        case &#x27;/&#x27;: return b ? a / b : 0;        default: return 0;    &#125;&#125;int main() &#123;    char input[100];    // unsafe method that may cause buffer overflow    gets(input);    int a, b, result;    char op;    if (sscanf(input, &quot;%d %c %d&quot;, &amp;a, &amp;op, &amp;b) != 3)        return 1;    result = calculate(a, b, op);    printf(&quot;Result: %d\\n&quot;, result);    return 0;&#125;\n\n1. 编译源码  使用 AFL 的编译器 afl-gcc 或afl-clang对源文件 hello.c 进行编译，添加所需要的代码覆盖插桩。afl-gcc或 afl-clang 实际上是对常规的 gcc 或clang编译器进行了封装，通过在编译时进行插桩，来统计 fuzz 过程中的代码覆盖率：\n1afl-gcc -o hello hello.c\n\n2. 准备种子语料库  不论程序是从 file 还是从 stdin 获取数据，AFL 都需要一个初始语料库来启动模糊测试过程。输入（无论是来自 file 或 stdin）是 AFL 用来开始探索程序行为的基础。初始语料库（seed corpus）是一组文件，其中包含了各种有效的输入示例，这些输入会被 AFL 用作模糊测试的起始点。\n从 stdin 读取输入时，AFL 会将语料库中的每个文件内容作为输入在每次测试运行时送到程序的标准输入流中。使用 AFL 时，必须要有初始语料库。注意这一点 AFL 与 Libfuzzer 不同，Libfuzzer 只接受 stdin，不接受 file，初始语料库为可选项。\n12mkdir inecho &#x27;abc&#x27; &gt; in/seed\n\n3. 执行测试  在运行 AFL 之前，需要执行下面的系统设置命令，将字符串”core”写入到文件 /proc/sys/kernel/core_pattern 中。\n在 Linux 系统中，/proc/sys/kernel/core_pattern 文件用于指定当程序崩溃时，内核转储文件（core dump）的文件名模式。通过修改这个文件，可以控制内核生成 core 文件的行为。\n通过执行这个命令，生成的核心转储文件将以”core”命名，这使得 AFL 更容易检测和处理目标程序的崩溃情况，从而更好地进行模糊测试。\n1echo core | tee /proc/sys/kernel/core_pattern\n\n在 hello 中使用 gets 函数从 stdin 中读取数据，因此在运行 AFL 时，不需要添加 @@。是否使用@@ 取决于待测程序接受的输入来自 file 还是 stdin。\n1afl-fuzz -i in -o out -- ./hello\n\n4. 结果解读AFL 开始运行后，将会看到如下的界面显示：\n\n\n从这个界面上可以看到 AFL 找到了多少 crash，但还不能直观地显示覆盖率。pythia是一款 AFL 的扩展工具，可以查看代码覆盖率的情况。\nAFL 在运行过程中，会不断地产生输出。输出目录结构如下：\n123456789101112131415161718192021222324out|-- crashes|   |-- README.txt|   |-- id:000000,sig:06,src:000000,op:havoc,rep:64|   |-- id:000001,sig:06,src:000002+000003,op:splice,rep:128|   |-- id:000002,sig:06,src:000003,op:havoc,rep:32|   |-- id:000003,sig:06,src:000002+000003,op:splice,rep:16|   |-- id:000004,sig:06,src:000004,op:havoc,rep:32|   |-- id:000005,sig:11,src:000003+000002,op:splice,rep:64|   `-- id:000006,sig:06,src:000004+000005,op:splice,rep:2|-- fuzz_bitmap|-- fuzzer_stats|-- hangs|-- plot_data`-- queue    |-- id:000000,orig:seed    |-- id:000001,src:000000,op:havoc,rep:16,+cov    |-- id:000002,src:000000+000001,op:splice,rep:4,+cov    |-- id:000003,src:000001,op:arith8,pos:1,val:-5,+cov    |-- id:000004,src:000001,op:arith8,pos:1,val:-9,+cov    `-- id:000005,src:000002+000003,op:splice,rep:4,+cov3 directories, 17 files\n\n\nqueue&#x2F; - 存放 AFL 生成的触发新代码路径的测试样本\n\ncrashes&#x2F; - 存放能触发待测程序崩溃的测试样本\n\nhangs&#x2F; - 存发导致待测程序超时的测试样本\n\nfuzzer_stats - 文本文件，包含了 fuzzer 的实时统计信息，如执行速度、路径覆盖等度量指标。这个文件不断更新以反映当前的 fuzzing 状态。\n\nplot_data - 文本文件，包含了 AFL 执行过程中的统计数据。使用 AFL 的 afl-plot 工具处理 plot_data 文件，可以生成 fuzz 过程的可视化图像。\n\nfuzz_bitmap - 这是用来记录路径覆盖率的位图（coverage bitmap），非人类可读。AFL 使用这个位图来跟踪程序在处理不同输入时执行的不同分支，用来帮助 AFL 识别新的、唯一的代码路径，以便后续生成更具有探索性的测试样本。\n\n\n四、AFL 的 QEMU 模式  前面的例子中，AFL 在对待测程序的源码进行编译时插桩。实际中，我们不一定能拿到待测源码，我们要测的可能是一个已经编译好的二进制文件。这种情况下 Libfuzzer 就无能为力了，但 AFL 还能用，这依赖于 AFL 的 QEMU 模式。\nAFL 的 QEMU 模式，也称为 AFL-QEMU，允许你在二进制模糊测试中使用 AFL，即使源代码不可用。这在对闭源应用进行模糊测试时非常有用。这种模式使用 QEMU 的用户模式仿真，来运行并分析非原生的二进制文件。以下是安装 AFL 的 QEMU 模式和使用步骤的指南：\n1. 编译 QEMU 支持  在 AFL 主目录下有一个专门的 QEMU 模式目录。进入该目录并编译 QEMU 模式，过程中可能缺少依赖项，根据提示进行安装即可：\n12cd qemu_mode./build_qemu_support.sh\n\n2. AFL-QEMU 使用步骤  用法很简单，在 AFL 运行命令中添加 -Q 参数即可：\n1afl-fuzz -i input -o output -Q -- /path/to/binary @@\n\n\n五、AFL 的升级版——AFL++AFL++ 可以看作是原始 AFL 的”增强版”，对 AFL 的调度策略和变异算法进行了很多改进，同时还引入了很多新特性，如 CMPLOG 和持久化这样的特性。\n1. CMPLOGCMPLOG 是 AFL++ 引入的一个新功能，类似于 Libfuzzer 中的 trace-cmp，它可以极大地提高代码覆盖率。CMPLOG 的主要作用是对程序中的所有比较操作进行记录，包括等于、不等于、小于等逻辑比较。当 fuzzer 执行时，CMPLOG 能够捕获比较操作的参数，并将对应的值添加到 fuzzer 的输入测试用例中。这个过程实际上帮助 fuzzer 更好地理解代码中期待的输入，特别是那些用于逻辑分支的字面值和魔法数字。这种理解能够导向更深入的路径覆盖，进而揭露隐藏更深的潜在缺陷。\n2. 持久化模式AFL 的持久化（persistent）模式允许目标程序在单个进程周期内重复执行多次模糊测试用例。这对性能产生了显著的提升，因为它减少了程序启动和终止的开销，特别是当测试的目标程序需要很大的初始化成本时。在 AFL++ 中，持久化模式的执行更为高效，它允许模糊器在目标程序中一次性执行多个测试用例，而非每次执行一个用例都重启目标程序。有了持久化模式，AFL++ 能够在相同的时间内执行更多的测试迭代，从而提高漏洞检测的速度。\n六、小结AFL 是一款强大的模糊测试工具，实践中 AFL++ 的应用非常广泛。相比 Libfuzzer，AFL++ 不局限于源码，并且支持多种 cpu 架构，还有丰富的插件生态可以使用。\n但模糊测试本身存在覆盖率瓶颈的问题，难以探索复杂的程序路径，这时候可以结合其他的技术，如符号执行来突破。","dateCreated":"2023-10-15T11:23:55+08:00","dateModified":"2024-05-30T16:11:03+08:00","datePublished":"2023-10-15T11:23:55+08:00","description":"模糊测试工具 AFL（American Fuzzy Lop）的原理介绍与实践应用","headline":"AFL 原理与实践","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2023/AFL%E5%8E%9F%E7%90%86%E4%B8%8E%E5%AE%9E%E8%B7%B5/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2023/AFL%E5%8E%9F%E7%90%86%E4%B8%8E%E5%AE%9E%E8%B7%B5/","keywords":"安全, 工具, AFL, Fuzz"}</script>
     <meta name="description" content="模糊测试工具 AFL（American Fuzzy Lop）的原理介绍与实践应用">
 <meta property="og:type" content="blog">
 <meta property="og:title" content="AFL 原理与实践">
@@ -26,10 +26,10 @@
 <meta property="article:published_time" content="2023-10-15T03:23:55.000Z">
 <meta property="article:modified_time" content="2024-05-30T08:11:03.608Z">
 <meta property="article:author" content="一瓢清浅">
-<meta property="article:tag" content="Fuzz">
 <meta property="article:tag" content="安全">
 <meta property="article:tag" content="工具">
 <meta property="article:tag" content="AFL">
+<meta property="article:tag" content="Fuzz">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:image" content="https://www.stepbystep.asia/2023/AFL%E5%8E%9F%E7%90%86%E4%B8%8E%E5%AE%9E%E8%B7%B5/AFL%E8%BF%90%E8%A1%8C%E7%95%8C%E9%9D%A2.png">
     
diff --git "a/2023/LibAFL\347\256\200\344\273\213/index.html" "b/2023/LibAFL\347\256\200\344\273\213/index.html"
index 5f649f6..0f32093 100644
--- "a/2023/LibAFL\347\256\200\344\273\213/index.html"
+++ "b/2023/LibAFL\347\256\200\344\273\213/index.html"
@@ -14,7 +14,7 @@
     
     
     
-    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n1. 什么是 LibAFLLibAFL 是一款用 Rust 语言开发的开源模糊测试框架，它将模糊测试的组件划分成一组模块文件，用户可以基于这组模块，快速实现自定义的 fuzz 引擎。\n2. 为什么要设计 LibAFL 现有的 Fuzz 引擎很多是基于 AFL 进行改造的，不同的改造之间存在不兼容的情况，比如 Fairfuzz 是基于 AFL 改造的，但是 AFL++ 不支持 Fairfuzz。如果希望把多种 Fuzz 优化技术集合在一起，工程难度很大。\nAFL++ 是 AFL 的进化版，它在 AFL 的基础上集成了很多 Fuzz 优化技术，并支持以插件的方式进行功能扩展，例如可以自定义 mutator。但 AFL++ 还是受限于 AFL 本身的程序设计，与 mutator 无关的优化技术，与 AFL++ 的集成也比较困难。\n3. LibAFL 整体架构 （1）Fuzz 引擎的相关组件 \nInput 指 fuzz 过程中，传递给 target 的输入数据。Libfuzzer 和 AFL 默认的输入格式，都是字节数组。fuzz 的入口函数在以这个字节数组作为入参，然后对字节数组进行切片和类型变换，转换为 target 中待测函数所要求的参数形式，再对待测函数进行调用。\n\nCorpus 指 fuzz 过程中，用来存放有效 input 的语料库。AFL 必须要有初始语料库，Libfuzzer 可以不提供初始语料库。语料库可以存放在磁盘中通过 io 读写，也可以全部加载进内存中。前者效率低，后者内存消耗大。\n\nScheduler 指 fuzz 引擎从语料库中选择 input 的调度机制。语料库中包含大量的 input，fuzz 每轮执行需要挑选一个 input。调度机制决定了 input 的挑选方法，简单的实现包括先入先出、随机挑选等。对调度机制进行优化，也是改进 fuzz 的一个方向。\n\nStagefuzz 的每一轮执行实际上都包含多个步骤，每个步骤都可以理解为一个阶段。比如变异阶段是对 input 进行随机变异操作，分析阶段可以使用污点分析等技术搜集更多信息，语料库精简阶段是对语料库进行筛选操作。一连串的阶段性操作构成了一次完整的 fuzz 执行过程。\n\nObserver 观察器用来收集 fuzz 单词运行过程中的信息。在覆盖率引导的 fuzz 引擎中，观察器会看这次执行过程中，input 所经过的代码路径。AFL 中的 bitmap 就是一个观察器，AFL 将代码路径转化为 branch 或 edge 的集合，并记录在 bitmap 中。\n\nExecutor 执行器负责将 input 喂给 target 开启一次 fuzz 执行。不同的 fuzz 工具，可能有不同的执行方式。Libfuzzer 是一个单进程的执行模式，在一个进程中生成 input 运行 target，并不断循环这个过程；AFL 则通过 fork 模式，每次 input 都会 fork 出一个子进程，在子进程中运行 target。\n\nFeedback 反馈通常是基于观察器收集到的执行结果，来判断这次 fuzz 执行过程中，使用的 input 是不是一个有效的输入，如果是有效输入才会保存到语料库中。在覆盖率引导的 fuzz 引擎中，当一个 input 能命中此前都没有到达的代码区块时，才会被认为是有效的。\n\nMutator 变异器接受一个 input 作为输入，通过修改、插入、删除等变异操作，衍生出一个新的 input。在 AFL 和 Libfuzzer 中，input 为字节数组，变异器通过对字节位和字节块进行改变，进而得到新的 input。在 target 输入需要满足指定格式时，自定义变异器是一条可行的途径。\n\nGenerator 生成器是指从头生成一个 input 作为输入，它不是基于已有的 input 进行修改。常用于基于生成的 fuzz 引擎中，例如 peach 中通过定义 input 的数据模型来指导 input 的生成。\n\n\n（2）LibAFL 的架构设计 LibAFL 的核心架构设计如下图：\n\n\n 其中的一些实体名词含义参见前一部分介绍。在这个架构图中，有三个比较大的组件：\n\nState：负责记录和维护 fuzzer 运行过程中的需要持久化的信息。它包括了各类统计数据、测试用例数据、已发现的漏洞、程序执行的路径等。这些信息用于帮助 fuzzer 做出智能决策，优化测试过程。\n\nFuzzer：负责实际执行模糊测试。它使用各种算法和策略来生成或者变异输入数据，然后将这些数据用于测试目标程序，以期发现潜在的安全漏洞。Fuzzer 需要与状态组件紧密协作，以使用状态信息引导自己的测试过程。\n\nEvent Manager：事件管理器作为 LibAFL 架构中的通信枢纽，它负责协调不同组件间的交互工作。事件管理器处理各种事件，如新发现的错误、状态更新信号等，并确保这些信息及时、正确地在组件间传递。\n\n\n4. LibAFL 使用方法 \n 简单的模糊器实例 - LibAFL 模糊测试库 \nfuzzing-101-with-libafl\n\n5. 参考资料 \nLibAFL: A Framework to Build Modular and Reusable Fuzzers\nLibAFL 学习笔记 \nLibAFL 中文文档 \n","dateCreated":"2023-11-18T10:38:08+08:00","dateModified":"2024-06-27T16:30:08+08:00","datePublished":"2023-11-18T10:38:08+08:00","description":"LibAFL 是用 Rust 开发的一款模糊测试库，支持 Fuzz 各模块的灵活定制 ","headline":"LibAFL 简介","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2023/LibAFL%E7%AE%80%E4%BB%8B/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2023/LibAFL%E7%AE%80%E4%BB%8B/","keywords":"Fuzz, 安全, 工具, AFL"}</script>
+    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n1. 什么是 LibAFLLibAFL 是一款用 Rust 语言开发的开源模糊测试框架，它将模糊测试的组件划分成一组模块文件，用户可以基于这组模块，快速实现自定义的 fuzz 引擎。\n2. 为什么要设计 LibAFL 现有的 Fuzz 引擎很多是基于 AFL 进行改造的，不同的改造之间存在不兼容的情况，比如 Fairfuzz 是基于 AFL 改造的，但是 AFL++ 不支持 Fairfuzz。如果希望把多种 Fuzz 优化技术集合在一起，工程难度很大。\nAFL++ 是 AFL 的进化版，它在 AFL 的基础上集成了很多 Fuzz 优化技术，并支持以插件的方式进行功能扩展，例如可以自定义 mutator。但 AFL++ 还是受限于 AFL 本身的程序设计，与 mutator 无关的优化技术，与 AFL++ 的集成也比较困难。\n3. LibAFL 整体架构 （1）Fuzz 引擎的相关组件 \nInput 指 fuzz 过程中，传递给 target 的输入数据。Libfuzzer 和 AFL 默认的输入格式，都是字节数组。fuzz 的入口函数在以这个字节数组作为入参，然后对字节数组进行切片和类型变换，转换为 target 中待测函数所要求的参数形式，再对待测函数进行调用。\n\nCorpus 指 fuzz 过程中，用来存放有效 input 的语料库。AFL 必须要有初始语料库，Libfuzzer 可以不提供初始语料库。语料库可以存放在磁盘中通过 io 读写，也可以全部加载进内存中。前者效率低，后者内存消耗大。\n\nScheduler 指 fuzz 引擎从语料库中选择 input 的调度机制。语料库中包含大量的 input，fuzz 每轮执行需要挑选一个 input。调度机制决定了 input 的挑选方法，简单的实现包括先入先出、随机挑选等。对调度机制进行优化，也是改进 fuzz 的一个方向。\n\nStagefuzz 的每一轮执行实际上都包含多个步骤，每个步骤都可以理解为一个阶段。比如变异阶段是对 input 进行随机变异操作，分析阶段可以使用污点分析等技术搜集更多信息，语料库精简阶段是对语料库进行筛选操作。一连串的阶段性操作构成了一次完整的 fuzz 执行过程。\n\nObserver 观察器用来收集 fuzz 单词运行过程中的信息。在覆盖率引导的 fuzz 引擎中，观察器会看这次执行过程中，input 所经过的代码路径。AFL 中的 bitmap 就是一个观察器，AFL 将代码路径转化为 branch 或 edge 的集合，并记录在 bitmap 中。\n\nExecutor 执行器负责将 input 喂给 target 开启一次 fuzz 执行。不同的 fuzz 工具，可能有不同的执行方式。Libfuzzer 是一个单进程的执行模式，在一个进程中生成 input 运行 target，并不断循环这个过程；AFL 则通过 fork 模式，每次 input 都会 fork 出一个子进程，在子进程中运行 target。\n\nFeedback 反馈通常是基于观察器收集到的执行结果，来判断这次 fuzz 执行过程中，使用的 input 是不是一个有效的输入，如果是有效输入才会保存到语料库中。在覆盖率引导的 fuzz 引擎中，当一个 input 能命中此前都没有到达的代码区块时，才会被认为是有效的。\n\nMutator 变异器接受一个 input 作为输入，通过修改、插入、删除等变异操作，衍生出一个新的 input。在 AFL 和 Libfuzzer 中，input 为字节数组，变异器通过对字节位和字节块进行改变，进而得到新的 input。在 target 输入需要满足指定格式时，自定义变异器是一条可行的途径。\n\nGenerator 生成器是指从头生成一个 input 作为输入，它不是基于已有的 input 进行修改。常用于基于生成的 fuzz 引擎中，例如 peach 中通过定义 input 的数据模型来指导 input 的生成。\n\n\n（2）LibAFL 的架构设计 LibAFL 的核心架构设计如下图：\n\n\n 其中的一些实体名词含义参见前一部分介绍。在这个架构图中，有三个比较大的组件：\n\nState：负责记录和维护 fuzzer 运行过程中的需要持久化的信息。它包括了各类统计数据、测试用例数据、已发现的漏洞、程序执行的路径等。这些信息用于帮助 fuzzer 做出智能决策，优化测试过程。\n\nFuzzer：负责实际执行模糊测试。它使用各种算法和策略来生成或者变异输入数据，然后将这些数据用于测试目标程序，以期发现潜在的安全漏洞。Fuzzer 需要与状态组件紧密协作，以使用状态信息引导自己的测试过程。\n\nEvent Manager：事件管理器作为 LibAFL 架构中的通信枢纽，它负责协调不同组件间的交互工作。事件管理器处理各种事件，如新发现的错误、状态更新信号等，并确保这些信息及时、正确地在组件间传递。\n\n\n4. LibAFL 使用方法 \n 简单的模糊器实例 - LibAFL 模糊测试库 \nfuzzing-101-with-libafl\n\n5. 参考资料 \nLibAFL: A Framework to Build Modular and Reusable Fuzzers\nLibAFL 学习笔记 \nLibAFL 中文文档 \n","dateCreated":"2023-11-18T10:38:08+08:00","dateModified":"2024-06-27T16:30:08+08:00","datePublished":"2023-11-18T10:38:08+08:00","description":"LibAFL 是用 Rust 开发的一款模糊测试库，支持 Fuzz 各模块的灵活定制 ","headline":"LibAFL 简介","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2023/LibAFL%E7%AE%80%E4%BB%8B/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2023/LibAFL%E7%AE%80%E4%BB%8B/","keywords":"安全, 工具, AFL, Fuzz"}</script>
     <meta name="description" content="LibAFL 是用 Rust 开发的一款模糊测试库，支持 Fuzz 各模块的灵活定制">
 <meta property="og:type" content="blog">
 <meta property="og:title" content="LibAFL 简介">
@@ -26,10 +26,10 @@
 <meta property="article:published_time" content="2023-11-18T02:38:08.000Z">
 <meta property="article:modified_time" content="2024-06-27T08:30:08.593Z">
 <meta property="article:author" content="一瓢清浅">
-<meta property="article:tag" content="Fuzz">
 <meta property="article:tag" content="安全">
 <meta property="article:tag" content="工具">
 <meta property="article:tag" content="AFL">
+<meta property="article:tag" content="Fuzz">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:image" content="https://www.stepbystep.asia/2023/LibAFL%E7%AE%80%E4%BB%8B/LibAFL%E6%9E%B6%E6%9E%84%E8%AE%BE%E8%AE%A1.png">
     
diff --git "a/2023/LibFuzzer\344\275\277\347\224\250\350\257\264\346\230\216/index.html" "b/2023/LibFuzzer\344\275\277\347\224\250\350\257\264\346\230\216/index.html"
index b02c42c..fec8f81 100644
--- "a/2023/LibFuzzer\344\275\277\347\224\250\350\257\264\346\230\216/index.html"
+++ "b/2023/LibFuzzer\344\275\277\347\224\250\350\257\264\346\230\216/index.html"
@@ -14,7 +14,7 @@
     
     
     
-    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n按照  官方定义，LibFuzzer 是一个in-process（进程内的），coverage-guided（以覆盖率为引导的），evolutionary（进化的） 的 fuzz 引擎，是 LLVM 项目的一部分，主要用于对 C&#x2F;C++ 程序进行 Fuzz 测试。LibFuzzer 三个特性的具体含义为：\n\nin-process：不会为每个测试用例启动一个进程，而是将所有的测试数据投放在同一个进程的内存空间中\n\ncoverage-guided：对每一个测试输入都进行代码覆盖率计算，不断累积测试用例使得代码覆盖率最大化\n\nevolutionary：结合了变异和生成两种形势的 Fuzz 引擎\n\n变异：基于已有的数据样本，通过一些变异规则，产生新的测试用例\n\n生成：通过对目标协议或接口规范进行建模，从零开始产生测试用例\n\n\n\n\nLibFuzzer 与待测的 library 进行链接，通过向指定的 fuzzing 入口（即target 函数）发送测试数据，并跟踪被触达的代码区域，然后对输入的数据进行变异，以达到代码覆盖率最大的目的，其中代码覆盖率的信息由 LLVM 的 SanitizerCoverage 工具提供。\n一、使用方法 1. 安装环境Clang 是一个类似 GCC 的 C&#x2F;C++ 语言编译工具，此处 简介。LibFuzzer 现在已被集成到 Clang 6.0 之后的版本中，在 Linux 环境下，只需直接安装 Clang 即可：\n1apt install clang\n\n安装完毕之后，可以通过如下命令查看 clang 版本：\n1clang --version\n\n2. 构建 target使用 LibFuzzer 时，第一步就是要实现 target 函数——LLVMFuzzerTestOneInput，该函数以 bytes 数组作为输入，函数体内使用待测 API 对这个 bytes 数组进行处理：\n12345// fuzz_target.ccextern &quot;C&quot; int LLVMFuzzerTestOneInput(const uint8_t *Data, size_t Size) &#123;  DoSomethingInterestingWithMyAPI(Data, Size);  return 0;  // Values other than 0 and -1 are reserved for future use.&#125;\n\ntarget 函数的名称、参数类型、返回值类型都不能改变。此外，官方文档中还有如下说明：\n\ntarget 函数在同一个进程中被多次执行，被不同的输入循环调用；\n\ntarget 函数需要容忍任何形势的输入，比如空数据、很长的数据、格式错误的数据等；\n\ntarget 函数不允许调用 exit 函数，否则将导致 Fuzz 终止执行；\n\ntarget 函数中可以使用线程，但是子线程要在函数体结束前 join，即进入下一次循环前，结束上一次循环的子线程；\n\ntarget 函数的结果必须是确定性的，即两次的 Data 如果一致，两次的执行结果也必须一致；\n\ntarget 函数执行速度必须快，避免三阶及以上的复杂度、日志记录和过多的内存消耗；\n\ntarget 函数应尽量避免修改全局状态，因为在同一个进程中修改全局变量，会导致下一次运行与上一次运行的上下文不同，可能影响程序确定性；\n\ntarget 函数的处理范围越窄越好，如果函数要处理多种数据格式，那最好拆分成多个子函数，每个子函数处理一种格式。\n\n\ntarget 函数编写完成后，通过以下命令编译成可执行文件：\n1234clang -g -O1 -fsanitize=fuzzer                         fuzz_target.cc # Builds the fuzz target w/o sanitizersclang -g -O1 -fsanitize=fuzzer,address                 fuzz_target.cc # Builds the fuzz target with ASANclang -g -O1 -fsanitize=fuzzer,signed-integer-overflow fuzz_target.cc # Builds the fuzz target with a part of UBSANclang -g -O1 -fsanitize=fuzzer,memory                  fuzz_target.cc # Builds the fuzz target with MSAN\n\nClang 支持的编译选项可以  参考文档  或者通过–help 查看，构建 LibFuzzer target 时常用的  编译选项  如下：\n\n-g：生成调试信息\n\n-O：设置编译器优化等级，可以是 1&#x2F;2&#x2F;3，默认为 1，数字越大，优化越多，注意2 和 3 有可能导致 Fuzz 找不到 crash\n\n-o：指定输出文件名\n\n-I：uppercase i，添加头文件搜索路径\n\n-L：添加库文件搜索路径\n\n-l：lowercase L，指定库文件名称，动态库和静态库同时存在时，动态库优先\n\n-fsanitize：启用 LibFuzzer，对源码进行插桩，并添加各种  消毒器 sanitizer，对程序进行运行时检查。\n\n-fsanitize&#x3D;fuzzer  编译时对源码插桩，链接 libFuzzer 库文件（使用 libFuzzer 的 main 函数）\n\n-fsanitize&#x3D;fuzzer-no-link  编译时对源码插桩，不链接 libFuzzer，适用于拥有 main 函数的源码。对大型项目来说，构建效率更高\n\n-fsanitize&#x3D;address  地址消毒器（AddressSanitizer），用于检测缓冲区溢出、UAF、Double Free、内存泄漏等内存问题\n\n-fsanitize&#x3D;memory  内存消毒器（MemorySanitizer），用于检测未初始化的内存访问\n\n-fsanitize&#x3D;undefined  未定义行为消毒器（UndefinedBehaviorSanitizer），用于检测程序运行中未定义行为，如越界访问、整数溢出、空指针解引用等\n\n\n\n-fsanitize-coverage：启用代码覆盖率的统计，包括 function 级别，basic block 级别和 edge 级别，详情可  参考文档 。但需要注意的是， 高版本的 clang 中，已经取消了对 -fsanitize-coverage&#x3D;trace-pc-guard 的支持，建议改用 -fsanitize&#x3D;fuzzer 替代，否则会出现报错，参见第二章节使用示例。\n\n-fsanitize-coverage&#x3D;trace-pc-guard,edge  使用 edge 级别代码覆盖率，edge 为默认级别，可省略\n\n-fsanitize-coverage&#x3D;trace-pc-guard,func  使用 function 级别代码覆盖率\n\n-fsanitize-coverage&#x3D;trace-pc-guard,bb  使用 basic block 级别代码覆盖率\n\n\n\n\n关于添加 LibFuzzer 相关选项后的详细构建过程，有兴趣可以参考libFuzzer 编译链接。\n关于 LibFuzzer 通过插桩统计代码覆盖率的具体实现，有兴趣可以参考Coverage Control in libFuzzer。\n3. 执行 fuzz在 target 函数构建成功后，会生成一个可执行的 fuzz 二进制文件，该文件通过命令行方式执行，可以接受指定的参数选项。执行格式为：\n1./fuzz-target -flag1=val1 -flag2=val2 ... path1 path2 ...\n\n在不限制运行时长的情况下，Fuzz 将会一直执行下去，直到出现 crash（通常是因为触发 sanitizer 异常）才会终止。导致 crash 的输入将会作为能触发 bug 的 testcase 保存到磁盘上，并根据 crash 的类型，用不同的文件名前缀进行区分，比如 crash-XXX，leak-XXX，timeout-XXX 等。\n(1) 参数说明  常见的 flag 选项及作用列举如下，使用 flag 时必须以 -flag&#x3D;val 的格式：\n\n\n\nflag\n默认值\n作用\n\n\n\nverbosity\n1\n运行时输出详细日志\n\n\nseed\n0\n随机种子。如果为 0，则自动生成随机种子\n\n\nruns\n-1\n测试运行的次数（-1 表示无限）\n\n\nmax_len\n0\n测试输入的最大长度。若为 0，libFuzzer 会自行猜测\n\n\nshuffle\n1\n为 1 表示启动时打乱初始语料库\n\n\nprefer_small\n1\n为 1 表示打乱语料库时，较小输入更优先\n\n\ntimeout\n1200\n超时时长，单位为秒。如果单次运行超过时长，Fuzz 将被终止\n\n\nmax_total_time\n0\n最大运行时长，单位为秒。若为正，表示 Fuzz 最长运行时间\n\n\nhelp\n0\n为 1 表示打印帮助信息\n\n\nmerge\n0\n为 1 表示在不损失代码覆盖率的情况下，进行语料库合并\n\n\nmerge_control_file\n0\n指定合并进程的控制文件，用于恢复合并状态\n\n\nminimize_crash\n0\n为 1 表示将提供的崩溃输入进行最小化。与 -runs &#x3D; N 或 -max_total_time &#x3D; N 一起使用以限制尝试次数\n\n\njobs\n0\njob 的数量，多个 job 将被分配到 workers 上执行，每个 job 的 stdout&#x2F;stderr 被重定向到 fuzz-&lt;JOB&gt;.log\n\n\nworkers\n0\nworker 的数量，为 0 将使用 min(jobs, number_of_cpu_cores&#x2F;2)\n\n\nreload\n1\n设置重新加载主语料库的间隔秒数。在并行模式下，在多个 job 中同步语料集。为 0 表示禁止\n\n\nreduce_inputs\n1\n为 1 表示尝试减少输入数据的大小，同时保留其完整的特征集\n\n\nrss_limit_mb\n2048\nRSS 内存用量限制，单位为 Mb。为 0 表示无限制\n\n\npurge_allocator_interval\n1\n清理缓存的建个时长，单位为秒。当指定 rss_limit_mb 且 rss 使用率超过 50% 时，开始清理。为 -1 表示禁止\n\n\nmalloc_limit_mb\n0\n单次 malloc 申请内存的大小限制，单位为 Mb。为 0 则采用 rss_limit_mb 进行限制\n\n\ndetect_leaks\n1\n为 1，且启用 LeakSanitizer 消毒器时，将在 Fuzz 过程中检测内存泄漏，而不仅是在 Fuzz 结束时才检测\n\n\nprint_coverage\n0\n退出时打印覆盖率信息\n\n\nprint_corpus_stats\n0\n退出时打印语料信息\n\n\nprint_final_stats\n0\n退出时打印统计信息\n\n\nonly_ascii\n0\n为 1 表示只生成 ASCII（isprint + isspace）字符作为输入\n\n\nartifact_prefix\n0\n将 fuzzing artifacts（crash、timeout 等 file）保存为文件时所使用的前缀，即文件将保存为 $(artifact_prefix)file\n\n\nexact_artifact_path\n0\n将单个 fuzz artfifact 保存为文件时所使用的前缀。将覆盖 -artifact_prefix，并行任务中不要使用相同取值\n\n\n(2) 语料使用  模糊测试通过随机的方式变异或生成测试用例。提供种子语料库作为随机变异的基础用例，避免从头开始生完全随机地生成用例，在待测函数接受复杂或结构化输入的情况下，能显著提升 Fuzz 测试的效率和覆盖率。\nLibFuzzer 是以覆盖率为引导的，当提供种子语料库时，LibFuzzer 从语料库中读取语料，通过随机变异产生新的测试数据，输入到 Fuzz Target。由于在构建 Fuzz Target 时，通过编译参数进行了代码插桩，因此可以跟踪 Fuzz Target 在接收到输入后，具体执行了哪些代码。如果某个测试输入能执行到之前从未执行的代码，那么这个测试输入就是一个有效变异，将被纳入到语料库，作为后续变异的基础。整体流程大致如下，仅做原理示意，不等于具体实现。\ngraph LR\n    A[从语料库中读取样本] --> B[随机变异生成新样本]\n    B --> C[新样本输入 Fuzz Target]\n    C --> D[跟踪代码执行路径]\n    D --> E{是否覆盖新的代码}\n    E -->| 是 | F[测试数据加入语料库]\n    E -->| 否 | B\n    F --> A\n\n使用 corpus 时，需要提供一个或多个存放种子语料的路径，命令为：\n1./fuzz_target -max_len=1000 -jobs=20 corpus_dir  # 种子语料存放在 corpus_dir 目录下\n\n当语料库很大时，可以在保持代码覆盖率的情况下进行精简操作，这时需要用 -merge 参数，命令为：\n1./fuzz_target -merge=1 mini_corpus_dir corpus_dir  # 原始语料集存放在 corpus_dir 目录下，精简后的语料集存放在 mini_corpus_dir 目录下\n\n利用 -merge 参数，还可以实现有效语料的提取，即从一批候选语料中，找到能够触发新代码路径的语料，命令为：\n1./fuzz_target -merge=1 interesting_corpus_dir candidate_corpus_dir  # 候选语料放在 candidate_corpus_dir，有效语料放在 interesting_corpus_dir\n\n总的来说，语料集的路径可以有一个、两个或更多，当使用 -merge 参数时，这些语料集中发现的有效语料，都会被保存到第一个路径下。需要注意的是，合并语料是一个非常耗时的过程，通过使用 -merge_control_file 参数，可以实现无缝恢复的多阶段合并，即通过 killall -SIGUSR1 /path/to/fuzzer/binary 中断合并操作后，下次还能继续上一次的合并进度，继续开始合并操作。示例如下：\n123456789101112131415% rm -f SomeLocalPath% ./my_fuzzer CORPUS1 CORPUS2 -merge=1 -merge_control_file=SomeLocalPath...MERGE-INNER: using the control file &#x27;SomeLocalPath&#x27;...# While this is running, do `killall -SIGUSR1 my_fuzzer` in another console==9015== INFO: libFuzzer: exiting as requested# This will leave the file SomeLocalPath with the partial state of the merge.# Now, you can continue the merge by executing the same command. The merge will continue from where it has been interrupted.% ./my_fuzzer CORPUS1 CORPUS2 -merge=1 -merge_control_file=SomeLocalPath...MERGE-OUTER: non-empty control file provided: &#x27;SomeLocalPath&#x27;MERGE-OUTER: control file ok, 32 files total, first not processed file 20...\n\n语料库除了用于提高 Fuzz 效率，还可用于回归测试。在回归测试和复现 crash 时，还可以具体指定某一个 testcase，命令为：\n1./fuzz_target testcase_path  # testcase_path 就是 fuzz crash 时保存的 testcase file 的文件路径\n\n4. 输出解读  在 Fuzz 执行过程中，标准错误流 stderr 中，通常会输出以下格式的内容：\n12345678910111213INFO: Seed: 1523017872INFO: Loaded 1 modules (16 guards): [0x744e60, 0x744ea0),INFO: -max_len is not provided, using 64INFO: A corpus is not provided, starting from an empty corpus#0    READ units: 1#1    INITED cov: 3 ft: 2 corp: 1/1b exec/s: 0 rss: 24Mb#3811 NEW    cov: 4 ft: 3 corp: 2/2b exec/s: 0 rss: 25Mb L: 1 MS: 5 ChangeBit-ChangeByte-ChangeBit-ShuffleBytes-ChangeByte-#3827 NEW    cov: 5 ft: 4 corp: 3/4b exec/s: 0 rss: 25Mb L: 2 MS: 1 CopyPart-#3963 NEW    cov: 6 ft: 5 corp: 4/6b exec/s: 0 rss: 25Mb L: 2 MS: 2 ShuffleBytes-ChangeBit-#4167 NEW    cov: 7 ft: 6 corp: 5/9b exec/s: 0 rss: 25Mb L: 3 MS: 1 InsertByte-==31511== ERROR: libFuzzer: deadly signal...artifact_prefix=&#x27;./&#x27;; Test unit written to ./crash-b13e8756b13a00cf168300179061fb4b91fefbed\n\n第一行显示 Fuzz 测试使用的随机种子，可以通过 -seed 参数来设置。\n第二行显示插桩后的 PC guards 数量（PC 指 Program Counter），可理解为 Fuzz 识别出来的 edge 总数，参考  此处脚注说明。\n第三行显示输入数据的长度限制，示例中 -max_len 参数没有设置，Fuzz 程序将 -max_len 定为 64，即最大数据长度不超过 64kb。\n第四行显示语料库信息，示例中没有提供 corpus，Fuzz 程序从头开始生成语料。\n第五行到第十行，每行开头的 #N 表示 Fuzz 已执行了 N 次测试输入，后面的内容为测试过程中的事件代码和统计信息：\n\n\n\n事件代码\n含义\n\n\n\nREAD\nFuzz 已从语料库中读取所有初始输入样本\n\n\nINITED\nFuzz 已完成初始化，包括通过被测代码运行每个初始输入样本\n\n\nNEW\nFuzz 生成了一个测试输入样本，它能触发被测代码的新路径，将被保存到主语料库目录\n\n\nREDUCE\nFuzz 找到了一个更好的输入样本，它能保持原有样本的特征集（参考下表 ft 含义），但是 size 更小\n\n\npulse\nFuzz 已生成 2 的 n 次方个输入（定期生成以使用户确信 Fuzz 仍在工作）\n\n\nDONE\nFuzz 已完成操作，因为它已达到指定的迭代限制（-runs）或时间限制（-max_total_time）\n\n\nRELOAD\nFuzz 正在定期重新加载语料库目录中的输入样本，这使它能够发现其他 Fuzz 进程发现的任何输入\n\n\n\n\n\n统计指标\n含义\n\n\n\ncov\n执行当前语料库所覆盖的 block 或 edge 的总数\n\n\nft\nLibFuzzer 使用不同的信号来评估代码覆盖率：边缘覆盖率、边缘计数器、间接调用者 &#x2F; 被调用者对等。这些信号组合起来称为特征\n\n\ncorp\n当前内存测试语料库中的条目数及其大小（单位为 byte）\n\n\nlim\n当前语料库中新样本的长度限制。 随着时间的推移而增加，直到达到最大长度 (-max_len)\n\n\nexec&#x2F;s\n每秒 Fuzz 执行次数\n\n\nrss\n当前内存消耗（单位为 Mb）\n\n\nL\n新样本的大小（单位为 byte）。只用于 NEW 和 REDUCE 事件\n\n\nMS: &lt;n&gt; &lt;operations&gt;\n生成新样本时的变异次数和变异方法。只用于 NEW 和 REDUCE 事件\n\n\n第十一行开始，显示 Fuzz 遇到 crash 并终止执行，导致 crash 的用例被保存为.&#x2F;crash-&lt;sha1&gt; 文件，保存路径和名称可以通过 -artifact_prefix 参数修改。\n二、使用示例  以CVE-2016-5180为例，演示 LibFuzzer 的使用过程。CVE-2016-5180是在 c-ares 中出现的堆溢出问题，是使得 ChromeOS 被攻击（重启后以访客模式执行代码）的漏洞之一。\n1. 下载源码  最新的 c-ares 代码已修复漏洞，为了复现漏洞，clone 代码后，需要恢复到漏洞修复之前。\n123git clone https://github.com/c-ares/c-ares.gitcd c-ares/git reset --hard 51fbb479f7948fca2ace3ff34a15ff27e796afdd\n\n2. 编写 Fuzz 主函数  实现 LLVMFuzzerTestOneInput 函数，将 LibFuzzer 输入的字节流进行转换，调用 ares_create_query 函数，并将代码保存为 target.cc 文件。\n1234567891011121314151617// Copyright 2016 Google Inc. All Rights Reserved.// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);#include &lt;stdint.h&gt;#include &lt;stdlib.h&gt;#include &lt;string&gt;#include &lt;arpa/nameser.h&gt;#include &lt;ares.h&gt;extern &quot;C&quot; int LLVMFuzzerTestOneInput(const uint8_t *Data, size_t Size) &#123;  unsigned char *buf;  int buflen;  std::string s(reinterpret_cast&lt;const char *&gt;(Data), Size);  ares_create_query(s.c_str(), ns_c_in, ns_t_a, 0x1234, 0, &amp;buf, &amp;buflen, 0);  free(buf);  return 0;&#125;\n\n3. 编译 Fuzz target使用 fuzzer-test-suite 提供的编译脚本，执行 build.sh 脚本，会自动调用 custom-build.sh 和 common.sh 进行编译。三个 shell 脚本和 Fuzz 函数的存放路径如下，脚本中会自动使用 git 拉取代码，这里将第 1 步手动拉取的代码删掉了：\n123456789root@server:~/fuzz$ tree.├── cares│   ├── build.sh│   └── target.cc├── common.sh└── custom-build.sh1 directory, 4 files\n\n注意需要将原始脚本中的 -fsanitize-coverage&#x3D;trace-pc-guard 替换为 -fsanitize&#x3D;fuzzer，否则执行 Fuzz 时会出现错误：-fsanitize-coverage&#x3D;trace-pc-guard is no longer supported by libFuzzer。\n1234root@server:~/fuzz$ ./cares-fsanitize_fuzzer-fsanitize-coverage=trace-pc-guard is no longer supported by libFuzzer.Please either migrate to a compiler that supports -fsanitize=fuzzeror use an older version of libFuzzer\n\n执行脚本进行编译（也可以自己编写命令进行编译，编译相关的内容之后会单独写文章进行说明）：\n1root@server:~/fuzz$ ./cares/build.sh\n\n编译完后，可以看到目录下多了一个二进制文件 cares-fsanitize_fuzzer，两个目录 BUILD 和 SRC。cares-fsanitize_fuzzer 是可执行的 Fuzz 程序，SRC 目录存放 c-ares 含漏洞的源码，BUILD 目录用于存放编译产生的中间文件和最终文件：\n12345678910root@server:~/fuzz$ tree -L 1.├── BUILD├── cares├── cares-fsanitize_fuzzer├── common.sh├── custom-build.sh└── SRC3 directories, 3 files\n\n4. 执行 Fuzz 测试  直接运行编译得到的二进制文件，如需附带参数，可参考第一章节执行 fuzz 的参数说明。\n123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778root@server:~/fuzz$ ./cares-fsanitize_fuzzerINFO: Seed: 817252946INFO: Loaded 1 modules   (10 inline 8-bit counters): 10 [0x5a90e0, 0x5a90ea),INFO: Loaded 1 PC tables (10 PCs): 10 [0x56c278,0x56c318),INFO: -max_len is not provided; libFuzzer will not generate inputs larger than 4096 bytesINFO: A corpus is not provided, starting from an empty corpus#2      INITED cov: 3 ft: 3 corp: 1/1b exec/s: 0 rss: 27Mb#3      NEW    cov: 4 ft: 4 corp: 2/5b lim: 4 exec/s: 0 rss: 27Mb L: 4/4 MS: 1 CrossOver-#10     REDUCE cov: 4 ft: 4 corp: 2/4b lim: 4 exec/s: 0 rss: 27Mb L: 3/3 MS: 2 ChangeByte-CrossOver-#11     REDUCE cov: 4 ft: 4 corp: 2/3b lim: 4 exec/s: 0 rss: 27Mb L: 2/2 MS: 1 EraseBytes-#1368   REDUCE cov: 6 ft: 6 corp: 3/20b lim: 17 exec/s: 0 rss: 27Mb L: 17/17 MS: 2 InsertByte-InsertRepeatedBytes-#1524   REDUCE cov: 6 ft: 6 corp: 3/19b lim: 17 exec/s: 0 rss: 27Mb L: 16/16 MS: 1 EraseBytes-===================================================================3049145==ERROR: AddressSanitizer: heap-buffer-overflow on address 0x6030012599c2 at pc 0x000000550e1c bp 0x7fffbad826d0 sp 0x7fffbad826c8WRITE of size 1 at 0x6030012599c2 thread T0    #0 0x550e1b in ares_create_query (/home/fuzz/cares-fsanitize_fuzzer+0x550e1b)    #1 0x55053c in LLVMFuzzerTestOneInput /home/fuzz/cares/target.cc:14:3    #2 0x4586a1 in fuzzer::Fuzzer::ExecuteCallback(unsigned char const*, unsigned long) (/home/fuzz/cares-fsanitize_fuzzer+0x4586a1)    #3 0x457de5 in fuzzer::Fuzzer::RunOne(unsigned char const*, unsigned long, bool, fuzzer::InputInfo*, bool*) (/home/fuzz/cares-fsanitize_fuzzer+0x457de5)    #4 0x45a087 in fuzzer::Fuzzer::MutateAndTestOne() (/home/fuzz/cares-fsanitize_fuzzer+0x45a087)    #5 0x45ad85 in fuzzer::Fuzzer::Loop(std::__Fuzzer::vector&lt;fuzzer::SizedFile, fuzzer::fuzzer_allocator&lt;fuzzer::SizedFile&gt; &gt;&amp;) (/home/fuzz/cares-fsanitize_fuzzer+0x45ad85)    #6 0x44973e in fuzzer::FuzzerDriver(int*, char***, int (*)(unsigned char const*, unsigned long)) (/home/fuzz/cares-fsanitize_fuzzer+0x44973e)    #7 0x472582 in main (/home/fuzz/cares-fsanitize_fuzzer+0x472582)    #8 0x7fd31481c082 in __libc_start_main (/lib/x86_64-linux-gnu/libc.so.6+0x24082)    #9 0x41e4dd in _start (/home/fuzz/cares-fsanitize_fuzzer+0x41e4dd)0x6030012599c2 is located 0 bytes to the right of 18-byte region [0x6030012599b0,0x6030012599c2)allocated by thread T0 here:    #0 0x51e20d in malloc (/home/fuzz/cares-fsanitize_fuzzer+0x51e20d)    #1 0x5508f6 in ares_create_query (/home/fuzz/cares-fsanitize_fuzzer+0x5508f6)    #2 0x55053c in LLVMFuzzerTestOneInput /home/fuzz/cares/target.cc:14:3    #3 0x4586a1 in fuzzer::Fuzzer::ExecuteCallback(unsigned char const*, unsigned long) (/home/fuzz/cares-fsanitize_fuzzer+0x4586a1)    #4 0x457de5 in fuzzer::Fuzzer::RunOne(unsigned char const*, unsigned long, bool, fuzzer::InputInfo*, bool*) (/home/fuzz/cares-fsanitize_fuzzer+0x457de5)    #5 0x45a087 in fuzzer::Fuzzer::MutateAndTestOne() (/home/fuzz/cares-fsanitize_fuzzer+0x45a087)    #6 0x45ad85 in fuzzer::Fuzzer::Loop(std::__Fuzzer::vector&lt;fuzzer::SizedFile, fuzzer::fuzzer_allocator&lt;fuzzer::SizedFile&gt; &gt;&amp;) (/home/fuzz/cares-fsanitize_fuzzer+0x45ad85)    #7 0x44973e in fuzzer::FuzzerDriver(int*, char***, int (*)(unsigned char const*, unsigned long)) (/home/fuzz/cares-fsanitize_fuzzer+0x44973e)    #8 0x472582 in main (/home/fuzz/cares-fsanitize_fuzzer+0x472582)    #9 0x7fd31481c082 in __libc_start_main (/lib/x86_64-linux-gnu/libc.so.6+0x24082)SUMMARY: AddressSanitizer: heap-buffer-overflow (/home/fuzz/cares-fsanitize_fuzzer+0x550e1b) in ares_create_queryShadow bytes around the buggy address:  0x0c06802432e0: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c06802432f0: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c0680243300: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c0680243310: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c0680243320: fa fa fa fa fa fa fa fa fa fa fd fd fd fa fa fa=&gt;0x0c0680243330: fd fd fd fa fa fa 00 00[02]fa fa fa fd fd fd fa  0x0c0680243340: fa fa fd fd fd fa fa fa fd fd fd fa fa fa fd fd  0x0c0680243350: fd fa fa fa fd fd fd fa fa fa fd fd fd fa fa fa  0x0c0680243360: fd fd fd fa fa fa fd fd fd fa fa fa fd fd fd fa  0x0c0680243370: fa fa fd fd fd fa fa fa fd fd fd fa fa fa fd fd  0x0c0680243380: fd fa fa fa fd fd fd fa fa fa fd fd fd fa fa faShadow byte legend (one shadow byte represents 8 application bytes):  Addressable:           00  Partially addressable: 01 02 03 04 05 06 07  Heap left redzone:       fa  Freed heap region:       fd  Stack left redzone:      f1  Stack mid redzone:       f2  Stack right redzone:     f3  Stack after return:      f5  Stack use after scope:   f8  Global redzone:          f9  Global init order:       f6  Poisoned by user:        f7  Container overflow:      fc  Array cookie:            ac  Intra object redzone:    bb  ASan internal:           fe  Left alloca redzone:     ca  Right alloca redzone:    cb  Shadow gap:              cc==3049145==ABORTINGMS: 4 ChangeByte-InsertByte-CopyPart-ChangeByte-; base unit: 00b28ff06b788b9b67c6b259800f404f9f3761fd0x5c,0x2e,0x0,0x6b,0x0,\\\\.\\x00k\\x00artifact_prefix=&#x27;./&#x27;; Test unit written to ./crash-edef708d314ed627eba0ef2b042e47aa96a9b899Base64: XC4AawA=\n\n可以看到，LibFuzzer 发现了 c-ares 中的 heap-buffer-overflow 漏洞，触发 crash 的用例保存为 crash-edef708d314ed627eba0ef2b042e47aa96a9b899 文件，该用例包含 5 个字节，字节码分别为：0x5c,0x2e,0x0,0x6b,0x0，其中 0x0 为空字符 NULL，属于不可见字符。\n5. 提取语料  执行 Fuzz 时，传入一个空文件夹作为 copus 路径，执行完后，可以在文件夹中看到 LibFuzzer 执行过程中，生成的有效语料。\n123456789101112131415161718192021222324252627282930313233343536373839404142root@server:~/fuzz/cares$ mkdir corpusroot@server:~/fuzz/cares$ lsBUILD  build.sh  cares_fuzzer  corpus  target.ccroot@server:~/fuzz/cares$ ./cares_fuzzer corpus/INFO: Seed: 4140748905INFO: Loaded 1 modules   (57 inline 8-bit counters): 57 [0x5a9100, 0x5a9139),INFO: Loaded 1 PC tables (57 PCs): 57 [0x5a9140,0x5a94d0),INFO:        0 files found in corpus/INFO: -max_len is not provided; libFuzzer will not generate inputs larger than 4096 bytesINFO: A corpus is not provided, starting from an empty corpus#2      INITED cov: 13 ft: 14 corp: 1/1b exec/s: 0 rss: 27Mb#4      NEW    cov: 16 ft: 20 corp: 2/3b lim: 4 exec/s: 0 rss: 27Mb L: 2/2 MS: 2 ChangeByte-InsertByte-#9      NEW    cov: 16 ft: 26 corp: 3/6b lim: 4 exec/s: 0 rss: 27Mb L: 3/3 MS: 5 ChangeBit-ChangeByte-ChangeByte-CopyPart-InsertByte-#10     NEW    cov: 16 ft: 32 corp: 4/10b lim: 4 exec/s: 0 rss: 27Mb L: 4/4 MS: 1 CrossOver-#25     NEW    cov: 18 ft: 34 corp: 5/11b lim: 4 exec/s: 0 rss: 27Mb L: 1/4 MS: 5 ChangeBit-ChangeASCIIInt-CMP-CrossOver-EraseBytes- DE: &quot;\\x01\\x00&quot;-#94     NEW    cov: 19 ft: 35 corp: 6/15b lim: 4 exec/s: 0 rss: 27Mb L: 4/4 MS: 4 CrossOver-ShuffleBytes-ChangeByte-ChangeBit-#108    NEW    cov: 21 ft: 37 corp: 7/16b lim: 4 exec/s: 0 rss: 27Mb L: 1/4 MS: 4 ChangeByte-ShuffleBytes-ChangeBit-ChangeByte-#125    NEW    cov: 22 ft: 38 corp: 8/18b lim: 4 exec/s: 0 rss: 27Mb L: 2/4 MS: 2 ShuffleBytes-InsertByte-...==3237059==ABORTINGMS: 2 InsertRepeatedBytes-ChangeByte-; base unit: 1bef8aac927d18852642a96c20e50efba80fdfae0x5c,0x5,0x98,0x98,0x98,0x98,0x98,0x98,0x98,0x98,0x98,0x98,0x98,0x5c,0x2e,\\\\\\x05\\x98\\x98\\x98\\x98\\x98\\x98\\x98\\x98\\x98\\x98\\x98\\\\.artifact_prefix=&#x27;./&#x27;; Test unit written to ./crash-157768d6f06d94325fe0e6bcf66cbd2d27dd8db7Base64: XAWYmJiYmJiYmJiYmFwuroot@server:~/fuzz/cares$ ls -altotal 2244drwxrwxr-x 4 root root    4096 Sep 26 17:47 .drwxrwxr-x 5 root root    4096 Sep 26 15:25 ..drwxrwxr-x 9 root root   20480 Sep 26 17:18 BUILD-rw-rw-r-- 1 root root     722 Sep 26 17:13 build.sh-rwxrwxr-x 1 root root 2250720 Sep 26 17:18 cares_fuzzerdrwxrwxr-x 2 root root    4096 Sep 26 17:47 corpus-rw-rw-r-- 1 root root      15 Sep 26 17:47 crash-157768d6f06d94325fe0e6bcf66cbd2d27dd8db7-rw-rw-r-- 1 root root     499 Sep 26 17:14 target.ccroot@server:~/fuzz/cares$ ls corpus/08534f33c201a45017b502e90a800f1b708ebcb3  5175b74bd75b8d90a01f77709deba3982fbbdcb2  78bdce51613f555049a9937095bf469bcb77e94f  be566cb17d3bce0b2a8e5e710b3779df720db1f50f1c5448bf80343eeac759f8adcbdc2720533d15  5318c4ac20dac95a702bee2e27834d39ea6bc2b6  8e54ed049741d7cf6fb8ef7f4288ef0be3b54f17  be5c29e07560abcf094c3419712a01590bbe85940fe509b10d833be6eb3d5ed4947cbe0fbb64ed84  5ba93c9db0cff93f52b521d7420e43f6eda2784f  8ea51a3719d7cbfc3e2dcd3edf6109918d5aad55  caea31b9ef76b9be352ad1054956efbb86d4451a1bef8aac927d18852642a96c20e50efba80fdfae  60321f72401b49b895535045eb8d3b9ca7db7c7c  91a3f7c503955600f5dac12c1c1a3c5b674a4d98  dea712be0e801f4502a21e04dfbec5bd0cbc677c24792aa3923c4cd185519d3d445ecfd0801db1c1  6380a9a2d2701df0cb53d880842747cbefef8a5d  9f64357cb30f24cf567513e140e9fb0cbf1a2be5  e716589d09e16cf4a48d2c7f1d357bb481aaf3bc3a52ce780950d4d969792a2559cd519d7ee8c727  6414bd7955e39106721edf7cc29efdb82f7007ac  b534844fd943d8b338025ad82d68283f1bcdb5c0\n\n6. 合并语料  当 Fuzz 执行很久之后，会产生大量语料。为了减少语料数量，可以使用 merge 参数进行合并。创建一个 min_corpus 目录，执行 Fuzz 时，启动 merge 参数，传入 min_corpus 目录和 corpus 目录，合并完后，可以在 min_corpus 目录下看到缩减之后的语料。以下示例显示预料数据从 31 个减少到 29 个：\n1234567891011121314151617181920212223root@server:~/fuzz/cares$ mkdir min_corpusroot@server:~/fuzz/cares$ ./cares_fuzzer -merge=1 min_corpus/ corpus/INFO: Seed: 1671146211INFO: Loaded 1 modules   (57 inline 8-bit counters): 57 [0x5a9100, 0x5a9139),INFO: Loaded 1 PC tables (57 PCs): 57 [0x5a9140,0x5a94d0),MERGE-OUTER: 31 files, 0 in the initial corpus, 0 processed earlierMERGE-OUTER: attempt 1INFO: Seed: 1671165588INFO: Loaded 1 modules   (57 inline 8-bit counters): 57 [0x5a9100, 0x5a9139),INFO: Loaded 1 PC tables (57 PCs): 57 [0x5a9140,0x5a94d0),INFO: -max_len is not provided; libFuzzer will not generate inputs larger than 1048576 bytesMERGE-INNER: using the control file &#x27;/tmp/libFuzzerTemp.3327149.txt&#x27;MERGE-INNER: 31 total files; 0 processed earlier; will process 31 files now#1      pulse  cov: 9 ft: 10 exec/s: 0 rss: 27Mb#2      pulse  cov: 13 ft: 14 exec/s: 0 rss: 27Mb#4      pulse  cov: 20 ft: 22 exec/s: 0 rss: 27Mb#8      pulse  cov: 28 ft: 38 exec/s: 0 rss: 27Mb#16     pulse  cov: 29 ft: 56 exec/s: 0 rss: 27Mb#31     DONE   cov: 29 ft: 82 exec/s: 0 rss: 28MbMERGE-OUTER: succesfull in 1 attempt(s)MERGE-OUTER: the control file has 2691 bytesMERGE-OUTER: consumed 0Mb (27Mb rss) to parse the control fileMERGE-OUTER: 29 new files with 82 new features added; 29 new coverage edges\n\n三、优化技巧  整体优化思路分两种：\n\n找到 crash 更快 –&gt; 并行化，多个实例一起运行\n覆盖 edge 更多 –&gt; 加强语料，让输入能走到更深的分支\n\n（一）并行化1、LibFuzzer(1) jobs 和 workers\n\njobs：指定 fuzz 实例的数量。在不设置运行时长的情况下，每个 fuzz 实例找到 crash 才会停止。理论上有多少 jobs，最后会产生多少个 crash 文件。但实际上，不同的 job 可能找到同样的 crash，最后 crash 文件个数少于 job 个数。\nworks：执行 fuzz 进程的数量。在多个 jobs 的情况下，平均每个 woker 执行 #jobs&#x2F;#workers 个 job。\n\n简单来说，使用 workers 能提升 fuzz 运行速度，使用 jobs 能增加 crash 数量（仅根据输入去重，没有对调用栈去重）。 只使用 jobs 的情况下，默认开启 min(#jobs, #cores) &#x2F;&#x2F; 2 个 workers。\n(2) fork\n目前 fork 是实验阶段的参数，计划最终使用 fork 代替 jobs 和 workers 来实现 LibFuzzer 的并行化。\n\nfork：父进程不直接执行 fuzz，而是开启 N 个子进程，每个子进程使用语料库的随机子集进行 fuzz，当子进程退出后，该子进程的语料将被合并到主语料库中。子进程可以通过设置参数，来实现对指定错误的容错能力：\n\n-ignore_ooms：默认为 True。子进程发生内存溢出时，保存输入用于重现，但 fuzz 继续执行。\n\n-ignore_timeouts：默认为 True。子进程发生超时时，保留输入用于重现，但 fuzz 继续执行。\n\n-ignore_crashes：默认为 False。子进程发生其他类型 crash 时，保留输入用于重现，但 fuzz 继续执行。\n\n\n2、LibFuzzer 结合 AFLAFL 可以支持 LibFuzzer 的 target，编译方法参考  此处说明。\n12afl-fuzz -i testcase_dir -o findings_dir ./fuzz-target @@ ./fuzz-target testcase_dir findings_dir # Will write new tests to testcase_dir\n\n需要定期重启 AFL 和 LibFuzzer，以完成语料同步。\n（二）加强语料 1、字典 运行时使用 -dict 参数指定字典（Dictionary）文件的路径，字典用于指定和控制模糊测试中输入数据的一部分，从而提高模糊测试的效果。\n字典文件：\n12345678910# Lines starting with &#x27;#&#x27; and empty lines are ignored.# Adds &quot;blah&quot; (w/o quotes) to the dictionary.kw1=&quot;blah&quot;# Use \\\\ for backslash and \\&quot; for quotes.kw2=&quot;\\&quot;ac\\\\dc\\&quot;&quot;# Use \\xAB for hex valueskw3=&quot;\\xF7\\xF8&quot;# the name of the keyword followed by &#x27;=&#x27; may be omitted:&quot;foo\\x0Abar&quot;\n\n使用方法（运行时）：\n1./fuzz-target -dict=dict_file\n\n2、CMP编译时使用 -fsanitize-coverage&#x3D;trace-cmp 参数，让 fuzz 拦截 CMP 指令（例如 if 语句中的 compare 条件）并根据拦截到的 CMP 指令的参数来引导变异。这可能会减慢模糊测试的速度，但很可能会改善测试结果。\n使用方法（编译时）：\n1clang++ buggy.cc -fsanitize=fuzzer,address -fsanitize-coverage=trace-cmp -g -o buggy-fuzzer\n\n3、Value Profile需要与 -fsanitize-coverage=trace-cmp 一起使用，让 fuzz 收集 CMP 指令的参数值进行分析，用于发现更多的有效输入。但是有两个缺点：首先可能会导致速度降低 2 倍。 其次语料库可能增长数倍。\n使用方法（运行时）：\n1./fuzz-target -use_value_profile=1\n\n4、Fuzzer-friendly build mode程序中可能存在某些对 fuzz 不友好的特性，例如：\n\n随机化：同一个输入，可能走不同的路径\n校验和：拦截无效输入\n\n此时可以用构建宏 FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION 来编译一个对 fuzz 友好的版本，使用时需要对源码进行修改。例如：\n12345678void MyInitPRNG() &#123;#ifdef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION  // In fuzzing mode the behavior of the code should be deterministic.  srand(0);#else  srand(time(0));#endif&#125;\n\n四、 参考资料\nlibFuzzer – a library for coverage-guided fuzz testing\nlibFuzzer 使用总结教程\nEfficient Fuzzing Guide\nThe art of fuzzing-A Step-by-Step Guide to Coverage-Guided Fuzzing with LibFuzzer\nAn introduction to LLVM libFuzzer\nAn informative guide on using AFL and libFuzzer\nlibfuzzer-workshop\nSanitizers\nThe Magic Behind Feedback-Based Fuzzing\n","dateCreated":"2023-09-17T18:30:15+08:00","dateModified":"2024-06-26T14:24:54+08:00","datePublished":"2023-09-17T18:30:15+08:00","description":"模糊测试工具 LibFuzzer 从 0 到 1，原理 + 安装 + 使用 + 优化，一篇讲完","headline":"LibFuzzer 使用说明","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2023/LibFuzzer%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2023/LibFuzzer%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E/","keywords":"Fuzz, 安全, 工具, LibFuzzer"}</script>
+    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n按照  官方定义，LibFuzzer 是一个in-process（进程内的），coverage-guided（以覆盖率为引导的），evolutionary（进化的） 的 fuzz 引擎，是 LLVM 项目的一部分，主要用于对 C&#x2F;C++ 程序进行 Fuzz 测试。LibFuzzer 三个特性的具体含义为：\n\nin-process：不会为每个测试用例启动一个进程，而是将所有的测试数据投放在同一个进程的内存空间中\n\ncoverage-guided：对每一个测试输入都进行代码覆盖率计算，不断累积测试用例使得代码覆盖率最大化\n\nevolutionary：结合了变异和生成两种形势的 Fuzz 引擎\n\n变异：基于已有的数据样本，通过一些变异规则，产生新的测试用例\n\n生成：通过对目标协议或接口规范进行建模，从零开始产生测试用例\n\n\n\n\nLibFuzzer 与待测的 library 进行链接，通过向指定的 fuzzing 入口（即target 函数）发送测试数据，并跟踪被触达的代码区域，然后对输入的数据进行变异，以达到代码覆盖率最大的目的，其中代码覆盖率的信息由 LLVM 的 SanitizerCoverage 工具提供。\n一、使用方法 1. 安装环境Clang 是一个类似 GCC 的 C&#x2F;C++ 语言编译工具，此处 简介。LibFuzzer 现在已被集成到 Clang 6.0 之后的版本中，在 Linux 环境下，只需直接安装 Clang 即可：\n1apt install clang\n\n安装完毕之后，可以通过如下命令查看 clang 版本：\n1clang --version\n\n2. 构建 target使用 LibFuzzer 时，第一步就是要实现 target 函数——LLVMFuzzerTestOneInput，该函数以 bytes 数组作为输入，函数体内使用待测 API 对这个 bytes 数组进行处理：\n12345// fuzz_target.ccextern &quot;C&quot; int LLVMFuzzerTestOneInput(const uint8_t *Data, size_t Size) &#123;  DoSomethingInterestingWithMyAPI(Data, Size);  return 0;  // Values other than 0 and -1 are reserved for future use.&#125;\n\ntarget 函数的名称、参数类型、返回值类型都不能改变。此外，官方文档中还有如下说明：\n\ntarget 函数在同一个进程中被多次执行，被不同的输入循环调用；\n\ntarget 函数需要容忍任何形势的输入，比如空数据、很长的数据、格式错误的数据等；\n\ntarget 函数不允许调用 exit 函数，否则将导致 Fuzz 终止执行；\n\ntarget 函数中可以使用线程，但是子线程要在函数体结束前 join，即进入下一次循环前，结束上一次循环的子线程；\n\ntarget 函数的结果必须是确定性的，即两次的 Data 如果一致，两次的执行结果也必须一致；\n\ntarget 函数执行速度必须快，避免三阶及以上的复杂度、日志记录和过多的内存消耗；\n\ntarget 函数应尽量避免修改全局状态，因为在同一个进程中修改全局变量，会导致下一次运行与上一次运行的上下文不同，可能影响程序确定性；\n\ntarget 函数的处理范围越窄越好，如果函数要处理多种数据格式，那最好拆分成多个子函数，每个子函数处理一种格式。\n\n\ntarget 函数编写完成后，通过以下命令编译成可执行文件：\n1234clang -g -O1 -fsanitize=fuzzer                         fuzz_target.cc # Builds the fuzz target w/o sanitizersclang -g -O1 -fsanitize=fuzzer,address                 fuzz_target.cc # Builds the fuzz target with ASANclang -g -O1 -fsanitize=fuzzer,signed-integer-overflow fuzz_target.cc # Builds the fuzz target with a part of UBSANclang -g -O1 -fsanitize=fuzzer,memory                  fuzz_target.cc # Builds the fuzz target with MSAN\n\nClang 支持的编译选项可以  参考文档  或者通过–help 查看，构建 LibFuzzer target 时常用的  编译选项  如下：\n\n-g：生成调试信息\n\n-O：设置编译器优化等级，可以是 1&#x2F;2&#x2F;3，默认为 1，数字越大，优化越多，注意2 和 3 有可能导致 Fuzz 找不到 crash\n\n-o：指定输出文件名\n\n-I：uppercase i，添加头文件搜索路径\n\n-L：添加库文件搜索路径\n\n-l：lowercase L，指定库文件名称，动态库和静态库同时存在时，动态库优先\n\n-fsanitize：启用 LibFuzzer，对源码进行插桩，并添加各种  消毒器 sanitizer，对程序进行运行时检查。\n\n-fsanitize&#x3D;fuzzer  编译时对源码插桩，链接 libFuzzer 库文件（使用 libFuzzer 的 main 函数）\n\n-fsanitize&#x3D;fuzzer-no-link  编译时对源码插桩，不链接 libFuzzer，适用于拥有 main 函数的源码。对大型项目来说，构建效率更高\n\n-fsanitize&#x3D;address  地址消毒器（AddressSanitizer），用于检测缓冲区溢出、UAF、Double Free、内存泄漏等内存问题\n\n-fsanitize&#x3D;memory  内存消毒器（MemorySanitizer），用于检测未初始化的内存访问\n\n-fsanitize&#x3D;undefined  未定义行为消毒器（UndefinedBehaviorSanitizer），用于检测程序运行中未定义行为，如越界访问、整数溢出、空指针解引用等\n\n\n\n-fsanitize-coverage：启用代码覆盖率的统计，包括 function 级别，basic block 级别和 edge 级别，详情可  参考文档 。但需要注意的是， 高版本的 clang 中，已经取消了对 -fsanitize-coverage&#x3D;trace-pc-guard 的支持，建议改用 -fsanitize&#x3D;fuzzer 替代，否则会出现报错，参见第二章节使用示例。\n\n-fsanitize-coverage&#x3D;trace-pc-guard,edge  使用 edge 级别代码覆盖率，edge 为默认级别，可省略\n\n-fsanitize-coverage&#x3D;trace-pc-guard,func  使用 function 级别代码覆盖率\n\n-fsanitize-coverage&#x3D;trace-pc-guard,bb  使用 basic block 级别代码覆盖率\n\n\n\n\n关于添加 LibFuzzer 相关选项后的详细构建过程，有兴趣可以参考libFuzzer 编译链接。\n关于 LibFuzzer 通过插桩统计代码覆盖率的具体实现，有兴趣可以参考Coverage Control in libFuzzer。\n3. 执行 fuzz在 target 函数构建成功后，会生成一个可执行的 fuzz 二进制文件，该文件通过命令行方式执行，可以接受指定的参数选项。执行格式为：\n1./fuzz-target -flag1=val1 -flag2=val2 ... path1 path2 ...\n\n在不限制运行时长的情况下，Fuzz 将会一直执行下去，直到出现 crash（通常是因为触发 sanitizer 异常）才会终止。导致 crash 的输入将会作为能触发 bug 的 testcase 保存到磁盘上，并根据 crash 的类型，用不同的文件名前缀进行区分，比如 crash-XXX，leak-XXX，timeout-XXX 等。\n(1) 参数说明  常见的 flag 选项及作用列举如下，使用 flag 时必须以 -flag&#x3D;val 的格式：\n\n\n\nflag\n默认值\n作用\n\n\n\nverbosity\n1\n运行时输出详细日志\n\n\nseed\n0\n随机种子。如果为 0，则自动生成随机种子\n\n\nruns\n-1\n测试运行的次数（-1 表示无限）\n\n\nmax_len\n0\n测试输入的最大长度。若为 0，libFuzzer 会自行猜测\n\n\nshuffle\n1\n为 1 表示启动时打乱初始语料库\n\n\nprefer_small\n1\n为 1 表示打乱语料库时，较小输入更优先\n\n\ntimeout\n1200\n超时时长，单位为秒。如果单次运行超过时长，Fuzz 将被终止\n\n\nmax_total_time\n0\n最大运行时长，单位为秒。若为正，表示 Fuzz 最长运行时间\n\n\nhelp\n0\n为 1 表示打印帮助信息\n\n\nmerge\n0\n为 1 表示在不损失代码覆盖率的情况下，进行语料库合并\n\n\nmerge_control_file\n0\n指定合并进程的控制文件，用于恢复合并状态\n\n\nminimize_crash\n0\n为 1 表示将提供的崩溃输入进行最小化。与 -runs &#x3D; N 或 -max_total_time &#x3D; N 一起使用以限制尝试次数\n\n\njobs\n0\njob 的数量，多个 job 将被分配到 workers 上执行，每个 job 的 stdout&#x2F;stderr 被重定向到 fuzz-&lt;JOB&gt;.log\n\n\nworkers\n0\nworker 的数量，为 0 将使用 min(jobs, number_of_cpu_cores&#x2F;2)\n\n\nreload\n1\n设置重新加载主语料库的间隔秒数。在并行模式下，在多个 job 中同步语料集。为 0 表示禁止\n\n\nreduce_inputs\n1\n为 1 表示尝试减少输入数据的大小，同时保留其完整的特征集\n\n\nrss_limit_mb\n2048\nRSS 内存用量限制，单位为 Mb。为 0 表示无限制\n\n\npurge_allocator_interval\n1\n清理缓存的建个时长，单位为秒。当指定 rss_limit_mb 且 rss 使用率超过 50% 时，开始清理。为 -1 表示禁止\n\n\nmalloc_limit_mb\n0\n单次 malloc 申请内存的大小限制，单位为 Mb。为 0 则采用 rss_limit_mb 进行限制\n\n\ndetect_leaks\n1\n为 1，且启用 LeakSanitizer 消毒器时，将在 Fuzz 过程中检测内存泄漏，而不仅是在 Fuzz 结束时才检测\n\n\nprint_coverage\n0\n退出时打印覆盖率信息\n\n\nprint_corpus_stats\n0\n退出时打印语料信息\n\n\nprint_final_stats\n0\n退出时打印统计信息\n\n\nonly_ascii\n0\n为 1 表示只生成 ASCII（isprint + isspace）字符作为输入\n\n\nartifact_prefix\n0\n将 fuzzing artifacts（crash、timeout 等 file）保存为文件时所使用的前缀，即文件将保存为 $(artifact_prefix)file\n\n\nexact_artifact_path\n0\n将单个 fuzz artfifact 保存为文件时所使用的前缀。将覆盖 -artifact_prefix，并行任务中不要使用相同取值\n\n\n(2) 语料使用  模糊测试通过随机的方式变异或生成测试用例。提供种子语料库作为随机变异的基础用例，避免从头开始生完全随机地生成用例，在待测函数接受复杂或结构化输入的情况下，能显著提升 Fuzz 测试的效率和覆盖率。\nLibFuzzer 是以覆盖率为引导的，当提供种子语料库时，LibFuzzer 从语料库中读取语料，通过随机变异产生新的测试数据，输入到 Fuzz Target。由于在构建 Fuzz Target 时，通过编译参数进行了代码插桩，因此可以跟踪 Fuzz Target 在接收到输入后，具体执行了哪些代码。如果某个测试输入能执行到之前从未执行的代码，那么这个测试输入就是一个有效变异，将被纳入到语料库，作为后续变异的基础。整体流程大致如下，仅做原理示意，不等于具体实现。\ngraph LR\n    A[从语料库中读取样本] --> B[随机变异生成新样本]\n    B --> C[新样本输入 Fuzz Target]\n    C --> D[跟踪代码执行路径]\n    D --> E{是否覆盖新的代码}\n    E -->| 是 | F[测试数据加入语料库]\n    E -->| 否 | B\n    F --> A\n\n使用 corpus 时，需要提供一个或多个存放种子语料的路径，命令为：\n1./fuzz_target -max_len=1000 -jobs=20 corpus_dir  # 种子语料存放在 corpus_dir 目录下\n\n当语料库很大时，可以在保持代码覆盖率的情况下进行精简操作，这时需要用 -merge 参数，命令为：\n1./fuzz_target -merge=1 mini_corpus_dir corpus_dir  # 原始语料集存放在 corpus_dir 目录下，精简后的语料集存放在 mini_corpus_dir 目录下\n\n利用 -merge 参数，还可以实现有效语料的提取，即从一批候选语料中，找到能够触发新代码路径的语料，命令为：\n1./fuzz_target -merge=1 interesting_corpus_dir candidate_corpus_dir  # 候选语料放在 candidate_corpus_dir，有效语料放在 interesting_corpus_dir\n\n总的来说，语料集的路径可以有一个、两个或更多，当使用 -merge 参数时，这些语料集中发现的有效语料，都会被保存到第一个路径下。需要注意的是，合并语料是一个非常耗时的过程，通过使用 -merge_control_file 参数，可以实现无缝恢复的多阶段合并，即通过 killall -SIGUSR1 /path/to/fuzzer/binary 中断合并操作后，下次还能继续上一次的合并进度，继续开始合并操作。示例如下：\n123456789101112131415% rm -f SomeLocalPath% ./my_fuzzer CORPUS1 CORPUS2 -merge=1 -merge_control_file=SomeLocalPath...MERGE-INNER: using the control file &#x27;SomeLocalPath&#x27;...# While this is running, do `killall -SIGUSR1 my_fuzzer` in another console==9015== INFO: libFuzzer: exiting as requested# This will leave the file SomeLocalPath with the partial state of the merge.# Now, you can continue the merge by executing the same command. The merge will continue from where it has been interrupted.% ./my_fuzzer CORPUS1 CORPUS2 -merge=1 -merge_control_file=SomeLocalPath...MERGE-OUTER: non-empty control file provided: &#x27;SomeLocalPath&#x27;MERGE-OUTER: control file ok, 32 files total, first not processed file 20...\n\n语料库除了用于提高 Fuzz 效率，还可用于回归测试。在回归测试和复现 crash 时，还可以具体指定某一个 testcase，命令为：\n1./fuzz_target testcase_path  # testcase_path 就是 fuzz crash 时保存的 testcase file 的文件路径\n\n4. 输出解读  在 Fuzz 执行过程中，标准错误流 stderr 中，通常会输出以下格式的内容：\n12345678910111213INFO: Seed: 1523017872INFO: Loaded 1 modules (16 guards): [0x744e60, 0x744ea0),INFO: -max_len is not provided, using 64INFO: A corpus is not provided, starting from an empty corpus#0    READ units: 1#1    INITED cov: 3 ft: 2 corp: 1/1b exec/s: 0 rss: 24Mb#3811 NEW    cov: 4 ft: 3 corp: 2/2b exec/s: 0 rss: 25Mb L: 1 MS: 5 ChangeBit-ChangeByte-ChangeBit-ShuffleBytes-ChangeByte-#3827 NEW    cov: 5 ft: 4 corp: 3/4b exec/s: 0 rss: 25Mb L: 2 MS: 1 CopyPart-#3963 NEW    cov: 6 ft: 5 corp: 4/6b exec/s: 0 rss: 25Mb L: 2 MS: 2 ShuffleBytes-ChangeBit-#4167 NEW    cov: 7 ft: 6 corp: 5/9b exec/s: 0 rss: 25Mb L: 3 MS: 1 InsertByte-==31511== ERROR: libFuzzer: deadly signal...artifact_prefix=&#x27;./&#x27;; Test unit written to ./crash-b13e8756b13a00cf168300179061fb4b91fefbed\n\n第一行显示 Fuzz 测试使用的随机种子，可以通过 -seed 参数来设置。\n第二行显示插桩后的 PC guards 数量（PC 指 Program Counter），可理解为 Fuzz 识别出来的 edge 总数，参考  此处脚注说明。\n第三行显示输入数据的长度限制，示例中 -max_len 参数没有设置，Fuzz 程序将 -max_len 定为 64，即最大数据长度不超过 64kb。\n第四行显示语料库信息，示例中没有提供 corpus，Fuzz 程序从头开始生成语料。\n第五行到第十行，每行开头的 #N 表示 Fuzz 已执行了 N 次测试输入，后面的内容为测试过程中的事件代码和统计信息：\n\n\n\n事件代码\n含义\n\n\n\nREAD\nFuzz 已从语料库中读取所有初始输入样本\n\n\nINITED\nFuzz 已完成初始化，包括通过被测代码运行每个初始输入样本\n\n\nNEW\nFuzz 生成了一个测试输入样本，它能触发被测代码的新路径，将被保存到主语料库目录\n\n\nREDUCE\nFuzz 找到了一个更好的输入样本，它能保持原有样本的特征集（参考下表 ft 含义），但是 size 更小\n\n\npulse\nFuzz 已生成 2 的 n 次方个输入（定期生成以使用户确信 Fuzz 仍在工作）\n\n\nDONE\nFuzz 已完成操作，因为它已达到指定的迭代限制（-runs）或时间限制（-max_total_time）\n\n\nRELOAD\nFuzz 正在定期重新加载语料库目录中的输入样本，这使它能够发现其他 Fuzz 进程发现的任何输入\n\n\n\n\n\n统计指标\n含义\n\n\n\ncov\n执行当前语料库所覆盖的 block 或 edge 的总数\n\n\nft\nLibFuzzer 使用不同的信号来评估代码覆盖率：边缘覆盖率、边缘计数器、间接调用者 &#x2F; 被调用者对等。这些信号组合起来称为特征\n\n\ncorp\n当前内存测试语料库中的条目数及其大小（单位为 byte）\n\n\nlim\n当前语料库中新样本的长度限制。 随着时间的推移而增加，直到达到最大长度 (-max_len)\n\n\nexec&#x2F;s\n每秒 Fuzz 执行次数\n\n\nrss\n当前内存消耗（单位为 Mb）\n\n\nL\n新样本的大小（单位为 byte）。只用于 NEW 和 REDUCE 事件\n\n\nMS: &lt;n&gt; &lt;operations&gt;\n生成新样本时的变异次数和变异方法。只用于 NEW 和 REDUCE 事件\n\n\n第十一行开始，显示 Fuzz 遇到 crash 并终止执行，导致 crash 的用例被保存为.&#x2F;crash-&lt;sha1&gt; 文件，保存路径和名称可以通过 -artifact_prefix 参数修改。\n二、使用示例  以CVE-2016-5180为例，演示 LibFuzzer 的使用过程。CVE-2016-5180是在 c-ares 中出现的堆溢出问题，是使得 ChromeOS 被攻击（重启后以访客模式执行代码）的漏洞之一。\n1. 下载源码  最新的 c-ares 代码已修复漏洞，为了复现漏洞，clone 代码后，需要恢复到漏洞修复之前。\n123git clone https://github.com/c-ares/c-ares.gitcd c-ares/git reset --hard 51fbb479f7948fca2ace3ff34a15ff27e796afdd\n\n2. 编写 Fuzz 主函数  实现 LLVMFuzzerTestOneInput 函数，将 LibFuzzer 输入的字节流进行转换，调用 ares_create_query 函数，并将代码保存为 target.cc 文件。\n1234567891011121314151617// Copyright 2016 Google Inc. All Rights Reserved.// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);#include &lt;stdint.h&gt;#include &lt;stdlib.h&gt;#include &lt;string&gt;#include &lt;arpa/nameser.h&gt;#include &lt;ares.h&gt;extern &quot;C&quot; int LLVMFuzzerTestOneInput(const uint8_t *Data, size_t Size) &#123;  unsigned char *buf;  int buflen;  std::string s(reinterpret_cast&lt;const char *&gt;(Data), Size);  ares_create_query(s.c_str(), ns_c_in, ns_t_a, 0x1234, 0, &amp;buf, &amp;buflen, 0);  free(buf);  return 0;&#125;\n\n3. 编译 Fuzz target使用 fuzzer-test-suite 提供的编译脚本，执行 build.sh 脚本，会自动调用 custom-build.sh 和 common.sh 进行编译。三个 shell 脚本和 Fuzz 函数的存放路径如下，脚本中会自动使用 git 拉取代码，这里将第 1 步手动拉取的代码删掉了：\n123456789root@server:~/fuzz$ tree.├── cares│   ├── build.sh│   └── target.cc├── common.sh└── custom-build.sh1 directory, 4 files\n\n注意需要将原始脚本中的 -fsanitize-coverage&#x3D;trace-pc-guard 替换为 -fsanitize&#x3D;fuzzer，否则执行 Fuzz 时会出现错误：-fsanitize-coverage&#x3D;trace-pc-guard is no longer supported by libFuzzer。\n1234root@server:~/fuzz$ ./cares-fsanitize_fuzzer-fsanitize-coverage=trace-pc-guard is no longer supported by libFuzzer.Please either migrate to a compiler that supports -fsanitize=fuzzeror use an older version of libFuzzer\n\n执行脚本进行编译（也可以自己编写命令进行编译，编译相关的内容之后会单独写文章进行说明）：\n1root@server:~/fuzz$ ./cares/build.sh\n\n编译完后，可以看到目录下多了一个二进制文件 cares-fsanitize_fuzzer，两个目录 BUILD 和 SRC。cares-fsanitize_fuzzer 是可执行的 Fuzz 程序，SRC 目录存放 c-ares 含漏洞的源码，BUILD 目录用于存放编译产生的中间文件和最终文件：\n12345678910root@server:~/fuzz$ tree -L 1.├── BUILD├── cares├── cares-fsanitize_fuzzer├── common.sh├── custom-build.sh└── SRC3 directories, 3 files\n\n4. 执行 Fuzz 测试  直接运行编译得到的二进制文件，如需附带参数，可参考第一章节执行 fuzz 的参数说明。\n123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778root@server:~/fuzz$ ./cares-fsanitize_fuzzerINFO: Seed: 817252946INFO: Loaded 1 modules   (10 inline 8-bit counters): 10 [0x5a90e0, 0x5a90ea),INFO: Loaded 1 PC tables (10 PCs): 10 [0x56c278,0x56c318),INFO: -max_len is not provided; libFuzzer will not generate inputs larger than 4096 bytesINFO: A corpus is not provided, starting from an empty corpus#2      INITED cov: 3 ft: 3 corp: 1/1b exec/s: 0 rss: 27Mb#3      NEW    cov: 4 ft: 4 corp: 2/5b lim: 4 exec/s: 0 rss: 27Mb L: 4/4 MS: 1 CrossOver-#10     REDUCE cov: 4 ft: 4 corp: 2/4b lim: 4 exec/s: 0 rss: 27Mb L: 3/3 MS: 2 ChangeByte-CrossOver-#11     REDUCE cov: 4 ft: 4 corp: 2/3b lim: 4 exec/s: 0 rss: 27Mb L: 2/2 MS: 1 EraseBytes-#1368   REDUCE cov: 6 ft: 6 corp: 3/20b lim: 17 exec/s: 0 rss: 27Mb L: 17/17 MS: 2 InsertByte-InsertRepeatedBytes-#1524   REDUCE cov: 6 ft: 6 corp: 3/19b lim: 17 exec/s: 0 rss: 27Mb L: 16/16 MS: 1 EraseBytes-===================================================================3049145==ERROR: AddressSanitizer: heap-buffer-overflow on address 0x6030012599c2 at pc 0x000000550e1c bp 0x7fffbad826d0 sp 0x7fffbad826c8WRITE of size 1 at 0x6030012599c2 thread T0    #0 0x550e1b in ares_create_query (/home/fuzz/cares-fsanitize_fuzzer+0x550e1b)    #1 0x55053c in LLVMFuzzerTestOneInput /home/fuzz/cares/target.cc:14:3    #2 0x4586a1 in fuzzer::Fuzzer::ExecuteCallback(unsigned char const*, unsigned long) (/home/fuzz/cares-fsanitize_fuzzer+0x4586a1)    #3 0x457de5 in fuzzer::Fuzzer::RunOne(unsigned char const*, unsigned long, bool, fuzzer::InputInfo*, bool*) (/home/fuzz/cares-fsanitize_fuzzer+0x457de5)    #4 0x45a087 in fuzzer::Fuzzer::MutateAndTestOne() (/home/fuzz/cares-fsanitize_fuzzer+0x45a087)    #5 0x45ad85 in fuzzer::Fuzzer::Loop(std::__Fuzzer::vector&lt;fuzzer::SizedFile, fuzzer::fuzzer_allocator&lt;fuzzer::SizedFile&gt; &gt;&amp;) (/home/fuzz/cares-fsanitize_fuzzer+0x45ad85)    #6 0x44973e in fuzzer::FuzzerDriver(int*, char***, int (*)(unsigned char const*, unsigned long)) (/home/fuzz/cares-fsanitize_fuzzer+0x44973e)    #7 0x472582 in main (/home/fuzz/cares-fsanitize_fuzzer+0x472582)    #8 0x7fd31481c082 in __libc_start_main (/lib/x86_64-linux-gnu/libc.so.6+0x24082)    #9 0x41e4dd in _start (/home/fuzz/cares-fsanitize_fuzzer+0x41e4dd)0x6030012599c2 is located 0 bytes to the right of 18-byte region [0x6030012599b0,0x6030012599c2)allocated by thread T0 here:    #0 0x51e20d in malloc (/home/fuzz/cares-fsanitize_fuzzer+0x51e20d)    #1 0x5508f6 in ares_create_query (/home/fuzz/cares-fsanitize_fuzzer+0x5508f6)    #2 0x55053c in LLVMFuzzerTestOneInput /home/fuzz/cares/target.cc:14:3    #3 0x4586a1 in fuzzer::Fuzzer::ExecuteCallback(unsigned char const*, unsigned long) (/home/fuzz/cares-fsanitize_fuzzer+0x4586a1)    #4 0x457de5 in fuzzer::Fuzzer::RunOne(unsigned char const*, unsigned long, bool, fuzzer::InputInfo*, bool*) (/home/fuzz/cares-fsanitize_fuzzer+0x457de5)    #5 0x45a087 in fuzzer::Fuzzer::MutateAndTestOne() (/home/fuzz/cares-fsanitize_fuzzer+0x45a087)    #6 0x45ad85 in fuzzer::Fuzzer::Loop(std::__Fuzzer::vector&lt;fuzzer::SizedFile, fuzzer::fuzzer_allocator&lt;fuzzer::SizedFile&gt; &gt;&amp;) (/home/fuzz/cares-fsanitize_fuzzer+0x45ad85)    #7 0x44973e in fuzzer::FuzzerDriver(int*, char***, int (*)(unsigned char const*, unsigned long)) (/home/fuzz/cares-fsanitize_fuzzer+0x44973e)    #8 0x472582 in main (/home/fuzz/cares-fsanitize_fuzzer+0x472582)    #9 0x7fd31481c082 in __libc_start_main (/lib/x86_64-linux-gnu/libc.so.6+0x24082)SUMMARY: AddressSanitizer: heap-buffer-overflow (/home/fuzz/cares-fsanitize_fuzzer+0x550e1b) in ares_create_queryShadow bytes around the buggy address:  0x0c06802432e0: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c06802432f0: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c0680243300: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c0680243310: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c0680243320: fa fa fa fa fa fa fa fa fa fa fd fd fd fa fa fa=&gt;0x0c0680243330: fd fd fd fa fa fa 00 00[02]fa fa fa fd fd fd fa  0x0c0680243340: fa fa fd fd fd fa fa fa fd fd fd fa fa fa fd fd  0x0c0680243350: fd fa fa fa fd fd fd fa fa fa fd fd fd fa fa fa  0x0c0680243360: fd fd fd fa fa fa fd fd fd fa fa fa fd fd fd fa  0x0c0680243370: fa fa fd fd fd fa fa fa fd fd fd fa fa fa fd fd  0x0c0680243380: fd fa fa fa fd fd fd fa fa fa fd fd fd fa fa faShadow byte legend (one shadow byte represents 8 application bytes):  Addressable:           00  Partially addressable: 01 02 03 04 05 06 07  Heap left redzone:       fa  Freed heap region:       fd  Stack left redzone:      f1  Stack mid redzone:       f2  Stack right redzone:     f3  Stack after return:      f5  Stack use after scope:   f8  Global redzone:          f9  Global init order:       f6  Poisoned by user:        f7  Container overflow:      fc  Array cookie:            ac  Intra object redzone:    bb  ASan internal:           fe  Left alloca redzone:     ca  Right alloca redzone:    cb  Shadow gap:              cc==3049145==ABORTINGMS: 4 ChangeByte-InsertByte-CopyPart-ChangeByte-; base unit: 00b28ff06b788b9b67c6b259800f404f9f3761fd0x5c,0x2e,0x0,0x6b,0x0,\\\\.\\x00k\\x00artifact_prefix=&#x27;./&#x27;; Test unit written to ./crash-edef708d314ed627eba0ef2b042e47aa96a9b899Base64: XC4AawA=\n\n可以看到，LibFuzzer 发现了 c-ares 中的 heap-buffer-overflow 漏洞，触发 crash 的用例保存为 crash-edef708d314ed627eba0ef2b042e47aa96a9b899 文件，该用例包含 5 个字节，字节码分别为：0x5c,0x2e,0x0,0x6b,0x0，其中 0x0 为空字符 NULL，属于不可见字符。\n5. 提取语料  执行 Fuzz 时，传入一个空文件夹作为 copus 路径，执行完后，可以在文件夹中看到 LibFuzzer 执行过程中，生成的有效语料。\n123456789101112131415161718192021222324252627282930313233343536373839404142root@server:~/fuzz/cares$ mkdir corpusroot@server:~/fuzz/cares$ lsBUILD  build.sh  cares_fuzzer  corpus  target.ccroot@server:~/fuzz/cares$ ./cares_fuzzer corpus/INFO: Seed: 4140748905INFO: Loaded 1 modules   (57 inline 8-bit counters): 57 [0x5a9100, 0x5a9139),INFO: Loaded 1 PC tables (57 PCs): 57 [0x5a9140,0x5a94d0),INFO:        0 files found in corpus/INFO: -max_len is not provided; libFuzzer will not generate inputs larger than 4096 bytesINFO: A corpus is not provided, starting from an empty corpus#2      INITED cov: 13 ft: 14 corp: 1/1b exec/s: 0 rss: 27Mb#4      NEW    cov: 16 ft: 20 corp: 2/3b lim: 4 exec/s: 0 rss: 27Mb L: 2/2 MS: 2 ChangeByte-InsertByte-#9      NEW    cov: 16 ft: 26 corp: 3/6b lim: 4 exec/s: 0 rss: 27Mb L: 3/3 MS: 5 ChangeBit-ChangeByte-ChangeByte-CopyPart-InsertByte-#10     NEW    cov: 16 ft: 32 corp: 4/10b lim: 4 exec/s: 0 rss: 27Mb L: 4/4 MS: 1 CrossOver-#25     NEW    cov: 18 ft: 34 corp: 5/11b lim: 4 exec/s: 0 rss: 27Mb L: 1/4 MS: 5 ChangeBit-ChangeASCIIInt-CMP-CrossOver-EraseBytes- DE: &quot;\\x01\\x00&quot;-#94     NEW    cov: 19 ft: 35 corp: 6/15b lim: 4 exec/s: 0 rss: 27Mb L: 4/4 MS: 4 CrossOver-ShuffleBytes-ChangeByte-ChangeBit-#108    NEW    cov: 21 ft: 37 corp: 7/16b lim: 4 exec/s: 0 rss: 27Mb L: 1/4 MS: 4 ChangeByte-ShuffleBytes-ChangeBit-ChangeByte-#125    NEW    cov: 22 ft: 38 corp: 8/18b lim: 4 exec/s: 0 rss: 27Mb L: 2/4 MS: 2 ShuffleBytes-InsertByte-...==3237059==ABORTINGMS: 2 InsertRepeatedBytes-ChangeByte-; base unit: 1bef8aac927d18852642a96c20e50efba80fdfae0x5c,0x5,0x98,0x98,0x98,0x98,0x98,0x98,0x98,0x98,0x98,0x98,0x98,0x5c,0x2e,\\\\\\x05\\x98\\x98\\x98\\x98\\x98\\x98\\x98\\x98\\x98\\x98\\x98\\\\.artifact_prefix=&#x27;./&#x27;; Test unit written to ./crash-157768d6f06d94325fe0e6bcf66cbd2d27dd8db7Base64: XAWYmJiYmJiYmJiYmFwuroot@server:~/fuzz/cares$ ls -altotal 2244drwxrwxr-x 4 root root    4096 Sep 26 17:47 .drwxrwxr-x 5 root root    4096 Sep 26 15:25 ..drwxrwxr-x 9 root root   20480 Sep 26 17:18 BUILD-rw-rw-r-- 1 root root     722 Sep 26 17:13 build.sh-rwxrwxr-x 1 root root 2250720 Sep 26 17:18 cares_fuzzerdrwxrwxr-x 2 root root    4096 Sep 26 17:47 corpus-rw-rw-r-- 1 root root      15 Sep 26 17:47 crash-157768d6f06d94325fe0e6bcf66cbd2d27dd8db7-rw-rw-r-- 1 root root     499 Sep 26 17:14 target.ccroot@server:~/fuzz/cares$ ls corpus/08534f33c201a45017b502e90a800f1b708ebcb3  5175b74bd75b8d90a01f77709deba3982fbbdcb2  78bdce51613f555049a9937095bf469bcb77e94f  be566cb17d3bce0b2a8e5e710b3779df720db1f50f1c5448bf80343eeac759f8adcbdc2720533d15  5318c4ac20dac95a702bee2e27834d39ea6bc2b6  8e54ed049741d7cf6fb8ef7f4288ef0be3b54f17  be5c29e07560abcf094c3419712a01590bbe85940fe509b10d833be6eb3d5ed4947cbe0fbb64ed84  5ba93c9db0cff93f52b521d7420e43f6eda2784f  8ea51a3719d7cbfc3e2dcd3edf6109918d5aad55  caea31b9ef76b9be352ad1054956efbb86d4451a1bef8aac927d18852642a96c20e50efba80fdfae  60321f72401b49b895535045eb8d3b9ca7db7c7c  91a3f7c503955600f5dac12c1c1a3c5b674a4d98  dea712be0e801f4502a21e04dfbec5bd0cbc677c24792aa3923c4cd185519d3d445ecfd0801db1c1  6380a9a2d2701df0cb53d880842747cbefef8a5d  9f64357cb30f24cf567513e140e9fb0cbf1a2be5  e716589d09e16cf4a48d2c7f1d357bb481aaf3bc3a52ce780950d4d969792a2559cd519d7ee8c727  6414bd7955e39106721edf7cc29efdb82f7007ac  b534844fd943d8b338025ad82d68283f1bcdb5c0\n\n6. 合并语料  当 Fuzz 执行很久之后，会产生大量语料。为了减少语料数量，可以使用 merge 参数进行合并。创建一个 min_corpus 目录，执行 Fuzz 时，启动 merge 参数，传入 min_corpus 目录和 corpus 目录，合并完后，可以在 min_corpus 目录下看到缩减之后的语料。以下示例显示预料数据从 31 个减少到 29 个：\n1234567891011121314151617181920212223root@server:~/fuzz/cares$ mkdir min_corpusroot@server:~/fuzz/cares$ ./cares_fuzzer -merge=1 min_corpus/ corpus/INFO: Seed: 1671146211INFO: Loaded 1 modules   (57 inline 8-bit counters): 57 [0x5a9100, 0x5a9139),INFO: Loaded 1 PC tables (57 PCs): 57 [0x5a9140,0x5a94d0),MERGE-OUTER: 31 files, 0 in the initial corpus, 0 processed earlierMERGE-OUTER: attempt 1INFO: Seed: 1671165588INFO: Loaded 1 modules   (57 inline 8-bit counters): 57 [0x5a9100, 0x5a9139),INFO: Loaded 1 PC tables (57 PCs): 57 [0x5a9140,0x5a94d0),INFO: -max_len is not provided; libFuzzer will not generate inputs larger than 1048576 bytesMERGE-INNER: using the control file &#x27;/tmp/libFuzzerTemp.3327149.txt&#x27;MERGE-INNER: 31 total files; 0 processed earlier; will process 31 files now#1      pulse  cov: 9 ft: 10 exec/s: 0 rss: 27Mb#2      pulse  cov: 13 ft: 14 exec/s: 0 rss: 27Mb#4      pulse  cov: 20 ft: 22 exec/s: 0 rss: 27Mb#8      pulse  cov: 28 ft: 38 exec/s: 0 rss: 27Mb#16     pulse  cov: 29 ft: 56 exec/s: 0 rss: 27Mb#31     DONE   cov: 29 ft: 82 exec/s: 0 rss: 28MbMERGE-OUTER: succesfull in 1 attempt(s)MERGE-OUTER: the control file has 2691 bytesMERGE-OUTER: consumed 0Mb (27Mb rss) to parse the control fileMERGE-OUTER: 29 new files with 82 new features added; 29 new coverage edges\n\n三、优化技巧  整体优化思路分两种：\n\n找到 crash 更快 –&gt; 并行化，多个实例一起运行\n覆盖 edge 更多 –&gt; 加强语料，让输入能走到更深的分支\n\n（一）并行化1、LibFuzzer(1) jobs 和 workers\n\njobs：指定 fuzz 实例的数量。在不设置运行时长的情况下，每个 fuzz 实例找到 crash 才会停止。理论上有多少 jobs，最后会产生多少个 crash 文件。但实际上，不同的 job 可能找到同样的 crash，最后 crash 文件个数少于 job 个数。\nworks：执行 fuzz 进程的数量。在多个 jobs 的情况下，平均每个 woker 执行 #jobs&#x2F;#workers 个 job。\n\n简单来说，使用 workers 能提升 fuzz 运行速度，使用 jobs 能增加 crash 数量（仅根据输入去重，没有对调用栈去重）。 只使用 jobs 的情况下，默认开启 min(#jobs, #cores) &#x2F;&#x2F; 2 个 workers。\n(2) fork\n目前 fork 是实验阶段的参数，计划最终使用 fork 代替 jobs 和 workers 来实现 LibFuzzer 的并行化。\n\nfork：父进程不直接执行 fuzz，而是开启 N 个子进程，每个子进程使用语料库的随机子集进行 fuzz，当子进程退出后，该子进程的语料将被合并到主语料库中。子进程可以通过设置参数，来实现对指定错误的容错能力：\n\n-ignore_ooms：默认为 True。子进程发生内存溢出时，保存输入用于重现，但 fuzz 继续执行。\n\n-ignore_timeouts：默认为 True。子进程发生超时时，保留输入用于重现，但 fuzz 继续执行。\n\n-ignore_crashes：默认为 False。子进程发生其他类型 crash 时，保留输入用于重现，但 fuzz 继续执行。\n\n\n2、LibFuzzer 结合 AFLAFL 可以支持 LibFuzzer 的 target，编译方法参考  此处说明。\n12afl-fuzz -i testcase_dir -o findings_dir ./fuzz-target @@ ./fuzz-target testcase_dir findings_dir # Will write new tests to testcase_dir\n\n需要定期重启 AFL 和 LibFuzzer，以完成语料同步。\n（二）加强语料 1、字典 运行时使用 -dict 参数指定字典（Dictionary）文件的路径，字典用于指定和控制模糊测试中输入数据的一部分，从而提高模糊测试的效果。\n字典文件：\n12345678910# Lines starting with &#x27;#&#x27; and empty lines are ignored.# Adds &quot;blah&quot; (w/o quotes) to the dictionary.kw1=&quot;blah&quot;# Use \\\\ for backslash and \\&quot; for quotes.kw2=&quot;\\&quot;ac\\\\dc\\&quot;&quot;# Use \\xAB for hex valueskw3=&quot;\\xF7\\xF8&quot;# the name of the keyword followed by &#x27;=&#x27; may be omitted:&quot;foo\\x0Abar&quot;\n\n使用方法（运行时）：\n1./fuzz-target -dict=dict_file\n\n2、CMP编译时使用 -fsanitize-coverage&#x3D;trace-cmp 参数，让 fuzz 拦截 CMP 指令（例如 if 语句中的 compare 条件）并根据拦截到的 CMP 指令的参数来引导变异。这可能会减慢模糊测试的速度，但很可能会改善测试结果。\n使用方法（编译时）：\n1clang++ buggy.cc -fsanitize=fuzzer,address -fsanitize-coverage=trace-cmp -g -o buggy-fuzzer\n\n3、Value Profile需要与 -fsanitize-coverage=trace-cmp 一起使用，让 fuzz 收集 CMP 指令的参数值进行分析，用于发现更多的有效输入。但是有两个缺点：首先可能会导致速度降低 2 倍。 其次语料库可能增长数倍。\n使用方法（运行时）：\n1./fuzz-target -use_value_profile=1\n\n4、Fuzzer-friendly build mode程序中可能存在某些对 fuzz 不友好的特性，例如：\n\n随机化：同一个输入，可能走不同的路径\n校验和：拦截无效输入\n\n此时可以用构建宏 FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION 来编译一个对 fuzz 友好的版本，使用时需要对源码进行修改。例如：\n12345678void MyInitPRNG() &#123;#ifdef FUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION  // In fuzzing mode the behavior of the code should be deterministic.  srand(0);#else  srand(time(0));#endif&#125;\n\n四、 参考资料\nlibFuzzer – a library for coverage-guided fuzz testing\nlibFuzzer 使用总结教程\nEfficient Fuzzing Guide\nThe art of fuzzing-A Step-by-Step Guide to Coverage-Guided Fuzzing with LibFuzzer\nAn introduction to LLVM libFuzzer\nAn informative guide on using AFL and libFuzzer\nlibfuzzer-workshop\nSanitizers\nThe Magic Behind Feedback-Based Fuzzing\n","dateCreated":"2023-09-17T18:30:15+08:00","dateModified":"2024-06-26T14:24:54+08:00","datePublished":"2023-09-17T18:30:15+08:00","description":"模糊测试工具 LibFuzzer 从 0 到 1，原理 + 安装 + 使用 + 优化，一篇讲完","headline":"LibFuzzer 使用说明","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2023/LibFuzzer%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2023/LibFuzzer%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E/","keywords":"安全, 工具, Fuzz, LibFuzzer"}</script>
     <meta name="description" content="模糊测试工具 LibFuzzer 从 0 到 1，原理 + 安装 + 使用 + 优化，一篇讲完">
 <meta property="og:type" content="blog">
 <meta property="og:title" content="LibFuzzer 使用说明">
@@ -25,9 +25,9 @@
 <meta property="article:published_time" content="2023-09-17T10:30:15.000Z">
 <meta property="article:modified_time" content="2024-06-26T06:24:54.052Z">
 <meta property="article:author" content="一瓢清浅">
-<meta property="article:tag" content="Fuzz">
 <meta property="article:tag" content="安全">
 <meta property="article:tag" content="工具">
+<meta property="article:tag" content="Fuzz">
 <meta property="article:tag" content="LibFuzzer">
 <meta name="twitter:card" content="summary">
     
diff --git "a/2023/LibFuzzer\347\274\226\350\257\221\346\214\207\345\215\227/index.html" "b/2023/LibFuzzer\347\274\226\350\257\221\346\214\207\345\215\227/index.html"
index 6229803..b53c631 100644
--- "a/2023/LibFuzzer\347\274\226\350\257\221\346\214\207\345\215\227/index.html"
+++ "b/2023/LibFuzzer\347\274\226\350\257\221\346\214\207\345\215\227/index.html"
@@ -14,7 +14,7 @@
     
     
     
-    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n使用 LibFuzzer 时，编译 fuzz target 是需要使用者自己执行的重要步骤。在编译时，通过编译选项添加消毒器，链接 LibFuzzer 静态库，得到可执行的 fuzz target。\n本文针对 LibFuzzer Target 编译进行说明。\n一、使用开源脚本 fuzzer-test-suite 是 Google 开源的一个 Fuzz 基准测试集，包含 Fuzz（LibFuzzer 和 AFL）测试的多个 benchmark。这些 benchmark 都来自真实案例，涉及到图像处理、SQL 注入、JSON 解析等多个领域。\n以 c-ares-CVE 为例，编译主要用到以下三个 sh 脚本，以及实现了 LLVMFuzzerTestOneInput 的 cc 源码文件：\n123456fuzzer-test-suite│  common.sh│  custom-build.sh├─c-ares-CVE-2016-5180│      build.sh│      target.cc\n\n1. 编译过程  编译入口为 build.sh 文件，其代码如下：\n1234567891011121314151617181920#!/bin/bash# Copyright 2016 Google Inc. All Rights Reserved.# Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);. $(dirname $0)/../custom-build.sh $1 $2. $(dirname $0)/../common.shbuild_lib() &#123;  rm -rf BUILD  cp -rf SRC BUILD  (cd BUILD &amp;&amp; ./buildconf &amp;&amp; ./configure --disable-shared &amp;&amp; make -j $JOBS)&#125;get_git_revision https://github.com/c-ares/c-ares.git 51fbb479f7948fca2ace3ff34a15ff27e796afdd SRCbuild_libbuild_fuzzerif [[$FUZZING_ENGINE == &quot;hooks&quot;]]; then  # Link ASan runtime so we can hook memcmp et al.  LIB_FUZZING_ENGINE=&quot;$LIB_FUZZING_ENGINE -fsanitize=address&quot;fi$CXX $CXXFLAGS $SCRIPT_DIR/target.cc -I BUILD BUILD/.libs/libcares.a $LIB_FUZZING_ENGINE -o $EXECUTABLE_NAME_BASE\n\n执行 build.sh 时，首先依次调用外层的 custom-build.sh 和common.sh，然后执行如下步骤：\n\nget_git_revision：定义在 common.sh 中，拉取有漏洞的代码\n\nbuild_lib：将拉取的代码编译成静态库文件 libcares.a，注意--disable-shared 参数指定编译静态库文件，否则编译动态库文件\n\nbuild_fuzzer：定义在 common.sh 中，编译 Fuzz 引擎源码（如果使用 LibFuzzer，则编译 LibFuzzer 源码，得到libFuzzer.a）\n\n\\$CXX \\$CXXFLAGS \\$SCRIPT_DIR/target.cc：编译 target.cc 文件，链接 libcares.a 和libFuzzer.a，得到可执行的 fuzz target\n\n\n在整个编译过程中，需要重点关注的是  编译选项的设置  和静态库的链接。\n2. 编译选项  在build_lib中编译待测源码时，使用的是 configure-make 工具，该工具广泛用于 Linux 环境中编写的 C&#x2F;C++ 程序的编译（近年来开始使用 cmake 工具），主要包含两个步骤：\n\nconfigure对编译过程进行配置，通过参数和环境变量控制编译，生成 makefile\nmake从 makefile 中读取命令并执行编译，生成二进制文件\n\n通过 ./configure -h 可以查看编译参数和环境变量的含义，脚本中用到的参数和环境变量列举如下：\n\n\n\n参数\n含义\n\n\n\n–enable-shared\n编译动态库文件（默认 yes）\n\n\n–enable-static\n编译静态库文件（默认 yes）\n\n\n–disable-shared\n不编译动态库文件\n\n\n–disable-static\n不编译静态库文件\n\n\n\n\n\n环境变量\n含义\n\n\n\nCC\nC 编译程序\n\n\nCXX\nC++ 编译程序\n\n\nCFLAGS\nC 编译程序的命令行参数\n\n\nCXXFLAGS\nC++ 编译程序的命令行参数\n\n\n在执行 build_lib 时，设置了 --disable-shared 参数，指定将待测源码编译成静态库文件。在 custom-build.sh 和common.sh中，设置了如下环境变量：\n\ncustom-build.sh\n\nasan 模式\n123export FUZZING_ENGINE=libfuzzerexport CFLAGS=&quot;-O2 -fno-omit-frame-pointer -gline-tables-only -fsanitize=address -fsanitize-address-use-after-scope -fsanitize-coverage=trace-pc-guard,trace-cmp,trace-gep,trace-div&quot;export CXXFLAGS=&quot;$&#123;CFLAGS&#125;&quot;\n\nubsan 模式\n123export FUZZING_ENGINE=libfuzzerexport CFLAGS=&quot;-O2 -fno-omit-frame-pointer -gline-tables-only -fsanitize=undefined -fsanitize-coverage=trace-pc-guard,trace-cmp,trace-gep,trace-div&quot;export CXXFLAGS=&quot;$&#123;CFLAGS&#125;&quot;\n\n默认模式\n12FUZZING_ENGINE=$&#123;FUZZING_ENGINE:-&quot;fsanitize_fuzzer&quot;&#125;FUZZ_CXXFLAGS=&quot;-O2 -fno-omit-frame-pointer -gline-tables-only -fsanitize=address -fsanitize-address-use-after-scope -fsanitize-coverage=trace-pc-guard,trace-cmp,trace-gep,trace-div&quot;\n\n\ncommon.sh\n1234567891011121314151617FUZZ_CXXFLAGS=&quot;-O2 -fno-omit-frame-pointer -gline-tables-only -fsanitize=address -fsanitize-address-use-after-scope -fsanitize-coverage=trace-pc-guard,trace-cmp,trace-gep,trace-div&quot;......export CC=$&#123;CC:-&quot;clang&quot;&#125;export CXX=$&#123;CXX:-&quot;clang++&quot;&#125;export CPPFLAGS=$&#123;CPPFLAGS:-&quot;-DFUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION&quot;&#125;export LIB_FUZZING_ENGINE=&quot;libFuzzingEngine-$&#123;FUZZING_ENGINE&#125;.a&quot;if [[$FUZZING_ENGINE == &quot;fsanitize_fuzzer&quot;]]; then  FSANITIZE_FUZZER_FLAGS=&quot;-O2 -fno-omit-frame-pointer -gline-tables-only -fsanitize=address,fuzzer-no-link -fsanitize-address-use-after-scope&quot;  export CFLAGS=$&#123;CFLAGS:-$FSANITIZE_FUZZER_FLAGS&#125;  export CXXFLAGS=$&#123;CXXFLAGS:-$FSANITIZE_FUZZER_FLAGS&#125;elif......else  export CFLAGS=$&#123;CFLAGS:-&quot;$FUZZ_CXXFLAGS&quot;&#125;  export CXXFLAGS=$&#123;CXXFLAGS:-&quot;$FUZZ_CXXFLAGS&quot;&#125;fi\n\n可以看到脚本指定了 CC 和CXX编译工具为 clang 和clang++，在 CFLAGS 和CXXFLAGS中设置了 clang 的编译选项：\n\n\n\n选项\n含义\n\n\n\n-O2\n指定编译器优化等级为 2\n\n\n-fno-omit-frame-pointer\n将 frame pointer 保存在寄存器中。frame pointer 即栈帧基地址（指向栈底），在编译器优化时或某些平台上，fp 会被忽略，通过此选项可强制开启\n\n\n-gline-tables-only\n函数调用栈中包含函数名、文件名和行号等信息，但不包括局部变量和函数参数。要包括全部信息应使用 -g 选项\n\n\n-fsanitize&#x3D;fuzzer\n编译时对源码插桩，链接 libFuzzer 库文件\n\n\n-fsanitize&#x3D;fuzzer-no-link\n编译时对源码插桩，不链接 libFuzzer 库文件。编译待测源码时不链接，编译 fuzz target 时再链接，对大型项目可以提升编译效率\n\n\n-fsanitize&#x3D;address\n启用 AddressSanitizer，检测缓冲区溢出、UAF、Double Free、内存泄漏等内存问题\n\n\n-fsanitize-address-use-after-scope\n启用局部变量的 sanitization 以检测 use-after-scope 错误（作用域外访问）\n\n\n-fsanitize&#x3D;undefined\n启用 UndefinedSanitizer，检测程序运行中越界访问、整数溢出、空指针解引用等未定义行为\n\n\n-fsanitize-coverage&#x3D;trace-pc-guard,trace-cmp,trace-gep,trace-div\n开启代码覆盖率统计。在高版本 clang 中 -fsanitize-coverage&#x3D;trace-pc-guard 已弃用，默认开启代码覆盖率统计，使用此选项会报错\n\n\n3. 链接库文件  编译 fuzz target 时，执行了如下命令：\n1$CXX $CXXFLAGS $SCRIPT_DIR/target.cc -I BUILD BUILD/.libs/libcares.a $LIB_FUZZING_ENGINE -o $EXECUTABLE_NAME_BASE\n\n环境变量 CXX 和CXXFLAGS沿用之前定义，通过-I（uppercase i）选项，指定了.h 头文件目录和.a 静态库路径：\n\nBUILD：存放待测源码的头文件\n\nBUILD/.libs/libcares.a：编译待测源码生成的静态库文件libcares.a\n\n$LIB_FUZZING_ENGINE：编译 LibFuzzer 源码生成的libFuzzer.a\n\n\n链接库文件时，-I（uppercase i）可以用 -L 和-l（lowercase L）替换：\n1-I BUILD/.libs/libcares.a  等价于  -L BUILD/.libs -l cares\n\n特别地，链接 libFuzzer.a 库文件时，可以用过 -fsanitize=fuzzer 实现：\n1-I libFuzzer.a 等价于 -fsanitize=fuzzer\n\n二、自己编写命令  开源的编译脚本为了适配多个 benchmark 和多种 Fuzz 类型，做了较多逻辑处理，适配新的 benchmark 时不够灵活。通过对编译脚本的流程分析，很容易自己编写命令完成编译。\n在 Linux 环境下安装 clang，以 c-ares-CVE 为例，编写命令生成 fuzz target：\n0. 准备源码   123git clone https://github.com/c-ares/c-ares.gitcd c-ares/git reset --hard 51fbb479f7948fca2ace3ff34a15ff27e796afdd\n   此时查看目录内容如下：\n   123456root@server:~/fuzz/cares$ tree -L 1.├── c-ares└── target.cc1 directory, 1 file\n\n1. 设置环境变量   设置CC、CXX、CFLAGS、CXXFLAGS\n   1234export CC=clangexport CXX=clang++export CFLAGS=&quot;-O2 -fno-omit-frame-pointer -gline-tables-only -fsanitize=address,fuzzer-no-link -fsanitize-address-use-after-scope&quot;export CXXFLAGS=$CFLAGS\n\n2. 编译待测库    进入源码目录，执行configure 脚本，设置禁止编译动态库文件，执行 make 编译libcares.a\n   1234cd c-ares./buildconf./configure --disable-sharedmake -j4\n   编译成功后，会在源码目录下生成.lib 目录，存放生成的 libcares.a 文件\n   123root@server:~/fuzz/cares/c-ares$ cd .libs/root@server:~/fuzz/cares/c-ares/.libs$ lslibcares.a  libcares.la  libcares.lai\n\n3. 编译 fuzz target   由于安装 clang 时已经自带 LibFuzzer.a，因此不用再编译LibFuzzer.a，回到target.cc 目录，直接编译 targe.cc 链接 libFuzzer 即可\n   12cd ~/fuzz/cares$CXX $CXXFLAGS target.cc -fsanitize=fuzzer -g -I c-ares c-ares/.libs/libcares.a -o cares-fuzzer\n   编译成功后，会在当前目录下生成可执行文件 cares-fuzzer，执行cares-fuzzer 开始 fuzz 测试，可以看到触发了 crash\n   1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980root@server:~/fuzz/cares$ lsc-ares  cares-fuzzer  target.ccroot@server:~/fuzz/cares$ ./cares-fuzzerINFO: Seed: 3031255060INFO: Loaded 1 modules   (10 inline 8-bit counters): 10 [0x5a90e0, 0x5a90ea),INFO: Loaded 1 PC tables (10 PCs): 10 [0x56c278,0x56c318),INFO: -max_len is not provided; libFuzzer will not generate inputs larger than 4096 bytesINFO: A corpus is not provided, starting from an empty corpus#2      INITED cov: 3 ft: 3 corp: 1/1b exec/s: 0 rss: 27Mb#4      NEW    cov: 4 ft: 4 corp: 2/3b lim: 4 exec/s: 0 rss: 27Mb L: 2/2 MS: 2 ChangeBit-InsertByte-#1331   NEW    cov: 6 ft: 6 corp: 3/20b lim: 17 exec/s: 0 rss: 27Mb L: 17/17 MS: 2 InsertByte-CrossOver-#1368   REDUCE cov: 6 ft: 6 corp: 3/19b lim: 17 exec/s: 0 rss: 27Mb L: 16/16 MS: 2 CrossOver-EraseBytes-#1048576        pulse  cov: 6 ft: 6 corp: 3/19b lim: 4096 exec/s: 524288 rss: 773Mb#2097152        pulse  cov: 6 ft: 6 corp: 3/19b lim: 4096 exec/s: 419430 rss: 773Mb===================================================================664326==ERROR: AddressSanitizer: heap-buffer-overflow on address 0x603000d2c052 at pc 0x000000550e1c bp 0x7ffd914ddd30 sp 0x7ffd914ddd28WRITE of size 1 at 0x603000d2c052 thread T0    #0 0x550e1b in ares_create_query (/home/rootfuzz/cares/cares-fuzzer+0x550e1b)    #1 0x55053c in LLVMFuzzerTestOneInput /home/rootfuzz/cares/target.cc:14:3    #2 0x4586a1 in fuzzer::Fuzzer::ExecuteCallback(unsigned char const*, unsigned long) (/home/rootfuzz/cares/cares-fuzzer+0x4586a1)    #3 0x457de5 in fuzzer::Fuzzer::RunOne(unsigned char const*, unsigned long, bool, fuzzer::InputInfo*, bool*) (/home/rootfuzz/cares/cares-fuzzer+0x457de5)    #4 0x45a087 in fuzzer::Fuzzer::MutateAndTestOne() (/home/rootfuzz/cares/cares-fuzzer+0x45a087)    #5 0x45ad85 in fuzzer::Fuzzer::Loop(std::__Fuzzer::vector&lt;fuzzer::SizedFile, fuzzer::fuzzer_allocator&lt;fuzzer::SizedFile&gt; &gt;&amp;) (/home/rootfuzz/cares/cares-fuzzer+0x45ad85)    #6 0x44973e in fuzzer::FuzzerDriver(int*, char***, int (*)(unsigned char const*, unsigned long)) (/home/rootfuzz/cares/cares-fuzzer+0x44973e)    #7 0x472582 in main (/home/rootfuzz/cares/cares-fuzzer+0x472582)    #8 0x7f4b400f8082 in __libc_start_main (/lib/x86_64-linux-gnu/libc.so.6+0x24082)    #9 0x41e4dd in _start (/home/rootfuzz/cares/cares-fuzzer+0x41e4dd)0x603000d2c052 is located 0 bytes to the right of 18-byte region [0x603000d2c040,0x603000d2c052)allocated by thread T0 here:    #0 0x51e20d in malloc (/home/rootfuzz/cares/cares-fuzzer+0x51e20d)    #1 0x5508f6 in ares_create_query (/home/rootfuzz/cares/cares-fuzzer+0x5508f6)    #2 0x55053c in LLVMFuzzerTestOneInput /home/rootfuzz/cares/target.cc:14:3    #3 0x4586a1 in fuzzer::Fuzzer::ExecuteCallback(unsigned char const*, unsigned long) (/home/rootfuzz/cares/cares-fuzzer+0x4586a1)    #4 0x457de5 in fuzzer::Fuzzer::RunOne(unsigned char const*, unsigned long, bool, fuzzer::InputInfo*, bool*) (/home/rootfuzz/cares/cares-fuzzer+0x457de5)    #5 0x45a087 in fuzzer::Fuzzer::MutateAndTestOne() (/home/rootfuzz/cares/cares-fuzzer+0x45a087)    #6 0x45ad85 in fuzzer::Fuzzer::Loop(std::__Fuzzer::vector&lt;fuzzer::SizedFile, fuzzer::fuzzer_allocator&lt;fuzzer::SizedFile&gt; &gt;&amp;) (/home/rootfuzz/cares/cares-fuzzer+0x45ad85)    #7 0x44973e in fuzzer::FuzzerDriver(int*, char***, int (*)(unsigned char const*, unsigned long)) (/home/rootfuzz/cares/cares-fuzzer+0x44973e)    #8 0x472582 in main (/home/rootfuzz/cares/cares-fuzzer+0x472582)    #9 0x7f4b400f8082 in __libc_start_main (/lib/x86_64-linux-gnu/libc.so.6+0x24082)SUMMARY: AddressSanitizer: heap-buffer-overflow (/home/rootfuzz/cares/cares-fuzzer+0x550e1b) in ares_create_queryShadow bytes around the buggy address:  0x0c068019d7b0: fd fa fa fa fd fd fd fa fa fa fd fd fd fa fa fa  0x0c068019d7c0: fd fd fd fa fa fa fd fd fd fa fa fa fd fd fd fa  0x0c068019d7d0: fa fa fa fa fa fa fa fa fd fd fd fa fa fa fd fd  0x0c068019d7e0: fd fa fa fa fd fd fd fa fa fa fd fd fd fa fa fa  0x0c068019d7f0: fa fa fa fa fa fa fa fa fa fa fa fa fd fd fd fa=&gt;0x0c068019d800: fa fa fa fa fa fa fa fa 00 00[02]fa fa fa fa fa  0x0c068019d810: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c068019d820: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c068019d830: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c068019d840: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c068019d850: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa faShadow byte legend (one shadow byte represents 8 application bytes):  Addressable:           00  Partially addressable: 01 02 03 04 05 06 07  Heap left redzone:       fa  Freed heap region:       fd  Stack left redzone:      f1  Stack mid redzone:       f2  Stack right redzone:     f3  Stack after return:      f5  Stack use after scope:   f8  Global redzone:          f9  Global init order:       f6  Poisoned by user:        f7  Container overflow:      fc  Array cookie:            ac  Intra object redzone:    bb  ASan internal:           fe  Left alloca redzone:     ca  Right alloca redzone:    cb  Shadow gap:              cc==664326==ABORTINGMS: 4 ChangeBit-InsertByte-EraseBytes-ChangeByte-; base unit: 7c9981f8ba526a6e0b8c1bbb846c08e2d6026e3a0x5c,0x2e,\\\\.artifact_prefix=&#x27;./&#x27;; Test unit written to ./crash-c9257f8fd31ea852baf734ef06d37348bf6e8cb2Base64: XC4=\n\n三、补充说明 1. 脚本执行 带mode参数执行 build.sh 脚本时，需要编译 LibFuzzer 源码，这时候会出现找不到 LibFuzzer 源码的错误。需要自己下载源码，并放到指定路径，调试脚本解决问题，比较麻烦。\n建议不带参数执行build.sh，这时采用默认模式，编译时会采用 address 消毒器，这也是应用的最多的一种消毒器。\n2. 静态库 or 动态库  编译待测库的源码时，一定要编译成静态库文件 ，在congfigure 时使用 --disable-shared 参数。\n如果是编成动态库文件，或静态库动态库同时都有的情况下，fuzz target 会优先链接动态库文件。而动态库会导致 fuzz 测试失效。\n\n\n第一个图中使用静态库，fuzz 很快能发现 crash，第二个图中是用动态库，fuzz 运行很慢，找不到 crash。\n使用静态库得到 57 PCs，使用动态库得到 5 PCs，二者有明显区别，推测使用动态库可能会导致插桩失效，影响 fuzz 运行效率。","dateCreated":"2023-09-26T14:32:22+08:00","dateModified":"2024-06-26T15:04:11+08:00","datePublished":"2023-09-26T14:32:22+08:00","description":"怎样编出 LibFuzzer 的 target","headline":"LibFuzzer 编译指南","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2023/LibFuzzer%E7%BC%96%E8%AF%91%E6%8C%87%E5%8D%97/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2023/LibFuzzer%E7%BC%96%E8%AF%91%E6%8C%87%E5%8D%97/","keywords":"Fuzz, 安全, 工具, LibFuzzer"}</script>
+    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n使用 LibFuzzer 时，编译 fuzz target 是需要使用者自己执行的重要步骤。在编译时，通过编译选项添加消毒器，链接 LibFuzzer 静态库，得到可执行的 fuzz target。\n本文针对 LibFuzzer Target 编译进行说明。\n一、使用开源脚本 fuzzer-test-suite 是 Google 开源的一个 Fuzz 基准测试集，包含 Fuzz（LibFuzzer 和 AFL）测试的多个 benchmark。这些 benchmark 都来自真实案例，涉及到图像处理、SQL 注入、JSON 解析等多个领域。\n以 c-ares-CVE 为例，编译主要用到以下三个 sh 脚本，以及实现了 LLVMFuzzerTestOneInput 的 cc 源码文件：\n123456fuzzer-test-suite│  common.sh│  custom-build.sh├─c-ares-CVE-2016-5180│      build.sh│      target.cc\n\n1. 编译过程  编译入口为 build.sh 文件，其代码如下：\n1234567891011121314151617181920#!/bin/bash# Copyright 2016 Google Inc. All Rights Reserved.# Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);. $(dirname $0)/../custom-build.sh $1 $2. $(dirname $0)/../common.shbuild_lib() &#123;  rm -rf BUILD  cp -rf SRC BUILD  (cd BUILD &amp;&amp; ./buildconf &amp;&amp; ./configure --disable-shared &amp;&amp; make -j $JOBS)&#125;get_git_revision https://github.com/c-ares/c-ares.git 51fbb479f7948fca2ace3ff34a15ff27e796afdd SRCbuild_libbuild_fuzzerif [[$FUZZING_ENGINE == &quot;hooks&quot;]]; then  # Link ASan runtime so we can hook memcmp et al.  LIB_FUZZING_ENGINE=&quot;$LIB_FUZZING_ENGINE -fsanitize=address&quot;fi$CXX $CXXFLAGS $SCRIPT_DIR/target.cc -I BUILD BUILD/.libs/libcares.a $LIB_FUZZING_ENGINE -o $EXECUTABLE_NAME_BASE\n\n执行 build.sh 时，首先依次调用外层的 custom-build.sh 和common.sh，然后执行如下步骤：\n\nget_git_revision：定义在 common.sh 中，拉取有漏洞的代码\n\nbuild_lib：将拉取的代码编译成静态库文件 libcares.a，注意--disable-shared 参数指定编译静态库文件，否则编译动态库文件\n\nbuild_fuzzer：定义在 common.sh 中，编译 Fuzz 引擎源码（如果使用 LibFuzzer，则编译 LibFuzzer 源码，得到libFuzzer.a）\n\n\\$CXX \\$CXXFLAGS \\$SCRIPT_DIR/target.cc：编译 target.cc 文件，链接 libcares.a 和libFuzzer.a，得到可执行的 fuzz target\n\n\n在整个编译过程中，需要重点关注的是  编译选项的设置  和静态库的链接。\n2. 编译选项  在build_lib中编译待测源码时，使用的是 configure-make 工具，该工具广泛用于 Linux 环境中编写的 C&#x2F;C++ 程序的编译（近年来开始使用 cmake 工具），主要包含两个步骤：\n\nconfigure对编译过程进行配置，通过参数和环境变量控制编译，生成 makefile\nmake从 makefile 中读取命令并执行编译，生成二进制文件\n\n通过 ./configure -h 可以查看编译参数和环境变量的含义，脚本中用到的参数和环境变量列举如下：\n\n\n\n参数\n含义\n\n\n\n–enable-shared\n编译动态库文件（默认 yes）\n\n\n–enable-static\n编译静态库文件（默认 yes）\n\n\n–disable-shared\n不编译动态库文件\n\n\n–disable-static\n不编译静态库文件\n\n\n\n\n\n环境变量\n含义\n\n\n\nCC\nC 编译程序\n\n\nCXX\nC++ 编译程序\n\n\nCFLAGS\nC 编译程序的命令行参数\n\n\nCXXFLAGS\nC++ 编译程序的命令行参数\n\n\n在执行 build_lib 时，设置了 --disable-shared 参数，指定将待测源码编译成静态库文件。在 custom-build.sh 和common.sh中，设置了如下环境变量：\n\ncustom-build.sh\n\nasan 模式\n123export FUZZING_ENGINE=libfuzzerexport CFLAGS=&quot;-O2 -fno-omit-frame-pointer -gline-tables-only -fsanitize=address -fsanitize-address-use-after-scope -fsanitize-coverage=trace-pc-guard,trace-cmp,trace-gep,trace-div&quot;export CXXFLAGS=&quot;$&#123;CFLAGS&#125;&quot;\n\nubsan 模式\n123export FUZZING_ENGINE=libfuzzerexport CFLAGS=&quot;-O2 -fno-omit-frame-pointer -gline-tables-only -fsanitize=undefined -fsanitize-coverage=trace-pc-guard,trace-cmp,trace-gep,trace-div&quot;export CXXFLAGS=&quot;$&#123;CFLAGS&#125;&quot;\n\n默认模式\n12FUZZING_ENGINE=$&#123;FUZZING_ENGINE:-&quot;fsanitize_fuzzer&quot;&#125;FUZZ_CXXFLAGS=&quot;-O2 -fno-omit-frame-pointer -gline-tables-only -fsanitize=address -fsanitize-address-use-after-scope -fsanitize-coverage=trace-pc-guard,trace-cmp,trace-gep,trace-div&quot;\n\n\ncommon.sh\n1234567891011121314151617FUZZ_CXXFLAGS=&quot;-O2 -fno-omit-frame-pointer -gline-tables-only -fsanitize=address -fsanitize-address-use-after-scope -fsanitize-coverage=trace-pc-guard,trace-cmp,trace-gep,trace-div&quot;......export CC=$&#123;CC:-&quot;clang&quot;&#125;export CXX=$&#123;CXX:-&quot;clang++&quot;&#125;export CPPFLAGS=$&#123;CPPFLAGS:-&quot;-DFUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION&quot;&#125;export LIB_FUZZING_ENGINE=&quot;libFuzzingEngine-$&#123;FUZZING_ENGINE&#125;.a&quot;if [[$FUZZING_ENGINE == &quot;fsanitize_fuzzer&quot;]]; then  FSANITIZE_FUZZER_FLAGS=&quot;-O2 -fno-omit-frame-pointer -gline-tables-only -fsanitize=address,fuzzer-no-link -fsanitize-address-use-after-scope&quot;  export CFLAGS=$&#123;CFLAGS:-$FSANITIZE_FUZZER_FLAGS&#125;  export CXXFLAGS=$&#123;CXXFLAGS:-$FSANITIZE_FUZZER_FLAGS&#125;elif......else  export CFLAGS=$&#123;CFLAGS:-&quot;$FUZZ_CXXFLAGS&quot;&#125;  export CXXFLAGS=$&#123;CXXFLAGS:-&quot;$FUZZ_CXXFLAGS&quot;&#125;fi\n\n可以看到脚本指定了 CC 和CXX编译工具为 clang 和clang++，在 CFLAGS 和CXXFLAGS中设置了 clang 的编译选项：\n\n\n\n选项\n含义\n\n\n\n-O2\n指定编译器优化等级为 2\n\n\n-fno-omit-frame-pointer\n将 frame pointer 保存在寄存器中。frame pointer 即栈帧基地址（指向栈底），在编译器优化时或某些平台上，fp 会被忽略，通过此选项可强制开启\n\n\n-gline-tables-only\n函数调用栈中包含函数名、文件名和行号等信息，但不包括局部变量和函数参数。要包括全部信息应使用 -g 选项\n\n\n-fsanitize&#x3D;fuzzer\n编译时对源码插桩，链接 libFuzzer 库文件\n\n\n-fsanitize&#x3D;fuzzer-no-link\n编译时对源码插桩，不链接 libFuzzer 库文件。编译待测源码时不链接，编译 fuzz target 时再链接，对大型项目可以提升编译效率\n\n\n-fsanitize&#x3D;address\n启用 AddressSanitizer，检测缓冲区溢出、UAF、Double Free、内存泄漏等内存问题\n\n\n-fsanitize-address-use-after-scope\n启用局部变量的 sanitization 以检测 use-after-scope 错误（作用域外访问）\n\n\n-fsanitize&#x3D;undefined\n启用 UndefinedSanitizer，检测程序运行中越界访问、整数溢出、空指针解引用等未定义行为\n\n\n-fsanitize-coverage&#x3D;trace-pc-guard,trace-cmp,trace-gep,trace-div\n开启代码覆盖率统计。在高版本 clang 中 -fsanitize-coverage&#x3D;trace-pc-guard 已弃用，默认开启代码覆盖率统计，使用此选项会报错\n\n\n3. 链接库文件  编译 fuzz target 时，执行了如下命令：\n1$CXX $CXXFLAGS $SCRIPT_DIR/target.cc -I BUILD BUILD/.libs/libcares.a $LIB_FUZZING_ENGINE -o $EXECUTABLE_NAME_BASE\n\n环境变量 CXX 和CXXFLAGS沿用之前定义，通过-I（uppercase i）选项，指定了.h 头文件目录和.a 静态库路径：\n\nBUILD：存放待测源码的头文件\n\nBUILD/.libs/libcares.a：编译待测源码生成的静态库文件libcares.a\n\n$LIB_FUZZING_ENGINE：编译 LibFuzzer 源码生成的libFuzzer.a\n\n\n链接库文件时，-I（uppercase i）可以用 -L 和-l（lowercase L）替换：\n1-I BUILD/.libs/libcares.a  等价于  -L BUILD/.libs -l cares\n\n特别地，链接 libFuzzer.a 库文件时，可以用过 -fsanitize=fuzzer 实现：\n1-I libFuzzer.a 等价于 -fsanitize=fuzzer\n\n二、自己编写命令  开源的编译脚本为了适配多个 benchmark 和多种 Fuzz 类型，做了较多逻辑处理，适配新的 benchmark 时不够灵活。通过对编译脚本的流程分析，很容易自己编写命令完成编译。\n在 Linux 环境下安装 clang，以 c-ares-CVE 为例，编写命令生成 fuzz target：\n0. 准备源码   123git clone https://github.com/c-ares/c-ares.gitcd c-ares/git reset --hard 51fbb479f7948fca2ace3ff34a15ff27e796afdd\n   此时查看目录内容如下：\n   123456root@server:~/fuzz/cares$ tree -L 1.├── c-ares└── target.cc1 directory, 1 file\n\n1. 设置环境变量   设置CC、CXX、CFLAGS、CXXFLAGS\n   1234export CC=clangexport CXX=clang++export CFLAGS=&quot;-O2 -fno-omit-frame-pointer -gline-tables-only -fsanitize=address,fuzzer-no-link -fsanitize-address-use-after-scope&quot;export CXXFLAGS=$CFLAGS\n\n2. 编译待测库    进入源码目录，执行configure 脚本，设置禁止编译动态库文件，执行 make 编译libcares.a\n   1234cd c-ares./buildconf./configure --disable-sharedmake -j4\n   编译成功后，会在源码目录下生成.lib 目录，存放生成的 libcares.a 文件\n   123root@server:~/fuzz/cares/c-ares$ cd .libs/root@server:~/fuzz/cares/c-ares/.libs$ lslibcares.a  libcares.la  libcares.lai\n\n3. 编译 fuzz target   由于安装 clang 时已经自带 LibFuzzer.a，因此不用再编译LibFuzzer.a，回到target.cc 目录，直接编译 targe.cc 链接 libFuzzer 即可\n   12cd ~/fuzz/cares$CXX $CXXFLAGS target.cc -fsanitize=fuzzer -g -I c-ares c-ares/.libs/libcares.a -o cares-fuzzer\n   编译成功后，会在当前目录下生成可执行文件 cares-fuzzer，执行cares-fuzzer 开始 fuzz 测试，可以看到触发了 crash\n   1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980root@server:~/fuzz/cares$ lsc-ares  cares-fuzzer  target.ccroot@server:~/fuzz/cares$ ./cares-fuzzerINFO: Seed: 3031255060INFO: Loaded 1 modules   (10 inline 8-bit counters): 10 [0x5a90e0, 0x5a90ea),INFO: Loaded 1 PC tables (10 PCs): 10 [0x56c278,0x56c318),INFO: -max_len is not provided; libFuzzer will not generate inputs larger than 4096 bytesINFO: A corpus is not provided, starting from an empty corpus#2      INITED cov: 3 ft: 3 corp: 1/1b exec/s: 0 rss: 27Mb#4      NEW    cov: 4 ft: 4 corp: 2/3b lim: 4 exec/s: 0 rss: 27Mb L: 2/2 MS: 2 ChangeBit-InsertByte-#1331   NEW    cov: 6 ft: 6 corp: 3/20b lim: 17 exec/s: 0 rss: 27Mb L: 17/17 MS: 2 InsertByte-CrossOver-#1368   REDUCE cov: 6 ft: 6 corp: 3/19b lim: 17 exec/s: 0 rss: 27Mb L: 16/16 MS: 2 CrossOver-EraseBytes-#1048576        pulse  cov: 6 ft: 6 corp: 3/19b lim: 4096 exec/s: 524288 rss: 773Mb#2097152        pulse  cov: 6 ft: 6 corp: 3/19b lim: 4096 exec/s: 419430 rss: 773Mb===================================================================664326==ERROR: AddressSanitizer: heap-buffer-overflow on address 0x603000d2c052 at pc 0x000000550e1c bp 0x7ffd914ddd30 sp 0x7ffd914ddd28WRITE of size 1 at 0x603000d2c052 thread T0    #0 0x550e1b in ares_create_query (/home/rootfuzz/cares/cares-fuzzer+0x550e1b)    #1 0x55053c in LLVMFuzzerTestOneInput /home/rootfuzz/cares/target.cc:14:3    #2 0x4586a1 in fuzzer::Fuzzer::ExecuteCallback(unsigned char const*, unsigned long) (/home/rootfuzz/cares/cares-fuzzer+0x4586a1)    #3 0x457de5 in fuzzer::Fuzzer::RunOne(unsigned char const*, unsigned long, bool, fuzzer::InputInfo*, bool*) (/home/rootfuzz/cares/cares-fuzzer+0x457de5)    #4 0x45a087 in fuzzer::Fuzzer::MutateAndTestOne() (/home/rootfuzz/cares/cares-fuzzer+0x45a087)    #5 0x45ad85 in fuzzer::Fuzzer::Loop(std::__Fuzzer::vector&lt;fuzzer::SizedFile, fuzzer::fuzzer_allocator&lt;fuzzer::SizedFile&gt; &gt;&amp;) (/home/rootfuzz/cares/cares-fuzzer+0x45ad85)    #6 0x44973e in fuzzer::FuzzerDriver(int*, char***, int (*)(unsigned char const*, unsigned long)) (/home/rootfuzz/cares/cares-fuzzer+0x44973e)    #7 0x472582 in main (/home/rootfuzz/cares/cares-fuzzer+0x472582)    #8 0x7f4b400f8082 in __libc_start_main (/lib/x86_64-linux-gnu/libc.so.6+0x24082)    #9 0x41e4dd in _start (/home/rootfuzz/cares/cares-fuzzer+0x41e4dd)0x603000d2c052 is located 0 bytes to the right of 18-byte region [0x603000d2c040,0x603000d2c052)allocated by thread T0 here:    #0 0x51e20d in malloc (/home/rootfuzz/cares/cares-fuzzer+0x51e20d)    #1 0x5508f6 in ares_create_query (/home/rootfuzz/cares/cares-fuzzer+0x5508f6)    #2 0x55053c in LLVMFuzzerTestOneInput /home/rootfuzz/cares/target.cc:14:3    #3 0x4586a1 in fuzzer::Fuzzer::ExecuteCallback(unsigned char const*, unsigned long) (/home/rootfuzz/cares/cares-fuzzer+0x4586a1)    #4 0x457de5 in fuzzer::Fuzzer::RunOne(unsigned char const*, unsigned long, bool, fuzzer::InputInfo*, bool*) (/home/rootfuzz/cares/cares-fuzzer+0x457de5)    #5 0x45a087 in fuzzer::Fuzzer::MutateAndTestOne() (/home/rootfuzz/cares/cares-fuzzer+0x45a087)    #6 0x45ad85 in fuzzer::Fuzzer::Loop(std::__Fuzzer::vector&lt;fuzzer::SizedFile, fuzzer::fuzzer_allocator&lt;fuzzer::SizedFile&gt; &gt;&amp;) (/home/rootfuzz/cares/cares-fuzzer+0x45ad85)    #7 0x44973e in fuzzer::FuzzerDriver(int*, char***, int (*)(unsigned char const*, unsigned long)) (/home/rootfuzz/cares/cares-fuzzer+0x44973e)    #8 0x472582 in main (/home/rootfuzz/cares/cares-fuzzer+0x472582)    #9 0x7f4b400f8082 in __libc_start_main (/lib/x86_64-linux-gnu/libc.so.6+0x24082)SUMMARY: AddressSanitizer: heap-buffer-overflow (/home/rootfuzz/cares/cares-fuzzer+0x550e1b) in ares_create_queryShadow bytes around the buggy address:  0x0c068019d7b0: fd fa fa fa fd fd fd fa fa fa fd fd fd fa fa fa  0x0c068019d7c0: fd fd fd fa fa fa fd fd fd fa fa fa fd fd fd fa  0x0c068019d7d0: fa fa fa fa fa fa fa fa fd fd fd fa fa fa fd fd  0x0c068019d7e0: fd fa fa fa fd fd fd fa fa fa fd fd fd fa fa fa  0x0c068019d7f0: fa fa fa fa fa fa fa fa fa fa fa fa fd fd fd fa=&gt;0x0c068019d800: fa fa fa fa fa fa fa fa 00 00[02]fa fa fa fa fa  0x0c068019d810: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c068019d820: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c068019d830: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c068019d840: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa  0x0c068019d850: fa fa fa fa fa fa fa fa fa fa fa fa fa fa fa faShadow byte legend (one shadow byte represents 8 application bytes):  Addressable:           00  Partially addressable: 01 02 03 04 05 06 07  Heap left redzone:       fa  Freed heap region:       fd  Stack left redzone:      f1  Stack mid redzone:       f2  Stack right redzone:     f3  Stack after return:      f5  Stack use after scope:   f8  Global redzone:          f9  Global init order:       f6  Poisoned by user:        f7  Container overflow:      fc  Array cookie:            ac  Intra object redzone:    bb  ASan internal:           fe  Left alloca redzone:     ca  Right alloca redzone:    cb  Shadow gap:              cc==664326==ABORTINGMS: 4 ChangeBit-InsertByte-EraseBytes-ChangeByte-; base unit: 7c9981f8ba526a6e0b8c1bbb846c08e2d6026e3a0x5c,0x2e,\\\\.artifact_prefix=&#x27;./&#x27;; Test unit written to ./crash-c9257f8fd31ea852baf734ef06d37348bf6e8cb2Base64: XC4=\n\n三、补充说明 1. 脚本执行 带mode参数执行 build.sh 脚本时，需要编译 LibFuzzer 源码，这时候会出现找不到 LibFuzzer 源码的错误。需要自己下载源码，并放到指定路径，调试脚本解决问题，比较麻烦。\n建议不带参数执行build.sh，这时采用默认模式，编译时会采用 address 消毒器，这也是应用的最多的一种消毒器。\n2. 静态库 or 动态库  编译待测库的源码时，一定要编译成静态库文件 ，在congfigure 时使用 --disable-shared 参数。\n如果是编成动态库文件，或静态库动态库同时都有的情况下，fuzz target 会优先链接动态库文件。而动态库会导致 fuzz 测试失效。\n\n\n第一个图中使用静态库，fuzz 很快能发现 crash，第二个图中是用动态库，fuzz 运行很慢，找不到 crash。\n使用静态库得到 57 PCs，使用动态库得到 5 PCs，二者有明显区别，推测使用动态库可能会导致插桩失效，影响 fuzz 运行效率。","dateCreated":"2023-09-26T14:32:22+08:00","dateModified":"2024-06-26T15:04:11+08:00","datePublished":"2023-09-26T14:32:22+08:00","description":"怎样编出 LibFuzzer 的 target","headline":"LibFuzzer 编译指南","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2023/LibFuzzer%E7%BC%96%E8%AF%91%E6%8C%87%E5%8D%97/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2023/LibFuzzer%E7%BC%96%E8%AF%91%E6%8C%87%E5%8D%97/","keywords":"安全, 工具, Fuzz, LibFuzzer"}</script>
     <meta name="description" content="怎样编出 LibFuzzer 的 target">
 <meta property="og:type" content="blog">
 <meta property="og:title" content="LibFuzzer 编译指南">
@@ -27,9 +27,9 @@
 <meta property="article:published_time" content="2023-09-26T06:32:22.000Z">
 <meta property="article:modified_time" content="2024-06-26T07:04:11.486Z">
 <meta property="article:author" content="一瓢清浅">
-<meta property="article:tag" content="Fuzz">
 <meta property="article:tag" content="安全">
 <meta property="article:tag" content="工具">
+<meta property="article:tag" content="Fuzz">
 <meta property="article:tag" content="LibFuzzer">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:image" content="https://www.stepbystep.asia/2023/LibFuzzer%E7%BC%96%E8%AF%91%E6%8C%87%E5%8D%97/%E4%BD%BF%E7%94%A8%E9%9D%99%E6%80%81%E5%BA%93.png">
diff --git "a/2023/\347\254\246\345\217\267\346\211\247\350\241\214\344\270\216\346\267\267\345\220\210\346\250\241\347\263\212\346\265\213\350\257\225/index.html" "b/2023/\347\254\246\345\217\267\346\211\247\350\241\214\344\270\216\346\267\267\345\220\210\346\250\241\347\263\212\346\265\213\350\257\225/index.html"
index 76469ec..be64999 100644
--- "a/2023/\347\254\246\345\217\267\346\211\247\350\241\214\344\270\216\346\267\267\345\220\210\346\250\241\347\263\212\346\265\213\350\257\225/index.html"
+++ "b/2023/\347\254\246\345\217\267\346\211\247\350\241\214\344\270\216\346\267\267\345\220\210\346\250\241\347\263\212\346\265\213\350\257\225/index.html"
@@ -14,7 +14,7 @@
     
     
     
-    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n一、符号执行 1. 静态符号执行 定义  符号执行是一种程序分析技术，它通过使用符号代替实际的运行时值来探索程序的所有可能执行路径。这种技术不仅可以帮助生成覆盖率高的测试用例，还能有效地发现潜在的程序错误。\n\n\n具体地，符号执行采用抽象的符号代替具体值作为程序输入变量，得出每个路径抽象的输出结果和需要满足的约束条件。通过约束求解器，可以反推出指定程序路径时，程序输入应该设置的具体值。\n这种传统的符号执行不需要运行程序，所以也称为静态符号执行，它与 fuzz 测试相比各有优劣。举例来说，当我要求如下程序触发 AssertionError 时：\n12345def f():    x = int(input())    y = x * 2    if y == 12:        assert False\n如果使用 fuzz 测试，由于 x 是随机输入，为了满足y==12，fuzz 需要进行大量的尝试。\n如果使用符号执行，要触发 AssertionError 只需要满足约束条件 2*x==12 即可，求解可得x==6，一次分析即可搞定。\n原理  符号执行包括三个核心组件：\n\n状态信息存储器\nσ：程序变量的符号表达式\nπ：路径约束，即走到特定语句所经过的条件组合\nstmt：指向需要处理的下一条程序语句\n\n\n语句执行器：执行 stmt 指向的语句，更新 σ 或π的状态\n约束求解器：根据路径约束 π 和符号表达式σ，求出可行解\n\n下图演示了符号执行过程中，各组件的变化情况：\n\n\n缺陷  只需一次分析，即可获得所有路径的可行解，这个理想很美好，但现实很骨感。 静态符号执行在实际应用中，面临两大挑战：\n1. 路径爆炸\n程序中的分支和循环，都会使得程序路径爆炸式增长，导致分析过程变得不可行：\n\n每增加一次条件判断，程序会产生两个分支，极端情况下，路径数量呈指数增长\n无限循环和递归调用，可能导致无穷长的路径1234567def func():    s = 0    x = int(input())    while x &gt; 0:        s += x        print(f&#x27;total sum: &#123;s&#125;&#x27;)        x = int(input())\n\n处理路径爆炸问题的思路主要是限制分析的搜索空间，例如设置超时机制、搜索次数，使用启发式搜索等策略。\n2. 约束不可解\n符号执行中的关键环节在于约束求解器求解约束条件。学过数学的都知道，解不出来的方程可太多了。在程序中会面临更复杂的情况：\n\n程序调用无源码函数\n1234def func(x, y):    z = do_something(x)    if y + z &lt; 0:        print(&#x27;error&#x27;)\n\n不可解的非线程约束条件\n\n\n为了处理不可解的场景，动态符号执行诞生了，它将具体值与符号值结合，在符号值解不了的场景，用具体值代替，达到化简约束、降低求解难度的目的。\n2. 动态符号执行  静态符号执行不需要运行程序，动态符号执行则是要设置输入，启动程序，让程序跑起来。在程序运行过程中，程序的变量在理论上都有两种取值，一种是符号值，一种是具体值。\n在实现上，根据两种取值的配合方式，动态符号执行可分为两种路线：\nConcolic Testing在这种测试方法中，每个变量同时保留了符号值和具体值。在求解约束条件时，如果用符号值表达的约束条件解不了，那就将具体值代入对应的符号变量，化简条件再求解。\n此外，这种测试方法在一条路径探索结束后，会通过对条件约束进行取反操作，切换到其他的执行路径，再继续进行探索。\n\n\nExecution-Generated Testing在这种测试方法中，每个变量值保留符号值和具体值中的一个状态。程序中的任何一个运算，如果所有相关变量都是具体值，那就使用具体执行；如果有任何一个变量是符号值，那就使用符号执行。\n\n\n缺陷  没有完美的方案，动态符号执行虽然能缓解约束不可解的问题，但是使用具体值简化，也可能导致部分可执行路径无法被探索到。\n1234def func(x):    y = do_something(x)    if y &gt; 0:        print(&#x27;error&#x27;)\n\n由于 do_something 的源码未知，使用静态符号执行无法求解，动态符号执行会用 x 的具体值来计算 y。假设算出来y==-1，那么if 的判断条件由于矛盾而终止，导致 error 不可达。\n为了解决这个问题，需要不断地更换 x 的具体值。从这个角度来看，将 Fuzz 和动态符号执行结合起来，是一件自然而然的事情，于是就有了混合模糊测试技术（Hybrid Fuzzing)。\n3. 参考资料\n符号执行入门\nSymbolic Execution for Software Testing  Three Decades Later\nA Survey of Symbolic Execution Techniques\n北京大学 - 软件分析技术 - 第 19 课\nUsing Klee and Angr\n\n二、混合模糊测试1. 原理与架构Fuzz 测试与符号执行互有优劣，在一定程度上是互补关系。\n\n\n\n技术\n优点\n缺点\n\n\n\nFuzz 测试\n随机变异，运行速度快\n难以深入复杂的执行路径，代码覆盖率有限\n\n\n符号执行\n对程序进行分析和推理，可以突破复杂的路径约束\n运行速度慢，资源消耗大\n\n\n混合模糊测试结合二者的长处，通过 Fuzz 测试随机生成大量输入来测试程序的浅层代码，再结合动态符号执行来探索程序的深层路径，提升整体的代码覆盖率。\n混合模糊测试的常见架构设计如下：\n\n\n在 Fuzz 引擎和符号执行引擎之外，还有一个关键组件 Coordinator，其作用主要为协调 Fuzz 与符号执行的相互配合。 \nFuzz 测试与符号执行在执行速度与资源消耗方面都有很大区别，这个差异还会随着 target 而各有不同。如何设计一个好的 Coordinator，让运行时的性能最优，是混合模糊测试需要考虑的一个关键因素。\n2. SymCCSymCC是一款开源的动态符号执行工具，通过在编译时插桩，为每个变量构建符号表达，在运行时，缩短符号推理计算的时间，相比此前的符号执行工具（如 KLEE 和 QSYM）性能有明显提升。\nSymCC 由于出色表现，已被 LibAFL 官方集成。SymCC 本身提供了一个 symcc_fuzzing_helper 工具，简单快速的支持混合模糊测试功能，其核心代码为：\n\n\n这段代码的主要逻辑为：每隔 5 秒检查 AFL 的corpus目录，如果 AFL 有产生新的测试用例，那么就将这个测试用例发给 symcc，symcc 基于这个测试用例开始动态符号执行。\n使用 SymCC 进行混合模糊测试的步骤请见参考资料。能顺利跑起来的开源项目不多，SymCC 必须给个好评。\n3. 参考资料\nExploratory Review of Hybrid Fuzzing for Automated Vulnerability Detection\nSymbolic execution with SymCC: Don’t interpret, compile!\n符号执行 Symcc 与模糊测试 AFL 结合实践\n","dateCreated":"2023-12-24T16:22:08+08:00","dateModified":"2024-06-27T16:12:14+08:00","datePublished":"2023-12-24T16:22:08+08:00","description":"介绍符号执行技术，以及符号执行与 Fuzz 相结合的混合模糊测试技术","headline":"符号执行与混合模糊测试","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2023/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C%E4%B8%8E%E6%B7%B7%E5%90%88%E6%A8%A1%E7%B3%8A%E6%B5%8B%E8%AF%95/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2023/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C%E4%B8%8E%E6%B7%B7%E5%90%88%E6%A8%A1%E7%B3%8A%E6%B5%8B%E8%AF%95/","keywords":"Fuzz, 安全, 符号执行"}</script>
+    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n一、符号执行 1. 静态符号执行 定义  符号执行是一种程序分析技术，它通过使用符号代替实际的运行时值来探索程序的所有可能执行路径。这种技术不仅可以帮助生成覆盖率高的测试用例，还能有效地发现潜在的程序错误。\n\n\n具体地，符号执行采用抽象的符号代替具体值作为程序输入变量，得出每个路径抽象的输出结果和需要满足的约束条件。通过约束求解器，可以反推出指定程序路径时，程序输入应该设置的具体值。\n这种传统的符号执行不需要运行程序，所以也称为静态符号执行，它与 fuzz 测试相比各有优劣。举例来说，当我要求如下程序触发 AssertionError 时：\n12345def f():    x = int(input())    y = x * 2    if y == 12:        assert False\n如果使用 fuzz 测试，由于 x 是随机输入，为了满足y==12，fuzz 需要进行大量的尝试。\n如果使用符号执行，要触发 AssertionError 只需要满足约束条件 2*x==12 即可，求解可得x==6，一次分析即可搞定。\n原理  符号执行包括三个核心组件：\n\n状态信息存储器\nσ：程序变量的符号表达式\nπ：路径约束，即走到特定语句所经过的条件组合\nstmt：指向需要处理的下一条程序语句\n\n\n语句执行器：执行 stmt 指向的语句，更新 σ 或π的状态\n约束求解器：根据路径约束 π 和符号表达式σ，求出可行解\n\n下图演示了符号执行过程中，各组件的变化情况：\n\n\n缺陷  只需一次分析，即可获得所有路径的可行解，这个理想很美好，但现实很骨感。 静态符号执行在实际应用中，面临两大挑战：\n1. 路径爆炸\n程序中的分支和循环，都会使得程序路径爆炸式增长，导致分析过程变得不可行：\n\n每增加一次条件判断，程序会产生两个分支，极端情况下，路径数量呈指数增长\n无限循环和递归调用，可能导致无穷长的路径1234567def func():    s = 0    x = int(input())    while x &gt; 0:        s += x        print(f&#x27;total sum: &#123;s&#125;&#x27;)        x = int(input())\n\n处理路径爆炸问题的思路主要是限制分析的搜索空间，例如设置超时机制、搜索次数，使用启发式搜索等策略。\n2. 约束不可解\n符号执行中的关键环节在于约束求解器求解约束条件。学过数学的都知道，解不出来的方程可太多了。在程序中会面临更复杂的情况：\n\n程序调用无源码函数\n1234def func(x, y):    z = do_something(x)    if y + z &lt; 0:        print(&#x27;error&#x27;)\n\n不可解的非线程约束条件\n\n\n为了处理不可解的场景，动态符号执行诞生了，它将具体值与符号值结合，在符号值解不了的场景，用具体值代替，达到化简约束、降低求解难度的目的。\n2. 动态符号执行  静态符号执行不需要运行程序，动态符号执行则是要设置输入，启动程序，让程序跑起来。在程序运行过程中，程序的变量在理论上都有两种取值，一种是符号值，一种是具体值。\n在实现上，根据两种取值的配合方式，动态符号执行可分为两种路线：\nConcolic Testing在这种测试方法中，每个变量同时保留了符号值和具体值。在求解约束条件时，如果用符号值表达的约束条件解不了，那就将具体值代入对应的符号变量，化简条件再求解。\n此外，这种测试方法在一条路径探索结束后，会通过对条件约束进行取反操作，切换到其他的执行路径，再继续进行探索。\n\n\nExecution-Generated Testing在这种测试方法中，每个变量值保留符号值和具体值中的一个状态。程序中的任何一个运算，如果所有相关变量都是具体值，那就使用具体执行；如果有任何一个变量是符号值，那就使用符号执行。\n\n\n缺陷  没有完美的方案，动态符号执行虽然能缓解约束不可解的问题，但是使用具体值简化，也可能导致部分可执行路径无法被探索到。\n1234def func(x):    y = do_something(x)    if y &gt; 0:        print(&#x27;error&#x27;)\n\n由于 do_something 的源码未知，使用静态符号执行无法求解，动态符号执行会用 x 的具体值来计算 y。假设算出来y==-1，那么if 的判断条件由于矛盾而终止，导致 error 不可达。\n为了解决这个问题，需要不断地更换 x 的具体值。从这个角度来看，将 Fuzz 和动态符号执行结合起来，是一件自然而然的事情，于是就有了混合模糊测试技术（Hybrid Fuzzing)。\n3. 参考资料\n符号执行入门\nSymbolic Execution for Software Testing  Three Decades Later\nA Survey of Symbolic Execution Techniques\n北京大学 - 软件分析技术 - 第 19 课\nUsing Klee and Angr\n\n二、混合模糊测试1. 原理与架构Fuzz 测试与符号执行互有优劣，在一定程度上是互补关系。\n\n\n\n技术\n优点\n缺点\n\n\n\nFuzz 测试\n随机变异，运行速度快\n难以深入复杂的执行路径，代码覆盖率有限\n\n\n符号执行\n对程序进行分析和推理，可以突破复杂的路径约束\n运行速度慢，资源消耗大\n\n\n混合模糊测试结合二者的长处，通过 Fuzz 测试随机生成大量输入来测试程序的浅层代码，再结合动态符号执行来探索程序的深层路径，提升整体的代码覆盖率。\n混合模糊测试的常见架构设计如下：\n\n\n在 Fuzz 引擎和符号执行引擎之外，还有一个关键组件 Coordinator，其作用主要为协调 Fuzz 与符号执行的相互配合。 \nFuzz 测试与符号执行在执行速度与资源消耗方面都有很大区别，这个差异还会随着 target 而各有不同。如何设计一个好的 Coordinator，让运行时的性能最优，是混合模糊测试需要考虑的一个关键因素。\n2. SymCCSymCC是一款开源的动态符号执行工具，通过在编译时插桩，为每个变量构建符号表达，在运行时，缩短符号推理计算的时间，相比此前的符号执行工具（如 KLEE 和 QSYM）性能有明显提升。\nSymCC 由于出色表现，已被 LibAFL 官方集成。SymCC 本身提供了一个 symcc_fuzzing_helper 工具，简单快速的支持混合模糊测试功能，其核心代码为：\n\n\n这段代码的主要逻辑为：每隔 5 秒检查 AFL 的corpus目录，如果 AFL 有产生新的测试用例，那么就将这个测试用例发给 symcc，symcc 基于这个测试用例开始动态符号执行。\n使用 SymCC 进行混合模糊测试的步骤请见参考资料。能顺利跑起来的开源项目不多，SymCC 必须给个好评。\n3. 参考资料\nExploratory Review of Hybrid Fuzzing for Automated Vulnerability Detection\nSymbolic execution with SymCC: Don’t interpret, compile!\n符号执行 Symcc 与模糊测试 AFL 结合实践\n","dateCreated":"2023-12-24T16:22:08+08:00","dateModified":"2024-06-27T16:12:14+08:00","datePublished":"2023-12-24T16:22:08+08:00","description":"介绍符号执行技术，以及符号执行与 Fuzz 相结合的混合模糊测试技术","headline":"符号执行与混合模糊测试","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2023/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C%E4%B8%8E%E6%B7%B7%E5%90%88%E6%A8%A1%E7%B3%8A%E6%B5%8B%E8%AF%95/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2023/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C%E4%B8%8E%E6%B7%B7%E5%90%88%E6%A8%A1%E7%B3%8A%E6%B5%8B%E8%AF%95/","keywords":"符号执行, 安全, Fuzz"}</script>
     <meta name="description" content="介绍符号执行技术，以及符号执行与 Fuzz 相结合的混合模糊测试技术">
 <meta property="og:type" content="blog">
 <meta property="og:title" content="符号执行与混合模糊测试">
@@ -29,9 +29,9 @@
 <meta property="article:published_time" content="2023-12-24T08:22:08.000Z">
 <meta property="article:modified_time" content="2024-06-27T08:12:14.674Z">
 <meta property="article:author" content="一瓢清浅">
-<meta property="article:tag" content="Fuzz">
-<meta property="article:tag" content="安全">
 <meta property="article:tag" content="符号执行">
+<meta property="article:tag" content="安全">
+<meta property="article:tag" content="Fuzz">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:image" content="https://www.stepbystep.asia/2023/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C%E4%B8%8E%E6%B7%B7%E5%90%88%E6%A8%A1%E7%B3%8A%E6%B5%8B%E8%AF%95/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C%E5%AE%9A%E4%B9%89.png">
     
diff --git "a/2024/AFLplusplus\346\272\220\347\240\201\345\210\206\346\236\220\342\200\224\342\200\224\345\220\214\346\255\245\346\234\272\345\210\266/index.html" "b/2024/AFLplusplus\346\272\220\347\240\201\345\210\206\346\236\220\342\200\224\342\200\224\345\220\214\346\255\245\346\234\272\345\210\266/index.html"
index 28a6c71..48062fa 100644
--- "a/2024/AFLplusplus\346\272\220\347\240\201\345\210\206\346\236\220\342\200\224\342\200\224\345\220\214\346\255\245\346\234\272\345\210\266/index.html"
+++ "b/2024/AFLplusplus\346\272\220\347\240\201\345\210\206\346\236\220\342\200\224\342\200\224\345\220\214\346\255\245\346\234\272\345\210\266/index.html"
@@ -14,7 +14,7 @@
     
     
     
-    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n最近遇到 AFL++ 同步 interesting corpus 失败的问题，不得不嗑一嗑 AFL++ 的源码了，该来的躲不掉，虽然 C 代码让我有点头大。\n一、同步机制  常规情况下 AFL++ 是以单实例运行的。三个臭皮匠顶个诸葛亮，多开几个 AFL++ 实例一起跑是可行的，AFL++ 和其他的 Fuzz 工具（LibFuzzer、HonggFuzz）一起跑也是可以的。\n通过 afl-fuzz -h 可以看到 AFL++ 提供了相关的命令参数：\n\nOther stuff:&emsp;-M&#x2F;-S id&emsp;- distributed mode (-M sets -Z and disables trimming)&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;see docs&#x2F;fuzzing_in_depth.md#c-using-multiple-cores&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;for effective recommendations for parallel fuzzing.&emsp;-F path&emsp;- sync to a foreign fuzzer queue directory (requires -M, can&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;be specified up to 32 times)\n\n简而言之，AFL++ 同步相关的几个参数如下：\n\n-M：指定 AFL++ 主实例。主实例会从 -S 指定的从实例、-F 指定的其他 Fuzz 中同步有趣的测试用例。主实例只有一个，负责管理所有的测试用例。\n-S：指定 AFL++ 从实例。从实例产生的有趣测试用例将被同步到 -M 指定的主实例中，从实例也会从 -M 指定的主实例中同步有趣的测试用例。\n-F：指定其他 Fuzz 实例的 corpus 目录。由其他 Fuzz 产生的有趣的测试用例，将会被同步到 -M 指定的主实例中。\n\n可以看到  主实例位于多实例运行模式的核心地位，它负责汇总和分发 AFL++ 的测试用例。\n123456789101112131415  +---------+       +---------+  | Fuzzer 1|       | Fuzzer 2|  |   (F)   |       |   (F)   |  +----+----+       +----+----+       |                 |       v                 v+------+-----------------+------+|           Master (M)          |+-----+---------------+---------+      ^  |            ^  |      |  v            |  v  +---------+      +---------+  | Slave 1 |      | Slave 2 |  |   (S)   |      |   (S)   |  +---------+      +---------+\n\n实际使用时，执行命令参考如下：\n123afl-fuzz -i inputs -o outputs -M master -F /path/to/foreign_fuzzer1/queue -F /path/to/foreign_fuzzer2/queue -- ./targetafl-fuzz -i inputs -o outputs -S slave1 -- ./targetafl-fuzz -i inputs -o outputs -S slave2 -- ./target\n\n二、源码分析 AFL++ 的源码入口为afl_fuzz.c 的main函数。AFL++ 从其他 fuzzer 中同步 corpus，是通过 sync_fuzzers 函数来实现的。\n在 main 函数中，可以看到对 sync_fuzzers 函数的调用。一路跟踪下来，代码调用关系参考如下时序图：\nsequenceDiagram\n    participant main\n    participant sync_fuzzers\n    participant read_foreign_testcases\n    participant update_sync_time\n    participant scandir\n    participant fuzz_run_target\n    participant save_if_interesting\n    participant has_new_bits\n    participant describe_op\n    participant ck_write\n    participant add_to_queue\n\n    main->>sync_fuzzers: 开始同步\n    loop 遍历 AFL++ 的 out 目录中的子目录 d_name\n        sync_fuzzers->>update_sync_time: 更新同步时间\n        sync_fuzzers->>scandir: 读取 d_name/queue 目录中的 corpus 列表\n        loop 遍历新增的 corpus（通过 corpus 的 id 号来识别）\n            sync_fuzzers->>fuzz_run_target: 用 corpus 作为输入运行一次 target\n            fuzz_run_target-->>sync_fuzzers: 返回 target 运行结果\n            sync_fuzzers->>save_if_interesting: 检查并保存 corpus\n            save_if_interesting->>has_new_bits: 检查 corpus 是否为 interesting\n            has_new_bits-->>save_if_interesting: 返回检查结果\n            alt 如果 corpus 是 interesting\n                save_if_interesting->>describe_op: 为 corpus 创建文件名\n                describe_op-->>save_if_interesting: 返回文件名\n                save_if_interesting-->>ck_write: 将 interesting 的 corpus 保存到 AFL++ 的 queue 目录中\n                save_if_interesting->>add_to_queue: 将 interesting 的 corpus 添加到 AFL++ 的队列中\n            end\n        end\n    end\n    alt 如果指定了其他 Fuzz 的 corpus 目录\n        sync_fuzzers->>read_foreign_testcases: 开始同步其他 Fuzz 的 corpus\n        loop 遍历其他 Fuzz 的 corpus 目录\n            read_foreign_testcases->>scandir: 读取其他 Fuzz 的 corpus 列表\n            loop 遍历其他 Fuzz 的 corpus\n                read_foreign_testcases->>fuzz_run_target: 用 corpus 作为输入运行一次 target\n                fuzz_run_target-->>read_foreign_testcases: 返回 target 运行结果\n                read_foreign_testcases->>save_if_interesting: 检查 corpus 是否为 interesting\n                save_if_interesting->>has_new_bits: 检查 corpus 是否为 interesting\n                has_new_bits-->>save_if_interesting: 返回检查结果\n                alt 如果 corpus 是 interesting\n                    save_if_interesting->>describe_op: 为 corpus 创建文件名\n                    describe_op-->>save_if_interesting: 返回文件名\n                    save_if_interesting-->>ck_write: 将 interesting 的 corpus 保存到 AFL++ 的 queue 目录中\n                    save_if_interesting->>add_to_queue: 将 interesting 的 corpus 添加到 AFL++ 的队列中\n                end\n            end\n        end\n        read_foreign_testcases-->>sync_fuzzers: 同步其他 Fuzz 的 corpus 结束\n    end\n    sync_fuzzers-->>main: 同步完毕\n简而言之，主实例同步从实例过程是这样的：\n\nAFL++ 会检查 out 目录下的文件夹（排除 AFL++ 本身的 default 文件夹）\n如果文件夹中没有 queue 子目录，转 1\n如果文件夹中有 queue，则遍历 queue 下的 corpus\n如果 corpus 是处理过的（根据文件名 id 判断），转 4\n如果 corpus 是没有处理过的，那就用这个 corpus 作为输入，执行一次 target\n分析 target 执行结果，判断 corpus 是否为 interesting，如果不是 interesting，转 3\n如果 corpus 是 interesting，则将 corpus 保存为 out&#x2F;default&#x2F;queue 目录下的文件，并将 corpus 添加到 AFL++ 的内存队列中，再转 3\n\n主实例同步其他 Fuzz 的过程与之类似，只是每次同步时，并不会根据 corpus 文件名的 id 编号过滤已经分析过的 corpus，因此从外部 Fuzz 同步 corpus 的性能较差。\n三、实践应用  如果某一款工具能生成 corpus，但是希望以从示例的方式被主实例同步，需要保证这款工具产生的 corpus 的命名符合以下要求：\n\n以 id: 开头，然后是高位补 0 的六位数字\n第一个 corpus 的 id 从 0 开始，随后的 corpus 依次以 1 递增\n\n其原因读一遍 sync_fuzzers 的源码就明白了，源码面前，了无秘密。\n","dateCreated":"2024-07-16T09:02:06+08:00","dateModified":"2024-07-24T11:41:30+08:00","datePublished":"2024-07-16T09:02:06+08:00","description":"分析 AFL++ 同步机制的相关源码","headline":"AFLplusplus 源码分析——同步机制","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E5%90%8C%E6%AD%A5%E6%9C%BA%E5%88%B6/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E5%90%8C%E6%AD%A5%E6%9C%BA%E5%88%B6/","keywords":"AFL++, Fuzz, 安全, 工具"}</script>
+    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n最近遇到 AFL++ 同步 interesting corpus 失败的问题，不得不嗑一嗑 AFL++ 的源码了，该来的躲不掉，虽然 C 代码让我有点头大。\n一、同步机制  常规情况下 AFL++ 是以单实例运行的。三个臭皮匠顶个诸葛亮，多开几个 AFL++ 实例一起跑是可行的，AFL++ 和其他的 Fuzz 工具（LibFuzzer、HonggFuzz）一起跑也是可以的。\n通过 afl-fuzz -h 可以看到 AFL++ 提供了相关的命令参数：\n\nOther stuff:&emsp;-M&#x2F;-S id&emsp;- distributed mode (-M sets -Z and disables trimming)&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;see docs&#x2F;fuzzing_in_depth.md#c-using-multiple-cores&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;for effective recommendations for parallel fuzzing.&emsp;-F path&emsp;- sync to a foreign fuzzer queue directory (requires -M, can&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;be specified up to 32 times)\n\n简而言之，AFL++ 同步相关的几个参数如下：\n\n-M：指定 AFL++ 主实例。主实例会从 -S 指定的从实例、-F 指定的其他 Fuzz 中同步有趣的测试用例。主实例只有一个，负责管理所有的测试用例。\n-S：指定 AFL++ 从实例。从实例产生的有趣测试用例将被同步到 -M 指定的主实例中，从实例也会从 -M 指定的主实例中同步有趣的测试用例。\n-F：指定其他 Fuzz 实例的 corpus 目录。由其他 Fuzz 产生的有趣的测试用例，将会被同步到 -M 指定的主实例中。\n\n可以看到  主实例位于多实例运行模式的核心地位，它负责汇总和分发 AFL++ 的测试用例。\n123456789101112131415  +---------+       +---------+  | Fuzzer 1|       | Fuzzer 2|  |   (F)   |       |   (F)   |  +----+----+       +----+----+       |                 |       v                 v+------+-----------------+------+|           Master (M)          |+-----+---------------+---------+      ^  |            ^  |      |  v            |  v  +---------+      +---------+  | Slave 1 |      | Slave 2 |  |   (S)   |      |   (S)   |  +---------+      +---------+\n\n实际使用时，执行命令参考如下：\n123afl-fuzz -i inputs -o outputs -M master -F /path/to/foreign_fuzzer1/queue -F /path/to/foreign_fuzzer2/queue -- ./targetafl-fuzz -i inputs -o outputs -S slave1 -- ./targetafl-fuzz -i inputs -o outputs -S slave2 -- ./target\n\n二、源码分析 AFL++ 的源码入口为afl_fuzz.c 的main函数。AFL++ 从其他 fuzzer 中同步 corpus，是通过 sync_fuzzers 函数来实现的。\n在 main 函数中，可以看到对 sync_fuzzers 函数的调用。一路跟踪下来，代码调用关系参考如下时序图：\nsequenceDiagram\n    participant main\n    participant sync_fuzzers\n    participant read_foreign_testcases\n    participant update_sync_time\n    participant scandir\n    participant fuzz_run_target\n    participant save_if_interesting\n    participant has_new_bits\n    participant describe_op\n    participant ck_write\n    participant add_to_queue\n\n    main->>sync_fuzzers: 开始同步\n    loop 遍历 AFL++ 的 out 目录中的子目录 d_name\n        sync_fuzzers->>update_sync_time: 更新同步时间\n        sync_fuzzers->>scandir: 读取 d_name/queue 目录中的 corpus 列表\n        loop 遍历新增的 corpus（通过 corpus 的 id 号来识别）\n            sync_fuzzers->>fuzz_run_target: 用 corpus 作为输入运行一次 target\n            fuzz_run_target-->>sync_fuzzers: 返回 target 运行结果\n            sync_fuzzers->>save_if_interesting: 检查并保存 corpus\n            save_if_interesting->>has_new_bits: 检查 corpus 是否为 interesting\n            has_new_bits-->>save_if_interesting: 返回检查结果\n            alt 如果 corpus 是 interesting\n                save_if_interesting->>describe_op: 为 corpus 创建文件名\n                describe_op-->>save_if_interesting: 返回文件名\n                save_if_interesting-->>ck_write: 将 interesting 的 corpus 保存到 AFL++ 的 queue 目录中\n                save_if_interesting->>add_to_queue: 将 interesting 的 corpus 添加到 AFL++ 的队列中\n            end\n        end\n    end\n    alt 如果指定了其他 Fuzz 的 corpus 目录\n        sync_fuzzers->>read_foreign_testcases: 开始同步其他 Fuzz 的 corpus\n        loop 遍历其他 Fuzz 的 corpus 目录\n            read_foreign_testcases->>scandir: 读取其他 Fuzz 的 corpus 列表\n            loop 遍历其他 Fuzz 的 corpus\n                read_foreign_testcases->>fuzz_run_target: 用 corpus 作为输入运行一次 target\n                fuzz_run_target-->>read_foreign_testcases: 返回 target 运行结果\n                read_foreign_testcases->>save_if_interesting: 检查 corpus 是否为 interesting\n                save_if_interesting->>has_new_bits: 检查 corpus 是否为 interesting\n                has_new_bits-->>save_if_interesting: 返回检查结果\n                alt 如果 corpus 是 interesting\n                    save_if_interesting->>describe_op: 为 corpus 创建文件名\n                    describe_op-->>save_if_interesting: 返回文件名\n                    save_if_interesting-->>ck_write: 将 interesting 的 corpus 保存到 AFL++ 的 queue 目录中\n                    save_if_interesting->>add_to_queue: 将 interesting 的 corpus 添加到 AFL++ 的队列中\n                end\n            end\n        end\n        read_foreign_testcases-->>sync_fuzzers: 同步其他 Fuzz 的 corpus 结束\n    end\n    sync_fuzzers-->>main: 同步完毕\n简而言之，主实例同步从实例过程是这样的：\n\nAFL++ 会检查 out 目录下的文件夹（排除 AFL++ 本身的 default 文件夹）\n如果文件夹中没有 queue 子目录，转 1\n如果文件夹中有 queue，则遍历 queue 下的 corpus\n如果 corpus 是处理过的（根据文件名 id 判断），转 4\n如果 corpus 是没有处理过的，那就用这个 corpus 作为输入，执行一次 target\n分析 target 执行结果，判断 corpus 是否为 interesting，如果不是 interesting，转 3\n如果 corpus 是 interesting，则将 corpus 保存为 out&#x2F;default&#x2F;queue 目录下的文件，并将 corpus 添加到 AFL++ 的内存队列中，再转 3\n\n主实例同步其他 Fuzz 的过程与之类似，只是每次同步时，并不会根据 corpus 文件名的 id 编号过滤已经分析过的 corpus，因此从外部 Fuzz 同步 corpus 的性能较差。\n三、实践应用  如果某一款工具能生成 corpus，但是希望以从示例的方式被主实例同步，需要保证这款工具产生的 corpus 的命名符合以下要求：\n\n以 id: 开头，然后是高位补 0 的六位数字\n第一个 corpus 的 id 从 0 开始，随后的 corpus 依次以 1 递增\n\n其原因读一遍 sync_fuzzers 的源码就明白了，源码面前，了无秘密。\n","dateCreated":"2024-07-16T09:02:06+08:00","dateModified":"2024-07-24T11:41:30+08:00","datePublished":"2024-07-16T09:02:06+08:00","description":"分析 AFL++ 同步机制的相关源码","headline":"AFLplusplus 源码分析——同步机制","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E5%90%8C%E6%AD%A5%E6%9C%BA%E5%88%B6/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E5%90%8C%E6%AD%A5%E6%9C%BA%E5%88%B6/","keywords":"安全, 工具, Fuzz, AFL++"}</script>
     <meta name="description" content="分析 AFL++ 同步机制的相关源码">
 <meta property="og:type" content="blog">
 <meta property="og:title" content="AFLplusplus 源码分析——同步机制">
@@ -26,10 +26,10 @@
 <meta property="article:published_time" content="2024-07-16T01:02:06.000Z">
 <meta property="article:modified_time" content="2024-07-24T03:41:30.618Z">
 <meta property="article:author" content="一瓢清浅">
-<meta property="article:tag" content="AFL++">
-<meta property="article:tag" content="Fuzz">
 <meta property="article:tag" content="安全">
 <meta property="article:tag" content="工具">
+<meta property="article:tag" content="Fuzz">
+<meta property="article:tag" content="AFL++">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:image" content="https://www.stepbystep.asia/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E5%90%8C%E6%AD%A5%E6%9C%BA%E5%88%B6/sync_fuzzers%E6%BA%90%E7%A0%81.png">
     
diff --git "a/2024/AFLplusplus\346\272\220\347\240\201\345\210\206\346\236\220\342\200\224\342\200\224\350\246\206\347\233\226\347\216\207/index.html" "b/2024/AFLplusplus\346\272\220\347\240\201\345\210\206\346\236\220\342\200\224\342\200\224\350\246\206\347\233\226\347\216\207/index.html"
index c0ab6fe..0f55347 100644
--- "a/2024/AFLplusplus\346\272\220\347\240\201\345\210\206\346\236\220\342\200\224\342\200\224\350\246\206\347\233\226\347\216\207/index.html"
+++ "b/2024/AFLplusplus\346\272\220\347\240\201\345\210\206\346\236\220\342\200\224\342\200\224\350\246\206\347\233\226\347\216\207/index.html"
@@ -14,7 +14,7 @@
     
     
     
-    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n前文 AFL++ 同步机制 提到，执行同步函数 sync_fuzzers 会调用函数 save_if_interesting。顾名思义，这个save_if_interesting 函数是用来保存 interesting 的 corpus。\nAFL++ 认为 corpus 是否 interesting，是基于 corpus 对 binary 的代码覆盖率来判断。在分析 save_if_interesting 的源码之前，有必要了解一下 AFL++ 的覆盖率统计机制。\n一、原理简介  在AFL++ 白皮书  中，对覆盖率的计算有简要说明。\n首先，通过插桩，来跟踪 corpus 在 binary 中走过的路径，并将路径转换为一系列 (branch_src, branch_dst) 元组的集合。例如：\n12corpus 1: A -&gt; B -&gt; C -&gt; D -&gt; E  =&gt;  (AB, BC, CD, DE)corpus 2: A -&gt; B -&gt; D -&gt; C -&gt; E  =&gt;  (AB, BD, DC, CE)\n\n其次，通过一个共享数组 shared_mem 来记录 (branch_src, branch_dst) 元组（可以看作是 CFG 中的 edge 的表示）被命中的次数，伪代码为：\n123cur_location = &lt;COMPILE_TIME_RANDOM&gt;;shared_mem[cur_location ^ prev_location]++; prev_location = cur_location &gt;&gt; 1;\n当 corpus 从 branch_src 走到 branch_dst 时，将 branch_dst 与branch_src进行异或运算的结果作为 shared_mem 的索引，并给索引指向的元素进行加一操作，表示多命中一次(branch_src, branch_dst)。\n值得注意的是最后一行的右移操作。当从 branch_dst 开始找下一个 edge 时，并没有直接把 cur_location 赋值给 pre_location，而是先对cur_location 进行了一次右移操作，再赋值给pre_location。这样处理的好处有两个：\n\n区分 AB 和 BA。如果没有进行右移，那么 A^B 算出的索引，和 B^A 算出的索引，二者是相等的，也就是把 AB 和 BA 看做是同一个 edge。实际上 CFG 中 edge 都是有向边，方向性是一个很重要的信息。\n区分 AA 和 BB。在循环体中，如果 prev_location 与cur_location相等，那么 cur_location^prev_location 的结果将恒等于 0。导致循环体执行不同的 basic block 时，在 shared_mem 中无法得到有效区分。\n\n这种统计方式也是有一定局限性的，例如：\n123corpus 1: A -&gt; B -&gt; C -&gt; D -&gt; E  =&gt;  (AB, BC, CD, DE)corpus 2: A -&gt; B -&gt; C -&gt; A -&gt; E  =&gt;  (AB, BC, CA, AE)corpus 3: A -&gt; B -&gt; C -&gt; A -&gt; B -&gt; C -&gt; A -&gt; B -&gt; C -&gt; D -&gt; E  =&gt;  (AB, BC, CD, DE)\ncorpus 2 与 corpus 1 相比，增加了新的 edge 元组 CA 和 AE。因此 AFL++ 认为 corpus 2 找到一条新的路径。corpus 3 与 corpus 1 相比，没有增加新的 edge 元组。即使 corpus 3 的真实路径与 corpus 1 的真实路径有明显区别，但在 AFL++ 看来，corpus 3 并没有找到一条新路径。\nAFL++ 在判断一个 corpus 是否 interesting 时，除了考虑 corpus 有没有找到新路径（命中新 edge），也会考虑 edge 的命中次数。为了简化命中次数的比较，AFL++ 对次数进行分桶处理，将命中次数分为如下 8 个桶（以 2 的幂次来分割）。当 corpus 使得 edge 的命中次数从一个桶变到另一个桶时，它也会被认为是 interesting。\n11, 2, 3, 4-7, 8-15, 16-31, 32-127, 128+\n此处有个疑问：3 作为单独一个桶有点乱入的感觉，为什么不是 2-3 作为一个桶，且为什么没有 0 这个桶呢？\n总结一下，AFL++ 认为一个 corpus 是 interesting，当且仅当 corpus 至少满足以下条件之一：\n\ncorpus 找到了一个新的 edge。\ncorpus 使某个 edge 的命中次数从一个 bucket 转移到另一个 bucket。\n\n二、源码分析 1. save_if_interestingsave_if_interesting 函数位于afl-fuzz-bitmap.c，其签名为：\n1u8 save_if_interesting(afl_state_t *afl, void *mem, u32 len, u8 fault);\n\n在 sync_fuzzers 中调用 save_if_interesting 的代码如下：\n123456789101112131415161718192021222324if (st.st_size &amp;&amp; st.st_size &lt;= MAX_FILE) &#123;    u8  fault;    u8 *mem = mmap(0, st.st_size, PROT_READ, MAP_PRIVATE, fd, 0);        if (mem == MAP_FAILED) &#123; PFATAL(&quot;Unable to mmap &#x27;%s&#x27;&quot;, path); &#125;        /* See what happens. We rely on save_if_interesting() to catch major       errors and save the test case. */        u32 new_len = write_to_testcase(afl, (void **)&amp;mem, st.st_size, 1);        fault = fuzz_run_target(afl, &amp;afl-&gt;fsrv, afl-&gt;fsrv.exec_tmout);        if (afl-&gt;stop_soon) &#123; goto close_sync; &#125;        afl-&gt;syncing_party = sd_ent-&gt;d_name;    afl-&gt;queued_imported += save_if_interesting(afl, mem, new_len, fault);    show_stats(afl);    afl-&gt;syncing_party = 0;        munmap(mem, st.st_size);&#125;\n\n可以看到 save_if_interesting 函数的入参分别为：\n1234afl: AFL++ 的全局状态mem: corpus 的内容len: corpus 的长度fault: fuzz_run_target 的执行结果，0 表示正常结束，1 表示运行超时，2 表示出现 crash\n\n在 save_if_interesting 函数体内，主要执行了如下流程：\nsequenceDiagram\n    save_if_interesting ->> has_new_bits: 检查 corpus 是否能更新 bitmap\n    has_new_bits ->> discover_word: 检查 bitmap 是否有变化\n    discover_word -->> has_new_bits: 返回检查结果\n    has_new_bits -->> save_if_interesting: 返回 0 表示无变化，返回 1 表示命中次数的 bucket 有变化，返回 2 表示找到了一个新 edge\n    save_if_interesting ->> describe_op: 创建 corpus 文件名\n    describe_op -->> save_if_interesting: 返回 corpus 文件名\n    save_if_interesting ->> ck_write: 将 corpus 保存为文件\n    save_if_interesting ->> add_to_queue: 将 corpus 添加到 AFL++ 的队列中\n\n2. has_new_bits负责检查整个 bitmap 是否有变化的是 has_new_bits 函数，其代码为：\n123456789101112131415161718192021222324252627282930313233343536373839404142/* Check if the current execution path brings anything new to the table.   Update virgin bits to reflect the finds. Returns 1 if the only change is   the hit-count for a particular tuple; 2 if there are new tuples seen.   Updates the map, so subsequent calls will always return 0.   This function is called after every exec() on a fairly large buffer, so   it needs to be fast. We do this in 32-bit and 64-bit flavors. */inline u8 has_new_bits(afl_state_t *afl, u8 *virgin_map) &#123;#ifdef WORD_SIZE_64  u64 *current = (u64 *)afl-&gt;fsrv.trace_bits;  u64 *virgin = (u64 *)virgin_map;  u32 i = ((afl-&gt;fsrv.real_map_size + 7) &gt;&gt; 3);#else  u32 *current = (u32 *)afl-&gt;fsrv.trace_bits;  u32 *virgin = (u32 *)virgin_map;  u32 i = ((afl-&gt;fsrv.real_map_size + 3) &gt;&gt; 2);#endif                                                     /* ^WORD_SIZE_64 */  u8 ret = 0;  while (i--) &#123;    if (unlikely(*current)) discover_word(&amp;ret, current, virgin);    current++;    virgin++;  &#125;  if (unlikely(ret) &amp;&amp; likely(virgin_map == afl-&gt;virgin_bits))    afl-&gt;bitmap_changed = 1;  return ret;&#125;\n首先在宏定义中，计算整个 binary 的 bitmap 的长度i（可以理解为 edge 的个数）。\n然后在 while 循环中，依次循环每个 edge，调用 discover_word 函数来完成实际比对操作。\ncurrent和 virgin 分别表示当前 corpus 覆盖路径对应的 bitmap，以及整个 AFL++ 已走过的路径所对应的 bitmap。\n需要理解它们的数据结构，current和 virgin 是长度相等的一维数组，每个元素的有效数据是一个字节，即 8 个 bits 构成的 bit 数组，在 64 位和 32 位系统中，分别用 u64 指针和 u32 指针来指示。\n在第一部分介绍 AFL++ 统计覆盖率的原理时有讲，AFL++ 讲每个 edge 的命中频次进行分桶处理，分成了 8 个桶，每个桶实际上是以一个 bit 位来表示。\n在 AFL++ 初始化 virgin 时，将所有的 bit 位都设为 1，因此 1 表示没有落在这个桶，0 表示落在这个桶。但在 current 中，bit 为 1 表示落在这个桶，0 表示没有落在这个桶。需要注意 bit 为 1 的含义相反！\n以 virgin 为例，若virgin[12345]=0b10110110，表示 AFL++ 产生的所有 corpus 在 12345 这个 edge 上，有命中 2 次、8-15 次、128+ 次三种情况。\n3. discover_word具体完成某个 edge 的 bitmap 对比的是 discover_word 函数，其代码为：\n123456789101112131415161718192021222324252627282930313233/* Updates the virgin bits, then reflects whether a new count or a new tuple is * seen in ret. */inline void discover_word(u8 *ret, u64 *current, u64 *virgin) &#123;  /* Optimize for (*current &amp; *virgin) == 0 - i.e., no bits in current bitmap     that have not been already cleared from the virgin map - since this will     almost always be the case. */  if (*current &amp; *virgin) &#123;    if (likely(*ret &lt; 2)) &#123;      u8 *cur = (u8 *)current;      u8 *vir = (u8 *)virgin;      /* Looks like we have not found any new bytes yet; see if any non-zero         bytes in current[] are pristine in virgin[]. */      if ((cur[0] &amp;&amp; vir[0] == 0xff) || (cur[1] &amp;&amp; vir[1] == 0xff) ||          (cur[2] &amp;&amp; vir[2] == 0xff) || (cur[3] &amp;&amp; vir[3] == 0xff) ||          (cur[4] &amp;&amp; vir[4] == 0xff) || (cur[5] &amp;&amp; vir[5] == 0xff) ||          (cur[6] &amp;&amp; vir[6] == 0xff) || (cur[7] &amp;&amp; vir[7] == 0xff))        *ret = 2;      else        *ret = 1;    &#125;    *virgin &amp;= ~*current;  &#125;&#125;\n首先，计算 *current &amp; *virgin，即将current 指向的 8 个 bits 与 virgin 指向的 8 个 bits 进行按位与运算。\n前面说到 bit=1 在current与 virgin 中的含义是相反的，那么 current 与virgin按位与的结果为 1，说明至少有一个桶，virgin是没到过的，而 current 到了。\n接着，判断 likely(*ret &lt; 2)，在 AFL++ 看来*ret &lt; 2 是一个很可能出现的情况，current找到一个新的 edge，才会将设置*ret=2。\n判断 current 是否找到一个新的 edge，是通过依次比较 (cur[k] &amp;&amp; vir[k] == 0xff), k=0...7 来实现的。vir[k]==0xff表示所有桶的 bit 位为 1，即这个 edge 从来没到过。而 cur[k]==1 表示当前 corpus 到了这个 edge，从而认为 corpus 找到了新 edge。\n此处有个疑问：k 从 0 到 7 要怎么理解？从代码来看，current 和 virgin 的每个元素用 64 个 bit 来存储，分 8 次读取，某一次读取的 8 个 bit 是全为 1 就可以。那为什么不直接用 8 个 bit 来存储？\n4. describe_op在 AFL++ 获得一个 interesting 的 corpus 之后，会将其保存为文件。在保存之前，通过 describe_op 函数来生成文件名，在文件名中记录一些关键信息：\n1234567id: 记录 corpus 的 id 编号sync: 从哪个目录同步过来src: 从哪个 corpus 演化而来，记录来源 corpus 的 idtime: AFL++ 的运行时间execs: AFL++ 的运行次数+cov: 当前 corpus 找到了新 edge，即 has_new_bits 返回 2+tout: 当前 corpus 运行超时\n\n三、参考资料\nAFL 源码阅读（六）：队列、变异、同步\nAFL++ 白皮书和源码阅读\n","dateCreated":"2024-08-15T17:28:52+08:00","dateModified":"2024-09-13T15:11:29+08:00","datePublished":"2024-08-15T17:28:52+08:00","description":"分析 AFL++ 度量覆盖率的相关代码","headline":"AFL++ 源码分析——覆盖率","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E8%A6%86%E7%9B%96%E7%8E%87/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E8%A6%86%E7%9B%96%E7%8E%87/","keywords":"AFL++, Fuzz, 安全, 工具"}</script>
+    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n前文 AFL++ 同步机制 提到，执行同步函数 sync_fuzzers 会调用函数 save_if_interesting。顾名思义，这个save_if_interesting 函数是用来保存 interesting 的 corpus。\nAFL++ 认为 corpus 是否 interesting，是基于 corpus 对 binary 的代码覆盖率来判断。在分析 save_if_interesting 的源码之前，有必要了解一下 AFL++ 的覆盖率统计机制。\n一、原理简介  在AFL++ 白皮书  中，对覆盖率的计算有简要说明。\n首先，通过插桩，来跟踪 corpus 在 binary 中走过的路径，并将路径转换为一系列 (branch_src, branch_dst) 元组的集合。例如：\n12corpus 1: A -&gt; B -&gt; C -&gt; D -&gt; E  =&gt;  (AB, BC, CD, DE)corpus 2: A -&gt; B -&gt; D -&gt; C -&gt; E  =&gt;  (AB, BD, DC, CE)\n\n其次，通过一个共享数组 shared_mem 来记录 (branch_src, branch_dst) 元组（可以看作是 CFG 中的 edge 的表示）被命中的次数，伪代码为：\n123cur_location = &lt;COMPILE_TIME_RANDOM&gt;;shared_mem[cur_location ^ prev_location]++; prev_location = cur_location &gt;&gt; 1;\n当 corpus 从 branch_src 走到 branch_dst 时，将 branch_dst 与branch_src进行异或运算的结果作为 shared_mem 的索引，并给索引指向的元素进行加一操作，表示多命中一次(branch_src, branch_dst)。\n值得注意的是最后一行的右移操作。当从 branch_dst 开始找下一个 edge 时，并没有直接把 cur_location 赋值给 pre_location，而是先对cur_location 进行了一次右移操作，再赋值给pre_location。这样处理的好处有两个：\n\n区分 AB 和 BA。如果没有进行右移，那么 A^B 算出的索引，和 B^A 算出的索引，二者是相等的，也就是把 AB 和 BA 看做是同一个 edge。实际上 CFG 中 edge 都是有向边，方向性是一个很重要的信息。\n区分 AA 和 BB。在循环体中，如果 prev_location 与cur_location相等，那么 cur_location^prev_location 的结果将恒等于 0。导致循环体执行不同的 basic block 时，在 shared_mem 中无法得到有效区分。\n\n这种统计方式也是有一定局限性的，例如：\n123corpus 1: A -&gt; B -&gt; C -&gt; D -&gt; E  =&gt;  (AB, BC, CD, DE)corpus 2: A -&gt; B -&gt; C -&gt; A -&gt; E  =&gt;  (AB, BC, CA, AE)corpus 3: A -&gt; B -&gt; C -&gt; A -&gt; B -&gt; C -&gt; A -&gt; B -&gt; C -&gt; D -&gt; E  =&gt;  (AB, BC, CD, DE)\ncorpus 2 与 corpus 1 相比，增加了新的 edge 元组 CA 和 AE。因此 AFL++ 认为 corpus 2 找到一条新的路径。corpus 3 与 corpus 1 相比，没有增加新的 edge 元组。即使 corpus 3 的真实路径与 corpus 1 的真实路径有明显区别，但在 AFL++ 看来，corpus 3 并没有找到一条新路径。\nAFL++ 在判断一个 corpus 是否 interesting 时，除了考虑 corpus 有没有找到新路径（命中新 edge），也会考虑 edge 的命中次数。为了简化命中次数的比较，AFL++ 对次数进行分桶处理，将命中次数分为如下 8 个桶（以 2 的幂次来分割）。当 corpus 使得 edge 的命中次数从一个桶变到另一个桶时，它也会被认为是 interesting。\n11, 2, 3, 4-7, 8-15, 16-31, 32-127, 128+\n此处有个疑问：3 作为单独一个桶有点乱入的感觉，为什么不是 2-3 作为一个桶，且为什么没有 0 这个桶呢？\n总结一下，AFL++ 认为一个 corpus 是 interesting，当且仅当 corpus 至少满足以下条件之一：\n\ncorpus 找到了一个新的 edge。\ncorpus 使某个 edge 的命中次数从一个 bucket 转移到另一个 bucket。\n\n二、源码分析 1. save_if_interestingsave_if_interesting 函数位于afl-fuzz-bitmap.c，其签名为：\n1u8 save_if_interesting(afl_state_t *afl, void *mem, u32 len, u8 fault);\n\n在 sync_fuzzers 中调用 save_if_interesting 的代码如下：\n123456789101112131415161718192021222324if (st.st_size &amp;&amp; st.st_size &lt;= MAX_FILE) &#123;    u8  fault;    u8 *mem = mmap(0, st.st_size, PROT_READ, MAP_PRIVATE, fd, 0);        if (mem == MAP_FAILED) &#123; PFATAL(&quot;Unable to mmap &#x27;%s&#x27;&quot;, path); &#125;        /* See what happens. We rely on save_if_interesting() to catch major       errors and save the test case. */        u32 new_len = write_to_testcase(afl, (void **)&amp;mem, st.st_size, 1);        fault = fuzz_run_target(afl, &amp;afl-&gt;fsrv, afl-&gt;fsrv.exec_tmout);        if (afl-&gt;stop_soon) &#123; goto close_sync; &#125;        afl-&gt;syncing_party = sd_ent-&gt;d_name;    afl-&gt;queued_imported += save_if_interesting(afl, mem, new_len, fault);    show_stats(afl);    afl-&gt;syncing_party = 0;        munmap(mem, st.st_size);&#125;\n\n可以看到 save_if_interesting 函数的入参分别为：\n1234afl: AFL++ 的全局状态mem: corpus 的内容len: corpus 的长度fault: fuzz_run_target 的执行结果，0 表示正常结束，1 表示运行超时，2 表示出现 crash\n\n在 save_if_interesting 函数体内，主要执行了如下流程：\nsequenceDiagram\n    save_if_interesting ->> has_new_bits: 检查 corpus 是否能更新 bitmap\n    has_new_bits ->> discover_word: 检查 bitmap 是否有变化\n    discover_word -->> has_new_bits: 返回检查结果\n    has_new_bits -->> save_if_interesting: 返回 0 表示无变化，返回 1 表示命中次数的 bucket 有变化，返回 2 表示找到了一个新 edge\n    save_if_interesting ->> describe_op: 创建 corpus 文件名\n    describe_op -->> save_if_interesting: 返回 corpus 文件名\n    save_if_interesting ->> ck_write: 将 corpus 保存为文件\n    save_if_interesting ->> add_to_queue: 将 corpus 添加到 AFL++ 的队列中\n\n2. has_new_bits负责检查整个 bitmap 是否有变化的是 has_new_bits 函数，其代码为：\n123456789101112131415161718192021222324252627282930313233343536373839404142/* Check if the current execution path brings anything new to the table.   Update virgin bits to reflect the finds. Returns 1 if the only change is   the hit-count for a particular tuple; 2 if there are new tuples seen.   Updates the map, so subsequent calls will always return 0.   This function is called after every exec() on a fairly large buffer, so   it needs to be fast. We do this in 32-bit and 64-bit flavors. */inline u8 has_new_bits(afl_state_t *afl, u8 *virgin_map) &#123;#ifdef WORD_SIZE_64  u64 *current = (u64 *)afl-&gt;fsrv.trace_bits;  u64 *virgin = (u64 *)virgin_map;  u32 i = ((afl-&gt;fsrv.real_map_size + 7) &gt;&gt; 3);#else  u32 *current = (u32 *)afl-&gt;fsrv.trace_bits;  u32 *virgin = (u32 *)virgin_map;  u32 i = ((afl-&gt;fsrv.real_map_size + 3) &gt;&gt; 2);#endif                                                     /* ^WORD_SIZE_64 */  u8 ret = 0;  while (i--) &#123;    if (unlikely(*current)) discover_word(&amp;ret, current, virgin);    current++;    virgin++;  &#125;  if (unlikely(ret) &amp;&amp; likely(virgin_map == afl-&gt;virgin_bits))    afl-&gt;bitmap_changed = 1;  return ret;&#125;\n首先在宏定义中，计算整个 binary 的 bitmap 的长度i（可以理解为 edge 的个数）。\n然后在 while 循环中，依次循环每个 edge，调用 discover_word 函数来完成实际比对操作。\ncurrent和 virgin 分别表示当前 corpus 覆盖路径对应的 bitmap，以及整个 AFL++ 已走过的路径所对应的 bitmap。\n需要理解它们的数据结构，current和 virgin 是长度相等的一维数组，每个元素的有效数据是一个字节，即 8 个 bits 构成的 bit 数组，在 64 位和 32 位系统中，分别用 u64 指针和 u32 指针来指示。\n在第一部分介绍 AFL++ 统计覆盖率的原理时有讲，AFL++ 讲每个 edge 的命中频次进行分桶处理，分成了 8 个桶，每个桶实际上是以一个 bit 位来表示。\n在 AFL++ 初始化 virgin 时，将所有的 bit 位都设为 1，因此 1 表示没有落在这个桶，0 表示落在这个桶。但在 current 中，bit 为 1 表示落在这个桶，0 表示没有落在这个桶。需要注意 bit 为 1 的含义相反！\n以 virgin 为例，若virgin[12345]=0b10110110，表示 AFL++ 产生的所有 corpus 在 12345 这个 edge 上，有命中 2 次、8-15 次、128+ 次三种情况。\n3. discover_word具体完成某个 edge 的 bitmap 对比的是 discover_word 函数，其代码为：\n123456789101112131415161718192021222324252627282930313233/* Updates the virgin bits, then reflects whether a new count or a new tuple is * seen in ret. */inline void discover_word(u8 *ret, u64 *current, u64 *virgin) &#123;  /* Optimize for (*current &amp; *virgin) == 0 - i.e., no bits in current bitmap     that have not been already cleared from the virgin map - since this will     almost always be the case. */  if (*current &amp; *virgin) &#123;    if (likely(*ret &lt; 2)) &#123;      u8 *cur = (u8 *)current;      u8 *vir = (u8 *)virgin;      /* Looks like we have not found any new bytes yet; see if any non-zero         bytes in current[] are pristine in virgin[]. */      if ((cur[0] &amp;&amp; vir[0] == 0xff) || (cur[1] &amp;&amp; vir[1] == 0xff) ||          (cur[2] &amp;&amp; vir[2] == 0xff) || (cur[3] &amp;&amp; vir[3] == 0xff) ||          (cur[4] &amp;&amp; vir[4] == 0xff) || (cur[5] &amp;&amp; vir[5] == 0xff) ||          (cur[6] &amp;&amp; vir[6] == 0xff) || (cur[7] &amp;&amp; vir[7] == 0xff))        *ret = 2;      else        *ret = 1;    &#125;    *virgin &amp;= ~*current;  &#125;&#125;\n首先，计算 *current &amp; *virgin，即将current 指向的 8 个 bits 与 virgin 指向的 8 个 bits 进行按位与运算。\n前面说到 bit=1 在current与 virgin 中的含义是相反的，那么 current 与virgin按位与的结果为 1，说明至少有一个桶，virgin是没到过的，而 current 到了。\n接着，判断 likely(*ret &lt; 2)，在 AFL++ 看来*ret &lt; 2 是一个很可能出现的情况，current找到一个新的 edge，才会将设置*ret=2。\n判断 current 是否找到一个新的 edge，是通过依次比较 (cur[k] &amp;&amp; vir[k] == 0xff), k=0...7 来实现的。vir[k]==0xff表示所有桶的 bit 位为 1，即这个 edge 从来没到过。而 cur[k]==1 表示当前 corpus 到了这个 edge，从而认为 corpus 找到了新 edge。\n此处有个疑问：k 从 0 到 7 要怎么理解？从代码来看，current 和 virgin 的每个元素用 64 个 bit 来存储，分 8 次读取，某一次读取的 8 个 bit 是全为 1 就可以。那为什么不直接用 8 个 bit 来存储？\n4. describe_op在 AFL++ 获得一个 interesting 的 corpus 之后，会将其保存为文件。在保存之前，通过 describe_op 函数来生成文件名，在文件名中记录一些关键信息：\n1234567id: 记录 corpus 的 id 编号sync: 从哪个目录同步过来src: 从哪个 corpus 演化而来，记录来源 corpus 的 idtime: AFL++ 的运行时间execs: AFL++ 的运行次数+cov: 当前 corpus 找到了新 edge，即 has_new_bits 返回 2+tout: 当前 corpus 运行超时\n\n三、参考资料\nAFL 源码阅读（六）：队列、变异、同步\nAFL++ 白皮书和源码阅读\n","dateCreated":"2024-08-15T17:28:52+08:00","dateModified":"2024-09-13T15:11:29+08:00","datePublished":"2024-08-15T17:28:52+08:00","description":"分析 AFL++ 度量覆盖率的相关代码","headline":"AFL++ 源码分析——覆盖率","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E8%A6%86%E7%9B%96%E7%8E%87/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E8%A6%86%E7%9B%96%E7%8E%87/","keywords":"安全, 工具, Fuzz, AFL++"}</script>
     <meta name="description" content="分析 AFL++ 度量覆盖率的相关代码">
 <meta property="og:type" content="blog">
 <meta property="og:title" content="AFL++ 源码分析——覆盖率">
@@ -25,10 +25,10 @@
 <meta property="article:published_time" content="2024-08-15T09:28:52.000Z">
 <meta property="article:modified_time" content="2024-09-13T07:11:29.738Z">
 <meta property="article:author" content="一瓢清浅">
-<meta property="article:tag" content="AFL++">
-<meta property="article:tag" content="Fuzz">
 <meta property="article:tag" content="安全">
 <meta property="article:tag" content="工具">
+<meta property="article:tag" content="Fuzz">
+<meta property="article:tag" content="AFL++">
 <meta name="twitter:card" content="summary">
     
     
@@ -341,7 +341,7 @@ <h2 id="三、参考资料"><a href="# 三、参考资料" class="headerlink" ti
             <li class="post-action">
                 
                     
-                <a class="post-action-btn btn btn--default tooltip--top" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/" data-tooltip="ClusterFuzz 源码分析（一）" aria-label="上一篇: ClusterFuzz 源码分析（一）">
+                <a class="post-action-btn btn btn--default tooltip--top" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/" data-tooltip="ClusterFuzz 源码分析（一）" aria-label="上一篇: ClusterFuzz 源码分析（一）">
                     
                         <i class="fa fa-angle-left" aria-hidden="true"></i>
                         <span class="hide-xs hide-sm text-small icon-ml">上一篇</span>
@@ -404,7 +404,7 @@ <h2 id="三、参考资料"><a href="# 三、参考资料" class="headerlink" ti
             <li class="post-action">
                 
                     
-                <a class="post-action-btn btn btn--default tooltip--top" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/" data-tooltip="ClusterFuzz 源码分析（一）" aria-label="上一篇: ClusterFuzz 源码分析（一）">
+                <a class="post-action-btn btn btn--default tooltip--top" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/" data-tooltip="ClusterFuzz 源码分析（一）" aria-label="上一篇: ClusterFuzz 源码分析（一）">
                     
                         <i class="fa fa-angle-left" aria-hidden="true"></i>
                         <span class="hide-xs hide-sm text-small icon-ml">上一篇</span>
diff --git "a/2024/Angr\351\233\266\345\237\272\347\241\200\345\205\245\351\227\250/index.html" "b/2024/Angr\351\233\266\345\237\272\347\241\200\345\205\245\351\227\250/index.html"
index 613a02c..27014cc 100644
--- "a/2024/Angr\351\233\266\345\237\272\347\241\200\345\205\245\351\227\250/index.html"
+++ "b/2024/Angr\351\233\266\345\237\272\347\241\200\345\205\245\351\227\250/index.html"
@@ -14,7 +14,7 @@
     
     
     
-    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n一、Angr 简介Angr 是一个由 Python 语言编写的开源二进制分析框架，它主要用于静态分析、符号执行、逆向工程等安全研究领域。Angr 支持多种操作系统和硬件架构，包括 Windows、Linux、macOS 以及 x86、ARM 等。\n二、Angr 整体架构1、核心组件Angr 是一个复杂的二进制分析框架，其初始的整体架构设计如下图：\n\n\nAngr 的核心组件自下而上依次为：\n\nCLE：加载可执行文件和库文件\n\narchinfo：获取架构信息\n\nPyVEX：将指令转换成 VEX 这种中间语言（IR）\n\nSimuVEX：模拟执行引擎，负责在虚拟环境中执行 VEX\n\nClaripy：用于创建和管理符号变量及条件约束，传递给 Z3 求解器进行求解\n\nAngr：将各个组件集成起来，提供一套整体的二进制分析和符号执行框架\n\nanalysis：提供一套分析工具，通过 CFG、DDG 等对程序进行分析\n\nsurveyors：用于记录和跟踪程序的可执行路径\n\n\n随着 Angr 的发展，部分组件有更新和迭代：\n\nSimuVEX 被移除，其组件已集成到 Angr 中\n\nsurveyors 被移除，被 SimulationManager 所取代\n\n\n2、运作流程Angr 的整体运作流程如图：\n\n\n使用 Angr 进行二进制分析时，各组件的运行步骤为：\n\nCLE 加载二进制，获取机器指令\n\nArchinfo 分析二进制的架构类型\n\nPyVEX 根据架构类型，将机器指令转换为 VEX 中间表达\n\nSimEngine 基于 VEX 来模拟程序执行\n\nClarify 创建和管理执行过程中的符号变量和约束条件，转化为 SMT 表达式，传递给 Z3 求解\n\nSimOS（SimProcedures） 模拟程序与系统的交互，如标准 io 流、文件读写、系统调用等操作\n\n\n三、Angr 使用说明1. 安装Angr 需要 python 3.8 以上的运行环境，需要先装 3.8 版本以上的 python。\n安装 Angr 有两种推荐方式：\n\npip 安装\n1pip install Angr\n\n源码安装\n123git clone https://github.com/Angr/Angr-dev.gitcd Angr-dev./setup.sh -i -e Angr\n\n2. 运行  建议在虚拟环境中运行 Angr。源码安装的方式可以自动创建名为 Angr 的虚拟环境。手动创建虚拟环境的命令为：\n1python3 -m venv Angr\n\n启动虚拟环境：\n1source Angr/bin/active\n\n3. 使用Angr 作为 python 的三方库，通过 import 进行调用：\n1import Angr\n\nAngr 的顶层 API 围绕着 Angr 的核心组件来设计，包含一组常用的 Python 类和对象，它们提供了二进制分析、符号执行和其他功能。\n以下是 Angr 的一些常用 API 组件：\n\nProject（项目）：\n\nProject是 Angr 的中心组件，它代表了用户所要处理的二进制文件。\n创建一个 Project 实例是使用 Angr 进行分析的第一步，Project对象提供了对二进制文件的操作和分析的接口。\n\n\nFactory（工厂）：\n\nFactory对象通过 Project 的factory属性来访问，它提供了快速访问 Angr 的各种分析技术的接口，避免复杂的实例化操作。\n\n\nSimState（模拟状态）：\n\nSimState代表程序的一个瞬时状态，它包含寄存器、内存、堆栈、文件系统等运行时的上下文环境状态，可用于执行符号执行和具体执行。\nSimState对象通过 Project 的factory属性的方法来访问，这些方法包括 entry_state、blank_state、full_init_state 等。\n\n\nSimulationManager（模拟管理器）：\n\nSimulationManager用来跟踪程序执行过程中的路径探索和 SimState 演化，并对这些路径和 SimState 进行管理。\nSimulationManager对象通过 Project 的factory属性的 simulation_manager 方法实例化。\n\n\nLoader（加载器）：\n\nLoader负责将二进制文件载入内存，并处理符号以及它们的地址空间，为后续分析提供详细信息，如入口点、可执行段、符号表等。\nLoader对象通过 Project 的loader属性的方法来访问。\n\n\nBlock（块）：\n\nBlock表示程序基本块，是 Angr 分析的基本单位。每个 Block 是一组顺序执行代码片段，具有原子性，以分支或跳转结尾。\nBlock对象通过 Project 的factory属性的 block 方法实例化。\n\n\n\n四、Angr 实践应用example.c 源码：\n12345678910111213141516171819202122232425262728293031323334#include &lt;stdio.h&gt;#include &lt;string.h&gt;#include &lt;stdint.h&gt;#include &lt;assert.h&gt;#define MAX_LEN 100int calculate(int number)&#123;    return number * number;&#125;int main()&#123;    char input[MAX_LEN];    printf(&quot;Enter the string: &quot;);    fgets(input, MAX_LEN, stdin);    int len = strlen(input);    int num = 0;    for(int i = 0; i &lt; len; i++) &#123;        if(input[i] &gt;= &#x27;0&#x27; &amp;&amp; input[i] &lt;= &#x27;9&#x27;)&#123;            num = num * 10 + (input[i] - &#x27;0&#x27;);        &#125;    &#125;    int res = calculate(num);    assert(res != 65536);    return 0;&#125;\n\n将 example.c 编译为 example_binary ：\n1gcc example.c -o example_binary\n\n以 example_binary 为例，演示 Angr 用法。\n1. 静态程序分析  首先用 Angr 定位程序入口：\n12345678910111213&gt;&gt;&gt; import angr&gt;&gt;&gt; project = angr.Project(&#x27;example_binary&#x27;, load_options=&#123;&#x27;auto_load_libs&#x27;: False&#125;)&gt;&gt;&gt; project.filename&#x27;example_binary&#x27;&gt;&gt;&gt; project.arch&lt;Arch AMD64 (LE)&gt;&gt;&gt;&gt; project.entry4198624&gt;&gt;&gt; bb = project.factory.block(4198624)&gt;&gt;&gt; bb.instructions12&gt;&gt;&gt; hex(bb.addr)&#x27;0x4010e0&#x27;\n\n这个 0x4010e0 地址对应的是程序的入口 block ，包括 12 条指令，在 CFG 中表示为如下节点，可以看到 block 的名字并不是 main，而是 _start ：\n\n\n接着从 _start 开始执行，执行一次后到达 ___libc_start_main ，然而再执行一次后并没有到达 main ：\n123456789101112&gt;&gt;&gt; st_0 = project.factory.entry_state()&gt;&gt;&gt; hex(st_0.addr)&#x27;0x4010e0&#x27;&gt;&gt;&gt; nx  = st_0.step()&gt;&gt;&gt; nx.successors[&lt;SimState @ 0x500000&gt;]&gt;&gt;&gt; st_1 = nx.successors[0]&gt;&gt;&gt; hex(st_1.addr)&#x27;0x500000&#x27;&gt;&gt;&gt; nx = st_1.step()&gt;&gt;&gt; nx.successors[&lt;SimState @ 0x4012e0&gt;]\n\n为了获取 main 这个 block 的状态，可以使用 SimulationManager 来执行：\n12345678&gt;&gt;&gt; simgr = project.factory.simulation_manager(st_0)&gt;&gt;&gt; main_obj = project.loader.main_object.get_symbol(&#x27;main&#x27;)&gt;&gt;&gt; hex(main_obj.rebased_addr)&#x27;0x4011dc&#x27;&gt;&gt;&gt; simgr.explore(find=main_obj.rebased_addr)&lt;SimulationManager with 1 found&gt;&gt;&gt;&gt; simgr.found[&lt;SimState @ 0x4011dc&gt;]\n\n\n\n2. 静态符号执行example_binary 接受一个最长为 100 位的字符串作为输入，提取字符串中的数字，转换成数值，然后进行平方运算，结果等于 65536 时出现断言错误。反推回来，当输入字符串中包含 2、5、6 这三个数字时，就能导致AssertionError。\n要让程序自动找到触发 example_binary 中 AssertionError 的 input，可以用 Angr 符号执行来求解。\n首先引入claripy，创建符号变量：\n1234&gt;&gt;&gt; import claripy&gt;&gt;&gt; input_size = 100&gt;&gt;&gt; symbolic_buffer = claripy.BVS(&#x27;input&#x27;, 8 * (input_size - 1))&gt;&gt;&gt; entry_state = project.factory.entry_state(stdin=claripy.Concat(symbolic_buffer, claripy.BVV(b&#x27;\\n&#x27;)))\n\n通过 CFG 可以找到 AssertionError 的 block 地址为0x4010c0：\n\n\n然后用 SimulationManager 控制程序朝 AssertionError 开始探索：\n1234567891011121314151617181920212223&gt;&gt;&gt; simgr = project.factory.simulation_manager(entry_state)&gt;&gt;&gt; simgr.explore(find=0x4010c0)WARNING  | 2024-03-11 17:27:02,034 | angr.storage.memory_mixins.default_filler_mixin | The program is accessing memory with an unspecified value. This could indicate unwanted behavior.WARNING  | 2024-03-11 17:27:03,808 | angr.storage.memory_mixins.default_filler_mixin | angr will cope with this by generating an unconstrained symbolic variable and continuing. You can resolve this by:WARNING  | 2024-03-11 17:27:03,808 | angr.storage.memory_mixins.default_filler_mixin | 1) setting a value to the initial stateWARNING  | 2024-03-11 17:27:03,808 | angr.storage.memory_mixins.default_filler_mixin | 2) adding the state option ZERO_FILL_UNCONSTRAINED_&#123;MEMORY,REGISTERS&#125;, to make unknown regions hold nullWARNING  | 2024-03-11 17:27:03,808 | angr.storage.memory_mixins.default_filler_mixin | 3) adding the state option SYMBOL_FILL_UNCONSTRAINED_&#123;MEMORY,REGISTERS&#125;, to suppress these messages.WARNING  | 2024-03-11 17:27:03,994 | angr.storage.memory_mixins.default_filler_mixin | Filling memory at 0x7fffffffffeff70 with 1 unconstrained bytes referenced from 0x500010 (strlen+0x0 in extern-address space (0x10))&lt;SimulationManager with 829 active, 20 deadended, 1 found&gt;&gt;&gt;&gt;&gt;&gt;&gt; simgr.found[&lt;SimState @ 0x4010c0&gt;]&gt;&gt;&gt; found_state = simgr.found[0]&gt;&gt;&gt; found_state&lt;SimState @ 0x4010c0&gt;&gt;&gt;&gt; found_state.solver.eval(symbolic_buffer, cast_to=bytes)b&#x27;256\\x00\\x00\\x00\\x01\\x00\\x00\\x00\\x80\\x01\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00@ \\x08\\x08\\x00\\x02\\x00 \\x00\\x00\\x80\\x00\\x00\\x00@\\x00\\x01 \\x02\\x10\\x00\\x01 \\x10\\x00@\\x04\\x80\\x80\\x01\\x80\\x01@\\x02\\x08\\x08\\x04\\x80\\x01@\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00&#x27;&gt;&gt;&gt; len(found_state.solver.eval(symbolic_buffer, cast_to=bytes))99&gt;&gt;&gt; found_state.solver.constraints[&lt;Bool !(input_3_792[791:784] == 10)&gt;, &lt;Bool !(input_3_792[783:776] == 10)&gt;, &lt;Bool !(input_3_792[775:768] == 10)&gt;, &lt;Bool !(input_3_792[767:760] == 10)&gt;, &lt;Bool !(input_3_792[759:752] == 10)&gt;, &lt;Bool !(input_3_792[751:744] == 10)&gt;, &lt;Bool !(input_3_792[743:736] == 10)&gt;, &lt;Bool !(input_3_792[735:728] == 10)&gt;, &lt;Bool !(input_3_792[727:720] == 10)&gt;, &lt;Bool !(input_3_792[719:712] == 10)&gt;, &lt;Bool !(input_3_792[711:704] == 10)&gt;, &lt;Bool !(input_3_792[703:696] == 10)&gt;, &lt;Bool !……\n\n可以看到虽然很慢，但是 Angr 成功地算出了一个可以触发 AssertionError 的输入。计算结果保存在 SimulationManager 的found属性中，每个结果是一个 SimState 实例，通过 SimState 的solver属性可以查看可行解与约束条件。\n五、同类工具\n\n\n特性 \\ 工具\nAngr\nBAP\nTriton\nBinary Ninja\nGhidra\n\n\n\n发布年份\n2015\n2011\n2015\n2016\n2019\n\n\n开发语言\nPython\nOCaml (接口: C&#x2F;Python)\nC++ (接口: Python)\nC++\nJava\n\n\n模块化\n✅\n✅\n❌\n✅\n✅\n\n\n插件系统\n✅\n✅\n❌\n✅\n✅\n\n\n符号执行\n✅\n✅\n✅\n❌\n✅\n\n\n污点分析\n✅\n部分支持\n✅\n✅\n✅\n\n\n动静态分析\n均支持\n主要是静态分析\n主要是动态分析\n主要静态分析\n均支持\n\n\n形式化验证\n有限支持\n✅\n❌\n❌\n通过插件\n\n\n中间表示\nVEX IR\nMicrocode\nTriton IR\nLLIL&#x2F;MLIL&#x2F;HLIL\nP-Code\n\n\n社区活跃度\n高\n中\n低\n高\n高\n\n\n专长领域\n全栈式分析\n可扩展性与形式化验证\n动态分析与污点追踪\n逆向工程\n逆向工程\n\n\n跨平台支持\n广泛\n广泛\n有限\n广泛\n广泛\n\n\n学习曲线\n中等\n较高\n中等\n中等\n中等\n\n\n应用场景\nCTF&#x2F; 漏洞研究 &#x2F; 二进制加固\n安全研究 &#x2F; 形式化验证\n精确污点追踪 &#x2F; 变量跟踪\n逆向工程\n逆向工程\n\n\n开源\n✅\n部分开源\n✅\n社区版开源\n✅\n\n\n六、参考资料\nangr 原理与实践（一）——原理\nangr 官方文档\nangr 系列教程(一）核心概念及模块解读\nAngr 初学笔记\nBinary 自动分析的那些事\n","dateCreated":"2024-01-23T13:45:08+08:00","dateModified":"2024-06-26T16:27:23+08:00","datePublished":"2024-01-23T13:45:08+08:00","description":"Angr 是一款二进制分析和符号执行工具，常用于 CTF 和安全测试领域","headline":"符号执行工具——Angr 零基础入门","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2024/Angr%E9%9B%B6%E5%9F%BA%E7%A1%80%E5%85%A5%E9%97%A8/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2024/Angr%E9%9B%B6%E5%9F%BA%E7%A1%80%E5%85%A5%E9%97%A8/","keywords":"安全, 工具, 符号执行"}</script>
+    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n一、Angr 简介Angr 是一个由 Python 语言编写的开源二进制分析框架，它主要用于静态分析、符号执行、逆向工程等安全研究领域。Angr 支持多种操作系统和硬件架构，包括 Windows、Linux、macOS 以及 x86、ARM 等。\n二、Angr 整体架构1、核心组件Angr 是一个复杂的二进制分析框架，其初始的整体架构设计如下图：\n\n\nAngr 的核心组件自下而上依次为：\n\nCLE：加载可执行文件和库文件\n\narchinfo：获取架构信息\n\nPyVEX：将指令转换成 VEX 这种中间语言（IR）\n\nSimuVEX：模拟执行引擎，负责在虚拟环境中执行 VEX\n\nClaripy：用于创建和管理符号变量及条件约束，传递给 Z3 求解器进行求解\n\nAngr：将各个组件集成起来，提供一套整体的二进制分析和符号执行框架\n\nanalysis：提供一套分析工具，通过 CFG、DDG 等对程序进行分析\n\nsurveyors：用于记录和跟踪程序的可执行路径\n\n\n随着 Angr 的发展，部分组件有更新和迭代：\n\nSimuVEX 被移除，其组件已集成到 Angr 中\n\nsurveyors 被移除，被 SimulationManager 所取代\n\n\n2、运作流程Angr 的整体运作流程如图：\n\n\n使用 Angr 进行二进制分析时，各组件的运行步骤为：\n\nCLE 加载二进制，获取机器指令\n\nArchinfo 分析二进制的架构类型\n\nPyVEX 根据架构类型，将机器指令转换为 VEX 中间表达\n\nSimEngine 基于 VEX 来模拟程序执行\n\nClarify 创建和管理执行过程中的符号变量和约束条件，转化为 SMT 表达式，传递给 Z3 求解\n\nSimOS（SimProcedures） 模拟程序与系统的交互，如标准 io 流、文件读写、系统调用等操作\n\n\n三、Angr 使用说明1. 安装Angr 需要 python 3.8 以上的运行环境，需要先装 3.8 版本以上的 python。\n安装 Angr 有两种推荐方式：\n\npip 安装\n1pip install Angr\n\n源码安装\n123git clone https://github.com/Angr/Angr-dev.gitcd Angr-dev./setup.sh -i -e Angr\n\n2. 运行  建议在虚拟环境中运行 Angr。源码安装的方式可以自动创建名为 Angr 的虚拟环境。手动创建虚拟环境的命令为：\n1python3 -m venv Angr\n\n启动虚拟环境：\n1source Angr/bin/active\n\n3. 使用Angr 作为 python 的三方库，通过 import 进行调用：\n1import Angr\n\nAngr 的顶层 API 围绕着 Angr 的核心组件来设计，包含一组常用的 Python 类和对象，它们提供了二进制分析、符号执行和其他功能。\n以下是 Angr 的一些常用 API 组件：\n\nProject（项目）：\n\nProject是 Angr 的中心组件，它代表了用户所要处理的二进制文件。\n创建一个 Project 实例是使用 Angr 进行分析的第一步，Project对象提供了对二进制文件的操作和分析的接口。\n\n\nFactory（工厂）：\n\nFactory对象通过 Project 的factory属性来访问，它提供了快速访问 Angr 的各种分析技术的接口，避免复杂的实例化操作。\n\n\nSimState（模拟状态）：\n\nSimState代表程序的一个瞬时状态，它包含寄存器、内存、堆栈、文件系统等运行时的上下文环境状态，可用于执行符号执行和具体执行。\nSimState对象通过 Project 的factory属性的方法来访问，这些方法包括 entry_state、blank_state、full_init_state 等。\n\n\nSimulationManager（模拟管理器）：\n\nSimulationManager用来跟踪程序执行过程中的路径探索和 SimState 演化，并对这些路径和 SimState 进行管理。\nSimulationManager对象通过 Project 的factory属性的 simulation_manager 方法实例化。\n\n\nLoader（加载器）：\n\nLoader负责将二进制文件载入内存，并处理符号以及它们的地址空间，为后续分析提供详细信息，如入口点、可执行段、符号表等。\nLoader对象通过 Project 的loader属性的方法来访问。\n\n\nBlock（块）：\n\nBlock表示程序基本块，是 Angr 分析的基本单位。每个 Block 是一组顺序执行代码片段，具有原子性，以分支或跳转结尾。\nBlock对象通过 Project 的factory属性的 block 方法实例化。\n\n\n\n四、Angr 实践应用example.c 源码：\n12345678910111213141516171819202122232425262728293031323334#include &lt;stdio.h&gt;#include &lt;string.h&gt;#include &lt;stdint.h&gt;#include &lt;assert.h&gt;#define MAX_LEN 100int calculate(int number)&#123;    return number * number;&#125;int main()&#123;    char input[MAX_LEN];    printf(&quot;Enter the string: &quot;);    fgets(input, MAX_LEN, stdin);    int len = strlen(input);    int num = 0;    for(int i = 0; i &lt; len; i++) &#123;        if(input[i] &gt;= &#x27;0&#x27; &amp;&amp; input[i] &lt;= &#x27;9&#x27;)&#123;            num = num * 10 + (input[i] - &#x27;0&#x27;);        &#125;    &#125;    int res = calculate(num);    assert(res != 65536);    return 0;&#125;\n\n将 example.c 编译为 example_binary ：\n1gcc example.c -o example_binary\n\n以 example_binary 为例，演示 Angr 用法。\n1. 静态程序分析  首先用 Angr 定位程序入口：\n12345678910111213&gt;&gt;&gt; import angr&gt;&gt;&gt; project = angr.Project(&#x27;example_binary&#x27;, load_options=&#123;&#x27;auto_load_libs&#x27;: False&#125;)&gt;&gt;&gt; project.filename&#x27;example_binary&#x27;&gt;&gt;&gt; project.arch&lt;Arch AMD64 (LE)&gt;&gt;&gt;&gt; project.entry4198624&gt;&gt;&gt; bb = project.factory.block(4198624)&gt;&gt;&gt; bb.instructions12&gt;&gt;&gt; hex(bb.addr)&#x27;0x4010e0&#x27;\n\n这个 0x4010e0 地址对应的是程序的入口 block ，包括 12 条指令，在 CFG 中表示为如下节点，可以看到 block 的名字并不是 main，而是 _start ：\n\n\n接着从 _start 开始执行，执行一次后到达 ___libc_start_main ，然而再执行一次后并没有到达 main ：\n123456789101112&gt;&gt;&gt; st_0 = project.factory.entry_state()&gt;&gt;&gt; hex(st_0.addr)&#x27;0x4010e0&#x27;&gt;&gt;&gt; nx  = st_0.step()&gt;&gt;&gt; nx.successors[&lt;SimState @ 0x500000&gt;]&gt;&gt;&gt; st_1 = nx.successors[0]&gt;&gt;&gt; hex(st_1.addr)&#x27;0x500000&#x27;&gt;&gt;&gt; nx = st_1.step()&gt;&gt;&gt; nx.successors[&lt;SimState @ 0x4012e0&gt;]\n\n为了获取 main 这个 block 的状态，可以使用 SimulationManager 来执行：\n12345678&gt;&gt;&gt; simgr = project.factory.simulation_manager(st_0)&gt;&gt;&gt; main_obj = project.loader.main_object.get_symbol(&#x27;main&#x27;)&gt;&gt;&gt; hex(main_obj.rebased_addr)&#x27;0x4011dc&#x27;&gt;&gt;&gt; simgr.explore(find=main_obj.rebased_addr)&lt;SimulationManager with 1 found&gt;&gt;&gt;&gt; simgr.found[&lt;SimState @ 0x4011dc&gt;]\n\n\n\n2. 静态符号执行example_binary 接受一个最长为 100 位的字符串作为输入，提取字符串中的数字，转换成数值，然后进行平方运算，结果等于 65536 时出现断言错误。反推回来，当输入字符串中包含 2、5、6 这三个数字时，就能导致AssertionError。\n要让程序自动找到触发 example_binary 中 AssertionError 的 input，可以用 Angr 符号执行来求解。\n首先引入claripy，创建符号变量：\n1234&gt;&gt;&gt; import claripy&gt;&gt;&gt; input_size = 100&gt;&gt;&gt; symbolic_buffer = claripy.BVS(&#x27;input&#x27;, 8 * (input_size - 1))&gt;&gt;&gt; entry_state = project.factory.entry_state(stdin=claripy.Concat(symbolic_buffer, claripy.BVV(b&#x27;\\n&#x27;)))\n\n通过 CFG 可以找到 AssertionError 的 block 地址为0x4010c0：\n\n\n然后用 SimulationManager 控制程序朝 AssertionError 开始探索：\n1234567891011121314151617181920212223&gt;&gt;&gt; simgr = project.factory.simulation_manager(entry_state)&gt;&gt;&gt; simgr.explore(find=0x4010c0)WARNING  | 2024-03-11 17:27:02,034 | angr.storage.memory_mixins.default_filler_mixin | The program is accessing memory with an unspecified value. This could indicate unwanted behavior.WARNING  | 2024-03-11 17:27:03,808 | angr.storage.memory_mixins.default_filler_mixin | angr will cope with this by generating an unconstrained symbolic variable and continuing. You can resolve this by:WARNING  | 2024-03-11 17:27:03,808 | angr.storage.memory_mixins.default_filler_mixin | 1) setting a value to the initial stateWARNING  | 2024-03-11 17:27:03,808 | angr.storage.memory_mixins.default_filler_mixin | 2) adding the state option ZERO_FILL_UNCONSTRAINED_&#123;MEMORY,REGISTERS&#125;, to make unknown regions hold nullWARNING  | 2024-03-11 17:27:03,808 | angr.storage.memory_mixins.default_filler_mixin | 3) adding the state option SYMBOL_FILL_UNCONSTRAINED_&#123;MEMORY,REGISTERS&#125;, to suppress these messages.WARNING  | 2024-03-11 17:27:03,994 | angr.storage.memory_mixins.default_filler_mixin | Filling memory at 0x7fffffffffeff70 with 1 unconstrained bytes referenced from 0x500010 (strlen+0x0 in extern-address space (0x10))&lt;SimulationManager with 829 active, 20 deadended, 1 found&gt;&gt;&gt;&gt;&gt;&gt;&gt; simgr.found[&lt;SimState @ 0x4010c0&gt;]&gt;&gt;&gt; found_state = simgr.found[0]&gt;&gt;&gt; found_state&lt;SimState @ 0x4010c0&gt;&gt;&gt;&gt; found_state.solver.eval(symbolic_buffer, cast_to=bytes)b&#x27;256\\x00\\x00\\x00\\x01\\x00\\x00\\x00\\x80\\x01\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00@ \\x08\\x08\\x00\\x02\\x00 \\x00\\x00\\x80\\x00\\x00\\x00@\\x00\\x01 \\x02\\x10\\x00\\x01 \\x10\\x00@\\x04\\x80\\x80\\x01\\x80\\x01@\\x02\\x08\\x08\\x04\\x80\\x01@\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00\\x00&#x27;&gt;&gt;&gt; len(found_state.solver.eval(symbolic_buffer, cast_to=bytes))99&gt;&gt;&gt; found_state.solver.constraints[&lt;Bool !(input_3_792[791:784] == 10)&gt;, &lt;Bool !(input_3_792[783:776] == 10)&gt;, &lt;Bool !(input_3_792[775:768] == 10)&gt;, &lt;Bool !(input_3_792[767:760] == 10)&gt;, &lt;Bool !(input_3_792[759:752] == 10)&gt;, &lt;Bool !(input_3_792[751:744] == 10)&gt;, &lt;Bool !(input_3_792[743:736] == 10)&gt;, &lt;Bool !(input_3_792[735:728] == 10)&gt;, &lt;Bool !(input_3_792[727:720] == 10)&gt;, &lt;Bool !(input_3_792[719:712] == 10)&gt;, &lt;Bool !(input_3_792[711:704] == 10)&gt;, &lt;Bool !(input_3_792[703:696] == 10)&gt;, &lt;Bool !……\n\n可以看到虽然很慢，但是 Angr 成功地算出了一个可以触发 AssertionError 的输入。计算结果保存在 SimulationManager 的found属性中，每个结果是一个 SimState 实例，通过 SimState 的solver属性可以查看可行解与约束条件。\n五、同类工具\n\n\n特性 \\ 工具\nAngr\nBAP\nTriton\nBinary Ninja\nGhidra\n\n\n\n发布年份\n2015\n2011\n2015\n2016\n2019\n\n\n开发语言\nPython\nOCaml (接口: C&#x2F;Python)\nC++ (接口: Python)\nC++\nJava\n\n\n模块化\n✅\n✅\n❌\n✅\n✅\n\n\n插件系统\n✅\n✅\n❌\n✅\n✅\n\n\n符号执行\n✅\n✅\n✅\n❌\n✅\n\n\n污点分析\n✅\n部分支持\n✅\n✅\n✅\n\n\n动静态分析\n均支持\n主要是静态分析\n主要是动态分析\n主要静态分析\n均支持\n\n\n形式化验证\n有限支持\n✅\n❌\n❌\n通过插件\n\n\n中间表示\nVEX IR\nMicrocode\nTriton IR\nLLIL&#x2F;MLIL&#x2F;HLIL\nP-Code\n\n\n社区活跃度\n高\n中\n低\n高\n高\n\n\n专长领域\n全栈式分析\n可扩展性与形式化验证\n动态分析与污点追踪\n逆向工程\n逆向工程\n\n\n跨平台支持\n广泛\n广泛\n有限\n广泛\n广泛\n\n\n学习曲线\n中等\n较高\n中等\n中等\n中等\n\n\n应用场景\nCTF&#x2F; 漏洞研究 &#x2F; 二进制加固\n安全研究 &#x2F; 形式化验证\n精确污点追踪 &#x2F; 变量跟踪\n逆向工程\n逆向工程\n\n\n开源\n✅\n部分开源\n✅\n社区版开源\n✅\n\n\n六、参考资料\nangr 原理与实践（一）——原理\nangr 官方文档\nangr 系列教程(一）核心概念及模块解读\nAngr 初学笔记\nBinary 自动分析的那些事\n","dateCreated":"2024-01-23T13:45:08+08:00","dateModified":"2024-06-26T16:27:23+08:00","datePublished":"2024-01-23T13:45:08+08:00","description":"Angr 是一款二进制分析和符号执行工具，常用于 CTF 和安全测试领域","headline":"符号执行工具——Angr 零基础入门","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2024/Angr%E9%9B%B6%E5%9F%BA%E7%A1%80%E5%85%A5%E9%97%A8/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2024/Angr%E9%9B%B6%E5%9F%BA%E7%A1%80%E5%85%A5%E9%97%A8/","keywords":"符号执行, 安全, 工具"}</script>
     <meta name="description" content="Angr 是一款二进制分析和符号执行工具，常用于 CTF 和安全测试领域">
 <meta property="og:type" content="blog">
 <meta property="og:title" content="符号执行工具——Angr 零基础入门">
@@ -29,9 +29,9 @@
 <meta property="article:published_time" content="2024-01-23T05:45:08.000Z">
 <meta property="article:modified_time" content="2024-06-26T08:27:23.656Z">
 <meta property="article:author" content="一瓢清浅">
+<meta property="article:tag" content="符号执行">
 <meta property="article:tag" content="安全">
 <meta property="article:tag" content="工具">
-<meta property="article:tag" content="符号执行">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:image" content="https://www.stepbystep.asia/2024/Angr%E9%9B%B6%E5%9F%BA%E7%A1%80%E5%85%A5%E9%97%A8/Angr%E6%A0%B8%E5%BF%83%E7%BB%84%E4%BB%B6.png">
     
diff --git "a/2024/ClusterFuzz\346\236\266\346\236\204\345\210\206\346\236\220/overview.png" "b/2024/ClusterFuzz\346\236\266\346\236\204\345\210\206\346\236\220/overview.png"
deleted file mode 100644
index 8d1b109af876cc2b98839da48dbd6fffc58eaa65..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 39070
zcmZU)1z3}9_%?3yDk2sjE#2KUO1it5(v7slKt)8lq!}Y6Ml(7lAky8VL}BDW7&S(G
z5AXZ?{{QbgJ`O#2Hl97Z<BIb-uk()3)>I;TK=I(ljT=NN%CB^9+_(+=zuEK8E#MvT
zx0ew&ZoI#t@=8|!9cl+kWUg;;c?GYl@x0o0JC0iP@pHz`=x)2YNV7XnY3n!&VQ(g@
z$BaKz(})^>pnm(wbCQ35?vi|ce)oyOU0GQL1%+1%Yj57sd=A``ls-oau<U7eJ$w{*
z@Yf$X>}+|G9k|<+nm({_k`*|7B5892nwXVE)p{QoicHaOy4JhUB&dYnZw=t}jU31g
z6v6d{1MU0co7Wd80u<rK{PlY>`0Lj<ZXk&N{Uw8!k+?<de|?h!?Z)%h%Kv^2b9)qY
z{b%6j|Lz+FjmF9>|NGv5Pre}zJ5Ihwu$(O%qo!5aQsT0viqiM`CF7jU4b`%Jbq7@c
zXr#LJ0;YiU`|J7jqUEh>y1LGylRc{uHU_j%FTi0$g{Oh>11nfx3^{a4s4TB&$E@AO
zI3p4J;jNeV1(0(hn=Kc#4JN7dOs<D3z?6Vl6d&_p_0$;AIGeyQuXWvz$8~zBgZNkp
z1Kjl&8F*$}Rwi41`gh9Z1rSExZtS|+$*#}{&)KnAzkTITA7};om#it1Y^y||uYpa0
zWyy1AZS;B)d=Yn!owu}Hd-KL6$&fi;qqN1ZTfFJ;FfxX6uIBt;Em0w=SQrHdW~n2d
z3xUeweWCM@<3%$`4GRb3dX2f!wCxlv>p_kFeHxn`HsJ^vQX!sUEPVDp;$=!-D`Y|X
z4Rh0<th9aoIQ`=1+qvFb=!CuF5OuRnR(=JcsoKAz>j>3!vM9}~APsigg!Ei}t~ET(
zDI?C5YM>~8w6uGrSgyYy@hkGAleAEgE}I3~N4#%YcJOD0Snhg15f+#vCMJ@Az@+&I
zO+~qHC1ua+;?&d_=HXHvatWzQ1Nz3#McGY6{oIZ!EL<j_=>q8uW4nk5{%&i&IKi~+
zmq{1{1%)v~T%lUxcbU@oK6*rDmov;1erC5^VC|206wCj$K^FM4e@b#*e<nq_wm7<D
z@>ubkG92;UQ+da3hl1MAWB#ZnYp2s2rD~~6(X&N&VH&VXsVl`VY050YXvE;&Vi@27
zak@eM^=O{KgpsUZu_W;mM@xxZqHtH+HxRZf;mNq6IBPOvU%qv@)F#W;%louVoCd+i
zn(R1Q*Rbn7b;w5*{SiIj<>yUNQ8lXfEL^e7q#a;1dUo==w#F^ce{;&|8wA+GE1#B7
z0+q+xGoUDx_eU8evSDcGu@Hl6y*q8h6WlYbK%pWZi(SxG%n!U1tlJO;os40l2rbR)
zEVGSO)veoke20XAEC0{sIb3ll3ci|S#YfNXOx;IsCLGc`Fs$c7$mnKZnXkH$?DR5M
z(7oX6gXFUG$7FQ>*|Id;(xF(VQ~g0N<Dfad@zC3|<EgYXyJ3?nrSl^jR8L`H1c@$R
ze^cc#oBLAPEF!`wiPMCBvE^hp6<jm+W3>H|)<#6ww%+X@2D*Y{h@BZwqHqnjE;qIl
z&x0|3x8Y^zX>uURcNJjrh(wq+MGanNde8(cq*37@v2s@1zW!q<C3SVh@!E6yG4560
zuWZcybWdz9jo3K^rIP^T{MWHvjquULzHO}teiK*En$zz_lc0b$0Wan@T|RUOauig1
z%5&@h<CliTD&(=5H_DW-vqu^Nc7L-(Tg-aK;eatp-`uN67NwNFypw68<G&U2N?33<
zkLDW$&7^>_wzwAumVQ@$NZ*zyWI6?6S8vg-Bi*zbb2M!7mzK8L3*-9Vqexrrd-^Pj
zjPr50-xrkM$pFt#Pf$EuNDi;Omv(HRpg6AcBdE<(L-Rhy*%F18UjinIjD*UR+GO`m
z^(Hwu+t?M)9@z6rePB{TltOGA8O?sbcytd#lXjSVfdb}SaM$A<!GsVT)$^G~K&0-R
znBTxN|97cBy7VjVzcHBNdvVHpuV4Z*?VU|teN(~pf`y4ho#kMBH2(>1J&&`LDY2#2
z{;CYJ8Uh0S{^zNqd6w~gL}imhro4FYmlJxi+TQ4vMpw(MBF##TcG8pX?CQM1YJ!ry
z<FQyEj?M9td@G&KKFq(HBLAD|QE!zVenSQk?~iX}eOpj~Mk#^Vr`<h7OTAWdN9IDU
zJvCIVLTLkU5MgfLxH0;zPKzUH@%Vt<qFQc&-3g3|c;>R92>7s#3+E*G0@ZUEn=&9L
z&mrtepUVkuNpXZVH=Yg;rZWWxPx0|3GN~!k6SlSGLZ~hAX~8Cf(NDUC{EXq0CeLxS
zOlVg|e*~u!Z4{Oa2xRpX>Y?oIb0QI(F@`F=y|^F7yvNe3i(hFZ0Z-AN7FX4uA7@zp
zf>JutgRc6*b<vdSM8Txt&%!<8c_NFb1FYx_l<)o*q_d9uc)-HM<t#|=h%9w;l40nx
z2Hn2W-rj!K`A>vo%8&cTjeAK<N53XVw2am?-90GMn&4gy(I<AbVo)&V+gxh1c~?`w
zSQ>s{!sPwjHW&otk`hSRxLID8$y*>CIFfSdAJ}@3H6%zgfur=Cp3jACu9-&|M}OV_
zwZ__ijuZK;>wD_NNwVbQCa>v{;?GBliIWv}^e{KIo!UAyHMJ9ppB*EQOcucAcR`!|
zUzI6IQk4|=hj}yKH}akMc9H5k3X?fXgI#C9QDy|Ow?680)#dut|724jRbIcke(Ci$
zp6uVN51O)>(4_0@8-QV5@7{He{hw@$x$PtSe`U{qR|>cT$jeXO^%4SCKq4->AuoRY
zvHv4$|99W};}5=f&i+kn{~9fD&wpP4eAQ^|cX`X}PoW6J@4gtnPUQbb*8cwnf?ybJ
zxX$?h&kTSk(;Qp_8sJfE-{T(vSHPpLzju_EpPyfMuy<(4)hbL(Ol)p$?w$2b-~qtw
zb6ocqyhg-CMJ4@+-QD+?4L8te^y=y-5mI3E4)?CVYqS-WnwU5qO`^(}`0?Yd*6RPD
z2f_z4FgzUl<;!Cu$8;$K(f#`-ukYE8$D+ktc>1HGqVn$s6x#Mvfr3saOZ2c<tVtME
z4-SuSX=?Hh3?w5Z9gjVI{@*O#-9Rbjp@09TuNddYis|5cS7-t@awjMCy)gL!l9H0e
zFSr5&0>*E(iHnMka$t6McbDKsJTVa<$XR1^v##Ci*RS`M+Dh1i9snbI?{mG8z?kiq
z8Y-)*MpKUYL}R@?Jr7P!8h8~@M)V2B4lrZlIm-sO#hRL$y!?D>YHG*iH6=wwAOi!7
zl6eiCa{TM!^vizHFxnhBFZU)euxMsESjsy&Ii2h-c7p+Lx4*oRD#S6IEj1rB`9+`o
zI<5VSwPZLPVNhcK`?Rz$V0f(0A9!%2Ta9E({rU5!JL{~@eW}&o($dn(?#&xI0FeD>
zAT-g(3Q9_~!SC)(R4uqIHuGVkqN5qRthGGJsd|of7bQeRXM;}8>Ue~N>XhPWte9**
z0M?TO`ObWe1RZoRNveg99zCk4s93eJ@zK=ORL3{_VpPR9Jc;|Wqyl|Yxh;NVHOq@{
zIni>BTIyf@h<LX77+A%B9|Bm3X=rrx!vo1E^@vwbsi>%4yhww=V40Z%6zjUdDzdUS
zUHM0HOCNsgX?H0l4iF;#Wgq;~^bsLpR9swTaq+bs{u|<M(v57-H@E{6Gh?dt_VxWa
ze+%#%V}ff;ilG2(Yj?3F@ZGz{#>T^qF$N9}!oB-|slKLuxC!`|-|VZGe0+RVJu8d<
z+iI^(T=qYVi@8lrbNH{L{QvHDZQj5d<WPSIZ@s<*y!!!f!L_&kXW0M#^#*F@Eu!Jz
zYm0FI%qd%a#iXTJr4jqz%iE*D2@lR7_EVObYe_TrlV<ubDtf}bw}W+;Sf_;68fR3!
z+XJ7|mZ#49Ym2vy)b~E)aS{!qfl=HTZP(O*A7Lg|Eq~o^|EfWwFR&#vhrej_r-e_%
zZLLXyZrwmJP?XahW!R02H#y&sew)zdsD0zgt?IG23>zz@<Lg#kt>Kg5#Cud<sb>V#
zvms{ivCeZ~&>u(@12K8OPQqLk%!C-O_SOZrgm$<4Y=ZAKy+0v%@2eymHtY`b)RyTw
zj3S>UaQ;-FmhqEXWVb9p{mbZ=Kh50e)SnzoLjP`RjslctFY%Xji(OedHUcd&qX*3{
zBO65%$OOu1lOMzMkPYSz#evm=g34)>g{-MUv)@$<nnxOX33$+yehXt9pT5E=3MtS8
zHxQMz<Kx8sLNjUDHpk7ND<NduWYOzj;)hZW%;HnFUWLkd+k(6&8g5peV747~_p}h5
zm6#s=y?Y{;Io_SiyShsiqbszuHypq$g|^||tR!-O8-$@+f=GWwtibnkQ|cH+hJQX%
z2@-|L$yS<{*C&|^PqhY{l{V+LZF7$Q>ONn8a&Z1R8q;W6cHz+0%2uJ`IIBx1tY;Bb
zO??9u-T>_Id9gucG4EW#2ci6|J^Nr<_;~Eb-3q4R&iQ!>5s?|mo{5Rtyu40B+~nls
z_wV1CX#}~sxg{kRB*P8aCWaRYA3RWurD97^-jLjM*(S|Fez~k*&SvcKP%V6Vbyp)C
z#GHs6{+qgW^m#B7#YXw*TO*koL&|+PF^ACcT#c!-@p;mLv|7eWBVbELQ9j~du1hrs
zuvabz4__Kh;HGowbBXDGW}=#&^GPo2;1Q`4b5+%T9`2KH8v4o_0}wrZXLomD1c61>
z>knZSW9+u5ra(i(l>B__;9wAx1?swZ>yT`0dFn?}S!rqFz}hK~gE&xPN-ncyz|{(x
zlOsxVKMdu7LvNkN%@8ss98-x1X>C7Yr=464t;r5sVJl^Sv;?Gq9PHRR1b-OddTHxl
z3=_wG>NuQL<0;pFRZ(&=dUT0C!8|`IVfc&|mJURWw3d9UI5u(Zt)6P`I@lg-zb8aE
zH3f?O14NJkmruv{Zz<}E+zty11L~(q)2=ZN)3_;5Gese{<iCF`yUEOOjw=UMHfyu-
zC>&p;yYGYB7h>?WWs^=kM(^On*(0Uz2)w8N@IJ!PbNLlpa5RY`_n(GreJ#rYNVNvd
zV;0)B1v^}X^J=;Xg5q%hx`NF>2Z?)v=zgh@!W87uMPpykEcmxo7U<NJ$yT(z8Xm}R
zXU7;y3JO%YnMl8fudm(6$DukNV3RvKKGYur@kUfM%~qF>T|M2R+1ta<&%VEK%mF==
zIaB9s)L*n{KbWRtglF|S{kx+7KGNUc-%;H?HauKOT|F8%N1E~4(7poV&F@Wt*xJ~5
z@#01AgD))BmMjQj)XdWb&IztBb)ZD+QTofp*THUIt-vWx7Ec>&q*MLnkB)pdvnL|C
z*v=c{Dd1i1C8Z}ugb`$WUSqpMx^bp&+8|@ePXCb5YnGna_S?IbG?^BdRGBsJet8_C
z2?}%`s$$BTs`atp<P^){OvvlFMj;M@;z?Mp%Tl}55w{-5A4eDLL~%Nfts#6`)4ykS
z$~_3oFKLGE2@x@Xl#0QQQRAR~Mt26{BxS}2VSq=p*pFl*UOIujy#>W+=W;s^CzH4C
z6B6dz1~6^YcO<G7A|(1qZO`!dq?m}`%1;fA@EdOtJQyG&?5(c;5MLjwE^h5^il}Gd
z9-T|f{@K%0o0O|(ixTl%RjyGfO}c!*uUtxwBEUG`e^;o3bh+z_8+jTmTXx`?APmlH
z3NrH9uP?3AP4bcVZ+oS&`Q4-&4|gi7#}VCMMJ|=F)=_I#8ke4+%Bn~ZwhQcZxEgfx
zr&u@$TFF^5osBGPH7{;ADIIQtUxHMRHMPsjUvn#QJ3n_aZ@orM&xVfTjVh;{D!`<-
zkfhK(du%2?VeEX8-8y~i!PEz6f16pd&UP5n@?@~6vGAD?CHh1~;1~-B;|F_u;~NsT
zB2eo)J5=Q4Y;G|T5l>+7#3dcTWbOu>>}rTHeu;>Puv#h6E1I4H=?Z!zyCe$6dJk!0
zy!`x5_V=Geg@uO$YvHuGu)z7VOa`9=8M?CYFp>yt=`59t0W)#N7%{KCka8bRIhaGL
za}cXyBd0QB_m>h{4X~8d^sm0n9adJ^O#LmKw(tUs$U3sLSe5L#kyOjD2hVd>;%u^%
zZmc2f_|XI2-Qe1X!~r*fgvXp=uN-a&A41aKF%e&u!eS?Fpp)>yv%QTYREx;kidu|U
z-JA>7Ss1%L1vm2atTDjUz98vnUXDO1nc6MAW2ShqNv4wB&~UOdR|^w(Q#=9Y<>V~8
zq@!jGav_tbi;GN`Ce+l>u<cnBjeTAVU=MFq{SY<D)wSe%C9mTTPE`1ts`tncmH9Qe
z#{Ov;l!|lM5Zl3_q^(u`FMj0Tw(p6KZ*0FZm$Os1R&CT0+0H~7c%-+2)nf)aOPkRm
z@A$6fNV|!g@A<aNNccmCa=4;G5__@}$P64=D!Hi<RlQz5Y!bU)y1U&+c+{IXrTq=s
zg$jLl4*G8f*EF{zY3zbx(AOA!wEeRfOfm4H=J8>S!8(5Kyd9cX$tiHoUr?^8+ly0A
zit+EVla}U3>M0!txjxf+3plz}gQRcx?s#F8K06a;8&$`_^(E67n_UcP3p^1PDgW`~
zl`e;A&SGtCt;x69JIcQm*qKS|Q4J$qUGnBb{r!3QNrg?#&7VJgsv3-pd|>vk3t+4G
z$HvBX8uQk5!WbKO_`JOwVTSgzp1LBo`M%@gm;zpli$1SVxBZ(I*>_MgeCecaUW`3e
zOy`Ig^H&d)P$w{j?wf(|%IBr5V_QnOg$0mwk>|_1#Z<M30;GEcU@1=q-9c{M-`nR4
z-?8+fdmqM4ozEl)&8STlKnl`U{dXEK`3&5G6%fsr%0rVrg%yNR%a^%>rMRIl-<5s;
zTPgA7#HJ%rTBf;AmyG_O#RbS&rwRH&Z%gby5nNrcXzZ<%(b8&ZDjL2TC=<zUX=&-0
zG>eUP`u!uq#eu8j4FG^k-WNj(v>A2FI^uS>V`F14FE0`5-Ntu7DSd|n^YfWyI`j!u
z8LmedYl(3kATCSzZ0XlCa7~ECe+NSA+&Jjih<C9-U7XL?9F@BHQlR&q0#z9p?;X$;
zCJ}IwoFN-k=ljhs)sbG;#~|jcvAw+qh}7kuL7<RJN!Prv;ES{Lb$c6|QOn;>Un1_2
z&*S%yV66{ZTU+@02;X}cuiA33%_o)A$(hKhRey$CQC&&4E~!Bg0gCU$9Ko{b;sW3&
zDf$y5MWdy-rh9*v70vjnR@Cm!+{o;(5{79*hmDe_UYOxqr&CD`FVCMjKy-(y-dovy
zQ1V)RCdYUY6j_$B9FmfgbQ{2I!>{ztjyHvz^08b{BP3R*6e_7~WU1?Si=%rw`R5aw
zqgaekI@t5sP~4qZ^O%@ElAfiS@K!8(C||=yA6UVr;ULDnk9P@`e-#@81xfFS@r0?m
z`a_Idx_)k4T-@xI;ysnHz~dbiZsjQ;?$n6u%A=wpBZ@i}5}-5~g*uZdP^jbNKN95P
zcP<om8oh_T(FmT4`vnkmOsd8tNY?Q*xWR4IN+Wc9@-3!h`%LjiC*%^hzFFP~!3($D
zA4uV<Ed>LcQeFwsZ}QJ~FPdr}<8axUNqZdp=HZDRsk<7Ud&%%Kv$FKOu_DTT>iqMa
z1L@tmr#-fE#o8keTfr`C@{jr-^b6J_c#Z{6{$#V83RBNS;>KvhTCRckYXV;h7+;LP
zd=j+d^I=B5cvY=0s^uhR%W7wR#s;g$`n*6JeOvTLJETDM=#@LOSbjO_hkavLABMj=
z7f1R`>~f1@at=I!(J@f<#Xq{t&JHe*j~rm8&dTj&wDtM|tTKx^0Elg)mo+k;dcDVh
zu_jbeQLza|@H$U(rqlw(6bG||>?9~%{dltomRPNk&fhJEXH9w@1Qa0%wZ#AjI#yPP
zo!M%A^v@W|yyJv<*ZKMw(nnOHf7>I<$~eWz&xmBgN^DqW+QR~q>+7_PUvTV5bFg42
z53I+^G}a_^o!QDIS$&AP-=G@K;=hun9Zv}%J>Z|ZQp>#67Sk(e-UL2fGBFE_m#3O&
zA5&AEW}dG4GyIUp&%*cz!hOX}2mb(%GtB^h*GenA2c-9^3EW3y-2hHq#hBkHP++F>
z{E(#ZKx4p3nj+xpUGUFh?jcEc_gZ!Dv5M+KNI+Yz{x{f@Tn{2`A$mxaBJ`~+d|Ytw
zTp2$rZ&@QAWhm7@$lGxkyOz|<N62VVI|@SkuaCf3uy8YClf^7CFNfq<IZzLRhmP)p
z<>q3})Ds3p*5v+!1JCJ=sOff?&w1ichRJ}F_P*^;t}G-)m6YM$ty0MNLHEhTr>cA0
z+%$jX>E<jgBeuSq1namY7emnK6V3QvElN5=W=*fz#jJDCxx%-Ec*Jr}+0-muD8^U#
zkq$q8KlL>i|8Uv<laAW4DY7@It|0qLsv;fdUq-5FIq_?o3gA#!@}3a;A2}JwLq{fm
zoisn@2OD|L<OsyhO!O55kd9R5=~p|7rNagd8Ku3jYSN|dAguLDMlQq$yT%UjZl30f
zr_!AJA}FX`$7={R8m}6C@mqe$b|B^AZx`_i;7Nkhw~R*QmuA2rZEjK^5C~17L;%4K
zi3A>PDTLcS74zQEX3hz@!Y|wMlOy7E%*)L@zJS0>sCeT`>`<MAE^dA;V{tP}K|F<F
zm9!)%zw{?hYML{x0P?1^p@um_R<oNPQn%9a=cj*!ndg5Yqe`31a;1V~ivt%rRW)9z
zVh)LHLqj;vx;-?|BE8^xVG{$(s4qkR!Wbgz@iFD~mefi6*xDDtTS?({Gu-4~BLmU)
z;LPO)y^NW2aWTU>Ex3Sr>V{<3WQ-RmWkFtljNDXn?0sPAX?*JQ$OzL5l!$Hr^Wz`&
zG?>7nDWmP_XOACOInQvXcwL_Re*;=7&sa1ko$3f4QKgBvTdqj45}<mtosTwW>hy$-
z-TzY7q~X1-F%^1pirMshX0v{uTMWxkzIno2M%kVw?eE-=-tMbx^CV>=ZRT!f8=+eD
z?<CXxVks=&Z|zE*=8jw6cuYP+k{JiYhAGA%?^{3~lhAXPw$u~<8&1#BbHtTFVF+oL
z3B}F*ORkyr<DyZ1;$e<3Nf$okDaR1b+Y6fn5iCHry9Q%HhD9uts~cYybx|xy+eWm8
z#FpyE-yBrW_;r1bQ#9QhP7{t3lAz)~PQzJZWp(a=Kd;&YaiGA~2cU7H2jlqr#yJu0
zfXnNT)YuNpcA0BwjSOXqz(hSh`W65rc-cIyEq|9a1b=>h?f_0#M{jMZhSk>87zgd-
z<h<nXJ~%kgtbqI^{5<0>mg`Gcvve#h7@yf*B7DGzWUN53lpg#b!6B+@hI(w^#8Ztp
zG9<>i8+V2$4Q~Cm<Fo?#xNgBcscFv9fEpELeIMdi!g<I`>tEx0P&)1<LIPIMAHBaL
z-VL$wY`>f~Pdf0+Dl32T^1Anz138jduGyo&1d*axGXDziZ66V0qm27TPJSb=K4oI)
zGDW`!{DD;u?OFT$)M=w~4IZk5u*cA0zxnQ{9tbxnP}CTM1V;n%G(xw((mpBsN6pa4
z^Ed$9EA{m0Q{x+{0AZ69S#H(<RK&4$Z3(w@L4<$gv_bdD$!P}c<7X2P30NJ2oyvS_
zl|?yu`M&3lbFU*kl!e@ZAo=K3b`J&CAw9Oc`GiZL<3ZBjF&*OptMHk2&-C_U)VGJ5
z-k+oV5MC~WQytmI!BotY4P`Di+I{wv1E0@Gv`h`oE+0fp`GT&)$kJC%z2!>EVnt`;
z5PgN@dGXyJb*<|e>@#8AU>9y$8f{5o;{zRslC@fkT0wiY?mDYv8sc}?5LkF;Z@#F_
zqb_3D2q@sz$<Qoh(fllLQSi9~p-cV|y88KZkS<KDLd4)M1w^S54q4;x>NGCgrq6YI
zfT~1gm(C>|M<Lc416&h5Z9jTi6(?JK3**qOaPoovLZjXw_BvfLzix0lAjebAJyhjg
zzWtmYZ2h?k-ma;tfw@<6tv#K1j|;06PL9$s+FExb$xNR?dk~yX9m2q<k)n<Eo{N#Z
z-=|)!IiC)%>DKy$N{h)?>$Rnj!E;0t*+XRXD4ZkpA2{iBG-To%4i{9~;zI;e)7#zf
zsoVRjFw~-U7mfl7N%;7S`M^Ovl{#S#uz#+M5KEq2JZ#YCiF^BigzP~ffqwTC_0=Wn
zCPJ%XT+PY5r^4ahnOE1x4X;(w9+L#=wxzfE>L>DLL-(ZdL+*!(iLjb?5+Nko)wAkH
zy#d}6ZdkmB7D<zxncJ4L_Myf#uci>M;p>`*1<;ym>1~N^&CYM2X5=w;OxXVN^n0N&
zcZQq3vM;l*Qi$LEy#TGtEhm^?L1!se2bJ)xzgN!&eMQfdMOIH;8KYT#A&MAW3$Kw4
z79vHTteE1)2B@VKe@>m}Win;qTA*G=YS|VdwyVy)<>lXc1*fKy40Vlb5<xuhzQFLH
zVP6i%Gv+s)PTLWa%P+V_+FykkF|ivU&u=6<btO;@oleQ=4Z8pBq+c%XXRo-~w#_bf
zAtFH{ADUqkyxYO#*z_Q3LoSz$p-nGzIK?9PM#B>L>60f<Uc8tEr~<rmRoY~We|4J5
zb;@b!$qsMzCRQ7m=yefl6|%r9iox}M6FChumTY-BE|`x5(03N_EWW-XdZ?lvdhYM5
z1b%A7kbEJBSLFJmv1G?Iw8+L8lXS1gU`9jwl|k$y_Tc%Vx8I2iL(dB;qC`C^-^iX<
zM8{rnf*jm!^Q9l1JYFh=`BywEW2a_9wmpE8HvWzuFBR1lf2-*_C8Ss3Fjy{l9G#)*
z*lTqe<tnG&yrr68=&UiQT5v{kzhCxd(4WCdr27g1U13oL8^sw2);kq#!8RGP5HPss
zy4)#rUucbgpyX<tX-+Q*=@&~Qz_yuLAmM1*Rxean`Tb$+A5SkYO2Jy;>+Xik?JA*y
zQ2jW!``!%Xl=P#n?-6nMgHZe(V@Ek>7{6OfM_!#)r4dZI7%DVu=e(>WKk(<o%vD>q
zCS#U*kt_ZxpeSo`Y=DE)3~%R_Ky3NLM1wM}<PkWYwuv>ZX!fC-p63ucUx>DX(__C$
z&G9?&QzPV7N0if?C2bk$Be1^T=~e!Yb9YhY{vq>n31Vr|w7V{jWzjpkUVnrtW;#Bh
z@?utzHx-|;EOFUAK&<R<8%i*KpnCE9qSP<t?-A`x3J%ixjT4`un_qWnVqQ9!8OVMb
zWAW#*HpEolGN`;+C>s@}#}lbsI1Z5Ae^RSn$vsf6wE3{IvVztMR(UKhFK_bA0F!^-
z+uIu-|JabEqqKi`_*<t-O3v!)>aSnF($ZddOw*d?7@(pw^w^xhnwpO|`s|AC0Ns``
zMBJ|BPw@Fo$v_$ebKmTvBJoxuv{+-rH8u4PX@Y81yTU9L&1~E1cK>7&qJfl4z?8sm
za3{^<^g$mrn(}8Ly_Bhi!G8Dc6NLx9`sn44zhIdc(h5t?&}%xtHaxEtNp3n_c(a*}
z>sz{CW`WSs(O&B1B^MGBIwt!@nP|=(qP^$Ja{rf=CR5R}r}>)U9)l4aeR6!BSF+t-
z@m#ouNOZlz?Ld6H!+c8wDN7icr|WEcLWt7sOy!b5+RE(Ms3K(G<z<lHJF=_x5d1M_
zu|=dQwYJu)(y}cL*WKOivpwy)+M7T_L-TcWW5XdAQV_7%;^*h(l_~0B6-Oi0+SZo-
zT_-j)^!Aj>U2_WyN2UG(1Jj(0P3hjgz7j1M=&K3~Z{V>@J((jDhf2Es?RMo{NKU>Z
zt)uM5o3+ty#T75JLH{s9_2-9K>g2SpJ1ZjnO>=dXc8AUfb(g4f4x2#lmlh@wo+m$1
zTA$4-?az@orsWq!0k<`tcZj1{61LF0&&!;aKil{NHJtYf*`^FL8I*lKpbXuW+?{uv
zK3MtVsE2*TXJIAE2@07uGBi~51KLAX#l^)aQ|k$L8JYJNAp<d#B7<Fx3r$`ul9E|Y
z^R@PIs)bf!qwRLDiYCAuW4K+NN0x*0?!oSO(pWRY8Ww2n)T(a?a)yFs%LmLxizvQ{
z7Wo^VN9$`q^0fp*)u#hTH-Pb*()gmbYUhOoy$&O|8zSr2KjTd<#G=L5R_9Z1UvC@G
zgCcowmyMe1OKfkzos1b3ZdOH39#+<uvIT9$o~5!`W|Bfe1}@DE>4c9S4fplsmKqPx
zQhybCHg2g;IUmJeA_FkR?P9=!QhRMrb4A_DH8ET3O8E<RD{?o8C1n)4YIEFfqOcA6
z>N5UaF%zbN5jgq_hk|tf$z}n!jh@Q*FPKepke^JCOyEC~j)DqJL->uP0!%QkL(&x}
ze)ITPX!AQ<LS@?<xW;9c=ed{7m_?9@2H}n46oGrYKn=-&%?~3a<E}Che1&1iFRiGs
z8}Mw(TC8yRfTL;~HzdTERa@P4<}7HL$(0Xxm|I?k%@t@C<sZ0!O~0v^!lqPk=;NP}
z)ortmvrg}KKB4S+hv(lk8dRvY7BBgjQbTn@bTR7Be6!19q=ukP6~(TmSvKkBu<Xi+
zq49;ioULNLNN9<<x2da~a7dBdg!atjR-KC9I5T7L8kLlt)4@qk6n|#hJZ;3}EdfqM
z+|Yxe*Th~bGXcjtj+XL3pKh=&ZU+ECZa%P|iQlXL{)sLtD~ou>q6=jVD}Z=AJOv$e
zwnOlV{E=?<)nw2YP?~=iJM?XZ%r;GDV8ycycvgx@DkzHor!X>f?5A=6PzB_;z{CB4
z+Pc$|hQe+{T=A2`4<4P5uQED(65-&Z@3?Mmkd4pX6Saoc>Ex__k{uUwHg0ZGcZ&k6
zR30#CU0f@dq-4<5<;9_DW-n$|zZLQJc*lfa;Gp~T^t7sq*9&7-Yd2J=mTD|;|33L5
zCs5RBtvRNvCjO)QLBel$bl1CUzSY0>6@9Kz|8muv+x{$=M(dtOH6z8vtfeqRN3i$@
zslekOKYz;M#VPFvxC4vsC7j1ZUIm>T-AS&WYlcr>#Wz$Ok4-PN1!kr;Y|JZx)_?ud
zK9NC(3T${X2|XktVrt8OP;#$6Vla-|lbDzoCGNf?DG#Ni9t8pVGtpOt@OuPrg9AxC
zllK+Nr^x9i%KX~Luyv*KEzV1O%dZ_Nk21~%@3)mCE3|`(zkNWlP|o*E4il_9n_%+e
zE}e3xtqWbMkO()=BRGX9vbVd3)%U32O>jd4Rr2&d$HFo3eG%BzNL~!#!-tdU+0T-2
z7Ht7ja`;(}@^K<SujAzGtTNU++q-JqMFWp<Gu_!FA$f^qz?iiK2-V8#j$~v|OivpF
zQQ)$t)atIoNq@g8JJPB<viUOsX8Ym78e>%LG_tP8T4rZ;G%6uE((X&ej5a2pquhC>
z!pb=d;0zT6W<a_k{d72Mxc8e0!vG<&Mj%J{{-e0u4sm>Dkers*>-pfpgN+~T?Cd#^
z>ok#L_OfU+q(Mz~7*JsC!m4gns?RcDH)dY0!=Yk^nIT~@^V*ns=F9`l+cczc{_@7+
zT7ewIv?glKu#V?VeiMASQ3YK}w2=uCM|9Y9<nw8D9CPo}dX)pl`r>a|G2gb;3_DiR
z3&YT04M!9E&*hud%lPs0OIHh5OAgS*Sa<Mmv@2&TF#)}375t#kSCZ39{GQ+9ZPZM9
z0=u(_MFcs8NZ7f1NBXFwqpUN~EFMhb%QvdD1Sm}p50ByDVX1(_s*QOv3W}{?zaEp5
ztB_s&UFm{mWdS}_7Q4X5$jB%rmVQveOIa}wkf^_Yy%xU-^nJ6X0!?@BVnUBU#D1T~
zNU)TV{;d4%wJTgU5^2d@{M5?j_&YqQ(OuFfQLb&a4P2?0h=c6d!LV&^-tD(U!9YXZ
z(mgBq&mW(fj!OU>j-5ZS2vR<9o7TuDU0%wh(<`MMjf*^Y>5e2RyS)tX-1&KVuXOT*
z&~GzE+?lBhC`p``qGDnS?|RDm(u#*%wiZL!li7KB<B4|K-mZM~ceNkRqN}#{YX_L0
z2vm<D(MbU5c)Pc`I7ewD=|el{T@$iEpnIuQXh6%VOb+Ai5epc!XCs_onu~!Kx#>$b
zKc9R5kkmzCu*kOmjkJ#P4v_v-HkEgN1bOxT<H(Ute?Lp~a%N%HVQz5|%AQ-QtNucr
z_=}XJq(ddpOc-~ZT#V9;Ub_vbEmEo4i%qJz#{<J#J!HENAISQM*8j}r9nR01nj^nA
z#AEi%fPKl`a41b=w{~x1=F@9YFx&~Y-!=B)_Xu0~T|?si%9@OOc!P%-A%5>ihHfq|
z^J-PJi`+i`y2$SO_FXI>cli7FZF6`+Fy9CeK4Mmu(#)sf5r!Nb9KbGX*s@~B3)Q>{
z3vBs2sU>{Bbo~6%+S*D)Df}w!wXh0d_#<liBnEInCxVbVOg%Ow-A`Al;5{PQ@i#CH
zhva&GO#Vd9gOX@mzKsLz%au(3PS|SPbKYG$PXS;2ZJ?IT*efdi`4|Bf8->kR`G?ov
z58diL{~Ez}V${%AamLQEQu%e>Xn>ixbeSw>*bgrbsxh1fwJm*TJFIQ!{d{VGQUwST
zTEVN>vE%juvI&BYhB%Ag-k1;yOHWnLj^Dqn>|jT?G0w9mpO;=1KP(hFYe{aF@MUCI
z40B8smPl~RM!W`0yW#lV!<fvPl>_dQ8d4ZPz~R=*>D0NQ6yLn!g(Xy0|MP2H6f01V
zn{p1WQMrAXY>3c$^2F*PfgTJCadugs*xoOxt2riDx0c|?8Zg}A*cL+80GUw%OUW-S
z&6%60k9tBO$!*?PHFSrN0~ikX22019TzR$hKIHagIupAjkEyIg{Tldr@`KH0HJ#g5
zEJ;^f!=~Vu@{;}lKTk}dEA<pK4#K_<8hR5PxGjLx8Qz-cnR~Hxwac`Qy9=9%_Fw#l
z<-!k(ewMH7Dms=yjJ$pr0|)zjp=@Y%Ivg+6QDZOvmLO}p$K5P--b1;ETRvybJJtQr
z`m8-^6odzK5Ak=V;=kV$rBy==MBX96Ed9KaNj7Z52Xq#njzIH!-WA=0a<xPgx0N)!
zXv@Atj!#S&l^O3J&42+McQNmdv}kan-bQ~oAwUth2rs!vexukJx!c2GkYRTTYjw}0
z6<LQYLMiWgT=%A;O~Kn@v%r9_mNtUKMVCV-L4U%XdB5s!A24NXGaWG+SXLisHmPd+
zj*k$c>{-OyR{k=@*r&DT4)=_QZ-4p`m2o^C_UoMvx~K=8bgrR%&c1ToXGeUrpptV{
z7D_<e+|q(P{T&79Uy%64y<lwSvgF0#M966utz|H7El&FK6o7N4Tubx5d5|XN9|p01
zbai!qIOY<4`=H>{GsMKqY)Y-}2cDIjuyV*7_6c1-T#|^MaHncNCH(V@Wy`Jkj2yts
zW0g~yv?a6EhLEi<>|(LRr{jY2J<iim_pmrV5N%c^(Y2CCh(W<1014^G4;MRgjKvb3
zut$~7>s7|V4Mf`2z?VNOJg(-XUGa4=r>RCwiqRZxbMw}>D{@LoJuI-G13KsPvl-+i
z@UPC}kK+05dSVPA5s{ClCs1QDFl_3nYiioTDPq1|<COe6KAYoVcOR1xG|z7ad2f!c
z01}3|InZKO%g;>_=JF>8YFrAXyIHLog3`9XX)@6wTSDnd(sMs<))1T9ST7@J5F@k0
z>(*J}w~<Rga%ztaGlefhOr?AaM@84I`yhpnA*SVS?qFhDxwRUs*}Wf{yR_JwTtHrI
zq}h#nMZdqlkGt3lxdO;k>El`JtMhf~wzjqgAcO+_WsOW>$k}F52yOt}OHSjznt;4K
zs-zTldCiw8lR4eKuwZ^RXsl1y+0~UFc(N;CH~1P(PELN^vk3WZ$*K3y*^yYk5ok6-
zt7vaPMjk!-6?DQX8kP*}9V&qgUaYo84vu6Oa|_SoJdZXiZUTwL2a!VAHATNTBeAC8
z0ZM80>#clVHvkK(a{{sRTrS?8Se_Mf+b#K}mi$G{_F1}mJy6a_U+%}P26^vY{*K}q
zA0Lm5jNIT*E7A9)GSb$L&&rZ?TWD0Gg?#N76&KGI^^hx9yaBB*huqVf+-qzU?P{xU
zi;s`DYzwH?`0(L_o15D`y)V5$zhJy$r7N6rSD~CyQc6nY85yVXchfr@?Ccvw@1vrk
zQd3iLwbtk$t2g3V3IcSlw(BxNnIn-JIDO9!o+rs)8K;0B03BCI14?QoaV<YTzq1c=
zA)0UB@<OFa0=46k*Vr#U8vi+@)Y%jcEf#7yzHkX9idf|ohe`fO%^JxG!^#4UXKJD_
zRMkqF)2VLzCQ8Jmr0OzFb<AyV&$LZ=QxjEC;GUJ=6Xd-*|3@Kx<Jf3j>Ek63_iqzC
zVuax_?jdT!N`A)EAL4$*M#pnaK#u#9IT(~;8L{}O%HX380$P1T!{3X}+bAXBpV_mC
z^+|uLad+lEg|4dGXsQ!YQ&B17d#fLwpo^<VK_&XAT6?Xh?Wd>jYPkDFM5GBZwGPY$
z>L{lQNI@K+#JEpPEHcv$2<58UHuUEhg}piX#{i@~-mT=L%Y5-GC+Q&|O_1)Nn@b;h
ztQDfO$hyTfRPMQ0AoMZtpO6(_2$)ra_?K1J`5l8$J9o-8&hNN?jX8i!<i&WUbCJ8w
zq=4#)wAv|M6wWW@#WSuKMy_$k&~}sT>`K?Y56~J8Pk<IuzEtcEp-Cp=ad_US|AMLq
zFk(zeQFg%jeviuKhFgV5*gpNbnwAzVV5vaSs~|hr+k3hVzB=n=h?B$)3KVI<e$Fn{
zS3m%qRG@cnLNc`0e&pL-Ko&4Msy%(0nv~Rqh*Q^GP{_&{U071CH#U12>Xa$&Q;PdA
zNH{+ZdUAHe>+$;)HVaTZ)`<IpR=sRKal(d^O6lA3#c2aJ=nUWIB+>bu<LoQ)>aNm>
z!IKZoI!92b-c6B=^(f0<$pn6V%!ds#I5+bt=TXoy3e|(|x}mW;43!vd4~Tzo_A9iM
z?!(9O4-{ZU_Rcsqw9B6vY8^LGb{Kib#8xY`b(?;;nVB0M`o}=Go#EAC>wrp17Ga2U
zT+jR2K7cvnAkj7Fweb<KA1*K}4Gool`?g9{+o(i;cfMf{h*n1c<m&ER{WwviwFh+3
z)0Y8**@sR~*Hz}_<*B7|7aTKcx$qK@C&S^+zP`ecrLySm!x6)}k)fd&#7<Knz{+<8
zJ>9<NNXy2YUfcvHdH(!xXD&%&&5>6lTLb>Pdc%ofvp~H2nQ&V6Ej@B2B_$r7%4wG^
zJ;#R}kI0Lb0ZQA6_E5&S?R!b@Ip}S55ANaHc0(oR>r*tlgXscADBce`Gx^VI=65#7
zLe6m5^-7DD=`-XmN<$B}^mgOpwNS5IbP&)1zELtz;%1wnsgQc787yjM41KBAT=0){
zKcvx6cv4Y+9gsJKk_l2Xe+?|ph-++icUbr;;v0h<GEQgV+8CS}TpLIYe@HIZfI?ni
z+yS$g-aZ2AVEw($FhaOtdB9dl5zttCJ9WqTZgfNh9a+Hv5ccn@+`ZgHA&#E_y3GPC
zqidO~A$<aG!qfTrow4==2BpLbk~G<)*%AoQG=5gc!_S}SJro4i9R~_Cf_wKO#a2sf
ziqSoQaL1=7wTcC)FLvSh`|m2Lf^L3hyUL6DPg(=D4aqHYw;E^9ey-a91*%G@OYD3Y
zR!Ve3L=bSnI<kg0?F;PGw7P*<-+8Gnp!b)(?(;>&CbX0N;`~K-&W-Kili=dFyk>gc
zn-BUYNlR)BGre{A{56Jt0Y@&*?{WQJ?_n)Dh&{9{L2TW=%l7Ok(leF@yIGAZ>9&_x
z7m}AQv<$=ujW>o|Vqt)0>~KT@S+=mS(0dmQIWlOzd$K(fXSnRYPCflNEj?Z3#Drbi
zX|i~HT=#sU&Ie;{Wpk-L1q1-kwE3w@2vC8%PS4HFWwdwkzH3(ZLitUFt;-!gFNs6}
zRDvU|*kc2SB~c}_aAI1w{eRLbg!gZ9ljPX)Bb(XNlasqsHnpA&G*G3B)a9p87A>=u
zx_!qKF@5%)6p}XRbejvWNI?^<-}cq+-rVebgsS{uHpU%dy75p#t3<J~>hhi6uy1#^
zz!rxBYV=daWqTOF0yPiv<h>%i2zro;sciRFB1vTnstu*xaPL0<`Ki}0TX$Rh_d-m1
zVX9sBUlyE~v>?Z^;?vF7Ma?c7+~?>__i@*Z-C+^;B}NPb&J581#l?-B?*E|;Io}_V
zzREgkvX^cEa?>@a(Z*F<_n-ta>EC@vrDkQR!whX~3ex0Zg~hf<4zw!SfL{W2XNlw{
z*_<&z+9_8#<N}%4#r%r_#yT0uVY+WvSc-r^%Uhk#5zX%1qy&hj0igl(KDFFnL2X_}
zNw6t%L%u~Xp-ES^|HUfQrb7P;&~2+QDcp6*<(V#LiJ5R8E!U}Vnl*aO;Q$*uf0usn
z8ZqeA8!|*ZOt8bu0G3ZZi7-E$bPF+W&BybPqm^Svgb4wK)4DsG3f`QI6jD>M6K-Mf
z6=VSxUhSbDZ?6?0nb(>Orm<Y9sTwcE>8$y5CHTH@n_So*F~?8S#N~SE37aoX`8Qvz
zq0zBaVu^0;Jgt8_fdp$psAgb5vKRv3jcI_liH?qDe^z#WcC-x(*kWUs26#rkXTV7+
zKwUtZ<fX5#U-0eQ<%ya!gM2imCz#-iqB7xXloj6G%8H)trAn^9|Gl*|>Cu8N9lnr|
z5L81>&U+$!;Vm{hZRRQ1f!eIUuB*#z<?PBxUT~;m<ddg806$!cTw7|R=n%d5Z1&Rc
zm$~(Mi4S7rJL>#V&jDEDYfNC$xmG)<SCp6_i+HxD^wrvz*X`!tdd$Y!f&SKoTh-9b
zCi&YqV#9%BXhPDle_1?L`(JG1!84;(+6rza%)H;{{4ju~J;RZj2_c^he1e!zpF4kY
zabGNCoq=SphS+?#Ta))FWNs8XGc%Jaxa)_+LmL_zba7tR$SFE%$r0qqQXuE&0bq5W
zKy#>p+ENgZH2*Q$e`ZLC7;U65Wqq$ERXl2Qn<Cb{@Wh;Da4weh91~r*-!EIw@HdQ^
z4K7MuIXXYy?qq2MA9a<a-(J^qm^v>$a4muUp2=5*$F?P`20Ns99j1w~+~!x~@%bff
zn5(_BjJ%q&hhYFwRZ`Lfuu*fPMCFEo7iUK#9EM-^ao*z8B})P$l2`yXUhQ37?g0Ul
zPnrifqV_b^HY?cL?d!tUA*JiH^5I#R(2+-iAJ28EE&jG><%cy&$pYxt8ph{6kcX<~
zV7KOfmw(KaN+r(YfCy0S@%+>Wk4BLNX5e4G`pv&QJ2g^@i!r665?yWzR;A(TKR=ue
zN<`j|05dIs=8om1lDgJbR||@Y<{51C(W`w)Miu6CZTOA+xNEcufN{^+sy98c)X(P6
zU%ktYi-_<CI_M!saIh4Bb*0b$-p*@~!Hc^LgfCkHSS-P@^w<Y&6p5&~X&!nHdgEoM
z9mURfNRv2?$bk3qUOgx}bv*i??t1;T?s<ywc3@v6<<-{RDhm$xGsZi<wL<_8$=7wZ
zcVoXY!KdN4PUp^xQB69L63Nj0fZin1Q@gSt>zPKt9q21|;RX$3RSBy>B_$=<+1Y@I
zpN);}D3jJz%5$~1Wv^Yrw*RYMktP!(W9#MFHZd?(JuNArcYl9f+w2ygz<(OC3K)gH
z=UAS?APzWYK?hVHe|q8=VxJ-^Z+pVcMQq!6oy0;aa>#>M>%4D}5$27@$ZMS+1L9M`
zd*#Et_ALuu(DxO$FkfK9j!VRKLWxGRP&)G_xM`;GAAaO0J(u*$HgBc6y@w~ZpVE)h
z)0Z0!<kano+%CADvCDJ2P(PNyl}phK47)cCsGu^i32pxG-o-ckPk#Y8W>IAu{59lo
zLq|lUfhGIh#|K*3lIenO0Lkp$x_@uG0bn6{y*Ea+q%XYDgXybb7x)wVe7_c7%vmQP
z&p7~J@jJC6R#sLSv%i$=2R^$emS)89IcO94rbP3~`n?f$43m0JN(!)^WNb!2nKw8~
z?+%<-Ef+2b<@18efTt^>Mt>1d+_%6neDwDwaZu9tJo|p3I@4`96i3;nex{dV-oG7L
zDi~&vL9b^;IMph=(#i|;rU}<u?1OKU8lLUxeVwuT8Yer-ns@MfS&H`p=s~sWg#t)(
zzBfXpaJ<fW1_acn#Obfmeg~_4&FG?uO`srM0`i}ysNre4eKs8vJ2y9T5~YOi4(;XN
za3#PbbHQ@lr@%2C$Uz^AtgNg}%Js&=E88hZNSKoPC?Lc7bc8*bSy?-PdX<!P`U}Ml
zXP?#RXv=dlvYDM^dAzusL{A1IV5)~GV9tnd$77DfCN9y)Bh8ncRUeoyPIKX`476Oq
zn9t9eP+Fa9^>%iYWV*HVmMQUEWuh-*238+s|4F^nhiph9nR7p9jo1b!kYKQES*@jq
zy$TQa`S2g7oa0FCfTF@|eS_~%b%3~a9`^DdK!O33MnDZN`b;QMfFCIz{wP7e`{&Pb
zA_w5W4p8A~C@a5Qe-@Q+-Uh@gM@L81Lft}Lz%@B7nh!5dmak5bR~I7yZs;ZhpW~OW
zKyQD2j{}{3LDc-)x!EXhSlSvdB*dsy{2bI;E@m?yY>WI9Z73Ey;UEZz5&=;IaMp%Y
zK$ce-5W8e4hd2VNXE+@|{VDuIXZ%UDUqxNr+s}^{6eJp@(t`l->c=4hS%N$RY`(T@
zmqryiZ843meL!Kx<^s^)Dyaelc`vG8pk{JSMeSS?h|M}Dh${V^-83*Qx&=bVy?lio
z8!H4EGBR16QlBcHjE+x$;^BwRiTZA`^`8$t0jb;!Z3(ox+GR?1v$;#ia(kfj(M%AD
z&KrYMRw8rlSFx<D`_xupYRUdfC9>{26eqhMHg){>KcZ!Q{TLYN`Y6S{i;KOrB=>)0
zy0_0&f|04<U>t58#`0l%87ZwYZyhJaEWZ5Z2}3NcG<WKi(Y8vf+j6_cQx#P*pl?S`
z?tieV!pAS*$|N6faWq2<In*g#shhFPw*vZzF}%`IXu(9_gv8`rt$nROIXyl77AW3;
z^?6&sQDj6!-^d6|+=m^C?08OT94(?=^uzPZ&W=lIe1FmaK>Rt)nb+8Sa;f1He^5eW
zAYuLUA-^OltUqb7M(p)wa@NSyln^Ip^n;{0(?Qmo80V8L4qi<ppKaS)cq<P1$5i0G
z8c9){R6g^%gs+0vN<Asxtc;$ZRj1QRi^WF!qFYV~Zf<@JSj0!BKZs7NOOfs>A<LbY
z-`K>X35B!b#_cKlYu$cLRK~Sr+05a%F04T>9!rR=c24u>9>_vfTwO6h<O9E32@Bu(
z1DH~DT%3p>C~(xN4u~7{SO!SY=}NdsChew<{Ll!{LQwt++@9oIQ}Is!{X<S(-qDFW
zYb?ynk-rrxfY>QwhGNlNcuYZY-SF_jz>AAF7F!yc(Bm9!#DKXmLV^CNZC&+5{<95W
zDSt?%IRMe-A0SC|+{{|GRFE%PcBlnk6hIOw&J_tXnAR&&E`@&AJRT{8<V=y*7nLlV
zxe25Vd{@W<G}6KC-4`zNG-`XNWbWeZ6At?=V~^H!u}_Rnh+;Ai077ZGkY^-`6mf8W
z!@IerhToGRQB0z4uQ1gz?_h0hjR?A)p&y|iH@LUoL(2j*={7btGBPq0ooRbKY>W<3
z`ATukwZdP1{P+={9svg^w0eYA(2g35FtC9@8zHIIK}lUhgUNpg;QssifP%iCPDxOj
z$pNhNUT<Svu}@+)h6vzw6NY*WfOaEPAXq7|AV*F*ByPO^c+NR^*#+K8Cp$9yS+v12
z^DTb$(~rt)<{`l4azAfy+PnQ|dj@&X&++?xG{CeRUWdMhz&|k}_a0Fx|HJ~W57m#5
zf-&{ZUK4o$r(|GYAcQE_gir0xR(CC&`|d3*<~*SRG@GVPO-;bb!igF<oTCZaF*zUS
zJ!C}|@k%Z*qHRBIRU=C@K|?GvEsfO)1~4!kll00Yz`+GG$yKH#YwK{8o13f%Jb-nH
zzWERQU~^KD5n`UTwhDEmmzWlMjGAe0GR(`YGJS!JbU!?#^d0ZNX%5I^{3+vs7@#%J
z>fj+;N3e0P{VFS<lfqwba74=ZX<)|0=Gf%S3ji1miIK}3h_GK`XDL<KT?gvf01u1*
zlrY2#W56;vlLIbYS-A&TRZ?OiP_O%)9XcLR*1$VL3H<h!pyn|o%z6tgemo;0qBL}D
zPYhTyXg7_5gWE4!PB8N)V$brn_^R^_&g7}6smo)V3)K&JSy))Kw6vxjdc;@7BqWly
zs;N9B+}+(vKe4mS=Vv{B#^}$9CcICTTyP7)phDB*;jLZz!50XE_9D)-w6y(wys}JC
zb-`WGBaE{=m1vPK;VQtUndSBba1gxxaQp#XSZpfda-TLO`ojt)G}6>!^k(6<Rl5iJ
zq~1MuIlHumLhwi^;+DzS@3JFz%>LWO^`>22{X#hu=ag#U_%$!G{0CTS9UUEjZ?a)N
zfrBr$cmSf13>=h@p57;3k)A)X*=uo~BA2f&Ps%LfkLhI>8r*587^YP+9JGu<cEJD;
z_^HOzh5)*CfG)58Z+%i5z!@N*1Hf4@W+39q;$w77>$COiG;iNS5F`8^*-{qm=BN?6
zE6gj6d~9+lLw1aO!$BIG4>y>^D9$qO*0d3&`T-6lcexI0I#wKlG8?`-JKO|{?{=R!
zpk``4KN#SAM4P?<<YNLbc=?P-ojxH5x0VW^5J3S2)Cuj?>Hi|?yW^>T|M!n1E0l~1
z*%=vShK$G#*_)K?Ju{9`Nhy0}%gip0y^3V-tfR;#WDCdmJ&(Tc&#ymvJl?&_d7b-p
z-_LPf*YmntAtrMSi+FD@D#x!RzJ0f|HU8<bJdHDup&ut4ZrNu#AB1)#6?x(U4MzI;
znO@7Dwy#)Xat%K-`;J*VXjlk#-<kSPlK1bQ<7PMTdeCuWeYHRN1L}8GQv07^3laJ7
z1g|DZ<EWpD`Jmi8-p-ZOr_0_rIi5U860p`#RBT7y;Naq7@${X3%~m+P72kL`2kX3h
z{OxAH$AnE3x~4n1uc1fTAQhftDd~ldPR8*0UuRZvx$lLhvqAUSY}mj1o@S%SrG8Rk
zE<$R;Z;NJ6Cel&sNyEKRRV4R4n~kwv4XP+C0RLO+t`c+2(bzx(k8#Z*0AZqjhgB&%
zw4!c{LDVK6#MtCz%0W?tW;aM-<Qm(1=-I;fBzP@>6h7>0^_iLM*yQIXrmM||6gKtu
z@@w^TYSq2dVtD(1M0`-rFL#N()-y6Nt4Qq2uhRgUiM}e1q~fpN^Fx_ASM1K*fgA<|
z#F6kN=#LMfv}G0A0rh&G7Uy&8tfG5N)fS-u9PHwB&TT@w98!jYx^lI||L8`6$L9bX
zAjw->&#v0GYB?Y18$v@%+c3)EpbONjOJ6VBfo{_fp46p0Ed?1~Inq}thtPsLs&XTd
zBcqu?f9Y>1O~ge+eC+)S@Rq699Ob+{#7k61hZC)QCv(v!k5z-5m-nQkK0Ct7RbWnz
zCQktC_+)eG(xrm@e1mPrzw7G+goL+xH@3IUFKWQ{V*X|*#CH4kQ<w<e(N*?mNVx;E
zmNKNX*P7G}2AKvOM+whV1&}^hdi<_J{oN<ou%|o-0lK@HuR7iUk}x4SUvA~;)1}5D
zCYHqV+G{-R<k0dKIg#RcFuk8u`Q!x3dhlz4NQL9%M5a7h+$2;B%OfR~XwxGoBX@oe
zDX+Z1;*vRE1mDefeH6uTCrK6^+qCZ&s?HOyF5kPC4e*HG1x!HhButX`MW&lRa0oOq
zPb6~0Lv%k|ZU~1s{=g<;KSkVUxV;@deydlKSIBKF4~hA^c9M3oPan6ovf{gnE+76b
z!OP2g>-Ho}7>%*mp<udLPhI_PQrn|k)f5=nxJpN7e^Vv*ZUX8x(Tf)^U^=+(Om%u~
zEe4q7go~xLobz7cKw5UFDJs6_gJLq{3Y4=9$<k}J@^^bGG2746{BU9P>+&bdw;M*q
z6pX3F2o=^^rg#y0<sHdYZO&LogXEV052DHxh~Dkzyulo+WZ9j#Qz!@}U5jGx^vsOx
zs?S`kF5oPB<yks5?wu3Dir9fdg_iR<O9I|IzgbnQJDEOm>3#g%-+ycT9t?9Y#Xxy9
zYEA<Z9@d1;-d@XFaS03krBf3|_F6Byv*jE~S7q_^w7DL*&dlpQ-z|6FRCbRZCiuhX
z+w)V%+3*=K;jKT|MULX#-&z;qJPn8;j0Fuw5*ztl!=MtQ>P;wp{Vg7Wig{Yo0P?UP
zP(P&Q=M=;DtcHv*R%T5v2n!7$4gtSif!ggah>q4YGc&t?zw7N4{>86csNUArU`h)<
zHXC|<hR)m}kc(^)b>}W-7uk`T8aTPSKGsBq0-U1q^W5t41KI|ww*%AlGA1qMu{7kc
z<-+if{6h_T@LM1MCPf&K8R8gqmG`Q4m6ycgR^3!)CLuY0o`tOwR9yu~JDc(vG+WPt
zazTu>HU?x&c?Q?3So|j@COH0r+d$B+JFV7L+@CMno(f&lbe}(-hodH%HD|r3Bo_Gw
z_Ole`Y9Uf1FNSK=sHXb^5=bB@G^VQ}VD_rRGQ2`jKvPo_JTK0cCR@`4UHsxJ=V#eS
zco!p8@M${2<-1FR(M$Py1nQi8814S}<neI#*Gp=57~xorNYtB@XmN_zK4<_*pLeS7
zrlQVjCvW4AfqpiaN9v@q=z8}>&aUqwa8@Kaqdag@8L#VI>3ClRGw3lgNnerH+O!#8
z`1BR?7pi?8gngkn%#J5CC>OmC)&DWW5c3rC>WzGdH^t8pJn5NCx=Z3CgcD-3Pj4Ws
z@E|2o@tWKjd6ApDP}VD9sEeThZI^MnAcXD0-Bk>hHEU-}`)HFlx;kFDp(Aq|D9yH<
zDfLzR{Ic_lgtp8S@E1QD-RLimWZXiyadMrhdWE*ML{Ph~+Rh<(U=0=WZ`c1Ntu|yB
z`Ib8g40f1`R!zt;$(FKnJ5HZ>GT`38PQ-se5)u-U3^b(q9VmWpfI$awUS2Xs4pfOs
zw5zU|Uo2#T3jZ=l>S3WemhZ}pC7#r$H!Z?DCx_J=TtZz}z)bjVsm$B^9}K4Hv5Dj$
z0dZ(7{g#{NXCtB9I;bYu?Xd=k545y;<yw;0Ene=Hi|C<7*E~3G%ZgQrUi^&b_H@x3
zM%GG{?%knA7;Mt3FpV|(`=efiG-QKu4VI_YZj4Xo<xCa)jIhdYFG*;=ig+Cz9>VV_
zDJdXI=*|~+`XwbRi#K6oWomf0c!2knplajA*s$vNP=t|0y0l#GW!<`-^9PZht#JST
z;TFWfb@8vcl~~FVxZlU>OWPG@cpqj*KRt$GpL3XD7!0C%D*@R6%@Xw`08qFhCg9wF
zx}Bz|Y5F!L6t^=v)jh5$usp7KRplU!O=4zHy?c@>cqa7%P9M`~$oOAie(Hd921!I|
zSt>|fc2~v*jc5%;983dW1K9-}MMrx_M@Mh3qmez=cY1(UqLLp2z%@K9ByjXHg&}}=
zk;RGV=*3WzXDtPG+o-HEgJlC`&<8$`N`BONZDFgQ%y0>t@>Ct-k^5ExSMl-j4PL!@
zqpYHmJ%mS074Z$qT9~tY;HRn@R$D7J_sTvH?5bj2U{tQv+34Xzh9RjZAI@2sw%#q^
zmkVNz)sN1y3m<d@bBo10vp<G_RV7W9fwz*F2E+|0IBV9#+a_SrwL5i4;&8ngyMAo<
z-#yUN(^Dhy{PV+Wt^RN7(`mx%Ua0ks8zm3KAEm$updoh=((YOqAbn+Hw?|`WfB|!J
z3zGigeFZvsScQSR25?%oGF7l$WO#TkEtI1E{wL5mLY>O_Lx|=u9T^(9{R9NwqvQ=o
zJvex)xG5pfPHdC;<dW+$AiCemWk$A}5BO;5>RLW|5_(lIM7;RP{KEXa$NI0ksSDh@
zbGM<*?`dh7gF{8p8BQ;GygApY6|ToNG&x{Ar+{I)A5popG#G3iW^F1bcTV3}L4m;M
zmolHcQtR3N&d$!Eq1Yb(-{147%BL6|gPCA(;=7Aq$AOUO5fqOBHCFED4)TQTGt*lH
z38aXb<2#{HH-Yr;Z2k@U?cG+%V`qrdw!?*tCt}D0H(%ew-$MoMq`-rArLBsJiRFS#
z6z*LEk`2a^F9LPUtgN!h597~<p~8(K-bT2L>c{~l_L?E7nFOXm*JusZ^3UO4&Yg@X
zKzouopLN1XAvs79vLkHVxcqV)x36?@=K%UQ(5%Lrcq`Io+$Dw#1XPnhrVCJ2K)$xo
z^*){*w|LjX{SRm0oaT?Sk0zqy)6yn^hm8`-L4uC!{;`XTi-ICYBOI^7Xj32oMCiFS
zNqs_8g7kwW2PF8KDn#B<qb+#_pTRUct@sN#Xh+f~b=$o6b(trK5C&fkA!)+g(B3Gl
zfScrpw@FFk{h9J2VLl9z37{RuBoi8>59TBT<VY@7DypkHGI2dBIyzxoL{v2DcRwNj
zi8A0WE-o3!JeJP)d|D0t8>Z<<vQ%5vnvH@z!U8;l&$T$KxU1BY;zS4X4%D}XaIDtm
z*$AXnReLgI-<TkGh5(`+$X{1KUM^{Da9bJxO&$jYQP($s7H)8#b<Lcm<JhK#RMtay
zL_Mf>yRrV&!Wk*s^dTE4#T1S~cOZGNm{~dLhk-`<02?wkJ9%rXs_rN7u|i@O7S`pA
z{q0tDR|<1Yz$I3Kq38C|x8Z2IBFPIc-2zmV=T&Bg-X%Y8_r|eeRagR{;hT^UPz&6R
z^4#Bi;+;J=Jw1)TqeYFz=c?AsODZ+FTweEBwGqBiN`jzb$HgyqcoeX9C6^VeA3;bs
zxc=T~_?CYV#2HJu>|6K8*}Kr3@^CQ0dP7sDGEh(v6dgLOoMP+TI5<X9Y(ViXP_@bC
zU@IMHc=S2qmn`jL0gTEuy4y$((#v08Q*VV0H?8|(e*(YDe;QSX*cl<v7o|L_R^L>#
zeX)BDNr&}MAz|k01{MQ=3ASn+h)albnz$z)=6s#%$f4FNk|8v$nA$8h5Dc$8gZ}&Q
z7lou+<3*pGODc_ljC6>b1DgVF&I32FyCSgcNj!*$A`YjD0(Qj_Q1JlQ0E~lfi0Fu~
z3V1l&)1lP}GwAXBZiYEEHtKDAZ&z-}uuz{Vqk>(X^!IJr2a2|54>&&?;=uaAfoPn2
zzDtvdvXdzOog7$u;WHk>wK#TB)KHBKo*bN5?*31><)!)N21v{h%$&w^RBdzd)0}wl
zpR3F4P;Dse<v5b3Gr%Ks_5VI!R?(4LNUe4G=fBUuX&4l~rWxs5csuLsi0GLr!~^P@
zdrOv6i7a1Taj-wawimhuk@3@R;T8R+9M)r|fMwzGOm#Xw0T|d=nfe4JH;cbWL&-^%
z0Mml_+u~UA=#aDF66rer=@0n3B4MBGG3Xh7W{VdLZ9d|wzEAsTkj_g|M+pm&j$A#r
zdFNpI`U3M-Gn+jQ_7P4fl}+jJd!`C-!667$A|7FypM;WgBAasklM$|(RP|aKBZYZ1
zb8F}$tFO8skHP6`RCG_hxq8r$T4rq0GWCTAg4Z_yl;EqgTRV@PL4ZuATt(}uj8mQS
z0m(sj81J&T6oMM@r!z%~?kFIO_tO78jXh~8(SfxD(>t|JnV2|C0KDeW=0MkPx6BrA
zU=4lHBNc6Rd8|`O73xx^wD5hqU#(qhc`<Y*S1SDC>4OLbz{tDrkK0FbeSWMND6D6N
ziOt!1AA+??>J6h)S0D6e;nLFr#*>}qJ=IkNeCdah3BsY&P92on*G|{n$H|CeAk4Hy
zO)qpw7%d7_&jh3}+KXK?SI=RW)#oPcbC2?4hxju{2e1V~32=s*b$FW%>xf971zRon
zx|}Yt6OJX2$J+$X>R7Q5{5m5g)6P3ojpw4iw1@upcDWs5m+y>#jNrCzKm<`JJ{Wgd
zowW;Fvt_M{0*kD>7=zT98*l<G>|^6Q*B`>E{*3$CCpg*9i^&RWwPj^WoH2AohxID-
zOVL^PCa=PZkP#hpi`a-XPDfzR5ccmVBYRaRSwOat)+UPxnumi7J|5e$_eS_FaKSJL
zc9|caqs>y~PRveIijsni4<5Fs`LdyOV3I$*{(<^*8|;sIYY5&BAbzEp&PD>Sw*nW*
ztYX026&f{Dgf*<{9UsSt@MG&+XCr7*n3<TYZWN&}y?(|Cb>NrUpQ)%4xxPVNPLat#
z*LQxI`*-2>C$_~haU<`xq<*2MK!Cg|^}5ENFMo6ZsIeesc^2a}nfZW(n2PIj?N0~P
zn!#&_CL6Ou&TE0>1_WT+l)iK?C-29ZYQwpzk2qGUs|B`pP)UQ$h%^Q?&*YabDdG!W
z4INUt9ahH95UIef$))q)0fPgSMY&DeN+L02tG42#$^3HP5@}dVE}kx~)VOQ`KLo(E
z3iStOZuki9JY>e|Yhswv0p-owcx6duW@dEsrTt`C*5+WcwXrfb%5>weXP^XFG27@R
z-R_g=TKDz!#oAvP=B<O#6$d?f<SGP~^dlvgh9WlYR|5cgq_4{8?ttsU=^;-aLxpeK
zei7%g3+J9)Snz}i3NbOmA3+~KyvPDLEjUi_DhWq=aBwj9DhS@492|=EpbNN4p}m|_
zNG->`!0-6zAe0Ip`$~DDT%ilS>39Lros9%NN9tdw*a`}eU%q_Nx;}jk`l4BTs#s7}
z%NViVT|t)@z>kd5dj1Zy31FD&tU3$3=v{;2=WQA~a){)kd#l=SO<OWei4ffx$iK)o
zWjqB8)nSx3Cu1dZGyu;Z^N~8lG8lunUr*;kWZq#rVX4{|nv04UP|U6CAo_^V^1tQK
zY!0kx1>=<<xKS|*ee-4+R*f5s(?SA`p%Qqvi-(V&L`_OY77U$$oQn$|Y_0kFHhg@i
z;L?k|cmY%+5<${ai;D`Zide%mKrZ-!V1J{8tycj77m^tH@`X`AAZGLE#NTJ(43&2I
zuJc-kx`z737572_$ITVnM{ddBwJ<a{F*Uogi{!jaq*GNl(_qTTNPm_QApI!gS;qTm
zK=A5-e|i7R<;ox2mHGvV=D$rn`_~^jRrP*8`CAwaVutb&P?LQ*_%v*?w!2mK@#F20
zfTAMq5~TF|2)?J@-kZ{j+K@!maFs<7i%w19%5=IPgS4#{z*7}-=FAy^1v4*DX7A(C
z{w4{Ol5&s_kvo=89A$q=Oevk(D(_cOT1rGrJoA_T{LIwUU9qB~B1Qc6!#y+UC`n;q
zVa|{aN$+iTNXZZKv|?jpp;ZM}hA}k4zE2tb+Vnh}`g6h3`ocGolP<MS`B5U!g-Bzv
z>hv6|>mV@I(*wF#Z|~2K>PuIy><{Uhs-)iW`u;&Zj->BgeOAgg)su9)J(57MOOX1J
z_aS_tR75sJ87JVq6<9M=CnO{Q90CQ_<42FIYL}dtQ6;NwbDKcg_9lyL0cySkL%eC%
z`+6+Xka2u0Y-~3uUcK()h>7!9DxpP@ZC@kr8NyHQt$EXEjJW&~><R8~Vr}b&hq1^F
z*%jQ?<(ms)zI*E+Ji!1WpDW9b`-FMt<^B!?^K{*fX3~vq_hf~TeImqp8H_iXaXwNh
zn~#mn@<)|3((Pr}8u%u-F*I<(3cQpS%yl8OIJ$J97Y_`-c!wn-6}EqRP6~>BDj?}t
zSzYax47lRPfQ`esQK^O}i(#|2PxW}gQ_Um~e&{9$IIxF$Pzf6LcJM?#zvs@SH-IB$
zStg{&#~RTR9Sq51M{X6oi~!798@%4s)Rd)B`1Uz0oPxrfJHN0Cab?KA4=)*%cxjfS
zk~A!|irJe97YS>wgx=!w$2M+tG=_g%ZKhENzF+-)%nRwMH@pp_LaSvcRAEt3OXW}?
zwhS_E?s<Fg6x=MUC?H9DNA7Ct=v<|tsZ_yS^IiY)`?rm+;Y(szU5mPk*FS_Apcw0G
zn8-qc6*K_bc1gSafzt0UOj3czpG;PvoFHoii73ODY;475h$<;9-3-LPW|g#ig@)!a
zs^l>?64yjs8r#`08gPX(hph_gWia{q`PY!!{T0^qbOfu*dLOfJ19-0AROfRSG;DvE
zPyK&?D;0EQ71oo`jvH%gK6fNW;|EMJMdjy|%ruPiG-aRWpWYFP_Yd}<%7y30b}xmq
zU|9HY(ddTOD2AVK!5qFMI#{{Cxx6GNXMVME(jjU0Xomje;pKCaI{42JJP0@9Th<!E
zh<T4Ie$-F|Y+J1s6cru)dQOJUL4w}ki9Xe2+!RFC0QvWYTR)f*DSH$@)!@Q$BpU|X
zFs#v*&?;8or0{~~5hUyFvy0SUobhNpD4-yKA7=z*7QdIU!;e>%n;u-)4I=Ea=z_cx
zPwYixL<D84xF*0TvT}0Yetmgvxa=z@CkJ3|Zu5q{I|Fuy{GF!ZJvQg=d<BcQP4yzm
zptN4bQ$rEM6KfpL`LQBT-qzH(`OyR%qDmc%ot@o<dPuNRWY1rOqrzv&;?Hc8YY_ED
zt>;}jcj(=)3p729Nda>EGbNl4y4X(hy);PDQfkjn>TgH9ZgfnqyeYmUS>fz3>$~=?
z_w&%=K3e`GmlzC^1Yh%3pkBzd18Ey&t8>la<b9>UET0-b<-XV<R?}!1sD+e9)nCsL
zQ8ivokB`uJx?41AorNS;<7pmRq(tkE+#Fh7St)$8t1d*B>zS#h)Xo{PEuucD(>*10
z9dZ2ZG{nFHYe*eRt$p74B|XqExfSKi;r(W}-Mkb!E@PA<$ZcGzRX-Ii`p+rv6R{vw
zgR~ci5mqn7D3yW{7Oq6kC<9Dz{DbKoR+eSaY_UosMTWU=c7tBNoGxxq&3J=b1&)vm
zQ^{QuY1KNfp5mqJ{)(-krGBq#l_ve3otL-KcfS<0%sgmedo=2XZgC&utBHXrw~Z)L
zgjDC@N0~cFI<}~3IfA~eyx6HvhT_JUwsF8hz?lKuH74)ueAlcgna%EUBcM|VmN~|5
z2CaONq3=V5{%5AE5s35p7%fh1clRBbD0DOZJRXBj?;AlX3D!T9vUt<BaMt^_6ncwH
z*Zr7i$d>UCmvgY+ysqvJ;0mqRd<xZSZwU&5uF)E1A|3W@C9|`uQm7F1kL{z(l^6_l
zp8GrCAkJmO2vEqAv1m56uq*sIYQdY(FEa}Y#?IV6kHJBBU)JzS!JKoL(!ursm&0~9
zF4Y3Ek&}~y6b*#WSOF}p<pnPyeIe2?1NGO^!{VVTF5)2pTAuSd1<^>cu^0$$BvQ^%
zs%n2eM4yM^HoY=pD{?>bWD0EOw~aBEUxM(NUcl->n(E8^S8v~%>lflW62nFgn8<iA
z%>9GYW%4uj{9L{c@=^2j@)^FE#)=9mb+Pk`7;`>-un+ub)_mYbsMX&d&GxAYoA${v
zPos=+5(`9`mw0(e3M@4)b4o@=M%LDOf9B;yl$De|I6}@&y!R~5kpZo1WQ3KtOBfSq
zvt1xqmj&<BMYH6#;_!v2)HfF;A1Xv_W#{Ddyt~!h(ZR{Wl2un{M7@=H=gE^N1-d1E
zU?Bwj%N9t26|$ciy=SzVEH<u%%5yvxEkD%K+B);bjvG#K!0}8PLuyT8(YzBr|IPDX
zA34Jb27=-?tPi+2iGz3=0(oP}{zeZqE$toOJ*VG;OQUKM`?DZOzbOf}UQ2_yf0tY&
z0NUWGH35UuimPYOo;A0$45t<01BK8WE{CO-7R6OsL^>rdo5s+#`wud)^+nQ$2zH8)
z<m6=DhP|e?wpVK@SXu&vK@OuI--9YS2)CVhq)=a`M?R;GUV*hMMNC*y(lqaD)Agg_
zhJ{q0;^p#i&ehUo!AD;SV1Vs|4+sdO*1;r~0(eGWU?*xzN_ep!s{LOCh40trY0ftW
z>SCCO`;Kl+qTlJK5q7{@HY%`ibwak)(bXMPL+6O2{DBsM@0c~OH5I`qg9Y1Q5gvO5
zH`toyp0l@Re5b5yV+xfS4XKu`sfkHym@qTnd6|SI%giIxRzsYZDYg-oF>?+1&KOXw
z8E8h9z83K<<&KvNWaLD?z7kW((i(^azdav4ehf_jAe%5hf`#x7_cjD=hwp5*F(>xO
z4_i4ps-1hilXxy2iL813XGlU6N8=L=x&!UmF}L&AR9;qAUG@Eg4|zzSUE<>6z!&)2
zw{P1g7uH-WDk>7A8-3MLcN;H5eG@YVq;_ZLo0GRd#8XjGSy))02ETpFf$6bs`m<1u
z-K3!C5bfp8(4V5c_7i8DK2iZBT<>${<$qG`1OSRQ+V@@t-jJFkR{09h)>6Mb{g9i4
zXh`xJl<-xb$k4gG=v<NZ&hYU(W2_jVwKW%1nrKfOoBa8}EF|u^^S@e074Q|&;1-Os
zHnp(0p2xTrACs`Tp5_c?nwF}ui~<WVCICD_ol=i;w|w9<`>1mV;4nnDtEPwwg64Rb
zXCv#-v0?xEPQW38C}4LfXcu@Ajry$T2Dv%A8%^?86ppXbDb#%Pxz=0lx&X3Mlr?=q
zw#EGRw%alP!Tx@~zcK)9i8HSNYw*U!=X)}9^iFxdYKU-AjKv;|m*KqFtv;v03LKF1
zbZ?f7pZ7N$A7MP}x74$Z^N{H4UPIpU5+iO0<^55lFU=O&2fkXAm#AByn{DZjc!FNM
z7#$sbKncyxYQn56)C}iIC!cPx+3L%^eaa){AE}fLklxY3a>=+yiKP3Yxu3qi{!Pi|
zK8YJQ3W`S>bWM@kYA9ZD@t^Rz0QO8S%-ikv+fnBHIyzcaY-aNAe%PcURU0+sg$utR
z2lXV!#C)|))8m?7BVd_wb#h9dyn%X%@FrvNg&P^5E|QXr?3^>VOGECC!TTF8yYKq#
z?G@Modf#jjXlgn-ar3r_VmFEWFwP<TRc6LaPZ-SH3w`(Qog7;D;pYILr4EYPdU`5Q
zsO{a|9ANy>=tKckc8VyjO<BUTXCVJZNuqOpv-6iAXP;@2#;P65!_5vRR$ma?oIJA}
z-!Qj=d1iXp(mlbk3QAyJqbiVx1+K1);gek5hPfoTn1j(F4NjGcN;j;sqRMr5!V?&=
z`cQ*LqamC;{`OW;P0jK5Gdw)JhK7dU8+Tj;VHC1kQBOkvv=AmMZ$m?uSp7RW=RTE{
zWu`#*2j381b$1fs6Ln+r5SE}%pFY*?Mv{Un^?9p+5Sy#xvYyzZiOah3;j1&=jSq63
z1T`eT8$aOYAKm!w1)l=5l!Y?i+^+fUO@W?8y=3GARX%lQfOi(8BPGsQ9k6|MC)B#A
zor{T1C0P_!a%H?}pOlc`ZbymD4S|pwx``I<RK9`|*NvK**8~i_a<)tp1gr-@^(DHi
ze;yK=gH|Vq=GJ!aeL^6e2)8dBq_xAY85w~l1}20C21=I(9%9cx-1rkH2d*EmoJk7&
zGX-T8obR9HRWkr4kHbLcIwe%SR~LFxurK~383y9d;Nptid36yg+UM8*s}9C^pf)@A
z0jYr(XXD9%jri}ketPtuHVnY;q4CcvVJJ9TLWnQ!!3`l&o}5=8(c3*_f+zs?)#<1;
zrIyf2kNdR-UY91}zLG^%?_%FNdRHcz4I`=esI;_3udR9azj`REe(>Nfe~pHH2L77E
z)~!QB<w5UwA*wbWZoU!4YP_ADZ#A509&Y%s>{Iwy(nWGpydj(i7rOGrD`)8<?h~4K
z+T0u>t|5(8%I^CG>E*C&rab5oqr8@tW%ElCC@9gSprBrm5iVHrniBI)+4V}*+Z+zF
zcKlZJ<H^}QrJ8eGfOuFkMCJbwb}|{iS4ELtTlI7!qrBXm7@fO+ejvy0N7X01)v`~Y
z_GiMu_Sq+FmqRPWf92r2=q|I;iHhOtlCywNT2WTBD*5<ZSe~Q$1`B_<zr}rjvqBT2
z!0z~?D)7w@SL~vYOzg9VPHfyd2mA;kV7T-M71I@d2!$&6o15602I=jMhu(8(kntSo
zi8tY%<6JLt!@*X~YSQlu4Xd;TT$$Ngev|g?&(6&OB2!e?3KoMe$>@u_$6ubm0wU71
z!tXtxxe|Ez8DSrsl$7L;S*`rtl_X>jxJ{Gp!_R2llW^%J?SY0zR7_wgZ~w1_F;05%
zlqY>q1f<5GzuE2+zxMQ3Ae=1QtqQC?!oGM`3f0R40?x6~QN5J?SY4C$wzki@utN|5
z6RMl#&`vE?U*5n?A)W?YEggC898^Yq%o}PKYR{Gp(J}#m0z;I6J`WY~5#r>LT7pQr
zzs;n#c<@dQz2UdM=JuL`kAE%6djR}i<O21{HuTcf6OX~05)`o?h16*Ttoj!FGmXo)
zV7Q{f$@UjaXiYCJe(1RaNCnplG(E8Of1QjaGr1dmnaGp6L*2*mss#Z1>1RGLnez*t
zxqsdsQW~gi@z8_>1efnT{aDcqTwEh~g-NIAGh9%}*6_u{^4M_H1FpS=f}AZXiL!@-
z!7rUy)cGsmj#$(3bQ+FA4bkF<&Eb!Y&bo<G^B6q^Wt*rXMlSqXXmHu7ulbK)+yp)!
z|9OpuGx2BKIKid;D!;{jHtWeM=NX5Iy4P>c0|{~lyMsx%(5(NpH*PEdKfr8}Y6HH0
zN@!@PkfYD~7knVHqsy^OhGk#+T{J1Zm<Mz@g`%$B-rnx+f(>V20)P(NC^@DlYDVsI
zkA=dEWL8vGE~~8c-?@eztB@fR|K9XisH?l%bf_m<O=7Ilags{sg`R;yKEGO`00%$+
zB~vim0yG!V?Zl{dYa(1EF-YDsfE3pm-X+%b0U@PED9+_<^o1z@Q{icM3XMI8SP*?a
z5gp4GL9SbwvOvWA-(N;-J2}L2(4BerP5`QGIw=DK^b5jECi^$wVWf$Be_P>#()UAl
z_LEElKn|Q8>9O}0eMY{L)THm7GcXHoaow<&hAK&{^Q~3Dq{Zcz9iU<Zh-;{e`2qn{
z9#)MH*t0@Cbgt6UCdbDI&-Zh3-ngL#9&sxr;8Or|VU}$XjC9k!ph-5aaxw$Sc&34B
znnY-99lTr{?8`N2^BkAumllacJ)W*!&zC=V^61e3*o(Tm+l$)GOduLp=jSaRKfVNt
zYlTj$Tu@;sC@276lby|Kk6O@td-+zzQ3VkJ=nz$RVQvz&9$-xOo*Xa<kBw>Bg!AEX
zF9C2vV9}}|Ex!D`g0au{6!GH}d+yDDztSLkCGiM97M0$=M~_lddwBUeBO_L<3zed2
zQc8Fj9n>qpy2>(L<l*@DQta7QU!KO!+UDtMfq{msEEZ*D<==JPuq3?}43z12P=ifP
zOt)^SGh7%&qpx1M0=3P+(2#bSfG7(CgA_lm{fEi!uCA<jtuWYDtKuKNLA8XB9}ELw
z9Ws)uD=Ps0S&4xf_WSpkO-+%dr6pfR&|bv^dJGscGBUz_H}|qNw6(PE$;mYw?T&N5
zn6||cwE=PzG!>vQ*1G!Nlddu?2AKc0sVK~Oe4quy_ZXj$(Dn9A`vI;^P8YtHW(vRd
zQf7T;y&ipf7skiW51uzV<Cn=KZ3`3b4z|CLW~^rsc_3L4=o=OfLz!yS)YNDv4-YVz
z5VC&}6cqVnfTMj5o|sKeNO2r8YE0nDN2nF~$S&Um@FkEvR*A0>SW}fm0c#lYsOhAi
z6S#HD*~JB2>1YZ^C7BG6cXD7}(?<YAISuuq7UxtTKIg*B+U6hZ7<_a{WV5=b>KXat
zT(5^^&31LW<q_|T&7yRXm1(Dlq*fK|0d0B7{Sbw<y}7G*goK2)qXc3?Sobx3SU5m|
z@tE;3;3q1Iiu<4j5rfi`Dz&n}0yd;${mw9me}ItY2%Guk3w0y{K_{pBX<#C4ETJFg
zZztGtC|=f&FFI%L=T5@x4>ipDKfv=kjx6h~GDE??#O<dS*_$Im-L=314bUIkwDhA0
z!@&_00I2kSdsyudB>M0>n*>Wg18{JmXA=W~1+*n<;yd4=*!G9P?MeTWBTzsS1)Yf}
z#a<GY{(Q{O;P-{kvvDZlXJt9NP~$~b3fdyvNpM}@&3|8}rl4@E+Eu4K3=P<hE(s%5
zQ&O^VvokVEhEO&CI^o?rfIkUim0(suNm*G_Lu0XktrGLQphN<CNa*mOEi$Ql>TG3Y
zWnf_7<t0M33j7uu7IxZpq3EdD@6Sk}5wXVTcv{)eTgT<)aWp1BW9bF-GWjh<H|%LK
zvD#wB+0;*;Zl%FytbO#UN(R*n{fOz|UF=l4b#rTLE7X>z3wQUqxw)5U7Yi59<Kp6a
zEo^OXXAPtyjeq&O%`J^Lx-U~9iLs&+uvl7+ii(ocJb@BM6b}+Vf*?Ou^UPRZ^J>V#
zfEBBwg2JoF$cw9t^$-o_#N7FAdMlD!JbKh5rf=LF^#%v`oB+}BfY2&dtr4}KvK?Ik
z0~aa4Asm>4!{naKBDbrnD?dN~reufIIK1Tl%NpWov$lW%_DuY4qsdp;0YPvpSy|pi
zq99bXpAbwzKNokqs<O<=+||`JyO4M{soFTl2&H_8!MooheHw%j0f8UQD@R%170rM2
zAYW9{54G8scwH~ae<QgzB3Sk^gz2;i5G^4P*W?Nl8^R1x%5Rl%+^o6Z2eXpmbiIA>
z$10AN8p;&xWgEE6%f(F-X<zK<tZ?$`c&@96vPQTQTFmseQ79P!KY<O%=cCtWG+HTF
zQi$B<({GtS-R8v^yC!0~t(d0}f`J;ZPeKM;gCRm|c10p-vxmc`p@kMOsP9)dx3HM@
zS@MV~X}5ggLW*;L(M*wb5T{8Vd6ZKiX7hxrm>bJAx?_uh^ov2-O0AT3d(L@(g4^a?
zXlRmP_&&$6y0+GK@C!gcy1Kdm>0kLiWsn$WXK(-0u07qhDyHNeWl!ke$8l@X55}d!
z$^Kj8kV)RQm7^=a*WA14si@@8Bfe`H7mZ6ULahs=0?5{~&&Q}3P66x=b%1&Bo=MHS
zALMgQMNH%k^d7IqPiU#P_xdCRAf-aW(?=---qrfbJ+X(`2V@O)MZ0;{`WOOBOH226
zPx|mEbU5NysG`@q!>N`WP8K)bBdyLJkU~yGBxWaSB1_}48%`QT_WN%i<5anmJbnrl
zZI<)DPNQzOzZMuHY|jna#3+9S2e^vm#EH}dv$t>5E&pV6Yz&Oqh6L|O$A>k=58y!#
zNypuJzXvhPT3GZJAF;Qu75!DXMriS(r6aam`WxCI=K%9lpB;&Vq+#=!nwoynyU%B7
zYinz6eviidDfIbpv}4%dj<CaUv&%aSY2MhQ)6x>e%PB6NVi)DFQzFHXem*pHoLH1f
zt`H4n6v0D<zhuU7o*w2@|CR+vQC?{><(#vn&wj^INNw#`hdOLB_iCzbMlHZtTErGW
zNE_i}_W8&x&#c#ng99J#@3{IbyCrd*vzOs4c_Yc3$(uOPb3Os3oWYyf8oc}dq8l#M
zwg@YIf`2sx_uHeh`1l3EivpApt&oh|LJxc4L_j>a570muZL$6;GsJ54@CWPyLP9!{
z-0>zFFI9;y3?{uV+39<-4-GRG2My6`H5BQek-_v4oTtPdanyZ>*HOs~*H!ZEyLdS`
z6p=G@91Qv?2i)X>elb0RgPNN7ia6z`=t4pU+>m3yO4xBf_*d<s-he}!rNivXQ9?Q{
z-K7vRaS0SzC`1m#O*^837|A~uR0z#s{kuDGns37EgzJ~wNq}vjqoGkAha~qsbOfuB
z1x1wKn7ovf6mcf<>$_Wz0bbD1)Ex3zbg~aTlA^)xXL@7$gcf0wAA#@p`c5Alx&s96
z^@FUK*@sO7-V0@h9W17{#}y?djmHK>PvF7=3liwJ!7>brk!OWrZhg@C!iw!`s=B&v
zQK5KYD2K1Wlqg7=lc@Li;sqDwm^U6n@)r74+TW-C`;2Y6xR&S62n6><e>sbV-rHOy
zBMn0s*6w-60_JSUzze1wb1r-$1LbmKPfuzcLp?k^Amjgz2eBXkc6&@{MYC9!{f2`!
zuCk_TVy_SfN&5fo6nU4B*tFsz|2reO%eU>lKq85fwR50^vj-T`Z#{0`&yrm8R%AoT
zoZBD2G6p1E?69UOk%hA?!wiXWo$ak&iyEoNZv6@10ysE0Rln$-DddMpaHNp8)toH@
zVuL9AS_;kSLAWdY(R0nj=qw^2>}y(NN?Y8F=%S?g(^)TbpIKjXKaC^Iz`r%E!8zRw
z!)yVmt^&#u%rUM64`D;s@KMnJJ5kuUCq?bN8}~@(DU!Wm4#UDNX^8i~myY<%(9WU5
z^TU8X#Ic`eW0ep0a@4;^UOb0|2N35IoAOV{T0A*S&De88uhFA}<>1R87L`~tiS8fr
zQ<$Pja1Cvq|L=eNpqDEolH`G-2AmG5aU9LGD9z~#K65}|W9#PtD6c&%+Th4(>XvO-
znrl2K$^G}w`$$gXC&{ZP?$lcpG~r6REJ`|u#hOH->_1}}FA<Cj-qhA83K3(@%y27=
zQ4Lq!eAFP#qJ8B+P?vofJ_;H$2+a`9C*&;do-RAK4YLOmO>m)s(|iwp$;#4+xMXEy
zoQcm)IgZp$-}5eL>q(<))EW^m<G`3*sGRzs#bujWqG0Y$6RwzhZiqVDr`|1!*pJe*
zy5Q#GtLN6jzhySYF#NXBEGb9n6#t8^FN5{CVESSk{Cg&$djfiM7i-G_1xlL#@&2vH
z-?;Qkvrs6lY>g?-^1y+sa|f9NuR9H<Ol-E2KHdF3--4fe9C70M+^T6nXGH8)fU*BQ
z0|Wbr30U~4>TC(V&ZwW$P5G&pxM)t_T{;cuVfr-lii;;I?8jl276V8c=qSXPm>z)<
zA2`*J5D_H`*`on#Nlr-toi<bajQZmu2wKYB>i5a!zEzquva6W%98<7ebSa{85H)vB
z-m9myFN{~+Gp{gW5@zY|<yQBrtT)*M($K0lSdiua4uVuG$Rj-d{MhdiTe}a`FpM69
zDL`Rfo;o`PUqWF<#x!Uemxqhs;@E|p`w1=}QOG6_r?JKJyrHdpiRBV{*2LFEzj?Km
z!PdUM(KJTQu(`ZiLv$+Jht-o4SX+ofoqrV-_U7-ooTK<JJ|X%@;Bv5GaGaT#khpd0
z(^7<x*R|IVt*jP7dLPfFuc5F1`bG|Oau&}m&0Vtx<2wa@9qv~!J37vHpWLuZ;`6`6
zoJ!GG?7f8Y?~N%VuNP`mlB4vllAxG`GUA?x+O-h5(;aiV>$mR!`0wPj4l~~;#YWXp
zX7A+IU?AvmYZxSP>`iH)b@g5apL64ytOx8)KmWYRpCWvCa-{O(+TZCx{DSIk4h^~y
zy$2QC92yHCf?wW2U(X0nPn&3crQOe#9d<)6{^71v&i($u*7Scd{qz`%heNrgUuFTy
zLkn|r0Rz-sxu<*UW<EX`K)H`$C=MVz>_8>F@I*ADRY-((OLA2C{-2u0!eZlZJ?E*7
zdA}>#7gKVc(Dm17H>1f@eD5csNIa=LI5oVC53gJqn~0H$Q&mHYISBtd<Jj|o6R}!<
za*Q$c-H?T@7CIB?=G)g`AZ^wc0J>usWW9Fjk_?gFg9q!g(P}&<bybCh=SPa3%n}Xl
z-)Si%h!o09EDbSSFKByw3DYj>(0*+rM#{n@#;V7nC~UDR%DCLrd(z1}hS90<t9ACU
zOB(_8VMpZ6qf$dY@fZ7d-eN3nEYv9#?Dxyx_Ef%0FR#Y4^1gE?QlIwByN{XVGGr~m
z|6&UWVG0ygRVykh(?Bu~3{KmLADG_2(RQYl?~&&<^*`DHA~d1UPZ1{pOE809UK9AN
z8CAw{<mm*_#-Vv_{mQ@2&aLRGXV5JTM6e87;=}l+okP~m>)PaA$w@W&Ib(sMqBh<H
z@g6f0gUflsvx73#ga&6eRY<0X=_CK#=04yoonKMe@2$1bVRhNC{JK^7UDc#Vz=s0)
z!aX=^+qvc_Drcd?GH4`t+OVM{_{Fr$>8|R-Lap0(z?)2Q&7vncAu39G)6(Al2*~RJ
z|J&FR_yxE`Z#E^IVVqxB*c4@@Zq0GLf_ib!B;MEf*jiyr#v%I5s8>H+MY-AOIlCmx
zBG2<?EvD07ve&pP+N6qmEV)aCxY&AEDtNB2S5=X+VCbpBOJ5H~cEhq@v66Wv%`8jD
zcHRZ$yqZJ4{ZCx#HWe((#oKL^8^Vpls-zE5c&;LTDm+UK)!%J{LV^sJnacpgY0&If
zrjGho)xgcu0RUUWm3S~mBjP#_b4BKUSR@7}$wZ(feD#VTPYdokg2oL7;irLf1Wihd
zyKUg1%UqOr6yb4q@2X#=aUH*mN5MU+L@he+bzbXMj(LmMzC&x}rgB!s#z{^l!*-)~
z=<2_9hnc_TjkhMJGM@ObR(8fXFWn#XE+fva?RAp;#@F4mtE$&=Tq+->J516b8zrAF
z-z1Ng-yBJzq5QupG9CBAn-(y!DgE?`kcjBf<#~`fLxu+?2v{zy@U0=iudc_yumMmE
z8+vp;w(d;eXDA+_AnO1dD=5%r|KguL3q+d7uV8Ri-rd~%U94R5_gR-$dECu5#vgGM
z&IV!IUj_SXB`I(3QL2!UKS-ovfA`C9Pu5DYSZWvJ<=`b9y2`8FEg|{X1XWd~G*oEY
z6HaC8L)A7Qp7GPN#j}&r)PakxvZ{~u!RHao#6X58H6?9TTWZI})?{-D!yB{<y5rmH
zd3S$I5F3mB(ACK_Xefa+Q0T-XPJOrO|H8&xi3pVE^`2GG0D=G`uIv++p^;JHH5ACZ
zQNVjYf8GqSW3dS2XxBvD6jptKNltbIe*%!MV7FNkeZTS}%SVr<=jW-YspDf}W>;73
z?d)hNDP<ia@iuAbWZ^DKNFg=LhE|MLoiS3ojkmfgwBk^X)4V|^uX!ZhUT30K%~vhI
zoEd1i;mLA?Jl~?2mktx1uD_K@KHVdbd3UP4luXCkxc!#vrDbZ<XiXO8)ualgbz3EF
z(>1bj&g<M9EUV+r`Mb46b799VYX@=Rh68W+k+sG@1a-qN7Bqz^(Vl^nOILG#>fd2n
zlmKnXV)a&bb~d+3-EBTT;M0w4D?4tQ8^a964D_L1Tba1vwgPb17I=n&5N{3ski{P=
zN1k}%pe7LOaP~DdJpv#WItY83-<Jr^&iaP_;DNSbS9nMwKVCIYoe))K{p+2DtI&YN
z&*tt2J)~X-$(rdpM=r*#_P04j{Iu_*7Zyz^61BSNU2=^Y9=cw!o(z3tZ6vz2)zjhW
zOOz-mDdxYMYuxQS%gfxteb!!|mhG5ZCC2nR+iDV}j(6FtT5h;faRT{+d+2x<6$)q6
z{EYT9Pb$jcB-7|ylDV-dewJlgCe+c_SxZj)*zLmyzW-V>Xu;9wCra5M>%!7mfEsUp
zqj7u@94w5vO|mKCA^|FpsE;sG_^qYo^*tuEns+5!B?591;Gtc<Jj46`T`l=Gb`Su3
z31BGnJG38=RQdVKx^+NOxBy-wtH$NKk$5l=060`S_$We^41GY|IHbQVF%C;;?Mkem
zT>hQn+arfwSYC#f?5ib%S@zMk*AlzC5LjNp%uItxewd4f-#^r=V{CryQHaNC(zPbp
zv<oR6{rSl1Gh@fZD<Lm92O50l+3d2AZxRO^L?W3mPYlX?{Y$KR_5V0j>#T|)WeyE(
zR&(z@JMd28Z~Ti}-D3+^_2ToLoNu8<YM=|4%F<68FRXM|khT?cH^;pvhh){n?H3a0
z>p|4_3xAaW&7ckQDi@YUfIH$C2SEa;d~z#fKItVVCLX|)eckqeGMouubX(J&PQQlA
zEhOXsQZ5J)&|3l~FwbK0(V$O4R57Xt=Hv&x2HGP~kq%Me1BO5$qwZdT`Mk$~XI&^2
zCclSP6hZp>a&dDD#>Sw+B^btNo}>@7&F-Doq8Q5V0i>_I?`3ExiTzf#x<yUEYJ%Ht
z*pO)ZGAhdWLifGgn>*2U%0%^#Ijx>+z;5a-_gCFKXw^NoH6|=U*6oK5-fZM3sG_^l
zeaGhK6}T+;vcBTIyIL8ZorKoJ(RC;2&&Q~;>$M;KqW(q?J)_IL+%VB1#z}klyF5I3
zE$PE%yPvH8aP5Z=k^5fu%Y}*)pyPVK2hCt#bNzo^c;GRhSyGOSxxk1pTwzL>>0SdI
z@$c3a^FH&W0Sw1rm1>3hGmDFDVv`^W_!dT2>$;%&`d)@UX+1#lKVd!!)NxA@V0c+^
z)3i{G#SpkiZre%Ng7R-KzqfWYe+(mlp!0>k30yaR?;CCM9|QnK>qXK>2&3<P%3%5p
z&9K^<MuK^SmUJ09J~mc1VJJw`BEMK19siDFup(o3@PdQuQ4}d*W7bT4wk-c}+yfV5
z?vI%LiKsBwmC~QuHmidIjjwT%En}+mM&Hs<>Totra1QL!nly?}@9|HIktmCP!%#)-
zZ|sQfQ}<i1D~nd7e#jo&JMk9m>h%(=T&OE-rdiGQZ7Fnes56D$sfn{|DdTjjArNkI
zoUy5*?!SRN^ZONuuds3enhmVK<i^)aK+iotN8-H=x&Z$}XLNey;sT5TLjw&`=aJ-b
zm@NfAU4!8UIaQt9TUV*c$sbu;E7E^$X^~~P0ON3BsNUU@h#_m6wAk1oWWle_+%B!B
zgI)H=AEAIgCXBLJL%EuCAFMo_831bNO0{t&YG1EgCD3lwZz@?OI}x4R(7V>0?tP?T
zJ*2Xa6705}Oz!^Cfh@07p6lljR9UWfkuUwrRr^%F1=AUFtl{{4KlE?GzKBV(?nLB_
z6A*qS_OK^FkC$P8xcT1~HURv$9hk`W^#c@v*L$$X1O8WONY>Q`-W%Wqha?_0vo0c%
zF>SUwj~-<Jk!NvEOiYYiLW1pxi=7<?IWtq-D3C<mW^Ho9bW!bqvsxAJrbk^OC;t!!
z?a>F%0T0W!yNYx9(IT6@(&a(6#l{zmlU!7MIZUHAg7-!#c}nhk{9^LisCY3@5nWDS
z#07#j-%^b1`jJOPkW=?ivW;`Hd1-}HcR_w->TJ)?m<RP*KUX#MJG9je!d`(mLoia;
zt@@}psQY{EhsEghj+qg2I?Ceek4n|%o=A2HkbHmw?Xc(HH(ulg7-u^Hv|!+{SdaNr
zdl+FtyuCJgg7q+&0f&*b(!s6WT_Is%w!hPqAi_>M+cP#+tvWLy0Zaxk@)9z7dYAK(
zq!<VY2%KD8rpvkDVq^ezg{;EgydiGn=ispZ`s!lh4Uc^vj74v1_vA?1<aLDv>qdZT
z8;_rJMQ>V7jJHl|jvo79UJcmH9WZOyYZgbxM{j>$xzqjfx;Exe=WfMc?Wg)(?da}S
z+vIra@#F7rw?cO~-chkLNY;j%EO1&BQVU|<l@lJX1Q*y2(_46^S~L*xihF7vb{2PN
zV_wwu-rQpDynd{4+e4jyC(O|3@^<Y5h82Wlfw`7#G^E{X$6o^u4F3nu1x`F?rIT_r
z(-)GE@B=5rEH|WEy5nR6cx0WwqMbCeUXBCM3NJbDrpSS!0jSHC1+Hr=0<F3TVoyzC
zV&Y>D@zPrmOVQR72>Q_kw+IhVsU`_Zk>=`OT%wCznwomgqg4Mr-jw40T;CK+Slw=(
z?&g4D77~~P>)c(A825zz5MJi;;?=!}l*^Qwn6;0k;ka*bceO+gs3UzM4+X_~<gKT9
zWjj4|UuXZll0w<3RY0bYqGMw`AjTGT)LWt*rkscBP<wv%4<qZzQF-0Qk779&xU5S^
z_eYN&=UY8Wqy}&YRcFhBc{(p9{0}FQT4v|q5b;=nmti+iw+{wD%n8ex{4rx49X3Px
z+P|eq=_QiEMQqH{<iUf8`1ldKI`L~!HzkymVb^PAroddcisytd?y8-Z1f}XiGiVCq
zndROxINL3>Qn=(#s&>-q+87&)^_1)yPi}frS!?sSd;iUC@-L<|YL8#kSleNmYh=F1
z{dK+UDBEU5?HN=UYlbC1dxO+lZS&t%knJeWxdWJ@sXHQXF_yp>{pjugfITUi+kS_8
zz?R5QG(*(`S|+4Hd-~ny5UGcP>b82sU?6QZh#E9d-@xS3EyC<F>|Q^)s+1@BzkeTp
zFs({=|E%V@<>P4G|E+n5C|gzdkw)={Xg=s{iFbZm`E4<E7E>!2x?>i`4E;qjr1d=)
zOMMSSdl&-<CBy!!S<VqaoqA*j2*s&r`u%wtp)R=JmD=QfpwzF~S%GvM_jilC&5Bz1
zJnfR_r_qo7W~ivUNO<cFCqe>Cn>gp14j%H@`E>R6H?mKiZ+>NXi<!n>PG};Wqd-0T
zXGHH0J^B#dn-~9s0b!)Z0vrZ=L5l|o3cyKFF^ztoYJ2!nzzjHN6}D$s1y@jCEo7iK
zRNPJFt5Sb-*yI1i-e0#IxAW`ieB)_}I-u{F<n53!8IN+Pu=9J2B%*57nT;=J(xG4T
z&GP1#UY6O||MuqM|A#1U8P$5&kCi^bQc|E{fV?<v#fmR7`9VFi!SNYfP?G810D4!S
zjTY*Kt^}F2V;JsD>|c|@M0RLf3sa=M{L%Uul`wgB@_@~YU`z)S{judC&tJht>%eET
z1<ChvmZj*{d}CG)ujIzssor|=?+t%m2SIjva7=70h?3L}2d#(Jd*kdAMTCT~JT8<~
zYmFzzaDCXg?-}72Ugdm0PSTHv^VOk<O{sc2)O|=K82m#*A9<3_jlO*pJe@{!&*Ql0
z+7?Y^)x+*%o4^Mn)=$c}@-89Geb@e#pXbQp+z{gT7%n{Z@exj}95TkdQjES{zUm-E
zE>ZG*ZcpYrpOW^^p)+%brY*ajw|{m!u4Ek4E<d{zR6|xRD9u^I{PXbUtE7)8%Ex|d
zJe=?9KW%HI-fN{~aVP23vyI6YvHBl$84#A4pU=t9zXc39c7_vloMUdU|A1XYkAT_I
zK=xtgxWE-~*$kr-Tl~4T&?_98oT0Kum8_@a|LpkFV62}BXRWIL8*lrXwTHP12Js#;
z$6F2?O_w)D8bb^eh%?5#B4f9hIvQScl8La}4Jn1?Q0Q<9UyJv{Bt4xP#(Wp^S1z}_
zw}04HDm#8d)#%bE@~1Rd0vk&er3)uZAkp33_F#;5>H7VrfOcI?FlzKWI^L~pRB>p6
zY0n8O(RVim1;L)4t6n*$3X1T!W!9GcscoBsnde!mNyUGpo}c}<sNy8R;vUEdpL2@j
zG~fQq#${W({3Xb7)#<(Dz2HAt1F0rS>z<eY6}kw7ch0V$wv;N*H{mmg|5{$nD!@Cy
zyA`Cat}w+4`nhsz_6DpzaqBwd9U+p<zkuI>crbPX>op4iijzIejDf}kki>L(V5;Jt
zTzOdy8YbaM-@&%ob7a>J=i*KIR9=OI0O#!x;{|Li=-3zd6<ElP3}GGtNCRvq24ljk
zu;Y=LmX3?pJ_nJyIXS^KI$vVHtHtDtMrvs@4+uJI#FBS9z5jPdTsqsAQae9C?4HB|
zmj1_wa?7sxWY_LMkWW(4E3;6^MDV~dNxEs)v@z4V^b>FgxB+Jx{hKUEJ3sw-RNmd>
z86}<8?Jt~IuxXX=1CV=A{DU%|0vPyupxEx*QCI^vfNnW5%glJ*#=}ziOW(rjCl@Cq
z1{y3=y}p5-aDo*H&RVVILzlktY2Qy=Ir@w_>*bJ0tLw5%s(72D3z&77C_&ELs3MS3
z>x+)9OW(TfqdawmHT73-g$`yhA|dHsYe|PQ$?3N`ofF(n;nbmY(c`oBDhNK<6L7w=
z9M8aGc@x?X?5*GdQ_-guh!S(x07yiF^Nqo>7n%5WM0t66%>{U4a8r?yA@Y|(+@Yyi
zMuiA{ngq$kRSCA>zo5SXXP}GN4T9Tz6E0q@aSn%To<I~rN++u2xj+LtB2eLg#Z(aw
z3+RmN>S#wQ#^DCX?a3RTwk*dpksh6TYkC{q8mz@|4LHm>7=Df-O|OKxoS2vxIJ?kD
zE=~KwD2OkBnoP{hEsyRzlmSJ`@^o*91d&7h)<(ORAaw$hwiH(3b-FOYUrJX%Oa<~`
ztUgfA?C|QwXIwJS?iHFgUYj!5j<5|<S{vOZ-8mBZwb0xBhRU=}^H)CTwogA_O@@UW
z+V}1>$rI=-=!NX`nD;Z|LEM6b&<L72kT}`c*f_Oplc?sSU8Ltx8U^j$As6uIF7&>6
z6u)vYn3lZvM_VD9_gL+`@I<(^(238Ds`Td?I?sImJ)wbQ;<Go1ZQ3Adbx>T>(>H>1
zJ*Yz}C%ij5I)1~p_5*>__51IBO-)_AawQ=;nmM}Nsc1W5(7$cL;i4c7s--9Gi2a@6
zaV^WnGZywwyOjbw9GbJ#ruA!ex3@2BIXjgfmCiq}_Wh*pM)AeybX5?Gd7$ltUtl9m
zciZV94402%v3XBNXb7C0KN*qY_Gxln)^>_=(+C)**{Mj5pwi|b=A5lmdg9qJhjK2v
z=TRwbqLn@BqdHrYQ!{o8x|bDRAC_#v%j+;n02D3)ar6r~K}lf&demH}g1ULgwsh*F
z1?z9_<-ejEbNZeS#cySgYg9W{ly)bk*}k$Gx$<`HbkR}gVEZ84$o&Z@8ds=<#nhFp
zdn|Yk&U$WCux#peKb>rXnuu5^Uh`n2hP*b7_-L9F;6jhoN5_|ppI}^{Xl|8lSvLL*
zdkBsmpph%W0VNP3<sKZInR0`)_FG;en35gA+5wS)hHxFK*5pF&BAo}KPa{)4=}4hH
zZ$@KW9xr9F%08y16t?xFKj+$*(iHIDu|@R#Jp0Fy!>SX2!sVcyRJd7sgY!#+t3MB~
zawFq06Y2%3<b#G^trnH{#{;^wXBOSzM5g7YA<G~+JAE328~;>mc29xGYG8cAzTu0;
zG|O`9$xmE=08`S`rHI}YwDnWHQ61Wfjoa|_qF7Nufa>(7akginUeYeIK^--pzPL@o
zVLh3}8Uz*b@JdO}w(<R-O#h44lVeHKD)RZ3j$Cu)C3*YZV_ecdEU@A~EL-iz;-Y=1
zUtKYdxszEnI+)S9zk~k!C*zFRWD|7SF)RK&S@Bs&ea~z{%dxeJxPo%E!NX)-*QBt{
zuY6y@qwL>X6;J=DQ7-U)U+j=p_oL~Hp%pQ<8qMo!-Bj5oC(1SIEZJ$U!m*JAHa7H*
zelvc>+vw}ZnP)qno`xO+Tr5E^N>(lH&Z2z0|7~98uZq#PE~1i9B{PlU*N;@cU#t3@
z^W;ra_%Mqp<*I1+Q@NP26OGZf{k>Uoy;6Q-me#Ypr>C+2q5?uHSL4fv;cEj2>7;y(
zL52z3?Qj1MZwkI{vS+hx-(?CP;+jww`BLe$l3|hT_+z>W5+k0p!v9`ny4nXV_bbAb
zsp<wJ9=D6lji0@Ujwi}FOMyg{J_XEBGoHG!67^xsSwaaqcG{Y+9L}2m{~tSkjH=;g
z%hJ@bCYk4(C>h>e2*K9E;_js<*-mp4`8K37|K6bep6lDwcPN*gUu*JR<0kdb?zPU3
z1N_yGC|@4@JB|pDe7Bv3u>RvhA>*#KqbDs%Vc-8>UsoQ~#1)4FRwN2V#sMRWpkZJT
zFhcQGKnjIej2ci7F=!nSMbK)j<%%dCm?Cmjj);Q9N@DHQ7OH|sR8&a0$`zCGZiAen
z2o!|Ues2?SI@7v;WZv7&?z?~c_V<0?dx_!z*%Yed;5}OXc(S^oERC+RP_+CsgiohI
zYw5`8FIF6dbQ<RW3K7@kg{Rnc2I{x&3w{g7<&T}t%=GO7?R5&U{I#%f!?9T{X4Mxb
zzMWZqz5bwA$d}*FQcNX}pn!FnpS0wAUA58jifNg}cSd#}nwK?`mm~NzDbIoGkNAnd
zZRy`cmu|rKP1CHQs;)EXT@?qaPKICjdGWo8Ci}8=8>qKPy$c1(j=l6@5Hv6_fn?(;
zoMfvT$uopIg!XZSr-Qi~0N^n+6yb3nBEl4uD2pf3`mqZLX#Y+^nuHGP940IrZCcS2
z!OcYMJ%&shcfjGa1|^(8sGuNYY278`e@8%@1HF$(ztyJIW<qLm>}JZ+X^KPmxMK+$
z=o1^JEho;7{hfp~2{EQ#zXrTpTRjB&{&3OBo$&+t<Cz4RGNy=iZP{s+4$yrZ+_h^?
z^oUmtN0$!#rYLXkNIu~I3)k1JBd2KI3dVFDxUlGw&c=t=>!9Le1oSk!6p!Sx%7je|
zZFhw`&)20Mp}16<M0*E4=a$JEd%;hJ#!*u$ybDPN$odl0F&=fxOo*Y*X{`)|n4~M=
zpyq2Npox+TBu1j~uRQHdU#itr>fV;wSt8M99`8wO^o--i`meh<<W8)e6f+$E3X-J0
z_C_09TS@VxWQHTz*QBQZGfz*YO7-F$Dw{F|)3@#1xiqwzfoTaIhE-fdB8(Xt#d+45
zU<p-5b#+o#O=YF`{`+SJ4n3wtypF;4VX<*>0D#P=O}ksCpFR*08oEdhC)UN5+t`I9
ze;vcrv=wUQG)36#Y=w)wy}NtOBx@U+x5E;jd8=|AKw@#oM1}Ho`DT14za_1SXlzn&
zH-GO+!jVldum^}A5r_}fTZYI~+U`{2G;?mKe0xL$;H8q%QeQolrLlNK94Qb8;FkrV
zQp^W?MV686acZFPx%l9zqPj<q&h~<1QonQ^-72x@yj+~ttZb_oY-q!>Z9QB8oHx*N
z6x*Vqh=mVyw>M4S{f7A!JecCJ5dqf@6i$ICxH~l`XZ7d<BL)4KyC5h<;i6*ik?b*q
zrz_8?S><)-K@Yq<OeQ|RAor=1%U=X@O)w2Gxa)j5j&J5?|Cis6SB;m9NRyMM%uPIb
z(sA+PwUL&Nj;S8P%mwe*)?T+f_0Htx)=ZgOW_60d`&jo#Zc!U<v56VdVh=qu`%2ud
zPYMj9mEOb9vJ~7n!8zV{6&up|Mr0_fs|`rkAeM!bvL4bJ<&%VK%SIiJZv*WT?nkIa
z*f+vX2hF#6{`-!=g*H)D#%p|hoWD7+cW;|pcfktWNR?m3K{o>R5{=swQ`s??9kh?t
ze?cgdxq-)s6`X<l35=q60L43;t)r@B=<!YWK-X<AjLYy{xkq&FTrJBk->lg#w!Lq#
zVUW%1Pg;;W$2y8?T3S8bX%XB(H7j==X4cI8dkS1-bUI)OOCx4Cvoi-Q*|HFYTkid|
zkCz>N(%;ty=?w%pKrzJ0svVJ$oFPf9tE;OtHQ4tK%kI09K{Yeu1gi!M%JqI76}8@z
zzp=<r(`#wZMy;%^rIYHKQoP?7Zw^c75<dETKLZ=V`LUKP$=a4xQm(f*->_WITh;XE
zz|Q*t`G(PwP1Dsrt5;vx|ICj2)G0u*p!cPcR(5%Y>{zYPBi;Gx&6{WW>&%1nF#OPr
z^(HC8R1ax?ZAHZ&;DDI(u$01Om9HdLpk&QQWs*U@#mn7Ymz@PgUS_8M^79W{bg`AY
zRmMoYWkg|tfwsq$BxB2=QPVO`*;4{YN%Mp`oV6Hw)O_PVj0H9R|JRiK>*{-BL7o0!
dH1F<^t8%-jcTTVcbgncS+mqw*gZtJa{{V;mixmI>

diff --git "a/2024/ClusterFuzz\346\236\266\346\236\204\345\210\206\346\236\220/task.png" "b/2024/ClusterFuzz\346\236\266\346\236\204\345\210\206\346\236\220/task.png"
deleted file mode 100644
index d23cf1fb693f2baf4ecc85b45d58713d7d09b171..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 77713
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

diff --git "a/2024/ClusterFuzz\346\236\266\346\236\204\345\210\206\346\236\220/index.html" "b/2024/ClusterFuzz\346\272\220\347\240\201\345\210\206\346\236\220\357\274\210\344\270\200\357\274\211/index.html"
similarity index 96%
rename from "2024/ClusterFuzz\346\236\266\346\236\204\345\210\206\346\236\220/index.html"
rename to "2024/ClusterFuzz\346\272\220\347\240\201\345\210\206\346\236\220\357\274\210\344\270\200\357\274\211/index.html"
index 417eac4..aff4743 100644
--- "a/2024/ClusterFuzz\346\236\266\346\236\204\345\210\206\346\236\220/index.html"
+++ "b/2024/ClusterFuzz\346\272\220\347\240\201\345\210\206\346\236\220\357\274\210\344\270\200\357\274\211/index.html"
@@ -14,24 +14,24 @@
     
     
     
-    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\nClusterFuzz是 Google 开源的一个模糊测试平台，它集成了多种 Fuzz 引擎，如 Libfuzzer、AFL、Honggfuzz 等，支持跨平台，且具有高度可扩展性。\n简介ClusterFuzz 官网的运作流程图如下：\nFuzz 测试中，编写 fuzzer 和修复 bug 需要人工操作，ClusterFuzz 将这两个环节之外的部分都给自动化了，包括 Fuzz 执行、crash 去重、testcase 精简等。\nClusterFuzz 有两个核心组件：\n\nApp Engine instance：App 引擎，提供一个 web 界面，供用户提交任务、查看结果、展示统计数据等，此外这个 App 引擎还负责调度定时任务。\nFuzz Bots pool：实际执行 Fuzz 的一组 Bot，每个 Bot 从任务队列中挑出任务并执行，这些任务包括但不限于：\nfuzz：执行一次 fuzz 测试 session\nprogression：检查一个 testcase 是否可复现，或者已修复\nregression：查找 crash 被引入的版本范围\nminimize：最小化 testcase\ncorpus_pruning：精简 corpus 语料库（仅限 Libfuzzer）\nanalyze：检查手动上传的 testcase 是否引发 crash\n\n\n\nClusterFuzz 定义的 Fuzz Bot 有两种类型：\n\n可抢占的：机器可以随时关闭，且只能运行 fuzz 任务\n不可抢占的：机器不会关闭，能不间断运行各种类型的任务\n\n代码概要 Google 开源了 ClusterFuzz 的 代码仓，项目 python 为主，读起来相对容易。\n代码结构大致为：\n\nbot：bot 相关文件\nconfigs：配置文件\ndocker：docker 镜像文件\ndocs：官方说明文档\nlocal：本地运行时需要的文件\nresources：bot 依赖的外部资源文件\nsrc：源码根目录\nappengine：App Engine 组件\nhandlers：处理 web 请求\nlibs：web 后端的公共库文件\nprivate：web 前端模板代码\nresources：web 前端使用的资源\n\n\nclusterfuzz\n_internal：核心代码\nbase：通用基础模块\nbot：\nfuzzers：封装各种 fuzzer 引擎，如 Libfuzzer、AFL、Honggfuzz\ninit_scripts：各 os 平台的初始化脚本\nminimizer：最小化 testcase\ntasks：定义各项任务\ntokenizer：分词工具\n\n\nbuild_management：根据用户上传的文件，创建 fuzz 任务\nconfig：读取配置文件，获取配置项\ncrash_analysis：crash 的分析、比较和分级\ndatabase：数据表定义和数据库操作\ndatastore：基于 ndb 定义数据结构和处理操作\nfuzzer_utils：提供 fuzz 基础操作，如 mutator 算子和 testcase 处理\nfuzzing：提供 fuzz 高级操作，如管理 fuzz 产生的 corpus、设置 fuzz 策略、挑选 fuzz 任务等\ngoogle_cloud_utils：基于 gcs 二次开发，封装 clusterfuzz 与存储相关的接口\nmetrics：监控运行数据，提供统计报表\nplatforms：封装各 os 平台的键鼠操作\nprotos：gRPC 的 proto 文件\nscripts：脚本\nsystem：封装各 os 平台的系统操作\ntests：测试\n\n\nenvironment：初始化 fuzz 相关的环境变量\nfuzz：启动 fuzz 任务，实际由 bot 中定义的 fuzzer 执行\nprune：启动 corpus 精简任务\nreproduce：启动 testcase 复现任务\nstracktraces：分析 crash 调用栈\ntests：测试\n\n\nlocal\nbulter：接受外层 bulter 的调用，实际执行具体的任务\nremote：提供不同 os 平台的 handler 给 bulter 使用，对不同的 os 平台 bot 进行配置\n\n\npython\nbot\nother-bots\n\n\nplatform_requirements.txt：python 依赖的三方库\n\n\nbower.json：web 前端依赖的组件\nbutler.py：命令行模式启动 clusterfuzz 的 server、bot、web_server、cron_server、remote 等任务，具体任务的启动脚本在 scr/local/bulter 中\n","dateCreated":"2024-10-09T10:51:56+08:00","dateModified":"2024-10-10T13:08:02+08:00","datePublished":"2024-10-09T10:51:56+08:00","description":"","headline":"ClusterFuzz 源码分析（一）","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/","keywords":"Fuzz, 安全, 工具"}</script>
+    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\nClusterFuzz是 Google 开源的一个模糊测试平台，它集成了多种 Fuzz 引擎，如 Libfuzzer、AFL、Honggfuzz 等，支持跨平台，且具有高度可扩展性。\n简介ClusterFuzz 官网的运作流程图如下：\nFuzz 测试中，编写 fuzzer 和修复 bug 需要人工操作，ClusterFuzz 将这两个环节之外的部分都给自动化了，包括 Fuzz 执行、crash 去重、testcase 精简等。\nClusterFuzz 有两个核心组件：\n\nApp Engine instance：App 引擎，提供一个 web 界面，供用户提交任务、查看结果、展示统计数据等，此外这个 App 引擎还负责调度定时任务。\nFuzz Bots pool：实际执行 Fuzz 的一组 Bot，每个 Bot 从任务队列中挑出任务并执行，这些任务包括但不限于：\nfuzz：执行一次 fuzz 测试 session\nprogression：检查一个 testcase 是否可复现，或者已修复\nregression：查找 crash 被引入的版本范围\nminimize：最小化 testcase\ncorpus_pruning：精简 corpus 语料库（仅限 Libfuzzer）\nanalyze：检查手动上传的 testcase 是否引发 crash\n\n\n\nClusterFuzz 定义的 Fuzz Bot 有两种类型：\n\n可抢占的：机器可以随时关闭，且只能运行 fuzz 任务\n不可抢占的：机器不会关闭，能不间断运行各种类型的任务\n\n代码概要 Google 开源了 ClusterFuzz 的 代码仓，项目 python 为主，读起来相对容易。\n代码结构大致为：\n\nbot：bot 相关文件\nconfigs：配置文件\ndocker：docker 镜像文件\ndocs：官方说明文档\nlocal：本地运行时需要的文件\nresources：bot 依赖的外部资源文件\nsrc：源码根目录\nappengine：App Engine 组件\nhandlers：处理 web 请求\nlibs：web 后端的公共库文件\nprivate：web 前端模板代码\nresources：web 前端使用的资源\n\n\nclusterfuzz\n_internal：核心代码\nbase：通用基础模块\nbot：\nfuzzers：封装各种 fuzzer 引擎，如 Libfuzzer、AFL、Honggfuzz\ninit_scripts：各 os 平台的初始化脚本\nminimizer：最小化 testcase\ntasks：定义各项任务\ntokenizer：分词工具\n\n\nbuild_management：根据用户上传的文件，创建 fuzz 任务\nconfig：读取配置文件，获取配置项\ncrash_analysis：crash 的分析、比较和分级\ndatabase：数据表定义和数据库操作\ndatastore：基于 ndb 定义数据结构和处理操作\nfuzzer_utils：提供 fuzz 基础操作，如 mutator 算子和 testcase 处理\nfuzzing：提供 fuzz 高级操作，如管理 fuzz 产生的 corpus、设置 fuzz 策略、挑选 fuzz 任务等\ngoogle_cloud_utils：基于 gcs 二次开发，封装 clusterfuzz 与存储相关的接口\nmetrics：监控运行数据，提供统计报表\nplatforms：封装各 os 平台的键鼠操作\nprotos：gRPC 的 proto 文件\nscripts：脚本\nsystem：封装各 os 平台的系统操作\ntests：测试\n\n\nenvironment：初始化 fuzz 相关的环境变量\nfuzz：启动 fuzz 任务，实际由 bot 中定义的 fuzzer 执行\nprune：启动 corpus 精简任务\nreproduce：启动 testcase 复现任务\nstracktraces：分析 crash 调用栈\ntests：测试\n\n\nlocal\nbulter：接受外层 bulter 的调用，实际执行具体的任务\nremote：提供不同 os 平台的 handler 给 bulter 使用，对不同的 os 平台 bot 进行配置\n\n\npython\nbot\nother-bots\n\n\nplatform_requirements.txt：python 依赖的三方库\n\n\nbower.json：web 前端依赖的组件\nbutler.py：命令行模式启动 clusterfuzz 的 server、bot、web_server、cron_server、remote 等任务，具体任务的启动脚本在 scr/local/bulter 中\n","dateCreated":"2024-10-09T10:51:56+08:00","dateModified":"2024-10-10T13:09:32+08:00","datePublished":"2024-10-09T10:51:56+08:00","description":"","headline":"ClusterFuzz 源码分析（一）","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/","keywords":"安全, 工具, Fuzz"}</script>
     <meta name="description" content="ClusterFuzz是 Google 开源的一个模糊测试平台，它集成了多种 Fuzz 引擎，如 Libfuzzer、AFL、Honggfuzz 等，支持跨平台，且具有高度可扩展性。 简介ClusterFuzz 官网的运作流程图如下： Fuzz 测试中，编写 fuzzer 和修复 bug 需要人工操作，ClusterFuzz 将这两个环节之外的部分都给自动化了，包括 Fuzz 执行、crash">
 <meta property="og:type" content="blog">
 <meta property="og:title" content="ClusterFuzz 源码分析（一）">
-<meta property="og:url" content="https://www.stepbystep.asia/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/index.html">
+<meta property="og:url" content="https://www.stepbystep.asia/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/index.html">
 <meta property="og:site_name" content="千里之行，始于足下">
 <meta property="og:description" content="ClusterFuzz是 Google 开源的一个模糊测试平台，它集成了多种 Fuzz 引擎，如 Libfuzzer、AFL、Honggfuzz 等，支持跨平台，且具有高度可扩展性。 简介ClusterFuzz 官网的运作流程图如下： Fuzz 测试中，编写 fuzzer 和修复 bug 需要人工操作，ClusterFuzz 将这两个环节之外的部分都给自动化了，包括 Fuzz 执行、crash">
 <meta property="og:locale" content="zh_CN">
-<meta property="og:image" content="https://www.stepbystep.asia/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/overview.png">
-<meta property="og:image" content="https://www.stepbystep.asia/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/task.png">
+<meta property="og:image" content="https://www.stepbystep.asia/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/overview.png">
+<meta property="og:image" content="https://www.stepbystep.asia/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/task.png">
 <meta property="article:published_time" content="2024-10-09T02:51:56.000Z">
-<meta property="article:modified_time" content="2024-10-10T05:08:02.796Z">
+<meta property="article:modified_time" content="2024-10-10T05:09:32.325Z">
 <meta property="article:author" content="一瓢清浅">
-<meta property="article:tag" content="Fuzz">
 <meta property="article:tag" content="安全">
 <meta property="article:tag" content="工具">
+<meta property="article:tag" content="Fuzz">
 <meta name="twitter:card" content="summary">
-<meta name="twitter:image" content="https://www.stepbystep.asia/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/overview.png">
+<meta name="twitter:image" content="https://www.stepbystep.asia/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/overview.png">
     
     
         
@@ -254,7 +254,7 @@ <h1 class="post-title">
             <!--excerpt-->
 
 <p><a target="_blank" rel="external nofollow noopener noreferrer" href="https://google.github.io/clusterfuzz/">ClusterFuzz</a>是 Google 开源的一个模糊测试平台，它集成了多种 Fuzz 引擎，如 Libfuzzer、AFL、Honggfuzz 等，支持跨平台，且具有高度可扩展性。</p>
-<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
+<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
 <p>Fuzz 测试中，编写 fuzzer 和修复 bug 需要人工操作，ClusterFuzz 将这两个环节之外的部分都给自动化了，包括 Fuzz 执行、crash 去重、testcase 精简等。</p>
 <p>ClusterFuzz 有两个核心组件：</p>
 <ul>
@@ -272,7 +272,7 @@ <h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介<
 <p>ClusterFuzz 定义的 Fuzz Bot 有两种类型：</p>
 <ul>
 <li>可抢占的：机器可以随时关闭，且只能运行 fuzz 任务</li>
-<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
+<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
 </ul>
 <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码概要"></a>代码概要 </h2><p>Google 开源了 ClusterFuzz 的<a target="_blank" rel="external nofollow noopener noreferrer" href="https://github.com/google/clusterfuzz"> 代码仓</a>，项目 python 为主，读起来相对容易。</p>
 <p>代码结构大致为：</p>
@@ -526,7 +526,7 @@ <h4 id="about-card-name">一瓢清浅</h4>
               repo: 'comment',
               owner: 'jiliguluss',
               admin: ['jiliguluss'],
-              id: '2024/ClusterFuzz架构分析/',
+              id: '2024/ClusterFuzz源码分析（一）/',
               ...{"language":"zh-CN","perPage":10,"distractionFreeMode":false,"enableHotKey":true,"pagerDirection":"first"}
             }).render('gitalk')
           })()
diff --git "a/2024/Symbion\345\210\235\346\216\242/index.html" "b/2024/Symbion\345\210\235\346\216\242/index.html"
index 63f5beb..e0c5267 100644
--- "a/2024/Symbion\345\210\235\346\216\242/index.html"
+++ "b/2024/Symbion\345\210\235\346\216\242/index.html"
@@ -14,7 +14,7 @@
     
     
     
-    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n一、原理介绍  原始论文：SYMBION: Interleaving Symbolic with Concrete Execution\n官方博客：symbion: fusing concrete and symbolic execution\n1. 背景  符号执行可以用来获取走到指定程序区块的可行输入，但是符号执行在实际应用中面临很多挑战：\n\n路径爆炸问题：符号执行从程序入口开始探索，当程序中出现分支和循环时，会导致路径状态呈指数增长。\n\n环境交互问题：当程序与系统或三方库进行交互时，由于缺失源码或交互复杂等原因，会阻碍符号执行的状态更新。\n\n\n2. 方案Symbion 通过具体执行环境与符号执行环境的同步与切换，实现具体值和符号值交替执行。通过这种交替执行机制，减少符号执行探索的路径状态，并解决程序对外部环境的依赖问题。\n图中演示了具体执行环境与符号执行环境相互切换的过程：\n\n\n目标是对从 PoI 到TP的路径进行符号推理，CSP节点是程序入口。从 CSP 到PoI要经过复杂的运算和交互，这导致直接从 CSP 开始符号推理，将无法向后演进到PoI。\n使用 Symbion 时，首先将具体值输入给 CSP，在具体执行后到达PoI。然后在PoI 切换到符号执行环境，算出到达 TP 所需的变量取值。再将算出来的结果同步给具体执行环境，在 PoI 恢复具体执行，即可到达TP。\n3. 实现Symbion 的架构设计如下：\n\n\nSymbion 在 Angr 的基础上，增加了如下组件：\n\nConcrete Target：定义了与具体执行环境交互的方法，通过实现这些方法可以让 Symbion 支持特定的交互环境。例如 Symbion 实现的GDBConcreteTarget，它通过 gdbsever 控制远程目标程序的交互。\n\nread_memory(address, nbytes)：从具体进程内存中 address 开始读取 nbytes 字节。\nwrite_memory(address, value)：在具体进程内存中 address 处写入value。\nread_register(register)：返回具体进程中指定 register 的内容。\nwrite_register(register, value)：在具体进程的 register 中写入value。\nset_breakpoint(address)：在具体进程中的 address 处设置断点。\nremove_breakpoint(address)：移除之前在 address 处设置的断点。\nrun()：恢复具体进程的执行。\n\n\nSimEngineConcrete：利用 Concrete Target 的方法执行以下步骤，实现 Symbolic 环境到 Concrete 环境的切换。\n\n用用户提供的值修改具体进程的内存。\n用用户提供的值修改具体进程的寄存器。\n通过断点来设置新的PoI。\n恢复程序的具体执行，直到到达新的PoI，并将控制权交还给 Angr。\n\n\nConcrete SimPlugin：当具体执行到达 PoI，这个插件实现Concrete 环境到 Symbolic 环境的切换，它将具体状态导入 Angr 来创建SimState。\n\n将 SimState 的内存后端重定向到具体进程的内存，即在符号执行过程中，SimState的内存读取都是从具体进程中来操作。\n\n将具体进程中的寄存器值复制到 SimState 中。\n\n将具体进程的内存映射与 Angr 在启动期间加载的内存映射同步。\n\n\n\nSYMBION Exploration Technique：提供用户使用 Symbion 的 API ，通过这些 API ，用户指定 PoI 的地址，在具体执行到达 PoI 后，Symbion 切换为符号执行。\n\n\n简而言之，在 Symbion 的工作流程中，各组件的作用为：\n\n用户通过 SYMBION Exploration Technique 指定PoI。\n\n程序经过具体执行到达到 PoI 后暂停， Concrete SimPlugin 根据具体执行环境来创建一个SimState。\n\nAngr 通过符号执行，计算到达下一个 PoI 的可行解。\n\nSimEngineConcrete 用 Angr 算出来的结果修改具体进程中的变量，恢复具体执行直到下一个PoI。\n\n\n二、示例分析Symbion 官方示例：test_concrete_not_packed_elf64\n示例使用的二进制：not_packed_elf64\n二进制没有给源码，通过 IDA 逆向源码，并用 AI 改写，得到 C 源码如下，源码中取 dest 变量中的一串数值做判断，不同的分支触发不同的print。\n\n\n在 Symbion 的示例代码中，首先通过具体执行到达 BINARY_DECISION_ADDRESS，然后用符号执行探索从BINARY_DECISION_ADDRESS 到DROP_STAGE2_V2的路径。\n\n\n在符号执行求解成功后，再将求解结果传递给具体执行环境，并启动具体执行，即可到达DROP_STAGE2_V2：\n\n\n结合 CFG 和源码可以看到，符号执行的起点 BINARY_DECISION_ADDRESS 对应源码图右侧 55 行，符号执行的终点 DROP_STAGE2_V2 对应源码图右侧 77 行。通过 Symbion，实现了对二进制按指定路径的进行分析的目的。\n\n\nSymbion 的示例代码中，涉及到很多内存地址操作，需要结合 IDA 的反编译源码来看：\n\n\n\nline 2：启动具体执行，到 BINARY_DECISION_ADDRESS 停下，即 IDA 反编译源码第 67 行代码\n\nline 3：从具体执行环境的获取寄存器中的栈指针sp，指向栈顶（即栈开始的位置）\n\nline 4：从栈顶 sp 开始读取 20 个字节的内存，这块内存包括反编译源码中的变量 i 和v5\n\nline 5：判断是否为符号变量，此时为具体执行环境，所以不是符号变量\n\nline 7：定义符号变量，变量名为arg0，大小为 32 字节\n\nline 8：用 symbolic_buffer_memory 指向具体执行环境中 rbp-0xc0 的内存地址，它对应 IDA 反编译源码中的数组 s 的起始地址。\n\nline 10：从 symbolic_buffer_memory 开始加载 36 个字节的内存\n\nline 11：判断是否为符号变量，此时为具体执行环境，所以不是符号变量\n\nline 12：将 angr0 存储到symbolic_buffer_memory，将符号变量与具体执行环境的内存地址关联起来\n\nline 15：从 symbolic_buffer_memory 开始加载 36 个字节的内存\n\nline 16：判断是否为符号变量，因为 把 angr0 保存到这块内存，所以是符号变量\n\nline 19：符号执行状态初始化\n\nline 37：启动符号执行\n\n\n可以看到，Symbion 在切换具体执行环境和符号执行环境时，是通过内存地址把变量的具体值和符号值对应起来。需要结合 IDA 反编译的源码中给出的变量地址和内存大小，人工设置符号执行中所需要的符号变量，难以实现自动化。","dateCreated":"2024-02-27T16:33:24+08:00","dateModified":"2024-06-26T16:27:23+08:00","datePublished":"2024-02-27T16:33:24+08:00","description":"Symbion 是 Angr 的一款插件，可以实现具体执行与符号执行交替运行","headline":"交替符号执行工具——Symbion 初探","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2024/Symbion%E5%88%9D%E6%8E%A2/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2024/Symbion%E5%88%9D%E6%8E%A2/","keywords":"安全, 工具, 符号执行"}</script>
+    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n一、原理介绍  原始论文：SYMBION: Interleaving Symbolic with Concrete Execution\n官方博客：symbion: fusing concrete and symbolic execution\n1. 背景  符号执行可以用来获取走到指定程序区块的可行输入，但是符号执行在实际应用中面临很多挑战：\n\n路径爆炸问题：符号执行从程序入口开始探索，当程序中出现分支和循环时，会导致路径状态呈指数增长。\n\n环境交互问题：当程序与系统或三方库进行交互时，由于缺失源码或交互复杂等原因，会阻碍符号执行的状态更新。\n\n\n2. 方案Symbion 通过具体执行环境与符号执行环境的同步与切换，实现具体值和符号值交替执行。通过这种交替执行机制，减少符号执行探索的路径状态，并解决程序对外部环境的依赖问题。\n图中演示了具体执行环境与符号执行环境相互切换的过程：\n\n\n目标是对从 PoI 到TP的路径进行符号推理，CSP节点是程序入口。从 CSP 到PoI要经过复杂的运算和交互，这导致直接从 CSP 开始符号推理，将无法向后演进到PoI。\n使用 Symbion 时，首先将具体值输入给 CSP，在具体执行后到达PoI。然后在PoI 切换到符号执行环境，算出到达 TP 所需的变量取值。再将算出来的结果同步给具体执行环境，在 PoI 恢复具体执行，即可到达TP。\n3. 实现Symbion 的架构设计如下：\n\n\nSymbion 在 Angr 的基础上，增加了如下组件：\n\nConcrete Target：定义了与具体执行环境交互的方法，通过实现这些方法可以让 Symbion 支持特定的交互环境。例如 Symbion 实现的GDBConcreteTarget，它通过 gdbsever 控制远程目标程序的交互。\n\nread_memory(address, nbytes)：从具体进程内存中 address 开始读取 nbytes 字节。\nwrite_memory(address, value)：在具体进程内存中 address 处写入value。\nread_register(register)：返回具体进程中指定 register 的内容。\nwrite_register(register, value)：在具体进程的 register 中写入value。\nset_breakpoint(address)：在具体进程中的 address 处设置断点。\nremove_breakpoint(address)：移除之前在 address 处设置的断点。\nrun()：恢复具体进程的执行。\n\n\nSimEngineConcrete：利用 Concrete Target 的方法执行以下步骤，实现 Symbolic 环境到 Concrete 环境的切换。\n\n用用户提供的值修改具体进程的内存。\n用用户提供的值修改具体进程的寄存器。\n通过断点来设置新的PoI。\n恢复程序的具体执行，直到到达新的PoI，并将控制权交还给 Angr。\n\n\nConcrete SimPlugin：当具体执行到达 PoI，这个插件实现Concrete 环境到 Symbolic 环境的切换，它将具体状态导入 Angr 来创建SimState。\n\n将 SimState 的内存后端重定向到具体进程的内存，即在符号执行过程中，SimState的内存读取都是从具体进程中来操作。\n\n将具体进程中的寄存器值复制到 SimState 中。\n\n将具体进程的内存映射与 Angr 在启动期间加载的内存映射同步。\n\n\n\nSYMBION Exploration Technique：提供用户使用 Symbion 的 API ，通过这些 API ，用户指定 PoI 的地址，在具体执行到达 PoI 后，Symbion 切换为符号执行。\n\n\n简而言之，在 Symbion 的工作流程中，各组件的作用为：\n\n用户通过 SYMBION Exploration Technique 指定PoI。\n\n程序经过具体执行到达到 PoI 后暂停， Concrete SimPlugin 根据具体执行环境来创建一个SimState。\n\nAngr 通过符号执行，计算到达下一个 PoI 的可行解。\n\nSimEngineConcrete 用 Angr 算出来的结果修改具体进程中的变量，恢复具体执行直到下一个PoI。\n\n\n二、示例分析Symbion 官方示例：test_concrete_not_packed_elf64\n示例使用的二进制：not_packed_elf64\n二进制没有给源码，通过 IDA 逆向源码，并用 AI 改写，得到 C 源码如下，源码中取 dest 变量中的一串数值做判断，不同的分支触发不同的print。\n\n\n在 Symbion 的示例代码中，首先通过具体执行到达 BINARY_DECISION_ADDRESS，然后用符号执行探索从BINARY_DECISION_ADDRESS 到DROP_STAGE2_V2的路径。\n\n\n在符号执行求解成功后，再将求解结果传递给具体执行环境，并启动具体执行，即可到达DROP_STAGE2_V2：\n\n\n结合 CFG 和源码可以看到，符号执行的起点 BINARY_DECISION_ADDRESS 对应源码图右侧 55 行，符号执行的终点 DROP_STAGE2_V2 对应源码图右侧 77 行。通过 Symbion，实现了对二进制按指定路径的进行分析的目的。\n\n\nSymbion 的示例代码中，涉及到很多内存地址操作，需要结合 IDA 的反编译源码来看：\n\n\n\nline 2：启动具体执行，到 BINARY_DECISION_ADDRESS 停下，即 IDA 反编译源码第 67 行代码\n\nline 3：从具体执行环境的获取寄存器中的栈指针sp，指向栈顶（即栈开始的位置）\n\nline 4：从栈顶 sp 开始读取 20 个字节的内存，这块内存包括反编译源码中的变量 i 和v5\n\nline 5：判断是否为符号变量，此时为具体执行环境，所以不是符号变量\n\nline 7：定义符号变量，变量名为arg0，大小为 32 字节\n\nline 8：用 symbolic_buffer_memory 指向具体执行环境中 rbp-0xc0 的内存地址，它对应 IDA 反编译源码中的数组 s 的起始地址。\n\nline 10：从 symbolic_buffer_memory 开始加载 36 个字节的内存\n\nline 11：判断是否为符号变量，此时为具体执行环境，所以不是符号变量\n\nline 12：将 angr0 存储到symbolic_buffer_memory，将符号变量与具体执行环境的内存地址关联起来\n\nline 15：从 symbolic_buffer_memory 开始加载 36 个字节的内存\n\nline 16：判断是否为符号变量，因为 把 angr0 保存到这块内存，所以是符号变量\n\nline 19：符号执行状态初始化\n\nline 37：启动符号执行\n\n\n可以看到，Symbion 在切换具体执行环境和符号执行环境时，是通过内存地址把变量的具体值和符号值对应起来。需要结合 IDA 反编译的源码中给出的变量地址和内存大小，人工设置符号执行中所需要的符号变量，难以实现自动化。","dateCreated":"2024-02-27T16:33:24+08:00","dateModified":"2024-06-26T16:27:23+08:00","datePublished":"2024-02-27T16:33:24+08:00","description":"Symbion 是 Angr 的一款插件，可以实现具体执行与符号执行交替运行","headline":"交替符号执行工具——Symbion 初探","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2024/Symbion%E5%88%9D%E6%8E%A2/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2024/Symbion%E5%88%9D%E6%8E%A2/","keywords":"符号执行, 安全, 工具"}</script>
     <meta name="description" content="Symbion 是 Angr 的一款插件，可以实现具体执行与符号执行交替运行">
 <meta property="og:type" content="blog">
 <meta property="og:title" content="交替符号执行工具——Symbion 初探">
@@ -32,9 +32,9 @@
 <meta property="article:published_time" content="2024-02-27T08:33:24.000Z">
 <meta property="article:modified_time" content="2024-06-26T08:27:23.616Z">
 <meta property="article:author" content="一瓢清浅">
+<meta property="article:tag" content="符号执行">
 <meta property="article:tag" content="安全">
 <meta property="article:tag" content="工具">
-<meta property="article:tag" content="符号执行">
 <meta name="twitter:card" content="summary">
 <meta name="twitter:image" content="https://www.stepbystep.asia/2024/Symbion%E5%88%9D%E6%8E%A2/symbion%E4%B8%8A%E4%B8%8B%E6%96%87%E5%88%87%E6%8D%A2.png">
     
diff --git "a/2024/\347\224\261subprocess-PIPE\345\274\225\345\217\221\347\232\204\350\241\200\346\241\210/index.html" "b/2024/\347\224\261subprocess-PIPE\345\274\225\345\217\221\347\232\204\350\241\200\346\241\210/index.html"
index 1211a99..3c0b75f 100644
--- "a/2024/\347\224\261subprocess-PIPE\345\274\225\345\217\221\347\232\204\350\241\200\346\241\210/index.html"
+++ "b/2024/\347\224\261subprocess-PIPE\345\274\225\345\217\221\347\232\204\350\241\200\346\241\210/index.html"
@@ -14,7 +14,7 @@
     
     
     
-    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n一、案发现场  事情是酱滴：\n我写了个 python 脚本，在脚本中通过 subprocess 启动了 AFL++ 的子进程，对 binary 进行测试。\n然后我还在这个 python 脚本中，使用其他的工具生成针对 binary 有效的 corpus。\n参考前文AFL++ 同步机制，正常情况下 AFL++ 会将其他工具生成的 corpus（已确认能覆盖新的代码分支），同步到 AFL++ 的 queue 目录下。\n但是诡异的事情出现了：AFL++ 没有同步！\n二、破案过程 1. 还原现场 这个 AFL++ 不同步的情况不是必现的，非必现的问题真 TM 难调。\n我换了好几个机器，在 host 和 docker 上分别进行了多轮实验，前前后后跑了一两周的时间，排除了环境问题。虽然有的环境概率高，有的环境概率低，但只要跑的次数够多，都会出现 AFL++ 不同步的问题。\n2. 埋 log在反复跑实验的过程中，也有在 AFL++ 源码中埋 log。\n我在 sync_fuzzers 函数体内，以及调用之处加了很多 log。sync_fuzzers在 afl-fuzz.c 的main函数中有四处调用，编号 1~4 表示在代码中的先后顺序，实际调用流程大概如下：\nflowchart TD\n    A[main] --> B[stop_fuzzing]\n    B --> C[sync_fuzzers 4]\n    A --> D[while loop]\n    D --> E[sync_fuzzers 1]\n    E --> F[do-while loop]\n    F --> G[sync_fuzzers 2]\n    F --> H[sync_fuzzers 3]\n    H --> D\n    G --> D\n通过 log 发现，AFL++ 在同步 corpus 时，主要使用过 sync_fuzzers 1 来完成的。而在未同步的场景中，log 会在 do-while loop 里面中断，后续再也没有打印出sync_fuzzers 1。\n3. gdb 追踪  当 log 也印不出来的时候，gdb 看起来是唯一能用的工具了。\n于是我找了个复现概率高的机器，在启动 python 脚本后，用 gdb attach 脚本所启动的 AFL++ 子进程，并在 sync_fuzzers 的 1~4 处调用都打了断点，接着让 AFL++ 继续跑。\n神奇的事情出现了，AFL++ 正常同步的时候，sync_fuzzers 1总是会命中。然而当跑一阵后，sync_fuzzers 1就再也到不了了。此时 ctrl+c 暂停程序，查看调用栈如下：\n\n\n其中 afl-fuzz-one.c 的 420 行的代码如下，只是调用了 flush 库函数而已：\n\n\n我将此行注释掉，重新 gdb 一次，结果发现会在另一个 flush 处卡住。\n在库函数面前，我们要质疑的是自己的代码。\n三、罪魁祸首  我回头检查了自己的 Python 脚本，启动 AFL++ 的代码如下：\n12345678910111213self.fuzzer_popen = sp.Popen(    cmd,    shell=False,    stdout=sp.PIPE,    stderr=sp.PIPE,    env=env,    preexec_fn=os.setsid,)time.sleep(5)if self.fuzzer_popen.poll() is not None:    raise Exception(f&#x27;start fuzz process failed with error: &#123;self.fuzzer_popen.stderr.read().decode(&quot;utf-8&quot;)&#125;&#x27;)else:    logger.info(f&#x27;start fuzz process whose pid is &#123;self.fuzzer_popen.pid&#125;&#x27;)\n\n我又去查了一下 subprocess 的官方文档，赫然写着 注意事项：\n\nNote This will deadlock when using stdout&#x3D;PIPE or stderr&#x3D;PIPE and the child process generates enough output to a pipe such that it blocks waiting for the OS pipe buffer to accept more data. Use Popen.communicate() when using pipes to avoid that.\n\n破案了破案了，我用了 PIPE 来接受 AFL++ 的 stdout 和 stderr，但是我没有通过 communicate 来读取 PIPE，导致PIPE 中积压了大量的数据，阻碍了 AFL++ 继续flush。\n我被自己蠢哭了，也被 subprocess 坑惨了，修改后的代码如下：\n12345678self.fuzzer_popen = sp.Popen(    cmd,    shell=False,    stdout=sp.DEVNULL,    stderr=sp.DEVNULL,    env=env,    preexec_fn=os.setsid,)\n\n去他娘的 stdout 和 stderr，改完后 AFL++ 同步都正常了~~","dateCreated":"2024-07-30T16:19:00+08:00","dateModified":"2024-08-16T17:30:58+08:00","datePublished":"2024-07-30T16:19:00+08:00","description":"找了大半个月 AFL++ 不同步的原因，到头来都是 subprocess 的锅","headline":"由 subprocess.PIPE 引发的血案","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2024/%E7%94%B1subprocess-PIPE%E5%BC%95%E5%8F%91%E7%9A%84%E8%A1%80%E6%A1%88/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2024/%E7%94%B1subprocess-PIPE%E5%BC%95%E5%8F%91%E7%9A%84%E8%A1%80%E6%A1%88/","keywords":"AFL++, 安全, 开发, Python"}</script>
+    <script type="application/ld+json">{"@context":"http://schema.org","@type":"BlogPosting","author":{"@type":"Person","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg"},"articleBody":"\n\n一、案发现场  事情是酱滴：\n我写了个 python 脚本，在脚本中通过 subprocess 启动了 AFL++ 的子进程，对 binary 进行测试。\n然后我还在这个 python 脚本中，使用其他的工具生成针对 binary 有效的 corpus。\n参考前文AFL++ 同步机制，正常情况下 AFL++ 会将其他工具生成的 corpus（已确认能覆盖新的代码分支），同步到 AFL++ 的 queue 目录下。\n但是诡异的事情出现了：AFL++ 没有同步！\n二、破案过程 1. 还原现场 这个 AFL++ 不同步的情况不是必现的，非必现的问题真 TM 难调。\n我换了好几个机器，在 host 和 docker 上分别进行了多轮实验，前前后后跑了一两周的时间，排除了环境问题。虽然有的环境概率高，有的环境概率低，但只要跑的次数够多，都会出现 AFL++ 不同步的问题。\n2. 埋 log在反复跑实验的过程中，也有在 AFL++ 源码中埋 log。\n我在 sync_fuzzers 函数体内，以及调用之处加了很多 log。sync_fuzzers在 afl-fuzz.c 的main函数中有四处调用，编号 1~4 表示在代码中的先后顺序，实际调用流程大概如下：\nflowchart TD\n    A[main] --> B[stop_fuzzing]\n    B --> C[sync_fuzzers 4]\n    A --> D[while loop]\n    D --> E[sync_fuzzers 1]\n    E --> F[do-while loop]\n    F --> G[sync_fuzzers 2]\n    F --> H[sync_fuzzers 3]\n    H --> D\n    G --> D\n通过 log 发现，AFL++ 在同步 corpus 时，主要使用过 sync_fuzzers 1 来完成的。而在未同步的场景中，log 会在 do-while loop 里面中断，后续再也没有打印出sync_fuzzers 1。\n3. gdb 追踪  当 log 也印不出来的时候，gdb 看起来是唯一能用的工具了。\n于是我找了个复现概率高的机器，在启动 python 脚本后，用 gdb attach 脚本所启动的 AFL++ 子进程，并在 sync_fuzzers 的 1~4 处调用都打了断点，接着让 AFL++ 继续跑。\n神奇的事情出现了，AFL++ 正常同步的时候，sync_fuzzers 1总是会命中。然而当跑一阵后，sync_fuzzers 1就再也到不了了。此时 ctrl+c 暂停程序，查看调用栈如下：\n\n\n其中 afl-fuzz-one.c 的 420 行的代码如下，只是调用了 flush 库函数而已：\n\n\n我将此行注释掉，重新 gdb 一次，结果发现会在另一个 flush 处卡住。\n在库函数面前，我们要质疑的是自己的代码。\n三、罪魁祸首  我回头检查了自己的 Python 脚本，启动 AFL++ 的代码如下：\n12345678910111213self.fuzzer_popen = sp.Popen(    cmd,    shell=False,    stdout=sp.PIPE,    stderr=sp.PIPE,    env=env,    preexec_fn=os.setsid,)time.sleep(5)if self.fuzzer_popen.poll() is not None:    raise Exception(f&#x27;start fuzz process failed with error: &#123;self.fuzzer_popen.stderr.read().decode(&quot;utf-8&quot;)&#125;&#x27;)else:    logger.info(f&#x27;start fuzz process whose pid is &#123;self.fuzzer_popen.pid&#125;&#x27;)\n\n我又去查了一下 subprocess 的官方文档，赫然写着 注意事项：\n\nNote This will deadlock when using stdout&#x3D;PIPE or stderr&#x3D;PIPE and the child process generates enough output to a pipe such that it blocks waiting for the OS pipe buffer to accept more data. Use Popen.communicate() when using pipes to avoid that.\n\n破案了破案了，我用了 PIPE 来接受 AFL++ 的 stdout 和 stderr，但是我没有通过 communicate 来读取 PIPE，导致PIPE 中积压了大量的数据，阻碍了 AFL++ 继续flush。\n我被自己蠢哭了，也被 subprocess 坑惨了，修改后的代码如下：\n12345678self.fuzzer_popen = sp.Popen(    cmd,    shell=False,    stdout=sp.DEVNULL,    stderr=sp.DEVNULL,    env=env,    preexec_fn=os.setsid,)\n\n去他娘的 stdout 和 stderr，改完后 AFL++ 同步都正常了~~","dateCreated":"2024-07-30T16:19:00+08:00","dateModified":"2024-08-16T17:30:58+08:00","datePublished":"2024-07-30T16:19:00+08:00","description":"找了大半个月 AFL++ 不同步的原因，到头来都是 subprocess 的锅","headline":"由 subprocess.PIPE 引发的血案","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2024/%E7%94%B1subprocess-PIPE%E5%BC%95%E5%8F%91%E7%9A%84%E8%A1%80%E6%A1%88/"},"publisher":{"@type":"Organization","name":"一瓢清浅","sameAs":["#about","https://github.com/jiliguluss"],"image":"photo.jpg","logo":{"@type":"ImageObject","url":"photo.jpg"}},"url":"https://www.stepbystep.asia/2024/%E7%94%B1subprocess-PIPE%E5%BC%95%E5%8F%91%E7%9A%84%E8%A1%80%E6%A1%88/","keywords":"安全, AFL++, 开发, Python"}</script>
     <meta name="description" content="找了大半个月 AFL++ 不同步的原因，到头来都是 subprocess 的锅">
 <meta property="og:type" content="blog">
 <meta property="og:title" content="由 subprocess.PIPE 引发的血案">
@@ -27,8 +27,8 @@
 <meta property="article:published_time" content="2024-07-30T08:19:00.000Z">
 <meta property="article:modified_time" content="2024-08-16T09:30:58.371Z">
 <meta property="article:author" content="一瓢清浅">
-<meta property="article:tag" content="AFL++">
 <meta property="article:tag" content="安全">
+<meta property="article:tag" content="AFL++">
 <meta property="article:tag" content="开发">
 <meta property="article:tag" content="Python">
 <meta name="twitter:card" content="summary">
diff --git a/all-archives/index.html b/all-archives/index.html
index f0b75f3..7e5c65b 100644
--- a/all-archives/index.html
+++ b/all-archives/index.html
@@ -239,7 +239,7 @@ <h5 class="archive-title">
                 
             
             <li class="archive-post archive-day" data-date="20241009">
-                <a class="archive-post-title" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/">ClusterFuzz 源码分析（一）</a>
+                <a class="archive-post-title" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/">ClusterFuzz 源码分析（一）</a>
                 <span class="archive-post-date"> - 2024 年 10 月 9 日</span>
             </li>
         
diff --git a/all-categories/index.html b/all-categories/index.html
index 8a8f869..e0b4629 100644
--- a/all-categories/index.html
+++ b/all-categories/index.html
@@ -273,7 +273,7 @@ <h5 class="archive-result text-color-base text-xlarge" data-message-zero="没有
             
         
             
-                    <div id="posts-list-安全" class="archive box" data-category="安全" data-parent-categories><h4 class="archive-title text-xlarge"><a class="link-unstyled" href="/categories/%E5%AE%89%E5%85%A8/">安全 (11)</a></h4><ul class="archive-posts"><li class="archive-post"><a class="archive-post-title" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/">ClusterFuzz 源码分析（一）</a><span class="archive-post-date"> - 2024 年 10 月 9 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E8%A6%86%E7%9B%96%E7%8E%87/">AFL++ 源码分析——覆盖率</a><span class="archive-post-date"> - 2024 年 8 月 15 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E5%90%8C%E6%AD%A5%E6%9C%BA%E5%88%B6/">AFLplusplus 源码分析——同步机制</a><span class="archive-post-date"> - 2024 年 7 月 16 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/%E6%B1%A1%E7%82%B9%E5%88%86%E6%9E%90%E5%B7%A5%E5%85%B7%E2%80%94%E2%80%94libdft64/">污点分析工具——libdft64</a><span class="archive-post-date"> - 2024 年 5 月 17 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/Symbion%E5%88%9D%E6%8E%A2/">交替符号执行工具——Symbion 初探</a><span class="archive-post-date"> - 2024 年 2 月 27 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/Angr%E9%9B%B6%E5%9F%BA%E7%A1%80%E5%85%A5%E9%97%A8/">符号执行工具——Angr 零基础入门</a><span class="archive-post-date"> - 2024 年 1 月 23 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C%E4%B8%8E%E6%B7%B7%E5%90%88%E6%A8%A1%E7%B3%8A%E6%B5%8B%E8%AF%95/">符号执行与混合模糊测试</a><span class="archive-post-date"> - 2023 年 12 月 24 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/LibAFL%E7%AE%80%E4%BB%8B/">LibAFL 简介</a><span class="archive-post-date"> - 2023 年 11 月 18 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/AFL%E5%8E%9F%E7%90%86%E4%B8%8E%E5%AE%9E%E8%B7%B5/">AFL 原理与实践</a><span class="archive-post-date"> - 2023 年 10 月 15 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/LibFuzzer%E7%BC%96%E8%AF%91%E6%8C%87%E5%8D%97/">LibFuzzer 编译指南</a><span class="archive-post-date"> - 2023 年 9 月 26 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/LibFuzzer%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E/">LibFuzzer 使用说明</a><span class="archive-post-date"> - 2023 年 9 月 17 日</span></li><div id="posts-list-模糊测试" class="archive " data-category="模糊测试" data-parent-categories="安全"><h4 class="archive-title text-xlarge"><a class="link-unstyled" href="/categories/%E5%AE%89%E5%85%A8/%E6%A8%A1%E7%B3%8A%E6%B5%8B%E8%AF%95/">模糊测试 (7)</a></h4><ul class="archive-posts"><li class="archive-post"><a class="archive-post-title" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/">ClusterFuzz 源码分析（一）</a><span class="archive-post-date"> - 2024 年 10 月 9 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E8%A6%86%E7%9B%96%E7%8E%87/">AFL++ 源码分析——覆盖率</a><span class="archive-post-date"> - 2024 年 8 月 15 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E5%90%8C%E6%AD%A5%E6%9C%BA%E5%88%B6/">AFLplusplus 源码分析——同步机制</a><span class="archive-post-date"> - 2024 年 7 月 16 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/LibAFL%E7%AE%80%E4%BB%8B/">LibAFL 简介</a><span class="archive-post-date"> - 2023 年 11 月 18 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/AFL%E5%8E%9F%E7%90%86%E4%B8%8E%E5%AE%9E%E8%B7%B5/">AFL 原理与实践</a><span class="archive-post-date"> - 2023 年 10 月 15 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/LibFuzzer%E7%BC%96%E8%AF%91%E6%8C%87%E5%8D%97/">LibFuzzer 编译指南</a><span class="archive-post-date"> - 2023 年 9 月 26 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/LibFuzzer%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E/">LibFuzzer 使用说明</a><span class="archive-post-date"> - 2023 年 9 月 17 日</span></li></ul></div><div id="posts-list-污点分析" class="archive " data-category="污点分析" data-parent-categories="安全"><h4 class="archive-title text-xlarge"><a class="link-unstyled" href="/categories/%E5%AE%89%E5%85%A8/%E6%B1%A1%E7%82%B9%E5%88%86%E6%9E%90/">污点分析 (1)</a></h4><ul class="archive-posts"><li class="archive-post"><a class="archive-post-title" href="/2024/%E6%B1%A1%E7%82%B9%E5%88%86%E6%9E%90%E5%B7%A5%E5%85%B7%E2%80%94%E2%80%94libdft64/">污点分析工具——libdft64</a><span class="archive-post-date"> - 2024 年 5 月 17 日</span></li></ul></div><div id="posts-list-符号执行" class="archive " data-category="符号执行" data-parent-categories="安全"><h4 class="archive-title text-xlarge"><a class="link-unstyled" href="/categories/%E5%AE%89%E5%85%A8/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C/">符号执行 (3)</a></h4><ul class="archive-posts"><li class="archive-post"><a class="archive-post-title" href="/2024/Symbion%E5%88%9D%E6%8E%A2/">交替符号执行工具——Symbion 初探</a><span class="archive-post-date"> - 2024 年 2 月 27 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/Angr%E9%9B%B6%E5%9F%BA%E7%A1%80%E5%85%A5%E9%97%A8/">符号执行工具——Angr 零基础入门</a><span class="archive-post-date"> - 2024 年 1 月 23 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C%E4%B8%8E%E6%B7%B7%E5%90%88%E6%A8%A1%E7%B3%8A%E6%B5%8B%E8%AF%95/">符号执行与混合模糊测试</a><span class="archive-post-date"> - 2023 年 12 月 24 日</span></li></ul></div></ul></div>
+                    <div id="posts-list-安全" class="archive box" data-category="安全" data-parent-categories><h4 class="archive-title text-xlarge"><a class="link-unstyled" href="/categories/%E5%AE%89%E5%85%A8/">安全 (11)</a></h4><ul class="archive-posts"><li class="archive-post"><a class="archive-post-title" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/">ClusterFuzz 源码分析（一）</a><span class="archive-post-date"> - 2024 年 10 月 9 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E8%A6%86%E7%9B%96%E7%8E%87/">AFL++ 源码分析——覆盖率</a><span class="archive-post-date"> - 2024 年 8 月 15 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E5%90%8C%E6%AD%A5%E6%9C%BA%E5%88%B6/">AFLplusplus 源码分析——同步机制</a><span class="archive-post-date"> - 2024 年 7 月 16 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/%E6%B1%A1%E7%82%B9%E5%88%86%E6%9E%90%E5%B7%A5%E5%85%B7%E2%80%94%E2%80%94libdft64/">污点分析工具——libdft64</a><span class="archive-post-date"> - 2024 年 5 月 17 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/Symbion%E5%88%9D%E6%8E%A2/">交替符号执行工具——Symbion 初探</a><span class="archive-post-date"> - 2024 年 2 月 27 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/Angr%E9%9B%B6%E5%9F%BA%E7%A1%80%E5%85%A5%E9%97%A8/">符号执行工具——Angr 零基础入门</a><span class="archive-post-date"> - 2024 年 1 月 23 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C%E4%B8%8E%E6%B7%B7%E5%90%88%E6%A8%A1%E7%B3%8A%E6%B5%8B%E8%AF%95/">符号执行与混合模糊测试</a><span class="archive-post-date"> - 2023 年 12 月 24 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/LibAFL%E7%AE%80%E4%BB%8B/">LibAFL 简介</a><span class="archive-post-date"> - 2023 年 11 月 18 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/AFL%E5%8E%9F%E7%90%86%E4%B8%8E%E5%AE%9E%E8%B7%B5/">AFL 原理与实践</a><span class="archive-post-date"> - 2023 年 10 月 15 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/LibFuzzer%E7%BC%96%E8%AF%91%E6%8C%87%E5%8D%97/">LibFuzzer 编译指南</a><span class="archive-post-date"> - 2023 年 9 月 26 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/LibFuzzer%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E/">LibFuzzer 使用说明</a><span class="archive-post-date"> - 2023 年 9 月 17 日</span></li><div id="posts-list-模糊测试" class="archive " data-category="模糊测试" data-parent-categories="安全"><h4 class="archive-title text-xlarge"><a class="link-unstyled" href="/categories/%E5%AE%89%E5%85%A8/%E6%A8%A1%E7%B3%8A%E6%B5%8B%E8%AF%95/">模糊测试 (7)</a></h4><ul class="archive-posts"><li class="archive-post"><a class="archive-post-title" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/">ClusterFuzz 源码分析（一）</a><span class="archive-post-date"> - 2024 年 10 月 9 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E8%A6%86%E7%9B%96%E7%8E%87/">AFL++ 源码分析——覆盖率</a><span class="archive-post-date"> - 2024 年 8 月 15 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E5%90%8C%E6%AD%A5%E6%9C%BA%E5%88%B6/">AFLplusplus 源码分析——同步机制</a><span class="archive-post-date"> - 2024 年 7 月 16 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/LibAFL%E7%AE%80%E4%BB%8B/">LibAFL 简介</a><span class="archive-post-date"> - 2023 年 11 月 18 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/AFL%E5%8E%9F%E7%90%86%E4%B8%8E%E5%AE%9E%E8%B7%B5/">AFL 原理与实践</a><span class="archive-post-date"> - 2023 年 10 月 15 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/LibFuzzer%E7%BC%96%E8%AF%91%E6%8C%87%E5%8D%97/">LibFuzzer 编译指南</a><span class="archive-post-date"> - 2023 年 9 月 26 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/LibFuzzer%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E/">LibFuzzer 使用说明</a><span class="archive-post-date"> - 2023 年 9 月 17 日</span></li></ul></div><div id="posts-list-污点分析" class="archive " data-category="污点分析" data-parent-categories="安全"><h4 class="archive-title text-xlarge"><a class="link-unstyled" href="/categories/%E5%AE%89%E5%85%A8/%E6%B1%A1%E7%82%B9%E5%88%86%E6%9E%90/">污点分析 (1)</a></h4><ul class="archive-posts"><li class="archive-post"><a class="archive-post-title" href="/2024/%E6%B1%A1%E7%82%B9%E5%88%86%E6%9E%90%E5%B7%A5%E5%85%B7%E2%80%94%E2%80%94libdft64/">污点分析工具——libdft64</a><span class="archive-post-date"> - 2024 年 5 月 17 日</span></li></ul></div><div id="posts-list-符号执行" class="archive " data-category="符号执行" data-parent-categories="安全"><h4 class="archive-title text-xlarge"><a class="link-unstyled" href="/categories/%E5%AE%89%E5%85%A8/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C/">符号执行 (3)</a></h4><ul class="archive-posts"><li class="archive-post"><a class="archive-post-title" href="/2024/Symbion%E5%88%9D%E6%8E%A2/">交替符号执行工具——Symbion 初探</a><span class="archive-post-date"> - 2024 年 2 月 27 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2024/Angr%E9%9B%B6%E5%9F%BA%E7%A1%80%E5%85%A5%E9%97%A8/">符号执行工具——Angr 零基础入门</a><span class="archive-post-date"> - 2024 年 1 月 23 日</span></li><li class="archive-post"><a class="archive-post-title" href="/2023/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C%E4%B8%8E%E6%B7%B7%E5%90%88%E6%A8%A1%E7%B3%8A%E6%B5%8B%E8%AF%95/">符号执行与混合模糊测试</a><span class="archive-post-date"> - 2023 年 12 月 24 日</span></li></ul></div></ul></div>
             
         
             
diff --git a/all-tags/index.html b/all-tags/index.html
index 310e145..d0a4b92 100644
--- a/all-tags/index.html
+++ b/all-tags/index.html
@@ -466,7 +466,7 @@ <h4 class="archive-title">
                 <ul class="archive-posts">
                     
                         <li class="archive-post">
-                            <a class="archive-post-title" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/">
+                            <a class="archive-post-title" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/">
                                 ClusterFuzz 源码分析（一）
                             </a>
                             <span class="archive-post-date">
@@ -767,7 +767,7 @@ <h4 class="archive-title">
                 <ul class="archive-posts">
                     
                         <li class="archive-post">
-                            <a class="archive-post-title" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/">
+                            <a class="archive-post-title" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/">
                                 ClusterFuzz 源码分析（一）
                             </a>
                             <span class="archive-post-date">
@@ -897,7 +897,7 @@ <h4 class="archive-title">
                 <ul class="archive-posts">
                     
                         <li class="archive-post">
-                            <a class="archive-post-title" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/">
+                            <a class="archive-post-title" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/">
                                 ClusterFuzz 源码分析（一）
                             </a>
                             <span class="archive-post-date">
diff --git a/archives/2024/10/index.html b/archives/2024/10/index.html
index 9f64ffb..b208986 100644
--- a/archives/2024/10/index.html
+++ b/archives/2024/10/index.html
@@ -220,7 +220,7 @@ <h5 class="sidebar-profile-bio"><p>个人技术博客<br>涉猎开发、测试
             <div class="postShorten-header">
                 <h1 class="postShorten-title">
                     
-                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/" aria-label=": ClusterFuzz 源码分析（一）">
+                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/" aria-label=": ClusterFuzz 源码分析（一）">
                             ClusterFuzz 源码分析（一）
                         </a>
                     
@@ -246,7 +246,7 @@ <h1 class="postShorten-title">
                     <!--excerpt-->
 
 <p><a target="_blank" rel="external nofollow noopener noreferrer" href="https://google.github.io/clusterfuzz/">ClusterFuzz</a>是 Google 开源的一个模糊测试平台，它集成了多种 Fuzz 引擎，如 Libfuzzer、AFL、Honggfuzz 等，支持跨平台，且具有高度可扩展性。</p>
-<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
+<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
 <p>Fuzz 测试中，编写 fuzzer 和修复 bug 需要人工操作，ClusterFuzz 将这两个环节之外的部分都给自动化了，包括 Fuzz 执行、crash 去重、testcase 精简等。</p>
 <p>ClusterFuzz 有两个核心组件：</p>
 <ul>
@@ -264,7 +264,7 @@ <h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介<
 <p>ClusterFuzz 定义的 Fuzz Bot 有两种类型：</p>
 <ul>
 <li>可抢占的：机器可以随时关闭，且只能运行 fuzz 任务</li>
-<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
+<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
 </ul>
 <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码概要"></a>代码概要 </h2><p>Google 开源了 ClusterFuzz 的<a target="_blank" rel="external nofollow noopener noreferrer" href="https://github.com/google/clusterfuzz"> 代码仓</a>，项目 python 为主，读起来相对容易。</p>
 <p>代码结构大致为：</p>
@@ -341,7 +341,7 @@ <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码
                     
                     
                         <p>
-                            <a href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/#post-footer" class="postShorten-excerpt_link link" aria-label>
+                            <a href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/#post-footer" class="postShorten-excerpt_link link" aria-label>
                                 评论和共享
                             </a>
                         </p>
diff --git a/archives/2024/index.html b/archives/2024/index.html
index 81e3e74..170f2f5 100644
--- a/archives/2024/index.html
+++ b/archives/2024/index.html
@@ -220,7 +220,7 @@ <h5 class="sidebar-profile-bio"><p>个人技术博客<br>涉猎开发、测试
             <div class="postShorten-header">
                 <h1 class="postShorten-title">
                     
-                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/" aria-label=": ClusterFuzz 源码分析（一）">
+                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/" aria-label=": ClusterFuzz 源码分析（一）">
                             ClusterFuzz 源码分析（一）
                         </a>
                     
@@ -246,7 +246,7 @@ <h1 class="postShorten-title">
                     <!--excerpt-->
 
 <p><a target="_blank" rel="external nofollow noopener noreferrer" href="https://google.github.io/clusterfuzz/">ClusterFuzz</a>是 Google 开源的一个模糊测试平台，它集成了多种 Fuzz 引擎，如 Libfuzzer、AFL、Honggfuzz 等，支持跨平台，且具有高度可扩展性。</p>
-<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
+<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
 <p>Fuzz 测试中，编写 fuzzer 和修复 bug 需要人工操作，ClusterFuzz 将这两个环节之外的部分都给自动化了，包括 Fuzz 执行、crash 去重、testcase 精简等。</p>
 <p>ClusterFuzz 有两个核心组件：</p>
 <ul>
@@ -264,7 +264,7 @@ <h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介<
 <p>ClusterFuzz 定义的 Fuzz Bot 有两种类型：</p>
 <ul>
 <li>可抢占的：机器可以随时关闭，且只能运行 fuzz 任务</li>
-<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
+<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
 </ul>
 <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码概要"></a>代码概要 </h2><p>Google 开源了 ClusterFuzz 的<a target="_blank" rel="external nofollow noopener noreferrer" href="https://github.com/google/clusterfuzz"> 代码仓</a>，项目 python 为主，读起来相对容易。</p>
 <p>代码结构大致为：</p>
@@ -341,7 +341,7 @@ <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码
                     
                     
                         <p>
-                            <a href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/#post-footer" class="postShorten-excerpt_link link" aria-label>
+                            <a href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/#post-footer" class="postShorten-excerpt_link link" aria-label>
                                 评论和共享
                             </a>
                         </p>
diff --git a/archives/index.html b/archives/index.html
index e1bf062..aaeca38 100644
--- a/archives/index.html
+++ b/archives/index.html
@@ -220,7 +220,7 @@ <h5 class="sidebar-profile-bio"><p>个人技术博客<br>涉猎开发、测试
             <div class="postShorten-header">
                 <h1 class="postShorten-title">
                     
-                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/" aria-label=": ClusterFuzz 源码分析（一）">
+                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/" aria-label=": ClusterFuzz 源码分析（一）">
                             ClusterFuzz 源码分析（一）
                         </a>
                     
@@ -246,7 +246,7 @@ <h1 class="postShorten-title">
                     <!--excerpt-->
 
 <p><a target="_blank" rel="external nofollow noopener noreferrer" href="https://google.github.io/clusterfuzz/">ClusterFuzz</a>是 Google 开源的一个模糊测试平台，它集成了多种 Fuzz 引擎，如 Libfuzzer、AFL、Honggfuzz 等，支持跨平台，且具有高度可扩展性。</p>
-<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
+<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
 <p>Fuzz 测试中，编写 fuzzer 和修复 bug 需要人工操作，ClusterFuzz 将这两个环节之外的部分都给自动化了，包括 Fuzz 执行、crash 去重、testcase 精简等。</p>
 <p>ClusterFuzz 有两个核心组件：</p>
 <ul>
@@ -264,7 +264,7 @@ <h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介<
 <p>ClusterFuzz 定义的 Fuzz Bot 有两种类型：</p>
 <ul>
 <li>可抢占的：机器可以随时关闭，且只能运行 fuzz 任务</li>
-<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
+<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
 </ul>
 <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码概要"></a>代码概要 </h2><p>Google 开源了 ClusterFuzz 的<a target="_blank" rel="external nofollow noopener noreferrer" href="https://github.com/google/clusterfuzz"> 代码仓</a>，项目 python 为主，读起来相对容易。</p>
 <p>代码结构大致为：</p>
@@ -341,7 +341,7 @@ <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码
                     
                     
                         <p>
-                            <a href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/#post-footer" class="postShorten-excerpt_link link" aria-label>
+                            <a href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/#post-footer" class="postShorten-excerpt_link link" aria-label>
                                 评论和共享
                             </a>
                         </p>
diff --git a/baidusitemap.xml b/baidusitemap.xml
index 8115967..c7cf690 100644
--- a/baidusitemap.xml
+++ b/baidusitemap.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
-    <loc>https://www.stepbystep.asia/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/</loc>
+    <loc>https://www.stepbystep.asia/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/</loc>
     <lastmod>2024-10-10</lastmod>
   </url>
   <url>
diff --git "a/categories/\345\256\211\345\205\250/index.html" "b/categories/\345\256\211\345\205\250/index.html"
index 48719c5..b335033 100644
--- "a/categories/\345\256\211\345\205\250/index.html"
+++ "b/categories/\345\256\211\345\205\250/index.html"
@@ -220,7 +220,7 @@ <h5 class="sidebar-profile-bio"><p>个人技术博客<br>涉猎开发、测试
             <div class="postShorten-header">
                 <h1 class="postShorten-title">
                     
-                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/" aria-label=": ClusterFuzz 源码分析（一）">
+                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/" aria-label=": ClusterFuzz 源码分析（一）">
                             ClusterFuzz 源码分析（一）
                         </a>
                     
@@ -246,7 +246,7 @@ <h1 class="postShorten-title">
                     <!--excerpt-->
 
 <p><a target="_blank" rel="external nofollow noopener noreferrer" href="https://google.github.io/clusterfuzz/">ClusterFuzz</a>是 Google 开源的一个模糊测试平台，它集成了多种 Fuzz 引擎，如 Libfuzzer、AFL、Honggfuzz 等，支持跨平台，且具有高度可扩展性。</p>
-<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
+<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
 <p>Fuzz 测试中，编写 fuzzer 和修复 bug 需要人工操作，ClusterFuzz 将这两个环节之外的部分都给自动化了，包括 Fuzz 执行、crash 去重、testcase 精简等。</p>
 <p>ClusterFuzz 有两个核心组件：</p>
 <ul>
@@ -264,7 +264,7 @@ <h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介<
 <p>ClusterFuzz 定义的 Fuzz Bot 有两种类型：</p>
 <ul>
 <li>可抢占的：机器可以随时关闭，且只能运行 fuzz 任务</li>
-<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
+<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
 </ul>
 <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码概要"></a>代码概要 </h2><p>Google 开源了 ClusterFuzz 的<a target="_blank" rel="external nofollow noopener noreferrer" href="https://github.com/google/clusterfuzz"> 代码仓</a>，项目 python 为主，读起来相对容易。</p>
 <p>代码结构大致为：</p>
@@ -341,7 +341,7 @@ <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码
                     
                     
                         <p>
-                            <a href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/#post-footer" class="postShorten-excerpt_link link" aria-label>
+                            <a href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/#post-footer" class="postShorten-excerpt_link link" aria-label>
                                 评论和共享
                             </a>
                         </p>
diff --git "a/categories/\345\256\211\345\205\250/\346\250\241\347\263\212\346\265\213\350\257\225/index.html" "b/categories/\345\256\211\345\205\250/\346\250\241\347\263\212\346\265\213\350\257\225/index.html"
index 0be3fe9..4799ad0 100644
--- "a/categories/\345\256\211\345\205\250/\346\250\241\347\263\212\346\265\213\350\257\225/index.html"
+++ "b/categories/\345\256\211\345\205\250/\346\250\241\347\263\212\346\265\213\350\257\225/index.html"
@@ -220,7 +220,7 @@ <h5 class="sidebar-profile-bio"><p>个人技术博客<br>涉猎开发、测试
             <div class="postShorten-header">
                 <h1 class="postShorten-title">
                     
-                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/" aria-label=": ClusterFuzz 源码分析（一）">
+                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/" aria-label=": ClusterFuzz 源码分析（一）">
                             ClusterFuzz 源码分析（一）
                         </a>
                     
@@ -246,7 +246,7 @@ <h1 class="postShorten-title">
                     <!--excerpt-->
 
 <p><a target="_blank" rel="external nofollow noopener noreferrer" href="https://google.github.io/clusterfuzz/">ClusterFuzz</a>是 Google 开源的一个模糊测试平台，它集成了多种 Fuzz 引擎，如 Libfuzzer、AFL、Honggfuzz 等，支持跨平台，且具有高度可扩展性。</p>
-<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
+<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
 <p>Fuzz 测试中，编写 fuzzer 和修复 bug 需要人工操作，ClusterFuzz 将这两个环节之外的部分都给自动化了，包括 Fuzz 执行、crash 去重、testcase 精简等。</p>
 <p>ClusterFuzz 有两个核心组件：</p>
 <ul>
@@ -264,7 +264,7 @@ <h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介<
 <p>ClusterFuzz 定义的 Fuzz Bot 有两种类型：</p>
 <ul>
 <li>可抢占的：机器可以随时关闭，且只能运行 fuzz 任务</li>
-<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
+<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
 </ul>
 <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码概要"></a>代码概要 </h2><p>Google 开源了 ClusterFuzz 的<a target="_blank" rel="external nofollow noopener noreferrer" href="https://github.com/google/clusterfuzz"> 代码仓</a>，项目 python 为主，读起来相对容易。</p>
 <p>代码结构大致为：</p>
@@ -341,7 +341,7 @@ <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码
                     
                     
                         <p>
-                            <a href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/#post-footer" class="postShorten-excerpt_link link" aria-label>
+                            <a href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/#post-footer" class="postShorten-excerpt_link link" aria-label>
                                 评论和共享
                             </a>
                         </p>
diff --git a/index.html b/index.html
index 50a15a1..54ccb6a 100644
--- a/index.html
+++ b/index.html
@@ -219,7 +219,7 @@ <h5 class="sidebar-profile-bio"><p>个人技术博客<br>涉猎开发、测试
             <div class="postShorten-header">
                 <h1 class="postShorten-title">
                     
-                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/" aria-label=": ClusterFuzz 源码分析（一）">
+                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/" aria-label=": ClusterFuzz 源码分析（一）">
                             ClusterFuzz 源码分析（一）
                         </a>
                     
@@ -245,7 +245,7 @@ <h1 class="postShorten-title">
                     <!--excerpt-->
 
 <p><a target="_blank" rel="external nofollow noopener noreferrer" href="https://google.github.io/clusterfuzz/">ClusterFuzz</a>是 Google 开源的一个模糊测试平台，它集成了多种 Fuzz 引擎，如 Libfuzzer、AFL、Honggfuzz 等，支持跨平台，且具有高度可扩展性。</p>
-<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
+<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
 <p>Fuzz 测试中，编写 fuzzer 和修复 bug 需要人工操作，ClusterFuzz 将这两个环节之外的部分都给自动化了，包括 Fuzz 执行、crash 去重、testcase 精简等。</p>
 <p>ClusterFuzz 有两个核心组件：</p>
 <ul>
@@ -263,7 +263,7 @@ <h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介<
 <p>ClusterFuzz 定义的 Fuzz Bot 有两种类型：</p>
 <ul>
 <li>可抢占的：机器可以随时关闭，且只能运行 fuzz 任务</li>
-<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
+<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
 </ul>
 <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码概要"></a>代码概要 </h2><p>Google 开源了 ClusterFuzz 的<a target="_blank" rel="external nofollow noopener noreferrer" href="https://github.com/google/clusterfuzz"> 代码仓</a>，项目 python 为主，读起来相对容易。</p>
 <p>代码结构大致为：</p>
@@ -340,7 +340,7 @@ <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码
                     
                     
                         <p>
-                            <a href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/#post-footer" class="postShorten-excerpt_link link" aria-label>
+                            <a href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/#post-footer" class="postShorten-excerpt_link link" aria-label>
                                 评论和共享
                             </a>
                         </p>
diff --git a/sitemap.xml b/sitemap.xml
index 2a7f266..c582882 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2,7 +2,7 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   
   <url>
-    <loc>https://www.stepbystep.asia/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/</loc>
+    <loc>https://www.stepbystep.asia/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/</loc>
     
     <lastmod>2024-10-10</lastmod>
     
@@ -236,35 +236,35 @@
 
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/AFL/</loc>
+    <loc>https://www.stepbystep.asia/tags/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/Fuzz/</loc>
+    <loc>https://www.stepbystep.asia/tags/%E5%AE%89%E5%85%A8/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/%E5%AE%89%E5%85%A8/</loc>
+    <loc>https://www.stepbystep.asia/tags/%E5%B7%A5%E5%85%B7/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/%E5%B7%A5%E5%85%B7/</loc>
+    <loc>https://www.stepbystep.asia/tags/AFL/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C/</loc>
+    <loc>https://www.stepbystep.asia/tags/Fuzz/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
@@ -341,70 +341,70 @@
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/Linux/</loc>
+    <loc>https://www.stepbystep.asia/tags/LibFuzzer/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/%E6%93%8D%E4%BD%9C%E7%B3%BB%E7%BB%9F/</loc>
+    <loc>https://www.stepbystep.asia/tags/Linux/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/%E5%91%BD%E4%BB%A4/</loc>
+    <loc>https://www.stepbystep.asia/tags/%E6%93%8D%E4%BD%9C%E7%B3%BB%E7%BB%9F/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/LibFuzzer/</loc>
+    <loc>https://www.stepbystep.asia/tags/%E5%91%BD%E4%BB%A4/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/Web/</loc>
+    <loc>https://www.stepbystep.asia/tags/Python/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/%E7%88%AC%E8%99%AB/</loc>
+    <loc>https://www.stepbystep.asia/tags/IntelPin/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/python/</loc>
+    <loc>https://www.stepbystep.asia/tags/%E6%B1%A1%E7%82%B9%E5%88%86%E6%9E%90/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/Python/</loc>
+    <loc>https://www.stepbystep.asia/tags/Web/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/IntelPin/</loc>
+    <loc>https://www.stepbystep.asia/tags/%E7%88%AC%E8%99%AB/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/%E6%B1%A1%E7%82%B9%E5%88%86%E6%9E%90/</loc>
+    <loc>https://www.stepbystep.asia/tags/python/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
@@ -420,84 +420,84 @@
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/categories/%E5%AE%89%E5%85%A8/%E6%A8%A1%E7%B3%8A%E6%B5%8B%E8%AF%95/</loc>
+    <loc>https://www.stepbystep.asia/categories/%E5%AE%89%E5%85%A8/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/</loc>
+    <loc>https://www.stepbystep.asia/categories/%E5%AE%89%E5%85%A8/%E6%A8%A1%E7%B3%8A%E6%B5%8B%E8%AF%95/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/categories/%E5%AE%89%E5%85%A8/%E7%AC%A6%E5%8F%B7%E6%89%A7%E8%A1%8C/</loc>
+    <loc>https://www.stepbystep.asia/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/categories/%E5%BC%80%E5%8F%91/</loc>
+    <loc>https://www.stepbystep.asia/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/C/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/C/</loc>
+    <loc>https://www.stepbystep.asia/categories/%E5%BC%80%E5%8F%91/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/categories/%E5%BC%80%E5%8F%91/Docker/</loc>
+    <loc>https://www.stepbystep.asia/categories/web/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/categories/web/</loc>
+    <loc>https://www.stepbystep.asia/categories/%E5%BC%80%E5%8F%91/Docker/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/categories/%E5%BC%80%E5%8F%91/Linux/</loc>
+    <loc>https://www.stepbystep.asia/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/Python/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/categories/web/%E4%B8%AA%E4%BA%BA%E5%8D%9A%E5%AE%A2/</loc>
+    <loc>https://www.stepbystep.asia/categories/%E5%AE%89%E5%85%A8/%E6%B1%A1%E7%82%B9%E5%88%86%E6%9E%90/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/categories/%E5%BC%80%E5%8F%91/%E7%88%AC%E8%99%AB/</loc>
+    <loc>https://www.stepbystep.asia/categories/web/%E4%B8%AA%E4%BA%BA%E5%8D%9A%E5%AE%A2/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/Python/</loc>
+    <loc>https://www.stepbystep.asia/categories/%E5%BC%80%E5%8F%91/Linux/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/categories/%E5%AE%89%E5%85%A8/%E6%B1%A1%E7%82%B9%E5%88%86%E6%9E%90/</loc>
+    <loc>https://www.stepbystep.asia/categories/%E5%BC%80%E5%8F%91/%E7%88%AC%E8%99%AB/</loc>
     <lastmod>2024-10-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
diff --git a/tags/AFL/index.html b/tags/AFL/index.html
index 9ec261d..0f4c584 100644
--- a/tags/AFL/index.html
+++ b/tags/AFL/index.html
@@ -7,7 +7,7 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <meta name="generator" content="千里之行，始于足下">
-    <title>标签: AFL - 千里之行，始于足下</title>
+    <title>标签: AFL++ - 千里之行，始于足下</title>
     <meta name="author" content="一瓢清浅">
     
         <meta name="keywords" content="python,AI,安全,算法,编程,">
@@ -220,15 +220,15 @@ <h5 class="sidebar-profile-bio"><p>个人技术博客<br>涉猎开发、测试
             <div class="postShorten-header">
                 <h1 class="postShorten-title">
                     
-                        <a class="link-unstyled" href="/2023/LibAFL%E7%AE%80%E4%BB%8B/" aria-label=": LibAFL 简介">
-                            LibAFL 简介
+                        <a class="link-unstyled" href="/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E8%A6%86%E7%9B%96%E7%8E%87/" aria-label=": AFL++ 源码分析——覆盖率">
+                            AFL++ 源码分析——覆盖率
                         </a>
                     
                 </h1>
                 <div class="postShorten-meta">
-    <time datetime="2023-11-18T10:38:08+08:00">
+    <time datetime="2024-08-15T17:28:52+08:00">
 	
-		    2023 年 11 月 18 日
+		    2024 年 8 月 15 日
     	
     </time>
     
@@ -243,9 +243,9 @@ <h1 class="postShorten-title">
             </div>
             
                 <div class="postShorten-excerpt">
-                    <p>LibAFL 是用 Rust 开发的一款模糊测试库，支持 Fuzz 各模块的灵活定制 </p>
+                    <p>分析 AFL++ 度量覆盖率的相关代码</p>
                     
-                        <a href="/2023/LibAFL%E7%AE%80%E4%BB%8B/" class="postShorten-excerpt_link link" aria-label=": LibAFL 简介">
+                        <a href="/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E8%A6%86%E7%9B%96%E7%8E%87/" class="postShorten-excerpt_link link" aria-label=": AFL++ 源码分析——覆盖率">
                             阅读全文
                         </a>
                         
@@ -263,15 +263,58 @@ <h1 class="postShorten-title">
             <div class="postShorten-header">
                 <h1 class="postShorten-title">
                     
-                        <a class="link-unstyled" href="/2023/AFL%E5%8E%9F%E7%90%86%E4%B8%8E%E5%AE%9E%E8%B7%B5/" aria-label=": AFL 原理与实践">
-                            AFL 原理与实践
+                        <a class="link-unstyled" href="/2024/%E7%94%B1subprocess-PIPE%E5%BC%95%E5%8F%91%E7%9A%84%E8%A1%80%E6%A1%88/" aria-label=": 由 subprocess.PIPE 引发的血案">
+                            由 subprocess.PIPE 引发的血案
                         </a>
                     
                 </h1>
                 <div class="postShorten-meta">
-    <time datetime="2023-10-15T11:23:55+08:00">
+    <time datetime="2024-07-30T16:19:00+08:00">
 	
-		    2023 年 10 月 15 日
+		    2024 年 7 月 30 日
+    	
+    </time>
+    
+        <span>发布在 </span>
+        
+    <a class="category-link" href="/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/">编程语言</a>, <a class="category-link" href="/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/Python/">Python</a>
+
+
+    
+</div>
+
+            </div>
+            
+                <div class="postShorten-excerpt">
+                    <p>找了大半个月 AFL++ 不同步的原因，到头来都是 subprocess 的锅</p>
+                    
+                        <a href="/2024/%E7%94%B1subprocess-PIPE%E5%BC%95%E5%8F%91%E7%9A%84%E8%A1%80%E6%A1%88/" class="postShorten-excerpt_link link" aria-label=": 由 subprocess.PIPE 引发的血案">
+                            阅读全文
+                        </a>
+                        
+                    
+                </div>
+            
+        </div>
+        
+    </article>
+    
+    
+    <article class="postShorten postShorten--thumbnailimg-right">
+        <div class="postShorten-wrap">
+            
+            <div class="postShorten-header">
+                <h1 class="postShorten-title">
+                    
+                        <a class="link-unstyled" href="/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E5%90%8C%E6%AD%A5%E6%9C%BA%E5%88%B6/" aria-label=": AFLplusplus 源码分析——同步机制">
+                            AFLplusplus 源码分析——同步机制
+                        </a>
+                    
+                </h1>
+                <div class="postShorten-meta">
+    <time datetime="2024-07-16T09:02:06+08:00">
+	
+		    2024 年 7 月 16 日
     	
     </time>
     
@@ -286,9 +329,9 @@ <h1 class="postShorten-title">
             </div>
             
                 <div class="postShorten-excerpt">
-                    <p>模糊测试工具 AFL（American Fuzzy Lop）的原理介绍与实践应用</p>
+                    <p>分析 AFL++ 同步机制的相关源码</p>
                     
-                        <a href="/2023/AFL%E5%8E%9F%E7%90%86%E4%B8%8E%E5%AE%9E%E8%B7%B5/" class="postShorten-excerpt_link link" aria-label=": AFL 原理与实践">
+                        <a href="/2024/AFLplusplus%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%E2%80%94%E2%80%94%E5%90%8C%E6%AD%A5%E6%9C%BA%E5%88%B6/" class="postShorten-excerpt_link link" aria-label=": AFLplusplus 源码分析——同步机制">
                             阅读全文
                         </a>
                         
diff --git a/tags/Fuzz/index.html b/tags/Fuzz/index.html
index 3f2790f..d280388 100644
--- a/tags/Fuzz/index.html
+++ b/tags/Fuzz/index.html
@@ -220,7 +220,7 @@ <h5 class="sidebar-profile-bio"><p>个人技术博客<br>涉猎开发、测试
             <div class="postShorten-header">
                 <h1 class="postShorten-title">
                     
-                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/" aria-label=": ClusterFuzz 源码分析（一）">
+                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/" aria-label=": ClusterFuzz 源码分析（一）">
                             ClusterFuzz 源码分析（一）
                         </a>
                     
@@ -246,7 +246,7 @@ <h1 class="postShorten-title">
                     <!--excerpt-->
 
 <p><a target="_blank" rel="external nofollow noopener noreferrer" href="https://google.github.io/clusterfuzz/">ClusterFuzz</a>是 Google 开源的一个模糊测试平台，它集成了多种 Fuzz 引擎，如 Libfuzzer、AFL、Honggfuzz 等，支持跨平台，且具有高度可扩展性。</p>
-<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
+<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
 <p>Fuzz 测试中，编写 fuzzer 和修复 bug 需要人工操作，ClusterFuzz 将这两个环节之外的部分都给自动化了，包括 Fuzz 执行、crash 去重、testcase 精简等。</p>
 <p>ClusterFuzz 有两个核心组件：</p>
 <ul>
@@ -264,7 +264,7 @@ <h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介<
 <p>ClusterFuzz 定义的 Fuzz Bot 有两种类型：</p>
 <ul>
 <li>可抢占的：机器可以随时关闭，且只能运行 fuzz 任务</li>
-<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
+<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
 </ul>
 <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码概要"></a>代码概要 </h2><p>Google 开源了 ClusterFuzz 的<a target="_blank" rel="external nofollow noopener noreferrer" href="https://github.com/google/clusterfuzz"> 代码仓</a>，项目 python 为主，读起来相对容易。</p>
 <p>代码结构大致为：</p>
@@ -341,7 +341,7 @@ <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码
                     
                     
                         <p>
-                            <a href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/#post-footer" class="postShorten-excerpt_link link" aria-label>
+                            <a href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/#post-footer" class="postShorten-excerpt_link link" aria-label>
                                 评论和共享
                             </a>
                         </p>
diff --git a/tags/python/index.html b/tags/python/index.html
index 7d4e609..95c2411 100644
--- a/tags/python/index.html
+++ b/tags/python/index.html
@@ -7,7 +7,7 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <meta name="generator" content="千里之行，始于足下">
-    <title>标签: Python - 千里之行，始于足下</title>
+    <title>标签: python - 千里之行，始于足下</title>
     <meta name="author" content="一瓢清浅">
     
         <meta name="keywords" content="python,AI,安全,算法,编程,">
@@ -18,7 +18,7 @@
     <meta name="description" content="个人技术博客，涉及编程(python，c++)、安全测试、Web开发、AI算法等IT领域">
 <meta property="og:type" content="blog">
 <meta property="og:title" content="千里之行，始于足下">
-<meta property="og:url" content="https://www.stepbystep.asia/tags/Python/index.html">
+<meta property="og:url" content="https://www.stepbystep.asia/tags/python/index.html">
 <meta property="og:site_name" content="千里之行，始于足下">
 <meta property="og:description" content="个人技术博客，涉及编程(python，c++)、安全测试、Web开发、AI算法等IT领域">
 <meta property="og:locale" content="zh_CN">
@@ -220,21 +220,21 @@ <h5 class="sidebar-profile-bio"><p>个人技术博客<br>涉猎开发、测试
             <div class="postShorten-header">
                 <h1 class="postShorten-title">
                     
-                        <a class="link-unstyled" href="/2024/%E7%94%B1subprocess-PIPE%E5%BC%95%E5%8F%91%E7%9A%84%E8%A1%80%E6%A1%88/" aria-label=": 由 subprocess.PIPE 引发的血案">
-                            由 subprocess.PIPE 引发的血案
+                        <a class="link-unstyled" href="/2023/%E9%9B%B6%E5%9F%BA%E7%A1%80%E7%88%AC%E8%99%AB%E5%85%A5%E9%97%A8/" aria-label=": 零基础爬虫入门">
+                            零基础爬虫入门
                         </a>
                     
                 </h1>
                 <div class="postShorten-meta">
-    <time datetime="2024-07-30T16:19:00+08:00">
+    <time datetime="2023-01-08T14:05:37+08:00">
 	
-		    2024 年 7 月 30 日
+		    2023 年 1 月 8 日
     	
     </time>
     
         <span>发布在 </span>
         
-    <a class="category-link" href="/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/">编程语言</a>, <a class="category-link" href="/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/Python/">Python</a>
+    <a class="category-link" href="/categories/%E5%BC%80%E5%8F%91/">开发</a>, <a class="category-link" href="/categories/%E5%BC%80%E5%8F%91/%E7%88%AC%E8%99%AB/">爬虫</a>
 
 
     
@@ -243,52 +243,9 @@ <h1 class="postShorten-title">
             </div>
             
                 <div class="postShorten-excerpt">
-                    <p>找了大半个月 AFL++ 不同步的原因，到头来都是 subprocess 的锅</p>
+                    <p>从零开始学爬虫</p>
                     
-                        <a href="/2024/%E7%94%B1subprocess-PIPE%E5%BC%95%E5%8F%91%E7%9A%84%E8%A1%80%E6%A1%88/" class="postShorten-excerpt_link link" aria-label=": 由 subprocess.PIPE 引发的血案">
-                            阅读全文
-                        </a>
-                        
-                    
-                </div>
-            
-        </div>
-        
-    </article>
-    
-    
-    <article class="postShorten postShorten--thumbnailimg-right">
-        <div class="postShorten-wrap">
-            
-            <div class="postShorten-header">
-                <h1 class="postShorten-title">
-                    
-                        <a class="link-unstyled" href="/2024/Python%E8%BF%9B%E9%98%B6%E2%80%94%E2%80%94%E5%B9%B6%E5%8F%91%E7%BC%96%E7%A8%8B/" aria-label=": Python 进阶——并发编程">
-                            Python 进阶——并发编程
-                        </a>
-                    
-                </h1>
-                <div class="postShorten-meta">
-    <time datetime="2024-06-26T10:56:20+08:00">
-	
-		    2024 年 6 月 26 日
-    	
-    </time>
-    
-        <span>发布在 </span>
-        
-    <a class="category-link" href="/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/">编程语言</a>, <a class="category-link" href="/categories/%E7%BC%96%E7%A8%8B%E8%AF%AD%E8%A8%80/Python/">Python</a>
-
-
-    
-</div>
-
-            </div>
-            
-                <div class="postShorten-excerpt">
-                    <p>进程、线程、协程，并发编程绕不过的三座大山</p>
-                    
-                        <a href="/2024/Python%E8%BF%9B%E9%98%B6%E2%80%94%E2%80%94%E5%B9%B6%E5%8F%91%E7%BC%96%E7%A8%8B/" class="postShorten-excerpt_link link" aria-label=": Python 进阶——并发编程">
+                        <a href="/2023/%E9%9B%B6%E5%9F%BA%E7%A1%80%E7%88%AC%E8%99%AB%E5%85%A5%E9%97%A8/" class="postShorten-excerpt_link link" aria-label=": 零基础爬虫入门">
                             阅读全文
                         </a>
                         
diff --git "a/tags/\345\256\211\345\205\250/index.html" "b/tags/\345\256\211\345\205\250/index.html"
index 8ccba45..b04460a 100644
--- "a/tags/\345\256\211\345\205\250/index.html"
+++ "b/tags/\345\256\211\345\205\250/index.html"
@@ -220,7 +220,7 @@ <h5 class="sidebar-profile-bio"><p>个人技术博客<br>涉猎开发、测试
             <div class="postShorten-header">
                 <h1 class="postShorten-title">
                     
-                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/" aria-label=": ClusterFuzz 源码分析（一）">
+                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/" aria-label=": ClusterFuzz 源码分析（一）">
                             ClusterFuzz 源码分析（一）
                         </a>
                     
@@ -246,7 +246,7 @@ <h1 class="postShorten-title">
                     <!--excerpt-->
 
 <p><a target="_blank" rel="external nofollow noopener noreferrer" href="https://google.github.io/clusterfuzz/">ClusterFuzz</a>是 Google 开源的一个模糊测试平台，它集成了多种 Fuzz 引擎，如 Libfuzzer、AFL、Honggfuzz 等，支持跨平台，且具有高度可扩展性。</p>
-<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
+<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
 <p>Fuzz 测试中，编写 fuzzer 和修复 bug 需要人工操作，ClusterFuzz 将这两个环节之外的部分都给自动化了，包括 Fuzz 执行、crash 去重、testcase 精简等。</p>
 <p>ClusterFuzz 有两个核心组件：</p>
 <ul>
@@ -264,7 +264,7 @@ <h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介<
 <p>ClusterFuzz 定义的 Fuzz Bot 有两种类型：</p>
 <ul>
 <li>可抢占的：机器可以随时关闭，且只能运行 fuzz 任务</li>
-<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
+<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
 </ul>
 <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码概要"></a>代码概要 </h2><p>Google 开源了 ClusterFuzz 的<a target="_blank" rel="external nofollow noopener noreferrer" href="https://github.com/google/clusterfuzz"> 代码仓</a>，项目 python 为主，读起来相对容易。</p>
 <p>代码结构大致为：</p>
@@ -341,7 +341,7 @@ <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码
                     
                     
                         <p>
-                            <a href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/#post-footer" class="postShorten-excerpt_link link" aria-label>
+                            <a href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/#post-footer" class="postShorten-excerpt_link link" aria-label>
                                 评论和共享
                             </a>
                         </p>
diff --git "a/tags/\345\267\245\345\205\267/index.html" "b/tags/\345\267\245\345\205\267/index.html"
index b467fae..d5ef6ee 100644
--- "a/tags/\345\267\245\345\205\267/index.html"
+++ "b/tags/\345\267\245\345\205\267/index.html"
@@ -220,7 +220,7 @@ <h5 class="sidebar-profile-bio"><p>个人技术博客<br>涉猎开发、测试
             <div class="postShorten-header">
                 <h1 class="postShorten-title">
                     
-                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/" aria-label=": ClusterFuzz 源码分析（一）">
+                        <a class="link-unstyled" href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/" aria-label=": ClusterFuzz 源码分析（一）">
                             ClusterFuzz 源码分析（一）
                         </a>
                     
@@ -246,7 +246,7 @@ <h1 class="postShorten-title">
                     <!--excerpt-->
 
 <p><a target="_blank" rel="external nofollow noopener noreferrer" href="https://google.github.io/clusterfuzz/">ClusterFuzz</a>是 Google 开源的一个模糊测试平台，它集成了多种 Fuzz 引擎，如 Libfuzzer、AFL、Honggfuzz 等，支持跨平台，且具有高度可扩展性。</p>
-<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
+<h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介</h2><p>ClusterFuzz 官网的运作流程图如下：<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/overview.png" alt="ClusterFuzz 流程"></p>
 <p>Fuzz 测试中，编写 fuzzer 和修复 bug 需要人工操作，ClusterFuzz 将这两个环节之外的部分都给自动化了，包括 Fuzz 执行、crash 去重、testcase 精简等。</p>
 <p>ClusterFuzz 有两个核心组件：</p>
 <ul>
@@ -264,7 +264,7 @@ <h2 id="简介"><a href="# 简介" class="headerlink" title="简介"></a>简介<
 <p>ClusterFuzz 定义的 Fuzz Bot 有两种类型：</p>
 <ul>
 <li>可抢占的：机器可以随时关闭，且只能运行 fuzz 任务</li>
-<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
+<li>不可抢占的：机器不会关闭，能不间断运行各种类型的任务<br><img src="/./ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90/task.png" alt="Fuzz Bot"></li>
 </ul>
 <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码概要"></a>代码概要 </h2><p>Google 开源了 ClusterFuzz 的<a target="_blank" rel="external nofollow noopener noreferrer" href="https://github.com/google/clusterfuzz"> 代码仓</a>，项目 python 为主，读起来相对容易。</p>
 <p>代码结构大致为：</p>
@@ -341,7 +341,7 @@ <h2 id="代码概要"><a href="# 代码概要" class="headerlink" title="代码
                     
                     
                         <p>
-                            <a href="/2024/ClusterFuzz%E6%9E%B6%E6%9E%84%E5%88%86%E6%9E%90/#post-footer" class="postShorten-excerpt_link link" aria-label>
+                            <a href="/2024/ClusterFuzz%E6%BA%90%E7%A0%81%E5%88%86%E6%9E%90%EF%BC%88%E4%B8%80%EF%BC%89/#post-footer" class="postShorten-excerpt_link link" aria-label>
                                 评论和共享
                             </a>
                         </p>