cicro/benchmark-clang-5

C语言基准测试套件

镜像概述

本镜像提供一个针对C语言编译器、优化器和运行时环境的基准测试套件，旨在通过大量真实世界代码样本，全面测量性能变化，避免依赖单一基准测试结果。支持多种编译器（如gcc、clang、tcc）和优化级别，可结合硬件计数器分析深入性能细节。

核心功能

• 多编译器支持：兼容gcc、clang、tcc等主流C语言编译器及不同优化级别
• 真实代码样本：使用大量实际应用场景的代码片段，确保测试结果的代表性
• 硬件计数器分析：可选集成PAPI工具，获取指令数、周期数等硬件级性能指标
• 结果统计：通过Python脚本生成基本性能统计信息
• 可视化工具：使用R脚本生成箱线图、矩阵图、条形图等多种可视化图表

使用场景

• 编译器版本间性能对比与优化效果评估
• 不同运行时环境对程序性能的影响分析
• 硬件级性能指标（如指令混合比、每周期指令数）的深入研究
• 优化参数调整后的效果验证

配置说明

依赖

• 可选依赖：PAPI（用于硬件计数器分析）
• 内置依赖：Python（用于结果统计）、R（用于可视化）

运行基准测试

bash
# 示例：运行clang-O3优化级别并保存结果
./tools/bench.py my_results.json --filter-runtime=clang-O3

# 示例：筛选以"a"开头的测试用例，运行所有clang环境并启用硬件计数器
./tools/bench.py example_results.json --filter-harness="^a.*" --filter-runtime="clang-.*" --exec-args="--papi=PAPI_LD_INS,PAPI_SR_INS,PAPI_BR_INS,PAPI_TOT_INS"

分析结果

bash
./tools/stats.py my_results.json

可视化结果

bash
# 需至少两次运行结果以生成对比图表
./tools/plot.R --benchfile=example_results.json --base-runtime=clang-O0

Docker部署示例

bash
# 挂载本地目录保存结果
docker run -v $(pwd)/results:/results docker.xuanyuan.run/cicro/benchmark-clang-5 ./tools/bench.py /results/my_results.json --filter-runtime=clang-O3

注：运行基准测试时建议关闭非必要应用和网络，确保CPU性能模式设置正确以获得准确结果。硬件计数器需提前确认支持的指标组合。 ===FULL_DESC===