Add single file version for teaching. Move bench scripts to util. Adapt

README.
This commit is contained in:
Jan Eitzinger
2020-06-24 09:21:27 +02:00
parent 8a6951a0e6
commit 37cbd14a3c
5 changed files with 446 additions and 15 deletions

20
util/README.md Normal file
View File

@@ -0,0 +1,20 @@
# Single file teaching version
bwBench.c contains a single file version of The Bandwidth Benchmark that is tailored for usage in Tutorials or Courses.
It should compile with any C99 compiler.
# Benchmarking skript
A wrapper scripts in perl (bench.pl) and python (bench.py) are also provided to scan ranges of thread counts and determine the absolute highest sustained main memory bandwidth. In order to use it `likwid-pin` has to be in your path. The script has three required and one optional command line arguments:
```
$./bench.pl <executable> <thread count range> <repetitions> [<SMT setting>]
```
Example usage:
```
$./bench.pl ./bwbench-GCC 2-8 6
```
The script will always use physical cores only, where two SMT threads is the default. For different SMT thread counts use the 4th command line argument. Example for a processor without SMT:
```
$./bench.pl ./bwbench-GCC 14-24 10 1
```