Bringup-Bench 使用教程

1. 项目目录结构及介绍

Bringup-Bench 的目录结构如下：

.
├── ackermann
├── anagram
├── audio-codec
├── avl-tree
├── banner
├── blake2b
├── bloom-filter
├── boyer-moore-search
├── bubble-sort
├── c-interp
├── checkers
├── cipher
├── common
├── dhrystone
├── distinctness
├── donut
├── fft-int
├── flood-fill
├── frac-calc
├── fuzzy-match
├── fy-shuffle
├── gcd-list
├── grad-descent
├── graph-tests
├── hanoi
├── heapsort
├── indirect-test
├── k-means
├── kadane
├── kepler
├── knapsack
├── knights-tour
├── life
├── longdiv
├── lz-compress
├── mandelbrot
├── max-subseq
├── mersenne
├── minspan
├── murmur-hash
├── natlog
├── nr-solver
├── parrondo
├── pascal
├── pi-calc
├── primal-test
├── priority-queue
├── qsort-demo
├── quaternions
├── quine
├── rabinkarp-search
├── regex-parser
├── rho-factor
├── rle-compress
├── satomi
├── scripts
├── shortest-path
├── sieve
├── simple-grep
├── skeleton
├── spelt2num
├── spirograph
├── strange
├── target
├── tiny-NN
├── topo-sort
├── totient
├── vectors-3d
├── weekday
├── .gitignore
├── HASH-refs.txt
├── LICENSE
├── Makefile
├── README.md
├── VERSION

每个子目录都包含一个特定的基准测试，例如 bubble-sort 目录包含冒泡排序的基准测试代码。

2. 项目的启动文件介绍

项目的启动主要通过 Makefile 文件来管理。这个 Makefile 文件定义了一系列的规则和目标，用于构建和测试基准测试。

以下是一些基本的 Makefile 命令：

• make TARGET=<target> clean：清理项目目录，删除所有编译产生的文件。
• make TARGET=<target> build：构建项目，编译基准测试程序。
• make TARGET=<target> test：运行测试，验证基准测试程序的输出。

例如，如果你想为 Linux 主机目标构建并测试 bubble-sort 基准测试，你可以使用以下命令：

make TARGET=host build
make TARGET=host test

3. 项目的配置文件介绍

Bringup-Bench 项目中的配置主要通过 Makefile 文件中的变量和条件来实现。项目中的 common 目录包含了一些通用的库和接口，这些库和接口被设计为尽可能减少对外部库的依赖。

在 Makefile 中，你可以定义不同的目标（例如 TARGET=host、TARGET=standalone 等），这些目标会决定如何构建和运行基准测试。每个目标都有特定的构建规则和依赖。

项目的配置主要通过以下文件进行：

• Makefile：顶层 Makefile，定义了构建和测试的通用规则。
• common/libtarg.c：包含了用于将程序输出重定向到内部缓冲区的接口，这对于没有 I/O 支持的 CPU 启动非常有用。

通过调整 Makefile 文件中的变量和条件，你可以定制项目的构建过程，以适应不同的开发和测试环境。