From b9d64f0ce94d5d1361bb228eeb3b1cb46c3f7761 Mon Sep 17 00:00:00 2001
From: ss <shishi.dong@deltaww.com>
Date: Mon, 28 Oct 2024 15:19:02 +0800
Subject: [PATCH] Site updated: 2024-10-28 15:18:53

---
 .../index.html"                               |   4 +-
 .../index.html"                               |   4 +-
 .../index.html"                               |   4 +-
 .../index.html"                               |   4 +-
 .../index.html"                               |   4 +-
 .../index.html"                               |  60 ++++++++++++++-
 .../\344\270\200\345\257\271\344\270\200.png" | Bin 0 -> 18236 bytes
 .../\344\270\200\345\257\271\345\244\232.png" | Bin 0 -> 19515 bytes
 .../\345\244\232\345\257\271\345\244\232.png" | Bin 0 -> 20489 bytes
 sitemap.xml                                   |  26 +++----
 tags/AFL/index.html                           |  69 ++++--------------
 11 files changed, 92 insertions(+), 83 deletions(-)
 create mode 100644 "2024/\350\275\257\350\200\203\346\236\266\346\236\204\342\200\224\342\200\224\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241\344\270\216\345\273\272\346\250\241/\344\270\200\345\257\271\344\270\200.png"
 create mode 100644 "2024/\350\275\257\350\200\203\346\236\266\346\236\204\342\200\224\342\200\224\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241\344\270\216\345\273\272\346\250\241/\344\270\200\345\257\271\345\244\232.png"
 create mode 100644 "2024/\350\275\257\350\200\203\346\236\266\346\236\204\342\200\224\342\200\224\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241\344\270\216\345\273\272\346\250\241/\345\244\232\345\257\271\345\244\232.png"

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 6defa8b..6fdfa53 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":"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\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>
     <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="AFL">
 <meta property="article:tag" content="Fuzz">
 <meta property="article:tag" content="安全">
 <meta property="article:tag" content="工具">
+<meta property="article:tag" content="AFL">
 <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 41e50c8..6c851f8 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":"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\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>
     <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="AFL">
 <meta property="article:tag" content="Fuzz">
 <meta property="article:tag" content="安全">
 <meta property="article:tag" content="工具">
+<meta property="article:tag" content="AFL">
 <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/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 65520ba..7060cfb 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":"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最近遇到 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>
     <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="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 c4aac02..e191000 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":"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前文 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>
     <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="AFL++">
 <meta name="twitter:card" content="summary">
     
     
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 e8f7cff..15b91a5 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="安全">
 <meta property="article:tag" content="AFL++">
+<meta property="article:tag" content="安全">
 <meta property="article:tag" content="开发">
 <meta property="article:tag" content="Python">
 <meta name="twitter:card" content="summary">
