[pypy-svn] r58594 - pypy/build/doc

[hpk at codespeak.net]

Author: hpk
Date: Sat Oct  4 13:39:54 2008
New Revision: 58594

Modified:
   pypy/build/doc/benchmark_memory.txt
Log:
some info on current benchmarking tools. 



Modified: pypy/build/doc/benchmark_memory.txt
==============================================================================
--- pypy/build/doc/benchmark_memory.txt	(original)
+++ pypy/build/doc/benchmark_memory.txt	Sat Oct  4 13:39:54 2008
@@ -4,11 +4,7 @@
 
 $Id$
 
-XXX this is a draft incomplete document
-XXX next step is to lay out and write
-XXX the benchmarking infrastructure and
-XXX to incrementally complete and update
-XXX the document
+XXX draft XXX
 
 what we want to measure
 ===============================================
@@ -178,7 +174,7 @@
 
 Let's see what changes if we do::
 
-    >>> l = ["xasd"] * 1000000"
+    >>> l = ["xasd"] * 1000000
 
 we get this new mapping in the python process:: 
 
@@ -293,8 +289,6 @@
 http://maemo.org/development/tools/doc/diablo/sp-smaps-measure/
 http://maemo.org/development/tools/doc/diablo/sp-memusage/
 
-XXX discuss and write toolchain
-
 Exmap can be used to see very useful statistics about processes
 including very precise shared RSS figures. It can also show
 whether a specific symbol is mapped into the RAM but this
@@ -307,6 +301,24 @@
 of patches for more precise page mapping information by
 matt mackall
 
+runbench.py / report.py 
+++++++++++++++++++++++++++++++++
+
+At http://codespeak.net/svn/pypy/build/benchmem there 
+are linux scripts to measure memory usage of benchmarks 
+and generating a report from the results: 
+
+* runbench.py runs the benchamrks in the ``benchmark``
+  directory and writes information about memory usage 
+  into ``bench.log``. One can specify multiple Python
+  Intepreters for execution of the benchmarks. 
+
+* report.py takes a bench.log and generates a textual report. 
+
+Current benchmarks: 
+
+* ``sizes.py``: a number of benchmarks to create different 
+  python objects 
 
 Considerations about static memory usage
 ----------------------------------------