Skip to content

Commit 6ebc9a5

Browse files
committed
deploy: 69b948f
1 parent 0c67854 commit 6ebc9a5

File tree

9 files changed

+112
-112
lines changed

9 files changed

+112
-112
lines changed

commands/runbms.html

+3-3
Original file line numberDiff line numberDiff line change
@@ -184,7 +184,7 @@ <h2 id="usage"><a class="header" href="#usage">Usage</a></h2>
184184
<p><code>-s</code>: only use the specified heap sizes.
185185
This is a comma-separated string of integers or floating point numbers.
186186
For each slice <code>s</code> in <code>SLICE</code>, we run benchmarks at <code>s * minheap</code>.
187-
<code>N</code> and <code>n</code>s are ignored. </p>
187+
<code>N</code> and <code>n</code>s are ignored.</p>
188188
<p><code>-p</code>: add a prefix to the folder names where the results are stored.
189189
By default, the folder that stores the result is named using the host name and the timestamp.
190190
However, you can add a prefix to the folder name to signify which experiments the results belong to.</p>
@@ -230,7 +230,7 @@ <h3 id="zulip"><a class="header" href="#zulip"><code>Zulip</code></a></h3>
230230
type: Zulip
231231
request:
232232
type: private
233-
to: [&quot;your user id here&quot;]
233+
to: ["your user id here"]
234234
</code></pre>
235235
<h4 id="keys-1"><a class="header" href="#keys-1">Keys</a></h4>
236236
<p><code>request</code>: please follow the <a href="https://zulip.com/api/send-message">Zulip API documentation</a>.
@@ -250,7 +250,7 @@ <h3 id="copyfile"><a class="header" href="#copyfile"><code>CopyFile</code></a></
250250
dacapo_latency:
251251
type: CopyFile
252252
patterns:
253-
- &quot;scratch/dacapo-latency-*.csv&quot;
253+
- "scratch/dacapo-latency-*.csv"
254254
</code></pre>
255255
<h4 id="keys-2"><a class="header" href="#keys-2">Keys</a></h4>
256256
<p><code>patterns</code>: a list of patterns following the Python 3 <code>pathlib.Path.glob</code> <a href="https://docs.python.org/3/library/pathlib.html#pathlib.Path.glob">syntax</a>.

cookbook/perf_events.html