diff --git "a/2024/\350\275\257\350\200\203\346\236\266\346\236\204\342\200\224\342\200\224\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241\344\270\216\345\273\272\346\250\241/index.html" "b/2024/\350\275\257\350\200\203\346\236\266\346\236\204\342\200\224\342\200\224\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241\344\270\216\345\273\272\346\250\241/index.html"
index 12d8ccf..5a373f2 100644
--- "a/2024/\350\275\257\350\200\203\346\236\266\346\236\204\342\200\224\342\200\224\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241\344\270\216\345\273\272\346\250\241/index.html"
+++ "b/2024/\350\275\257\350\200\203\346\236\266\346\236\204\342\200\224\342\200\224\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241\344\270\216\345\273\272\346\250\241/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\n\n\n三级模式：\n\n外模式：是数据库用户能看见和使用的局部数据的逻辑结构，与某一应用有关的数据逻辑表示。对应用户视图，面向数据库用户。\n概念（逻辑）模式：是数据库中全体数据的逻辑结构和特征的描述，所有用户的公共数据视图。对应数据库表，面向数据库管理员。\n内模式：是数据物理结构和存储方式的描述，数据在数据库内部的表示方式。对应物理文件，面向系统程序员。\n\n\n两级映射：保证两类独立性，逻辑独立比物理独立更难实现\n\n外模式 - 模式映射：保证  逻辑独立性，即当逻辑模式发生改变时，应用程序不用修改。\n模式 - 内模式映射：保证  物理独立性，即当内模式发生改变时，应用程序不用修改。\n\n\n\n二、数据库理论  关系型数据库中的  关系  是指由行列组成的二维表文件，每行表示一条记录，每列表示一个属性。关系模型  是关系的逻辑描述，可以表示为：关系名(属性 1, 属性 2, …, 属性 N)。\n1. 关系运算  关系代数的基本运算主要有交、并、差、笛卡尔积、选择、投影、连接和除法运算。\n交、并、差、笛卡尔积  跟集合论中的运算是一个意思，就是把每张数据表视为行的集合，然后做运算。\n选择  是指从数据表中找出符合条件的行（记录）。\n投影  是指从数据表中抽取指定的列（属性）。\n连接  分为两种：\n\nθ连接：从两个关系的笛卡尔积中选取属性满足一定条件的元组\n自然连接（⊳⊲连接）：两个关系中进行比较的分量必须是相同的属性，并且在结果中将重复的属性去掉\n\n2. 函数依赖  函数依赖（Functional Dependency）是数据库理论中的一个重要概念，用于描述属性之间的关系。在关系数据库中，如果属性集 X 的值能够唯一地决定属性集 Y 的值，我们就说Y 函数依赖于 X，记作 X→Y。\n函数依赖的定义：\n给定一个关系 R，如果对于关系 R 中的任意两个元组 t1 和 t2，若 t1 和 t2 在属性集 X 上的值相同，则它们在属性集 Y 上的值也必须相同，那么我们就说 Y 函数依赖于 X。\n函数依赖的类型：\n\n平凡函数依赖：如果属性集 Y 是属性集 X 的一个子集，则称 X 决定 Y 的依赖关系为平凡依赖。例如 X→X\n非平凡函数依赖：属性 Y 不是属性 X 的子集，则称 X 决定 Y 的依赖关系为非平凡依赖。可以进一步分类：\n完全函数依赖：如果在一个复合属性集 X 中，Y 仅依赖于 X 的全部属性，而不依赖于 X 的任何真子集。\n部分函数依赖：如果 Y 依赖于 X 的某个真子集。\n传递函数依赖：如果 X 函数依赖于 Y，而 Y 又函数依赖于 Z，那么可以说 X 传递函数依赖于 Z。\n\n\n\n简单点说：左右包含是平凡，左右互斥非平凡，若无子集是完全，若有子集是部分，环环相连是传递。\n3. Armstrong 公理Armstrong 公理是一组用于推导关系数据库中函数依赖的基本规则，通过这些规则，可以推导出任意一组函数依赖的所有隐含依赖。\n\n自反性：若 X⊇Y，则 X→Y。即一个属性集必然决定其子集。\n增广性：若 X→Y，则 XZ→YZ。即如果 X 决定 Y，那么 X 与 Z 的组合也决定 Y 与 Z 的组合。\n传递性：若 X→Y 且 Y→Z，则 X→Z。即如果 X 决定 Y，且 Y 决定 Z，那么 X 也决定 Z。\n合并性：若 X→Y 且 X→Z，则 X→YZ。即如果 X 决定 Y，且 X 也决定 Z，那么 X 决定 YZ。\n分解性：若 X→Y 且 Y⊇Z，则存在 X→Z。即如果 X 决定 Y，而 Z 是 Y 的子集，那么 X 决定 Z。\n\n4. 关系分解  在数据库关系分解中，有两个重要概念：\n(1) 无损连接\n无损链接指的是将一个关系分解成多个子关系后，通过对这些子关系进行自然连接操作，可以无损地恢复原始关系。换句话说，在连接后得到的结果应该与原始关系完全相同，没有任何信息增加或丢失。\n无损连接分解的  判定方法  为：\n设ρ&#x3D;{R1, R2}是 R 的一个分解，F 是 R 上的函数依赖集。那么分解ρ相对于 F 是无损级联分解的充要条件为 (R1∩R2)→(R1−R2) 或 (R1∩R2)→(R2−R1) 。 注意两个条件只要有任意一个条件成立即可。\n(2) 保持依赖\n保持依赖指的是在关系分解后，仍然能够通过子关系中的函数依赖来推导出原始关系中的所有函数依赖。换句话说，分解后的子关系应该能够保持原始关系中的所有重要的依赖关系。\n举例来说，假设有一个关系 R(A, B, C)，并且它有函数依赖：A→B 和 B→C。\n\n如果将关系 R 分解为 R1(A, B)和 R2(B, C):\n通过属性 B 连接 R1 和 R2，可以恢复 R，因此是无损分解。\n关系 R1 保留了 A→B，关系 R2 保留了 B→C，因此是保持依赖。\n\n\n如果将关系 R 分解为 R1(A, B)和 R3(A, C):\n通过属性 A 连接 R1 和 R3，可以恢复 R，因此是无损分解。\n关系 R1 保留了 A→B，关系 R3 保留了 A→C，但是 B→C 丢失，因此不是保持依赖。\n\n\n\n5. 设计范式  数据库设计范式是指在设计数据库时遵循的一系列规范和原则，以确保数据的组织、存储和管理高效、合理。主要范式包括：\n(1) 第一范式（1NF）每个字段的值都是原子值，不能有重复的列或多值字段。\n不符合 1NF 的表：\n\n\n\n学生 ID\n学生姓名\n课程\n\n\n\n1\n张三\n数学, 物理\n\n\n在这个例子中，”课程”属性是个多值字段。需要重新设计成符合 1NF 的表：\n\n\n\n学生 ID\n学生姓名\n课程\n\n\n\n1\n张三\n数学\n\n\n1\n张三\n物理\n\n\n(2) 第二范式（2NF）在满足 1NF 的基础上，要求消除部分依赖，即每个非主键字段必须完全依赖于主键，而不是主键的一部分。\n不符合 2NF 的表：\n\n\n\n学生 ID\n课程\n学生姓名\n\n\n\n1\n数学\n张三\n\n\n1\n物理\n张三\n\n\n2\n语文\n李四\n\n\n在这个例子中，”学生姓名”只依赖于”学生 ID”，而不依赖于”课程”。我们可以分成两个符合 2NF 的表：\n学生表：\n\n\n\n学生 ID\n学生姓名\n\n\n\n1\n张三\n\n\n2\n李四\n\n\n选课表：\n\n\n\n学生 ID\n课程\n\n\n\n1\n数学\n\n\n1\n物理\n\n\n2\n语文\n\n\n(3) 第三范式（3NF）在满足 2NF 的基础上，要求消除传递依赖，即非主键字段不能依赖于其他非主键字段。\n不符合 3NF 的表：\n\n\n\n学生 ID\n学生姓名\n班级\n班主任\n\n\n\n1\n张三\n一班\n王老师\n\n\n2\n李四\n一班\n王老师\n\n\n在这个例子中，”班主任”依赖于”班级”，而不是”学生 ID”。可以进一步分成两个符合 3NF 的表：\n学生表：\n\n\n\n学生 ID\n学生姓名\n班级\n\n\n\n1\n张三\n一班\n\n\n2\n李四\n一班\n\n\n班级表：\n\n\n\n班级\n班主任\n\n\n\n一班\n王老师\n\n\n(4) 博茨 - 科得范式（BCNF）3NF 的强化版本，要求每个决定因素（函数依赖的左侧）必须是超键，进一步消除所有依赖问题。\n不符合 BCNF 的表：\n\n\n\n学生 ID\n课程\n教师\n\n\n\n1\n数学\n李老师\n\n\n1\n物理\n李老师\n\n\n2\n数学\n张老师\n\n\n在这个例子中，”教师”依赖于”课程”，而”课程”不是超键。可以将其分为两个符合 BCNF 的表：\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学生 ID\n课程\n\n\n\n1\n数学\n\n\n1\n物理\n\n\n2\n数学\n\n\n(5) 第四范式（4NF）解决多值依赖的问题，要求每个表只能包含一个多值依赖。\n不符合 4NF 的表：\n\n\n\n学生 ID\n课程\n兴趣\n\n\n\n1\n数学\n足球\n\n\n1\n物理\n篮球\n\n\n在这个例子中，”课程”和”兴趣”之间存在多值依赖。可以将其分为两个符合 4NF 的表：\n选课表：\n\n\n\n学生 ID\n课程\n\n\n\n1\n数学\n\n\n1\n物理\n\n\n兴趣表：\n\n\n\n学生 ID\n兴趣\n\n\n\n1\n足球\n\n\n1\n篮球\n\n\n三、数据库设计  数据库设计主要包含如下阶段：\n\n需求分析阶段：通过结构化分析，得到数据流图和数据字典\n概念设计阶段：根据功能模型，创建局部 ER 图，并合并为全局 ER 图（建立外模式）\n逻辑设计阶段：将 ER 图转换为数据库的关系模型（建立逻辑模式）\n物理设计阶段：根据数据逻辑模式，选择高效的存储结构和存储方法（建立内模式）\n\n\n\n（一）概念设计  在结构化分析阶段，我们通过自顶向下的方式建立的系统的功能模型，以数据流图和数据字典表示。数据库的概念设计阶段，实际上就是建立系统的数据模型。\n数据库的概念设计采用  自底向上  的方式，其任务是建立系统的数据模型（通常以 ER 图表示），主要步骤为：\n\n选择局部应用\n设计局部 ER 图\n合并得到全局 ER 图\n优化全局 ER 图\n\n1. ER 图元素ER 图用于描述系统的各种实体及其之间的关系，主要包含三个基本元素：\n\n实体：系统中的对象或概念，用矩形框表示。\n属性：实体具有的特性，用椭圆形表示。\n联系：用菱形框表示，通过连线与有关的实体相连，在连线上注明对应关系\n1:1 表示一对一关系\n1:n 表示一对多关系\nm:n 表示多对多关系\n\n\n\n\n\n2. ER 图合并  在合并 ER 图时，需要解决局部 ER 图之间的冲突问题，与合并之后全局 ER 图的冗余问题。\n冲突有三种类型：\n\n属性冲突：属性名和属性含义相同，但属性的取值类型或取值范围不同。\n命名冲突 ： 异名同义 （不同属性名表示同一种属性含义），或是 同名异义（同一属性名表示不同的属性含义）。\n结构冲突：\n同一对象在不同 ER 图中具有不同的抽象。例如某个对象在一个 ER 图中是实体，在另一个 ER 图中是属性。\n同一实体在不同 ER 图中所包含的属性个数和属性排列次序不完全相同。\n实体之间的关系在不同 ER 图中呈现为不同的联系。\n\n\n\n冗余有两种类型：\n\n冗余属性：可由基本数据导出的属性\n冗余联系：可由其他联系导出的联系\n\n消除冲突通常是结合业务需求，通过讨论与协商来处理。消除冗余通常是以数据流图和数据字典为依据，通过分析数据项之间的逻辑关系来处理。\n（二）逻辑设计  数据库的逻辑设计是指将 ER 图中的实体、属性、联系转换为数据库的关系模型。","dateCreated":"2024-10-23T09:27:29+08:00","dateModified":"2024-10-28T13:54:23+08:00","datePublished":"2024-10-23T09:27:29+08:00","description":"数据库的概念设计和逻辑设计","headline":"软考架构——数据库设计与建模","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2024/%E8%BD%AF%E8%80%83%E6%9E%B6%E6%9E%84%E2%80%94%E2%80%94%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BB%BA%E6%A8%A1/"},"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/%E8%BD%AF%E8%80%83%E6%9E%B6%E6%9E%84%E2%80%94%E2%80%94%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BB%BA%E6%A8%A1/","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一、数据库结构  典型的数据库结构可归纳为“三级模式，两级映射”：\n\n\n\n三级模式：\n\n外模式：是数据库用户能看见和使用的局部数据的逻辑结构，与某一应用有关的数据逻辑表示。对应用户视图，面向数据库用户。\n概念（逻辑）模式：是数据库中全体数据的逻辑结构和特征的描述，所有用户的公共数据视图。对应数据库表，面向数据库管理员。\n内模式：是数据物理结构和存储方式的描述，数据在数据库内部的表示方式。对应物理文件，面向系统程序员。\n\n\n两级映射：保证两类独立性，逻辑独立比物理独立更难实现\n\n外模式 - 模式映射：保证  逻辑独立性，即当逻辑模式发生改变时，应用程序不用修改。\n模式 - 内模式映射：保证  物理独立性，即当内模式发生改变时，应用程序不用修改。\n\n\n\n二、数据库理论  关系型数据库中的  关系  是指由行列组成的二维表文件，每行表示一条记录，每列表示一个属性。关系模型  是关系的逻辑描述，可以表示为：关系名(属性 1, 属性 2, …, 属性 N)。\n1. 关系运算  关系代数的基本运算主要有交、并、差、笛卡尔积、选择、投影、连接和除法运算。\n交、并、差、笛卡尔积  跟集合论中的运算是一个意思，就是把每张数据表视为行的集合，然后做运算。\n选择  是指从数据表中找出符合条件的行（记录）。\n投影  是指从数据表中抽取指定的列（属性）。\n连接  分为两种：\n\nθ连接：从两个关系的笛卡尔积中选取属性满足一定条件的元组\n自然连接（⊳⊲连接）：两个关系中进行比较的分量必须是相同的属性，并且在结果中将重复的属性去掉\n\n2. 函数依赖  函数依赖（Functional Dependency）是数据库理论中的一个重要概念，用于描述属性之间的关系。在关系数据库中，如果属性集 X 的值能够唯一地决定属性集 Y 的值，我们就说Y 函数依赖于 X，记作 X→Y。\n函数依赖的定义：\n给定一个关系 R，如果对于关系 R 中的任意两个元组 t1 和 t2，若 t1 和 t2 在属性集 X 上的值相同，则它们在属性集 Y 上的值也必须相同，那么我们就说 Y 函数依赖于 X。\n函数依赖的类型：\n\n平凡函数依赖：如果属性集 Y 是属性集 X 的一个子集，则称 X 决定 Y 的依赖关系为平凡依赖。例如 X→X\n非平凡函数依赖：属性 Y 不是属性 X 的子集，则称 X 决定 Y 的依赖关系为非平凡依赖。可以进一步分类：\n完全函数依赖：如果在一个复合属性集 X 中，Y 仅依赖于 X 的全部属性，而不依赖于 X 的任何真子集。\n部分函数依赖：如果 Y 依赖于 X 的某个真子集。\n传递函数依赖：如果 X 函数依赖于 Y，而 Y 又函数依赖于 Z，那么可以说 X 传递函数依赖于 Z。\n\n\n\n简单点说：左右包含是平凡，左右互斥非平凡，若无子集是完全，若有子集是部分，环环相连是传递。\n3. Armstrong 公理Armstrong 公理是一组用于推导关系数据库中函数依赖的基本规则，通过这些规则，可以推导出任意一组函数依赖的所有隐含依赖。\n\n自反性：若 X⊇Y，则 X→Y。即一个属性集必然决定其子集。\n增广性：若 X→Y，则 XZ→YZ。即如果 X 决定 Y，那么 X 与 Z 的组合也决定 Y 与 Z 的组合。\n传递性：若 X→Y 且 Y→Z，则 X→Z。即如果 X 决定 Y，且 Y 决定 Z，那么 X 也决定 Z。\n合并性：若 X→Y 且 X→Z，则 X→YZ。即如果 X 决定 Y，且 X 也决定 Z，那么 X 决定 YZ。\n分解性：若 X→Y 且 Y⊇Z，则存在 X→Z。即如果 X 决定 Y，而 Z 是 Y 的子集，那么 X 决定 Z。\n\n4. 关系分解  在数据库关系分解中，有两个重要概念：\n(1) 无损连接\n无损链接指的是将一个关系分解成多个子关系后，通过对这些子关系进行自然连接操作，可以无损地恢复原始关系。换句话说，在连接后得到的结果应该与原始关系完全相同，没有任何信息增加或丢失。\n无损连接分解的  判定方法  为：\n设ρ&#x3D;{R1, R2}是 R 的一个分解，F 是 R 上的函数依赖集。那么分解ρ相对于 F 是无损级联分解的充要条件为 (R1∩R2)→(R1−R2) 或 (R1∩R2)→(R2−R1) 。 注意两个条件只要有任意一个条件成立即可。\n(2) 保持依赖\n保持依赖指的是在关系分解后，仍然能够通过子关系中的函数依赖来推导出原始关系中的所有函数依赖。换句话说，分解后的子关系应该能够保持原始关系中的所有重要的依赖关系。\n举例来说，假设有一个关系 R(A, B, C)，并且它有函数依赖：A→B 和 B→C。\n\n如果将关系 R 分解为 R1(A, B)和 R2(B, C):\n通过属性 B 连接 R1 和 R2，可以恢复 R，因此是无损分解。\n关系 R1 保留了 A→B，关系 R2 保留了 B→C，因此是保持依赖。\n\n\n如果将关系 R 分解为 R1(A, B)和 R3(A, C):\n通过属性 A 连接 R1 和 R3，可以恢复 R，因此是无损分解。\n关系 R1 保留了 A→B，关系 R3 保留了 A→C，但是 B→C 丢失，因此不是保持依赖。\n\n\n\n5. 设计范式  数据库设计范式是指在设计数据库时遵循的一系列规范和原则，以确保数据的组织、存储和管理高效、合理。数据库主要范式包括：\n(1) 第一范式（1NF）每个字段的值都是原子值，不能有重复的列或多值字段。\n不符合 1NF 的表：\n\n\n\n学生 ID\n学生姓名\n课程\n\n\n\n1\n张三\n数学, 物理\n\n\n在这个例子中，”课程”属性是个多值字段。需要重新设计成符合 1NF 的表：\n\n\n\n学生 ID\n学生姓名\n课程\n\n\n\n1\n张三\n数学\n\n\n1\n张三\n物理\n\n\n(2) 第二范式（2NF）在满足 1NF 的基础上，要求消除部分依赖，即每个非主键字段必须完全依赖于主键，而不是主键的一部分。\n不符合 2NF 的表：\n\n\n\n学生 ID\n课程\n学生姓名\n\n\n\n1\n数学\n张三\n\n\n1\n物理\n张三\n\n\n2\n语文\n李四\n\n\n在这个例子中，”学生姓名”只依赖于”学生 ID”，而不依赖于”课程”。我们可以分成两个符合 2NF 的表：\n学生表：\n\n\n\n学生 ID\n学生姓名\n\n\n\n1\n张三\n\n\n2\n李四\n\n\n选课表：\n\n\n\n学生 ID\n课程\n\n\n\n1\n数学\n\n\n1\n物理\n\n\n2\n语文\n\n\n(3) 第三范式（3NF）在满足 2NF 的基础上，要求消除传递依赖，即非主键字段不能依赖于其他非主键字段。\n不符合 3NF 的表：\n\n\n\n学生 ID\n学生姓名\n班级\n班主任\n\n\n\n1\n张三\n一班\n王老师\n\n\n2\n李四\n一班\n王老师\n\n\n在这个例子中，”班主任”依赖于”班级”，而不是”学生 ID”。可以进一步分成两个符合 3NF 的表：\n学生表：\n\n\n\n学生 ID\n学生姓名\n班级\n\n\n\n1\n张三\n一班\n\n\n2\n李四\n一班\n\n\n班级表：\n\n\n\n班级\n班主任\n\n\n\n一班\n王老师\n\n\n(4) 博茨 - 科得范式（BCNF）3NF 的强化版本，要求每个决定因素（函数依赖的左侧）必须是超键，进一步消除所有依赖问题。\n不符合 BCNF 的表：\n\n\n\n学生 ID\n课程\n教师\n\n\n\n1\n数学\n李老师\n\n\n1\n物理\n李老师\n\n\n2\n数学\n张老师\n\n\n在这个例子中，”教师”依赖于”课程”，而”课程”不是超键。可以将其分为两个符合 BCNF 的表：\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学生 ID\n课程\n\n\n\n1\n数学\n\n\n1\n物理\n\n\n2\n数学\n\n\n(5) 第四范式（4NF）解决多值依赖的问题，要求每个表只能包含一个多值依赖。\n不符合 4NF 的表：\n\n\n\n学生 ID\n课程\n兴趣\n\n\n\n1\n数学\n足球\n\n\n1\n物理\n篮球\n\n\n在这个例子中，”课程”和”兴趣”之间存在多值依赖。可以将其分为两个符合 4NF 的表：\n选课表：\n\n\n\n学生 ID\n课程\n\n\n\n1\n数学\n\n\n1\n物理\n\n\n兴趣表：\n\n\n\n学生 ID\n兴趣\n\n\n\n1\n足球\n\n\n1\n篮球\n\n\n三、数据库设计  数据库设计主要包含如下阶段：\n\n需求分析阶段：通过结构化分析，得到数据流图和数据字典\n概念设计阶段：根据功能模型，创建局部 ER 图，并合并为全局 ER 图（建立外模式）\n逻辑设计阶段：将 ER 图转换为数据库的关系模型（建立逻辑模式）\n物理设计阶段：根据数据逻辑模式，选择高效的存储结构和存储方法（建立内模式）\n\n\n\n（一）概念设计  在结构化分析阶段，我们通过自顶向下的方式建立的系统的功能模型，以数据流图和数据字典表示。数据库的概念设计阶段，实际上就是建立系统的数据模型。\n数据库的概念设计采用  自底向上  的方式，其任务是建立系统的数据模型（通常以 ER 图表示），主要步骤为：\n\n选择局部应用\n设计局部 ER 图\n合并得到全局 ER 图\n优化全局 ER 图\n\n1. ER 图元素ER 图用于描述系统的各种实体及其之间的关系，主要包含三个基本元素：\n\n实体：系统中的对象或概念，用矩形框表示。\n属性：实体具有的特性，用椭圆形表示。\n联系：用菱形框表示，通过连线与有关的实体相连，在连线上注明对应关系\n1:1 表示一对一关系\n1:n 表示一对多关系\nm:n 表示多对多关系\n\n\n\n\n\n2. ER 图合并  在合并 ER 图时，需要解决局部 ER 图之间的冲突问题，与合并之后全局 ER 图的冗余问题。\n冲突有三种类型：\n\n属性冲突：属性名和属性含义相同，但属性的取值类型或取值范围不同。\n命名冲突 ： 异名同义 （不同属性名表示同一种属性含义），或是 同名异义（同一属性名表示不同的属性含义）。\n结构冲突：\n同一对象在不同 ER 图中具有不同的抽象。例如某个对象在一个 ER 图中是实体，在另一个 ER 图中是属性。\n同一实体在不同 ER 图中所包含的属性个数和属性排列次序不完全相同。\n实体之间的关系在不同 ER 图中呈现为不同的联系。\n\n\n\n冗余有两种类型：\n\n冗余属性：可由基本数据导出的属性\n冗余联系：可由其他联系导出的联系\n\n消除冲突通常是结合业务需求，通过讨论与协商来处理。消除冗余通常是以数据流图和数据字典为依据，通过分析数据项之间的逻辑关系来处理。\n（二）逻辑设计  数据库的逻辑设计是指将 ER 图中的实体、属性、联系转换为 DBMS 数据库的关系模式，并进行范式规约。\n1. ER 图转换ER 图中的实体和属性可以直接转换为数据库中的一个关系模式（一张表），主键为实体，其他字段为属性。\nER 图中的联系，根据不同的类型，有不同的转换方式：\n(1) 1:1 联系\n\n\n转换方式：\n\n转换为一个独立的关系模式：联系两端的实体主键作为属性。ER 图转换结果：\n员工(工号，姓名，性别)\n办公电脑(电脑编号，电脑配置)\n使用(工号，电脑编号)\n\n\n与任意一端实体的关系模式合并：将一个实体的主键作为另一个实体的外键。ER 图转换结果：\n员工(工号，姓名，性别，电脑编号)\n办公电脑(电脑编号，电脑配置)\n\n\n\n(2) 1:n 联系\n\n\n转换方式：\n\n转换为一个独立的关系模式：联系两端的实体主键作为属性。ER 图转换结果：\n班级(编号，年级，人数)\n学生(学号，姓名，性别)\n隶属(学号，编号)\n\n\n与多端的实体的关系模式合并：在多端实体关系模式中，添加一端实体主键作为外键。ER 图转换结果：\n班级(编号，年级，人数)\n学生(学号，姓名，性别，编号)\n\n\n\n(3) m:n 联系\n\n\n转换方式：\n\n转换为一个独立的关系模式：联系两端的实体主键作为属性。ER 图转换结果：\n员工(工号，姓名，性别)\n角色(角色编号，角色名称，角色权限)\n使用(工号，角色编号)\n\n\n\n2. 范式规约","dateCreated":"2024-10-23T09:27:29+08:00","dateModified":"2024-10-28T15:17:57+08:00","datePublished":"2024-10-23T09:27:29+08:00","description":"数据库的概念设计和逻辑设计","headline":"软考架构——数据库设计与建模","image":[],"mainEntityOfPage":{"@type":"WebPage","@id":"https://www.stepbystep.asia/2024/%E8%BD%AF%E8%80%83%E6%9E%B6%E6%9E%84%E2%80%94%E2%80%94%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BB%BA%E6%A8%A1/"},"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/%E8%BD%AF%E8%80%83%E6%9E%B6%E6%9E%84%E2%80%94%E2%80%94%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BB%BA%E6%A8%A1/","keywords":"软件工程, 数据库设计, 数据库范式"}</script>
     <meta name="description" content="数据库的概念设计和逻辑设计">
 <meta property="og:type" content="blog">
 <meta property="og:title" content="软考架构——数据库设计与建模">
