Skip to content

Commit 8cc7284

Browse files
committed
describe our benchmarking command
1 parent ebcdd02 commit 8cc7284

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

docs/contributor/CONTRIBUTING.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -167,3 +167,29 @@ following command. This will create a native executable called `graalpython` and
167167
print its path as the last output, if successful.
168168

169169
mx python-svm
170+
171+
### Benchmarking
172+
173+
We use the `mx` facilities for benchmarking. Use this to list the available
174+
Python suites and VM configurations:
175+
176+
mx benchmark --list
177+
178+
If you just want to run a single benchmark from, for example, the `meso` suite,
179+
you can use this:
180+
181+
mx benchmark meso --list
182+
183+
Then if you want to run something, use (for example):
184+
185+
mx benchmark meso:nbody3
186+
187+
To select which Python VM you want to use, you can pass the arguments separated
188+
by `--`:
189+
190+
mx benchmark meso:nbody3 -- --python-vm=cpython
191+
192+
For additional arguments to the Python launcher, you can separate them by
193+
another double-dash:
194+
195+
mx benchmark meso:nbody3 -- --python-vm=graalpython -- --python.EmulateJython -Dgraal.Dump= -Dgraal.MethodFilter=*measure*

0 commit comments

Comments
 (0)