Changes between Version 10 and Version 11 of Building/RunningNoFib

Timestamp:

04/02/10 09:22:55 (3 years ago)

Author:

batterseapower

Comment:

Move stuff from the other wiki page I added to here

Building/RunningNoFib

@@ -3 +3 @@
 = The !NoFib Benchmark Suite =
 
-The !NoFib benchmark suite is a collection of (mostly old) Haskell programs that we use for benchmarking GHC.  The !NoFib suite is kept in a separate darcs repository (see DarcsRepositories), and it should be checked out at the top level of a GHC source tree, i.e. at the same level as `compiler` and `libraries`.
+The !NoFib benchmark suite is a collection of (mostly old) Haskell programs that we use for benchmarking GHC. 
+
+== Getting nofib ==
+The !NoFib suite is kept in a separate darcs repository (see DarcsRepositories), and it should be checked out at the top level of a GHC source tree, i.e. at the same level as `compiler` and `libraries`. From your GHC tree, run:
+
+{{{
+./darc-all --nofib get
+}}}
+
+It will be pulled into the a "nofib" subdirectory.
+
+== Benchmarking ==
 
 To run the tests:
@@ -38 +49 @@
 }}}
 
+== Complete recipe ==
+
+{{{
+cd nofib
+make clean && make boot && make -k >& log1
+make clean && make boot && make -k EXTRA_HC_OPTS=-fenable-cool-optimisation >& log2
+nofib-analyse/nofib-analyse log1 log2
+}}}
+
+The output of the nofib-analyse tool is quite readable, with two provisios:
+  * Missing values in the output typically mean that the benchmark crashed and may indicate a problem with your optimisation
+  * If a difference between the two modes is displayed as an absolute quantity instead of a percentage, it means that the difference was below the threshold at which the analyser considers it significant
+
+If the comparison identifies any particularly bad benchmark results, you can run them individually by changing into their directory and running something like:
+
+{{{
+EXTRA_HC_OPTS="-fenable-cool-optimisation -ddump-simpl" make
+}}}
+
+You can add whatever dumping flags you need to see the output and understand what is going wrong.
+
 == Tweaking things ==