@@ -25,8 +25,11 @@
 <meta property="og:image" content="https://www.stepbystep.asia/2024/%E8%BD%AF%E8%80%83%E6%9E%B6%E6%9E%84%E2%80%94%E2%80%94%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BB%BA%E6%A8%A1/%E6%95%B0%E6%8D%AE%E5%BA%93%E7%BB%93%E6%9E%84.jpg">
 <meta property="og:image" content="https://www.stepbystep.asia/2024/%E8%BD%AF%E8%80%83%E6%9E%B6%E6%9E%84%E2%80%94%E2%80%94%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BB%BA%E6%A8%A1/%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1.jpg">
 <meta property="og:image" content="https://www.stepbystep.asia/2024/%E8%BD%AF%E8%80%83%E6%9E%B6%E6%9E%84%E2%80%94%E2%80%94%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BB%BA%E6%A8%A1/ERD.png">
+<meta property="og:image" content="https://www.stepbystep.asia/2024/%E8%BD%AF%E8%80%83%E6%9E%B6%E6%9E%84%E2%80%94%E2%80%94%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BB%BA%E6%A8%A1/%E4%B8%80%E5%AF%B9%E4%B8%80.png">
+<meta property="og:image" content="https://www.stepbystep.asia/2024/%E8%BD%AF%E8%80%83%E6%9E%B6%E6%9E%84%E2%80%94%E2%80%94%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BB%BA%E6%A8%A1/%E4%B8%80%E5%AF%B9%E5%A4%9A.png">
+<meta property="og:image" content="https://www.stepbystep.asia/2024/%E8%BD%AF%E8%80%83%E6%9E%B6%E6%9E%84%E2%80%94%E2%80%94%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BB%BA%E6%A8%A1/%E5%A4%9A%E5%AF%B9%E5%A4%9A.png">
 <meta property="article:published_time" content="2024-10-23T01:27:29.000Z">