+12-12
Original file line numberDiff line numberDiff line change
@@ -185,39 +185,39 @@ <h2 id="jvmti"><a class="header" href="#jvmti">JVMTI</a></h2>
185185
<pre><code class="language-yaml">modifiers:
186186
jvmti_env:
187187
type: EnvVar
188-
var: &quot;LD_PRELOAD&quot;
189-
val: &quot;/path/to/distillation/libperf_statistics.so&quot;
188+
var: "LD_PRELOAD"
189+
val: "/path/to/distillation/libperf_statistics.so"
190190
</code></pre>
191191
<p>Second, you need to specify a list of events you want to measure.</p>
192192
<pre><code class="language-yaml">modifiers:
193193
perf:
194194
type: EnvVar
195-
var: &quot;PERF_EVENTS&quot;
196-
val: &quot;PERF_COUNT_HW_CPU_CYCLES,PERF_COUNT_HW_INSTRUCTIONS,PERF_COUNT_HW_CACHE_LL:MISS,PERF_COUNT_HW_CACHE_L1D:MISS,PERF_COUNT_HW_CACHE_DTLB:MISS&quot;
195+
var: "PERF_EVENTS"
196+
val: "PERF_COUNT_HW_CPU_CYCLES,PERF_COUNT_HW_INSTRUCTIONS,PERF_COUNT_HW_CACHE_LL:MISS,PERF_COUNT_HW_CACHE_L1D:MISS,PERF_COUNT_HW_CACHE_DTLB:MISS"
197197
</code></pre>
198198
<p>If you want to get a full list of events you can use on a particular machine, you can clone and build <a href="https://sourceforge.net/p/perfmon2/libpfm4/ci/master/tree/"><code>libpfm4</code></a> and run the <code>showevtinfo</code> <a href="https://sourceforge.net/p/perfmon2/libpfm4/ci/master/tree/examples/showevtinfo.c">program</a>.</p>
199199
<p>Third, you need to tell the JVM to load the agent.
200200
Note that you need to specify the absolute path.</p>
201201
<pre><code class="language-yaml">modifiers:
202202
jvmti:
203203
type: JVMArg
204-
val: &quot;-agentpath:/path/to/distillation/libperf_statistics.so&quot;
204+
val: "-agentpath:/path/to/distillation/libperf_statistics.so"
205205
</code></pre>
206206
<p>Finally, you need to let the DaCapo benchmark inform the start and the end of a benchmark iteration.
207207
We will reuse the <code>RustMMTk</code> probe here, as the callback functions in the JVMTI agent are also called <code>harness_begin</code> and <code>harness_end</code>.</p>
208208
<pre><code class="language-yaml">modifiers:
209209
probes_cp:
210210
type: JVMClasspath
211-
val: &quot;/path/to/probes/out /path/to/probes/out/probes.jar&quot;
211+
val: "/path/to/probes/out /path/to/probes/out/probes.jar"
212212
probes:
213213
type: JVMArg
214-
val: &quot;-Djava.library.path=/path/to/probes/out -Dprobes=RustMMTk&quot;
214+
val: "-Djava.library.path=/path/to/probes/out -Dprobes=RustMMTk"
215215
</code></pre>
216216
<p>Now, putting it all together, you can define a set of modifiers, and use that set in your config strings.</p>
217217
<pre><code class="language-yaml">modifiers:
218218
jvmti_common:
219219
type: ModifierSet
220-
val: &quot;probes|probes_cp|jvmti|jvmti_env|perf&quot;
220+
val: "probes|probes_cp|jvmti|jvmti_env|perf"
221221
</code></pre>
222222
<h2 id="mmtk"><a class="header" href="#mmtk">MMTk</a></h2>
223223
<p>Please clone and build <a href="../quickstart.html#prepare-probes"><code>probes</code></a>.
@@ -226,17 +226,17 @@ <h2 id="mmtk"><a class="header" href="#mmtk">MMTk</a></h2>
226226
<pre><code class="language-yaml">modifiers:
227227
probes_cp:
228228
type: JVMClasspath
229-
val: &quot;/path/to/probes/out /path/to/probes/out/probes.jar&quot;
229+
val: "/path/to/probes/out /path/to/probes/out/probes.jar"
230230
probes:
231231
type: JVMArg
232-
val: &quot;-Djava.library.path=/path/to/probes/out -Dprobes=RustMMTk&quot;
232+
val: "-Djava.library.path=/path/to/probes/out -Dprobes=RustMMTk"
233233
</code></pre>
234234
<p>Then, you can specify a list of events you want to measure.</p>
235235
<pre><code class="language-yaml">modifiers:
236236
mmtk_perf:
237237
type: EnvVar
238-
var: &quot;MMTK_PHASE_PERF_EVENTS&quot;
239-
val: &quot;PERF_COUNT_HW_CPU_CYCLES,0,-1;PERF_COUNT_HW_INSTRUCTIONS,0,-1;PERF_COUNT_HW_CACHE_LL:MISS,0,-1;PERF_COUNT_HW_CACHE_L1D:MISS,0,-1;PERF_COUNT_HW_CACHE_DTLB:MISS,0,-1&quot;
238+
var: "MMTK_PHASE_PERF_EVENTS"
239+
val: "PERF_COUNT_HW_CPU_CYCLES,0,-1;PERF_COUNT_HW_INSTRUCTIONS,0,-1;PERF_COUNT_HW_CACHE_LL:MISS,0,-1;PERF_COUNT_HW_CACHE_L1D:MISS,0,-1;PERF_COUNT_HW_CACHE_DTLB:MISS,0,-1"
240240
</code></pre>
241241
<p>Note that the list is semicolon-separated.
242242
Each entry consists of three parts, separated by commas.

index.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -178,7 +178,7 @@ <h1 id="introduction"><a class="header" href="#introduction">Introduction</a></h
178178
<h2 id="disclaimer"><a class="header" href="#disclaimer">Disclaimer</a></h2>
179179
<p>At this stage, the focus of this project is driven by the internal use of members from <a href="https://users.cecs.anu.edu.au/~steveb/">Steve Blackburn</a>'s lab.
180180
If you are a member of the lab, you know what to do if you encounter any issue, and you can ignore the below.</p>
181-
<p>If you are a member of the public, please kindly note that the project is open-source and documented on a &quot;good-faith&quot; basis.
181+
<p>If you are a member of the public, please kindly note that the project is open-source and documented on a "good-faith" basis.
182182
We might not have the time to consider your features requests.
183183
Please don't be offended if we ignore these.
184184
Having said that, you are very welcomed to use it, and we will be very pleased if this helps anyone.

intro.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -178,7 +178,7 @@ <h1 id="introduction"><a class="header" href="#introduction">Introduction</a></h
178178
<h2 id="disclaimer"><a class="header" href="#disclaimer">Disclaimer</a></h2>
179179
<p>At this stage, the focus of this project is driven by the internal use of members from <a href="https://users.cecs.anu.edu.au/~steveb/">Steve Blackburn</a>'s lab.
180180
If you are a member of the lab, you know what to do if you encounter any issue, and you can ignore the below.</p>
181-
<p>If you are a member of the public, please kindly note that the project is open-source and documented on a &quot;good-faith&quot; basis.
181+
<p>If you are a member of the public, please kindly note that the project is open-source and documented on a "good-faith" basis.
182182
We might not have the time to consider your features requests.
183183
Please don't be offended if we ignore these.
184184
Having said that, you are very welcomed to use it, and we will be very pleased if this helps anyone.

0 commit comments

Comments
 (0)