Skip to content

Commit

Permalink
Update multicore-bench doc for main
Browse files Browse the repository at this point in the history
  • Loading branch information
polytypic committed Oct 18, 2024
1 parent 199cd1f commit 982ef8f
Show file tree
Hide file tree
Showing 14 changed files with 3,019 additions and 12 deletions.
4 changes: 3 additions & 1 deletion doc/multicore-bench/Multicore_bench/Cmd/index.html
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>Cmd (multicore-bench.Multicore_bench.Cmd)</title><meta charset="utf-8"/><link rel="stylesheet" href="../../../odoc.support/odoc.css"/><meta name="generator" content="odoc 2.4.3"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../../odoc.support/highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a><a href="../../index.html">multicore-bench</a> &#x00BB; <a href="../index.html">Multicore_bench</a> &#x00BB; Cmd</nav><header class="odoc-preamble"><h1>Module <code><span>Multicore_bench.Cmd</span></code></h1><p>Command line interface for a benchmark executable.</p></header><div class="odoc-content"><div class="odoc-spec"><div class="spec type anchored" id="type-output"><a href="#type-output" class="anchor"></a><code><span><span class="keyword">type</span> output</span><span> = </span><span>[ </span></code><ol><li id="type-output.JSON" class="def variant constructor anchored"><a href="#type-output.JSON" class="anchor"></a><code><span>| </span><span>`JSON</span></code><div class="def-doc"><span class="comment-delim">(*</span><p><code>`JSON</code> gives the JSON output for <a href="https://github.com/ocurrent/current-bench">current-bench</a>.</p><span class="comment-delim">*)</span></div></li><li id="type-output.Brief" class="def variant constructor anchored"><a href="#type-output.Brief" class="anchor"></a><code><span>| </span><span>`Brief</span></code><div class="def-doc"><span class="comment-delim">(*</span><p><code>`Brief</code> gives concise human readable output.</p><span class="comment-delim">*)</span></div></li><li id="type-output.Diff" class="def variant constructor anchored"><a href="#type-output.Diff" class="anchor"></a><code><span>| </span><span>`Diff <span class="keyword">of</span> string</span></code><div class="def-doc"><span class="comment-delim">(*</span><p><code>`Diff &quot;path.json&quot;</code> gives concise human readable diff against results stored in specified <code>path.json</code> file.</p><span class="comment-delim">*)</span></div></li></ol><code><span> ]</span></code></div><div class="spec-doc"><p>Specifies the output format.</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-run"><a href="#val-run" class="anchor"></a><code><span><span class="keyword">val</span> run :
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>Cmd (multicore-bench.Multicore_bench.Cmd)</title><meta charset="utf-8"/><link rel="stylesheet" href="../../../odoc.support/odoc.css"/><meta name="generator" content="odoc 2.4.3"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../../odoc.support/highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script><script>let base_url = '../../../';
let search_urls = ['../../db.js','../../../sherlodoc.js'];
</script><script src="../../../odoc.support/odoc_search.js" defer="defer"></script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a><a href="../../index.html">multicore-bench</a> &#x00BB; <a href="../index.html">Multicore_bench</a> &#x00BB; Cmd</nav><div class="odoc-search"><div class="search-inner"><input class="search-bar" placeholder="🔎 Search..."/><div class="search-snake"></div><div class="search-result"></div></div></div><header class="odoc-preamble"><h1>Module <code><span>Multicore_bench.Cmd</span></code></h1><p>Command line interface for a benchmark executable.</p></header><div class="odoc-content"><div class="odoc-spec"><div class="spec type anchored" id="type-output"><a href="#type-output" class="anchor"></a><code><span><span class="keyword">type</span> output</span><span> = </span><span>[ </span></code><ol><li id="type-output.JSON" class="def variant constructor anchored"><a href="#type-output.JSON" class="anchor"></a><code><span>| </span><span>`JSON</span></code><div class="def-doc"><span class="comment-delim">(*</span><p><code>`JSON</code> gives the JSON output for <a href="https://github.com/ocurrent/current-bench">current-bench</a>.</p><span class="comment-delim">*)</span></div></li><li id="type-output.Brief" class="def variant constructor anchored"><a href="#type-output.Brief" class="anchor"></a><code><span>| </span><span>`Brief</span></code><div class="def-doc"><span class="comment-delim">(*</span><p><code>`Brief</code> gives concise human readable output.</p><span class="comment-delim">*)</span></div></li><li id="type-output.Diff" class="def variant constructor anchored"><a href="#type-output.Diff" class="anchor"></a><code><span>| </span><span>`Diff <span class="keyword">of</span> string</span></code><div class="def-doc"><span class="comment-delim">(*</span><p><code>`Diff &quot;path.json&quot;</code> gives concise human readable diff against results stored in specified <code>path.json</code> file.</p><span class="comment-delim">*)</span></div></li></ol><code><span> ]</span></code></div><div class="spec-doc"><p>Specifies the output format.</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-run"><a href="#val-run" class="anchor"></a><code><span><span class="keyword">val</span> run :
<span><span class="label">benchmarks</span>:<span><span>(string * <a href="../Suite/index.html#type-t">Suite.t</a>)</span> list</span> <span class="arrow">&#45;&gt;</span></span>
<span><span class="optlabel">?budgetf</span>:float <span class="arrow">&#45;&gt;</span></span>
<span><span class="optlabel">?filters</span>:<span>string list</span> <span class="arrow">&#45;&gt;</span></span>
Expand Down
4 changes: 3 additions & 1 deletion doc/multicore-bench/Multicore_bench/Countdown/index.html
Original file line number Diff line number Diff line change
@@ -1,2 +1,4 @@
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>Countdown (multicore-bench.Multicore_bench.Countdown)</title><meta charset="utf-8"/><link rel="stylesheet" href="../../../odoc.support/odoc.css"/><meta name="generator" content="odoc 2.4.3"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../../odoc.support/highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a><a href="../../index.html">multicore-bench</a> &#x00BB; <a href="../index.html">Multicore_bench</a> &#x00BB; Countdown</nav><header class="odoc-preamble"><h1>Module <code><span>Multicore_bench.Countdown</span></code></h1><p>Scalable low-level countdown.</p></header><div class="odoc-content"><div class="odoc-spec"><div class="spec type anchored" id="type-t"><a href="#type-t" class="anchor"></a><code><span><span class="keyword">type</span> t</span></code></div><div class="spec-doc"><p>Represents a countdown counter.</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-create"><a href="#val-create" class="anchor"></a><code><span><span class="keyword">val</span> create : <span><span class="label">n_domains</span>:int <span class="arrow">&#45;&gt;</span></span> <span>unit <span class="arrow">&#45;&gt;</span></span> <a href="#type-t">t</a></span></code></div><div class="spec-doc"><p><code>create ~n_domains ()</code> returns a new countdown counter with initial value of <code>0</code>.</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-non_atomic_set"><a href="#val-non_atomic_set" class="anchor"></a><code><span><span class="keyword">val</span> non_atomic_set : <span><a href="#type-t">t</a> <span class="arrow">&#45;&gt;</span></span> <span>int <span class="arrow">&#45;&gt;</span></span> unit</span></code></div><div class="spec-doc"><p><code>non_atomic_set countdown count</code> sets the <code>count</code> of the <code>countdown</code>.</p><p>⚠️ This operation is not atomic. However, it is safe to call <code>non_atomic_set</code> with the same <code>countdown</code> and <code>count</code> in parallel, because the <code>countdown</code> will be initialized deterministically.</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-get"><a href="#val-get" class="anchor"></a><code><span><span class="keyword">val</span> get : <span><a href="#type-t">t</a> <span class="arrow">&#45;&gt;</span></span> int</span></code></div><div class="spec-doc"><p><code>get countdown</code> returns the count of the <code>countdown</code>.</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-alloc"><a href="#val-alloc" class="anchor"></a><code><span><span class="keyword">val</span> alloc : <span><a href="#type-t">t</a> <span class="arrow">&#45;&gt;</span></span> <span><span class="label">domain_index</span>:int <span class="arrow">&#45;&gt;</span></span> <span><span class="label">batch</span>:int <span class="arrow">&#45;&gt;</span></span> int</span></code></div><div class="spec-doc"><p><code>alloc countdown ~domain_index ~batch</code> tries to reduce the count of the <code>countdown</code> by at most <code>batch</code> (which must be positive) and returns the number by which the count was reduced or <code>0</code> in case the count was already <code>0</code>.</p></div></div></div></body></html>
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>Countdown (multicore-bench.Multicore_bench.Countdown)</title><meta charset="utf-8"/><link rel="stylesheet" href="../../../odoc.support/odoc.css"/><meta name="generator" content="odoc 2.4.3"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../../odoc.support/highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script><script>let base_url = '../../../';
let search_urls = ['../../db.js','../../../sherlodoc.js'];
</script><script src="../../../odoc.support/odoc_search.js" defer="defer"></script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a><a href="../../index.html">multicore-bench</a> &#x00BB; <a href="../index.html">Multicore_bench</a> &#x00BB; Countdown</nav><div class="odoc-search"><div class="search-inner"><input class="search-bar" placeholder="🔎 Search..."/><div class="search-snake"></div><div class="search-result"></div></div></div><header class="odoc-preamble"><h1>Module <code><span>Multicore_bench.Countdown</span></code></h1><p>Scalable low-level countdown.</p></header><div class="odoc-content"><div class="odoc-spec"><div class="spec type anchored" id="type-t"><a href="#type-t" class="anchor"></a><code><span><span class="keyword">type</span> t</span></code></div><div class="spec-doc"><p>Represents a countdown counter.</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-create"><a href="#val-create" class="anchor"></a><code><span><span class="keyword">val</span> create : <span><span class="label">n_domains</span>:int <span class="arrow">&#45;&gt;</span></span> <span>unit <span class="arrow">&#45;&gt;</span></span> <a href="#type-t">t</a></span></code></div><div class="spec-doc"><p><code>create ~n_domains ()</code> returns a new countdown counter with initial value of <code>0</code>.</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-non_atomic_set"><a href="#val-non_atomic_set" class="anchor"></a><code><span><span class="keyword">val</span> non_atomic_set : <span><a href="#type-t">t</a> <span class="arrow">&#45;&gt;</span></span> <span>int <span class="arrow">&#45;&gt;</span></span> unit</span></code></div><div class="spec-doc"><p><code>non_atomic_set countdown count</code> sets the <code>count</code> of the <code>countdown</code>.</p><p>⚠️ This operation is not atomic. However, it is safe to call <code>non_atomic_set</code> with the same <code>countdown</code> and <code>count</code> in parallel, because the <code>countdown</code> will be initialized deterministically.</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-get"><a href="#val-get" class="anchor"></a><code><span><span class="keyword">val</span> get : <span><a href="#type-t">t</a> <span class="arrow">&#45;&gt;</span></span> int</span></code></div><div class="spec-doc"><p><code>get countdown</code> returns the count of the <code>countdown</code>.</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-alloc"><a href="#val-alloc" class="anchor"></a><code><span><span class="keyword">val</span> alloc : <span><a href="#type-t">t</a> <span class="arrow">&#45;&gt;</span></span> <span><span class="label">domain_index</span>:int <span class="arrow">&#45;&gt;</span></span> <span><span class="label">batch</span>:int <span class="arrow">&#45;&gt;</span></span> int</span></code></div><div class="spec-doc"><p><code>alloc countdown ~domain_index ~batch</code> tries to reduce the count of the <code>countdown</code> by at most <code>batch</code> (which must be positive) and returns the number by which the count was reduced or <code>0</code> in case the count was already <code>0</code>.</p></div></div></div></body></html>
4 changes: 3 additions & 1 deletion doc/multicore-bench/Multicore_bench/Metric/index.html
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>Metric (multicore-bench.Multicore_bench.Metric)</title><meta charset="utf-8"/><link rel="stylesheet" href="../../../odoc.support/odoc.css"/><meta name="generator" content="odoc 2.4.3"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../../odoc.support/highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a><a href="../../index.html">multicore-bench</a> &#x00BB; <a href="../index.html">Multicore_bench</a> &#x00BB; Metric</nav><header class="odoc-preamble"><h1>Module <code><span>Multicore_bench.Metric</span></code></h1><p>Dealing with benchmark metrics.</p></header><div class="odoc-content"><div class="odoc-spec"><div class="spec type anchored" id="type-t"><a href="#type-t" class="anchor"></a><code><span><span class="keyword">type</span> t</span></code></div><div class="spec-doc"><p>Represents a metric.</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-make"><a href="#val-make" class="anchor"></a><code><span><span class="keyword">val</span> make :
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>Metric (multicore-bench.Multicore_bench.Metric)</title><meta charset="utf-8"/><link rel="stylesheet" href="../../../odoc.support/odoc.css"/><meta name="generator" content="odoc 2.4.3"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../../odoc.support/highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script><script>let base_url = '../../../';
let search_urls = ['../../db.js','../../../sherlodoc.js'];
</script><script src="../../../odoc.support/odoc_search.js" defer="defer"></script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a><a href="../../index.html">multicore-bench</a> &#x00BB; <a href="../index.html">Multicore_bench</a> &#x00BB; Metric</nav><div class="odoc-search"><div class="search-inner"><input class="search-bar" placeholder="🔎 Search..."/><div class="search-snake"></div><div class="search-result"></div></div></div><header class="odoc-preamble"><h1>Module <code><span>Multicore_bench.Metric</span></code></h1><p>Dealing with benchmark metrics.</p></header><div class="odoc-content"><div class="odoc-spec"><div class="spec type anchored" id="type-t"><a href="#type-t" class="anchor"></a><code><span><span class="keyword">type</span> t</span></code></div><div class="spec-doc"><p>Represents a metric.</p></div></div><div class="odoc-spec"><div class="spec value anchored" id="val-make"><a href="#val-make" class="anchor"></a><code><span><span class="keyword">val</span> make :
<span><span class="label">metric</span>:string <span class="arrow">&#45;&gt;</span></span>
<span><span class="label">config</span>:string <span class="arrow">&#45;&gt;</span></span>
<span><span class="optlabel">?units</span>:string <span class="arrow">&#45;&gt;</span></span>
Expand Down
4 changes: 3 additions & 1 deletion doc/multicore-bench/Multicore_bench/Suite/index.html
Original file line number Diff line number Diff line change
@@ -1,2 +1,4 @@
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>Suite (multicore-bench.Multicore_bench.Suite)</title><meta charset="utf-8"/><link rel="stylesheet" href="../../../odoc.support/odoc.css"/><meta name="generator" content="odoc 2.4.3"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../../odoc.support/highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a><a href="../../index.html">multicore-bench</a> &#x00BB; <a href="../index.html">Multicore_bench</a> &#x00BB; Suite</nav><header class="odoc-preamble"><h1>Module <code><span>Multicore_bench.Suite</span></code></h1><p>Dealing with benchmark suites.</p></header><div class="odoc-content"><div class="odoc-spec"><div class="spec type anchored" id="type-t"><a href="#type-t" class="anchor"></a><code><span><span class="keyword">type</span> t</span><span> = <span><span class="label">budgetf</span>:float <span class="arrow">&#45;&gt;</span></span> <span><a href="../Metric/index.html#type-t">Metric.t</a> list</span></span></code></div><div class="spec-doc"><p>Represents a benchmark suite, i.e. a function that produces a list of metric outputs for <a href="https://github.com/ocurrent/current-bench">current-bench</a>.</p></div></div></div></body></html>
<html xmlns="http://www.w3.org/1999/xhtml"><head><title>Suite (multicore-bench.Multicore_bench.Suite)</title><meta charset="utf-8"/><link rel="stylesheet" href="../../../odoc.support/odoc.css"/><meta name="generator" content="odoc 2.4.3"/><meta name="viewport" content="width=device-width,initial-scale=1.0"/><script src="../../../odoc.support/highlight.pack.js"></script><script>hljs.initHighlightingOnLoad();</script><script>let base_url = '../../../';
let search_urls = ['../../db.js','../../../sherlodoc.js'];
</script><script src="../../../odoc.support/odoc_search.js" defer="defer"></script></head><body class="odoc"><nav class="odoc-nav"><a href="../index.html">Up</a><a href="../../index.html">multicore-bench</a> &#x00BB; <a href="../index.html">Multicore_bench</a> &#x00BB; Suite</nav><div class="odoc-search"><div class="search-inner"><input class="search-bar" placeholder="🔎 Search..."/><div class="search-snake"></div><div class="search-result"></div></div></div><header class="odoc-preamble"><h1>Module <code><span>Multicore_bench.Suite</span></code></h1><p>Dealing with benchmark suites.</p></header><div class="odoc-content"><div class="odoc-spec"><div class="spec type anchored" id="type-t"><a href="#type-t" class="anchor"></a><code><span><span class="keyword">type</span> t</span><span> = <span><span class="label">budgetf</span>:float <span class="arrow">&#45;&gt;</span></span> <span><a href="../Metric/index.html#type-t">Metric.t</a> list</span></span></code></div><div class="spec-doc"><p>Represents a benchmark suite, i.e. a function that produces a list of metric outputs for <a href="https://github.com/ocurrent/current-bench">current-bench</a>.</p></div></div></div></body></html>
Loading

0 comments on commit 982ef8f

Please sign in to comment.