-<meta property="article:modified_time" content="2024-10-28T05:54:23.113Z">
+<meta property="article:modified_time" content="2024-10-28T07:17:57.307Z">
 <meta property="article:author" content="一瓢清浅">
 <meta property="article:tag" content="软件工程">
 <meta property="article:tag" content="数据库设计">
@@ -324,7 +327,7 @@ <h3 id="4- 关系分解"><a href="#4- 关系分解" class="headerlink" title="4.
 </ul>
 </li>
 </ul>
-<h3 id="5- 设计范式"><a href="#5- 设计范式" class="headerlink" title="5. 设计范式"></a>5. 设计范式 </h3><p> 数据库设计范式是指在设计数据库时遵循的一系列规范和原则，以确保数据的组织、存储和管理高效、合理。主要范式包括：</p>
+<h3 id="5- 设计范式"><a href="#5- 设计范式" class="headerlink" title="5. 设计范式"></a>5. 设计范式 </h3><p> 数据库设计范式是指在设计数据库时遵循的一系列规范和原则，以确保数据的组织、存储和管理高效、合理。数据库主要范式包括：</p>
 <h4 id="1- 第一范式（1NF）"><a href="#1- 第一范式（1NF）" class="headerlink" title="(1) 第一范式（1NF）"></a>(1) 第一范式（1NF）</h4><p><strong>每个字段的值都是原子值，不能有重复的列或多值字段。</strong></p>
 <p>不符合 1NF 的表：</p>
 <table>
