zjuchenyuan/honggfuzz

honggfuzz

https://hub.docker.com/r/zjuchenyuan/honggfuzz
来源：https://github.com/google/honggfuzz

当前版本：1.9  
更多版本：clang 6.0  
最后更新：2019/09（活跃）  
语言：C  
类型：变异模糊测试工具、编译时插桩  
标签：多进程、多线程、支持类似libfuzzer的持久模糊测试模式  

该镜像还提供1.7、1.8、1.9版本标签。

指南

以模糊测试MP3Gain 1.6.2为例。

步骤1：系统配置

以root或sudo用户身份运行以下命令（若未配置或重启后）：

bash
echo "" | sudo tee /proc/sys/kernel/core_pattern  
echo 0 | sudo tee /proc/sys/kernel/core_uses_pid  
echo performance | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor  
echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope  
echo 1 | sudo tee /proc/sys/kernel/sched_child_runs_first # tfuzz需要此配置  
echo 0 | sudo tee /proc/sys/kernel/randomize_va_space # vuzzer需要此配置  

出现“文件或目录不存在”的错误信息可忽略。

注意：
虽然并非所有配置都为该模糊测试工具所需，但为保持不同模糊测试工具间的一致性，我们统一提供这些命令。
这些命令可能会降低系统安全性（如关闭ASLR），但由于模糊测试实验通常在专用机器上进行，影响不大。
与许多模糊测试工具要求的echo core > /proc/sys/kernel/core_pattern（崩溃时生成核心转储文件）不同，此处我们禁用核心转储文件生成以减少模糊测试期间的I/O压力。http://man7.org/linux/man-pages/man5/core.5.html%E3%80%82

步骤2：编译目标程序

下载源代码，使用/honggfuzz/hfuzz_cc/hfuzz-clang编译。

bash
wget https://sourceforge.net/projects/mp3gain/files/mp3gain/1.6.2/mp3gain-1_6_2-src.zip/download -O mp3gain-1_6_2-src.zip  
mkdir -p mp3gain1.6.2 && cd mp3gain1.6.2  
unzip ../mp3gain-1_6_2-src.zip  

docker run --rm -w /work -it -v `pwd`:/work --privileged docker.xuanyuan.run/zjuchenyuan/honggfuzz sh -c "make clean; make"

步骤3：准备种子文件

https://github.com/UNIFUZZ/seeds%E6%8F%90%E4%BE%9B%E5%A4%9A%E7%A7%8D%E7%B1%BB%E5%9E%8B%E7%9A%84%E7%A7%8D%E5%AD%90%E6%96%87%E4%BB%B6%E3%80%82%E6%AD%A4%E5%A4%84%E6%8F%90%E4%BE%9B10%E4%B8%AAMP3%E7%A7%8D%E5%AD%90%E6%96%87%E4%BB%B6%EF%BC%8C%E4%B8%8B%E8%BD%BD%E5%88%B0%60seed_mp3%60%E6%96%87%E4%BB%B6%E5%A4%B9%EF%BC%9A

bash
# 安装subversion  
apt install -y subversion  
svn export https://github.com/UNIFUZZ/dockerized_fuzzing_examples/trunk/seed/mp3 seed_mp3  

步骤4：开始模糊测试！

bash
mkdir -p output/honggfuzz/queue  
docker run -w /work -it -v `pwd`:/work --privileged docker.xuanyuan.run/zjuchenyuan/honggfuzz \
    /honggfuzz/honggfuzz -f seed_mp3 -W output/honggfuzz/output \  
        --covdir_all output/honggfuzz/queue --threads 1 -- \  
        ./mp3gain ___FILE___  

参数解释

honggfuzz参数

• -f seed/mp3：输入种子文件夹
• -W output/honggfuzz/output：输出文件夹，存储崩溃信息及运行时文件
• --covdir_all output/honggfuzz/queue：队列文件夹，若不想种子文件夹被修改，此参数很重要
• --threads 1：仅运行1个实例，而非CPU数量/2
• ___FILE___：相当于AFL命令行中的@@

更多用法：https://github.com/google/honggfuzz/blob/master/docs/USAGE.md
===END===