Port to buildroot

Author: cirosantilli

Diff for: .gitignore

@@ -18,6 +18,7 @@ run
 /pkgs/tools/libtool/src/doc/stamp-vti
 /pkgs/tools/libtool/src/doc/version.texi
 
-# Unignore leftover present in the tars.
+# Ignore leftover present in the tars.
+/bin/.#parsecmgmt.1.6
 /toolkit/hpt/loggroup1.old/
 /toolkit/hpt/loggroup2.old/

Diff for: README.md

@@ -1,38 +1,71 @@
 # Parsec Benchmark
 
-<http://parsec.cs.princeton.edu/> 3.0-beta-20150206 ported to Ubuntu 16.04 and with proper version control.
+<http://parsec.cs.princeton.edu/> 3.0-beta-20150206 ported to Ubuntu 16.04 and SPLASH2 ported to Buildroot 2017.08 cross compilation (ARM, MIPS, etc.).
 
-## Getting started
+## Getting started Buildroot cross compilation
+
+See the instructions at: <https://github.com/cirosantilli/linux-kernel-module-cheat#parsec-benchmark> The Buildroot package is in that repo.
+
+Only SPLASH2 was ported currently, not the other benchmarks.
+
+PARSEC's build was designed for multiple archs, this can be seen at [bin/parsecmgmt](bin/parsecmgmt), but not for cross compilation. Some of the changes we've had to make:
+
+- use `CC` everywhere instead of hardcoded `gcc`
+- use `HOST_CC` for `.c` utilities used during compilation
+- remove absolute paths, e.g. `-I /usr/include`
+
+## Getting started Ubuntu 16.04
 
     ./configure
 
-Build all:
+Before doing anything else, you must get the `parecmgmt` command with:
 
     . env.sh
-    parsecmgmt -a build -p all
 
-Build just one to save time:
+Build all:
 
-    parsecmgmt -a build -p splash2
+    parsecmgmt -a build -p all
 
-Run all:
+Build all SPLASH2 benchmarks:
 
-    parsecmgmt -a run -p all
+    parsecmgmt -a build -p splash2x
 
-TODO some tests are broken. We will maintain a list.
+Build just one SPLASH2 benchmark:
+
+    parsecmgmt -a build -p splash2x.barnes
 
 Run one benchmark with one input size, listed in by increasing size:
 
-    parsecmgmt -a run -p splash2 -i simsmall
-    parsecmgmt -a run -p splash2 -i simmedium
-    parsecmgmt -a run -p splash2 -i simlarge
-    parsecmgmt -a run -p splash2 -i native
+    parsecmgmt -a run -p splash2x.barnes -i test
+    parsecmgmt -a run -p splash2x.barnes -i simdev
+    parsecmgmt -a run -p splash2x.barnes -i simsmall
+    parsecmgmt -a run -p splash2x.barnes -i simmedium
+    parsecmgmt -a run -p splash2x.barnes -i simlarge
+    parsecmgmt -a run -p splash2x.barnes -i native
+
+For some reason, the `splash2` version (without the X) does not have any test data besides `-i test`, making it basically useless. So just use the X version instead. TODO why? Can we just remove it then? When running `splash2`, it says:
+
+    NOTE: SPLASH-2 only supports "test" input sets.
+
+so likely not a bug.
+
+The tests are distributed separately as:
+
+* `test` tests come with the smallest possible distribution `core`, and are tiny sanity checks as the name suggests. We have however removed them from this repo, since they are still blobs, and blobs are evil.
+* `sim*` tests require `parsec-3.0-input-sim.tar.gz` which we install by default
+* `native` requires `parsec-3.0-input-native.tar.gz`, which we don't install by default because it is huge. These huge instances are intended for real silicon.
+
+Run all packages with the default `test` input size:
+
+    parsecmgmt -a run -p all
+
+TODO some tests are broken. We will maintain a list.
 
-`sim*` tests require `parsec-3.0-input-sim.tar.gz` which we install by default, and `native` requires `parsec-3.0-input-native.tar.gz`, which we don't install by default.
+Not every benchmark has every input size, e.g. `splash2.barnes` only has `test` input inside of `core` and `input-sim`
 
 TODO runs all sizes, or just one default size:
 
-    parsecmgmt -a run -p splash2
+    parsecmgmt -a run -p splash2x
 
 TODO how to read run output?