@@ -657,7 +660,56 @@ <h4 id="2-ER 图合并"><a href="#2-ER 图合并" class="headerlink" title="2. E
 <li><strong>冗余联系</strong>：可由其他联系导出的联系</li>
 </ol>
 <p>消除冲突通常是结合业务需求，通过讨论与协商来处理。<br>消除冗余通常是以数据流图和数据字典为依据，通过分析数据项之间的逻辑关系来处理。</p>
-<h3 id="（二）逻辑设计"><a href="#（二）逻辑设计" class="headerlink" title="（二）逻辑设计"></a>（二）逻辑设计 </h3><p> 数据库的逻辑设计是指将 ER 图中的实体、属性、联系转换为数据库的关系模型。</p>
+<h3 id="（二）逻辑设计"><a href="#（二）逻辑设计" class="headerlink" title="（二）逻辑设计"></a>（二）逻辑设计 </h3><p> 数据库的逻辑设计是指将 ER 图中的实体、属性、联系转换为 DBMS 数据库的关系模式，并进行范式规约。</p>
+<h4 id="1-ER 图转换"><a href="#1-ER 图转换" class="headerlink" title="1. ER 图转换"></a>1. ER 图转换</h4><p>ER 图中的实体和属性可以直接转换为数据库中的一个关系模式（一张表），主键为实体，其他字段为属性。</p>
+<p>ER 图中的联系，根据不同的类型，有不同的转换方式：</p>
+<p>(1) 1:1 联系</p>
+<img src="/2024/%E8%BD%AF%E8%80%83%E6%9E%B6%E6%9E%84%E2%80%94%E2%80%94%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BB%BA%E6%A8%A1/%E4%B8%80%E5%AF%B9%E4%B8%80.png" class title=" 一对一 ">
+
+<p>转换方式：</p>
+<ul>
+<li><strong>转换为一个独立的关系模式</strong>：联系两端的实体主键作为属性。ER 图转换结果：<ul>
+<li>员工(工号，姓名，性别)</li>
+<li>办公电脑(电脑编号，电脑配置)</li>
+<li>使用(工号，电脑编号)</li>
+</ul>
+</li>
+<li><strong>与任意一端实体的关系模式合并</strong>：将一个实体的主键作为另一个实体的外键。ER 图转换结果：<ul>
+<li>员工(工号，姓名，性别，电脑编号)</li>
+<li>办公电脑(电脑编号，电脑配置)</li>
+</ul>
+</li>
+</ul>
+<p>(2) 1:n 联系</p>
+<img src="/2024/%E8%BD%AF%E8%80%83%E6%9E%B6%E6%9E%84%E2%80%94%E2%80%94%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BB%BA%E6%A8%A1/%E4%B8%80%E5%AF%B9%E5%A4%9A.png" class title=" 一对多 ">
+
+<p>转换方式：</p>
+<ul>
+<li><strong>转换为一个独立的关系模式</strong>：联系两端的实体主键作为属性。ER 图转换结果：<ul>
+<li>班级(编号，年级，人数)</li>
+<li>学生(学号，姓名，性别)</li>
+<li>隶属(学号，编号)</li>
+</ul>
+</li>
+<li><strong>与多端的实体的关系模式合并</strong>：在多端实体关系模式中，添加一端实体主键作为外键。ER 图转换结果：<ul>
+<li>班级(编号，年级，人数)</li>
+<li>学生(学号，姓名，性别，编号)</li>
+</ul>
+</li>
+</ul>
+<p>(3) m:n 联系</p>
+<img src="/2024/%E8%BD%AF%E8%80%83%E6%9E%B6%E6%9E%84%E2%80%94%E2%80%94%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1%E4%B8%8E%E5%BB%BA%E6%A8%A1/%E5%A4%9A%E5%AF%B9%E5%A4%9A.png" class title=" 多对多 ">
+
+<p>转换方式：</p>
+<ul>
+<li><strong>转换为一个独立的关系模式</strong>：联系两端的实体主键作为属性。ER 图转换结果：<ul>
+<li>员工(工号，姓名，性别)</li>
+<li>角色(角色编号，角色名称，角色权限)</li>
+<li>使用(工号，角色编号)</li>
+</ul>
+</li>
+</ul>
+<h4 id="2- 范式规约"><a href="#2- 范式规约" class="headerlink" title="2. 范式规约"></a>2. 范式规约</h4>
             
 
 
diff --git "a/2024/\350\275\257\350\200\203\346\236\266\346\236\204\342\200\224\342\200\224\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241\344\270\216\345\273\272\346\250\241/\344\270\200\345\257\271\344\270\200.png" "b/2024/\350\275\257\350\200\203\346\236\266\346\236\204\342\200\224\342\200\224\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241\344\270\216\345\273\272\346\250\241/\344\270\200\345\257\271\344\270\200.png"
new file mode 100644
index 0000000000000000000000000000000000000000..60b8d3b85b0a7388c1e50c9ddd224eeaf722637c
GIT binary patch
literal 18236
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
Zlp4^uzw|%g7YzPe7heC@<b`dH|1W08_!j^G

literal 0
HcmV?d00001

diff --git "a/2024/\350\275\257\350\200\203\346\236\266\346\236\204\342\200\224\342\200\224\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241\344\270\216\345\273\272\346\250\241/\344\270\200\345\257\271\345\244\232.png" "b/2024/\350\275\257\350\200\203\346\236\266\346\236\204\342\200\224\342\200\224\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241\344\270\216\345\273\272\346\250\241/\344\270\200\345\257\271\345\244\232.png"
new file mode 100644
index 0000000000000000000000000000000000000000..5acef2b001ece1cff5993c0a0362ebd4b6078567
GIT binary patch
literal 19515
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

literal 0
HcmV?d00001

diff --git "a/2024/\350\275\257\350\200\203\346\236\266\346\236\204\342\200\224\342\200\224\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241\344\270\216\345\273\272\346\250\241/\345\244\232\345\257\271\345\244\232.png" "b/2024/\350\275\257\350\200\203\346\236\266\346\236\204\342\200\224\342\200\224\346\225\260\346\215\256\345\272\223\350\256\276\350\256\241\344\270\216\345\273\272\346\250\241/\345\244\232\345\257\271\345\244\232.png"
new file mode 100644
index 0000000000000000000000000000000000000000..c568af111d3491a4caa3ea07aa6f5cea65ce7f1a
GIT binary patch
literal 20489
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
b{H1fYSYbi^;eS)jf5r{@f7z4%ud#mvZJR?<

literal 0
HcmV?d00001

diff --git a/sitemap.xml b/sitemap.xml
index 51e9865..d219aa6 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -354,49 +354,49 @@
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/Linux/</loc>
+    <loc>https://www.stepbystep.asia/tags/Docker/</loc>
     <lastmod>2024-10-28</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/%E5%AE%B9%E5%99%A8/</loc>
     <lastmod>2024-10-28</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/LibFuzzer/</loc>
     <lastmod>2024-10-28</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/Docker/</loc>
+    <loc>https://www.stepbystep.asia/tags/Python/</loc>
     <lastmod>2024-10-28</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
   </url>
   
   <url>
-    <loc>https://www.stepbystep.asia/tags/%E5%AE%B9%E5%99%A8/</loc>
+    <loc>https://www.stepbystep.asia/tags/Linux/</loc>
     <lastmod>2024-10-28</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%93%8D%E4%BD%9C%E7%B3%BB%E7%BB%9F/</loc>
     <lastmod>2024-10-28</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-28</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
@@ -510,42 +510,42 @@
   </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/web/</loc>
     <lastmod>2024-10-28</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/</loc>
     <lastmod>2024-10-28</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-28</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/Docker/</loc>
     <lastmod>2024-10-28</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-28</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/%E5%BC%80%E5%8F%91/Linux/</loc>
     <lastmod>2024-10-28</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.2</priority>
diff --git a/tags/AFL/index.html b/tags/AFL/index.html
index a03d275..10a2d69 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="/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 class="link-unstyled" href="/2023/LibAFL%E7%AE%80%E4%BB%8B/" aria-label=": LibAFL 简介">
+                            LibAFL 简介
                         </a>
                     
                 </h1>
                 <div class="postShorten-meta">
-    <time datetime="2024-08-15T17:28:52+08:00">
+    <time datetime="2023-11-18T10:38:08+08:00">
 	
-		    2024 年 8 月 15 日
+		    2023 年 11 月 18 日
     	
     </time>
     
@@ -243,9 +243,9 @@ <h1 class="postShorten-title">
             </div>
             
                 <div class="postShorten-excerpt">
-                    <p>分析 AFL++ 度量覆盖率的相关代码</p>
+                    <p>LibAFL 是用 Rust 开发的一款模糊测试库，支持 Fuzz 各模块的灵活定制 </p>
                     
-                        <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 href="/2023/LibAFL%E7%AE%80%E4%BB%8B/" class="postShorten-excerpt_link link" aria-label=": LibAFL 简介">
                             阅读全文
                         </a>
                         
@@ -263,58 +263,15 @@ <h1 class="postShorten-title">
             <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/AFL%E5%8E%9F%E7%90%86%E4%B8%8E%E5%AE%9E%E8%B7%B5/" aria-label=": AFL 原理与实践">
+                            AFL 原理与实践
                         </a>
                     
                 </h1>
                 <div class="postShorten-meta">
-    <time datetime="2024-07-30T16:19:00+08:00">
+    <time datetime="2023-10-15T11:23:55+08:00">
 	
-		    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 日
+		    2023 年 10 月 15 日
     	
     </time>
     
@@ -329,9 +286,9 @@ <h1 class="postShorten-title">
             </div>
             
                 <div class="postShorten-excerpt">
-                    <p>分析 AFL++ 同步机制的相关源码</p>
+                    <p>模糊测试工具 AFL（American Fuzzy Lop）的原理介绍与实践应用</p>
                     
-                        <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 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>