rarias/ovni
rarias/ovni
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Add trace specification

Browse Source
This commit is contained in:
Rodrigo Arias 2022-07-18 16:26:24 +02:00
parent 6180235b50
commit 9820315ccb
4 changed files with 2885 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1112
doc/fig/event-jumbo.svg Normal file
View File

File diff suppressed because it is too large Load Diff
Side by Side

After

Width:  |  Height:  |  Size: 44 KiB

996
doc/fig/event-normal-payload.svg Normal file
View File

@ -0,0 +1,996 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- Created with Inkscape (http://www.inkscape.org/) -->
<svg
width="370"
height="360"
viewBox="0 0 97.895832 95.250003"
version="1.1"
id="svg5"
inkscape:version="1.2 (dc2aedaf03, 2022-05-15)"
sodipodi:docname="event-normal-payload.svg"
inkscape:export-filename="event-payload.png"
inkscape:export-xdpi="300"
inkscape:export-ydpi="300"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns="http://www.w3.org/2000/svg"
xmlns:svg="http://www.w3.org/2000/svg">
<sodipodi:namedview
id="namedview7"
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1.0"
inkscape:showpageshadow="2"
inkscape:pageopacity="0.0"
inkscape:pagecheckerboard="0"
inkscape:deskcolor="#d1d1d1"
inkscape:document-units="mm"
showgrid="true"
inkscape:zoom="2.0003685"
inkscape:cx="179.71689"
inkscape:cy="121.97753"
inkscape:window-width="954"
inkscape:window-height="1025"
inkscape:window-x="0"
inkscape:window-y="24"
inkscape:window-maximized="1"
inkscape:current-layer="layer1">
<inkscape:grid
type="xygrid"
id="grid126"
spacingx="2.6458333"
spacingy="2.6458333"
originx="-10.583333"
originy="-2.6458333"
empspacing="4" />
</sodipodi:namedview>
<defs
id="defs2" />
<g
inkscape:label="Layer 1"
inkscape:groupmode="layer"
id="layer1"
transform="translate(-10.583333,-2.6458333)">
<rect
style="fill:#ffffff;stroke:none;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.600001"
id="rect326"
width="97.895836"
height="95.25"
x="10.583333"
y="2.6458333" />
<rect
style="fill:#e6e6e6;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect2375"
width="84.666664"
height="5.2916665"
x="21.166666"
y="5.2916684" />
<rect
style="fill:#f6d5ff;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect1106"
width="10.583333"
height="10.583334"
x="21.166666"
y="21.166666" />
<rect
style="fill:#d5e5ff;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect1162"
width="10.583334"
height="10.583334"
x="31.749998"
y="21.166666" />
<rect
style="fill:#eef4d7;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect1102"
width="21.166668"
height="10.583334"
x="63.5"
y="21.166666" />
<rect
style="fill:#d5ffe6;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect1104"
width="21.166662"
height="10.583334"
x="84.666672"
y="21.166666" />
<rect
style="fill:#ffe6d5;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect2305"
width="84.666664"
height="10.583337"
x="21.166662"
y="42.33334" />
<rect
style="fill:#ffe6d5;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect1108"
width="84.666664"
height="10.583333"
x="21.166666"
y="31.750002" />
<rect
style="fill:#eeffaa;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect422"
width="21.166666"
height="10.583334"
x="42.333336"
y="21.166666" />
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="23.256979"
y="30.744894"
id="text346"><tspan
sodipodi:role="line"
id="tspan344"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="23.256979"
y="30.744894">Flags</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="34.483685"
y="30.951599"
id="text350"><tspan
sodipodi:role="line"
id="tspan348"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="34.483685"
y="30.951599">Size</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="47.357834"
y="30.832745"
id="text354"><tspan
sodipodi:role="line"
id="tspan352"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="47.357834"
y="30.832745">Model (O)</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="66.585602"
y="30.738176"
id="text358"><tspan
sodipodi:role="line"
id="tspan356"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="66.585602"
y="30.738176">Category (H)</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="89.706154"
y="30.832745"
id="text362"><tspan
sodipodi:role="line"
id="tspan360"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="89.706154"
y="30.832745">Value (x)</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="58.401604"
y="41.540619"
id="text366"><tspan
sodipodi:role="line"
id="tspan364"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="58.401604"
y="41.540619">Clock lo</tspan></text>
<rect
style="fill:#e6e6e6;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect2009"
width="21.166666"
height="7.937499"
x="21.166666"
y="10.583334" />
<rect
style="fill:#e6e6e6;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect2013"
width="21.166664"
height="7.937499"
x="42.333336"
y="10.583334" />
<rect
style="fill:#e6e6e6;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect2015"
width="21.166666"
height="7.937499"
x="63.5"
y="10.583334" />
<rect
style="fill:#e6e6e6;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect2017"
width="21.16666"
height="7.937499"
x="84.666672"
y="10.583334" />
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.175px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="30.794245"
y="14.38491"
id="text2087"><tspan
sodipodi:role="line"
id="tspan2085"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="30.794245"
y="14.38491">0</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.175px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="51.960911"
y="14.419791"
id="text2091"><tspan
sodipodi:role="line"
id="tspan2089"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="51.960911"
y="14.419791">1</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.175px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="73.127579"
y="14.419791"
id="text2095"><tspan
sodipodi:role="line"
id="tspan2093"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="73.127579"
y="14.419791">2</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.175px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="94.29425"
y="14.38491"
id="text2099"><tspan
sodipodi:role="line"
id="tspan2097"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="94.29425"
y="14.38491">3</tspan></text>
<text
xml:space="preserve"
style="font-size:2.82222px;line-height:1.25;font-family:cmr10;-inkscape-font-specification:cmr10;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="57.622669"
y="8.6726828"
id="text2155"><tspan
sodipodi:role="line"
id="tspan2153"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.82222px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="57.622669"
y="8.6726828">4 Bytes</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="25.183992"
y="27.999323"
id="text2179"><tspan
sodipodi:role="line"
id="tspan2177"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:4.23333px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="25.183992"
y="27.999323">0</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="35.741489"
y="28.066502"
id="text2183"><tspan
sodipodi:role="line"
id="tspan2181"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:4.23333px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="35.741489"
y="28.066502">f</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="46.346527"
y="28.00139"
id="text2207"><tspan
sodipodi:role="line"
id="tspan2205"
style="stroke-width:0.264583"
x="46.346527"
y="28.00139">4</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="56.908154"
y="28.066502"
id="text2211"><tspan
sodipodi:role="line"
id="tspan2209"
style="stroke-width:0.264583"
x="56.908154"
y="28.066502">f</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="67.513191"
y="28.00139"
id="text2215"><tspan
sodipodi:role="line"
id="tspan2213"
style="stroke-width:0.264583"
x="67.513191"
y="28.00139">4</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="78.100662"
y="27.999323"
id="text2219"><tspan
sodipodi:role="line"
id="tspan2217"
style="stroke-width:0.264583"
x="78.100662"
y="27.999323">8</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="88.699493"
y="28.00139"
id="text2223"><tspan
sodipodi:role="line"
id="tspan2221"
style="stroke-width:0.264583"
x="88.699493"
y="28.00139">7</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="99.267326"
y="27.999323"
id="text2227"><tspan
sodipodi:role="line"
id="tspan2225"
style="stroke-width:0.264583"
x="99.267326"
y="27.999323">8</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="25.226366"
y="38.582657"
id="text2231"><tspan
sodipodi:role="line"
id="tspan2229"
style="stroke-width:0.264583"
x="25.226366"
y="38.582657">5</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="35.692905"
y="38.582657"
id="text2235"><tspan
sodipodi:role="line"
id="tspan2233"
style="stroke-width:0.264583"
x="35.692905"
y="38.582657">8</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="46.326885"
y="38.582657"
id="text2239"><tspan
sodipodi:role="line"
id="tspan2237"
style="stroke-width:0.264583"
x="46.326885"
y="38.582657">c</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="57.004269"
y="38.582657"
id="text2243"><tspan
sodipodi:role="line"
id="tspan2241"
style="stroke-width:0.264583"
x="57.004269"
y="38.582657">1</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="67.442909"
y="38.582657"
id="text2247"><tspan
sodipodi:role="line"
id="tspan2245"
style="stroke-width:0.264583"
x="67.442909"
y="38.582657">b</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="78.100662"
y="38.582657"
id="text2251"><tspan
sodipodi:role="line"
id="tspan2249"
style="stroke-width:0.264583"
x="78.100662"
y="38.582657">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="88.609589"
y="38.582657"
id="text2255"><tspan
sodipodi:role="line"
id="tspan2253"
style="stroke-width:0.264583"
x="88.609589"
y="38.582657">b</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="99.289032"
y="38.582657"
id="text2259"><tspan
sodipodi:role="line"
id="tspan2257"
style="stroke-width:0.264583"
x="99.289032"
y="38.582657">5</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="58.403671"
y="52.123951"
id="text2303"><tspan
sodipodi:role="line"
id="tspan2301"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="58.403671"
y="52.123951">Clock hi</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="25.196384"
y="49.165989"
id="text2341"><tspan
sodipodi:role="line"
id="tspan2339"
style="stroke-width:0.264583"
x="25.196384"
y="49.165989">9</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="35.789024"
y="49.165989"
id="text2345"><tspan
sodipodi:role="line"
id="tspan2343"
style="stroke-width:0.264583"
x="35.789024"
y="49.165989">5</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="46.346519"
y="49.225933"
id="text2349"><tspan
sodipodi:role="line"
id="tspan2347"
style="stroke-width:0.264583"
x="46.346519"
y="49.225933">4</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="56.951561"
y="49.165989"
id="text2353"><tspan
sodipodi:role="line"
id="tspan2351"
style="stroke-width:0.264583"
x="56.951561"
y="49.165989">3</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="67.406746"
y="49.225933"
id="text2357"><tspan
sodipodi:role="line"
id="tspan2355"
style="stroke-width:0.264583"
x="67.406746"
y="49.225933">1</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="77.990059"
y="49.168056"
id="text2361"><tspan
sodipodi:role="line"
id="tspan2359"
style="stroke-width:0.264583"
x="77.990059"
y="49.168056">1</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="88.683998"
y="49.165989"
id="text2365"><tspan
sodipodi:role="line"
id="tspan2363"
style="stroke-width:0.264583"
x="88.683998"
y="49.165989">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="99.267326"
y="49.165989"
id="text2369"><tspan
sodipodi:role="line"
id="tspan2367"
style="stroke-width:0.264583"
x="99.267326"
y="49.165989">0</tspan></text>
<rect
style="fill:#e6e6e6;fill-opacity:1;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none;stroke-dashoffset:0"
id="rect2429"
width="5.2916656"
height="31.749998"
x="13.229167"
y="21.166666" />
<text
xml:space="preserve"
style="font-size:3.175px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="-42.821934"
y="17.058649"
id="text2433"
transform="rotate(-90)"><tspan
sodipodi:role="line"
id="tspan2431"
style="font-size:3.175px;stroke-width:0.264583"
x="-42.821934"
y="17.058649">Header</tspan></text>
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2161"
width="10.583333"
height="2.6458333"
x="21.166666"
y="15.875002" />
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2163"
width="10.583333"
height="2.6458333"
x="31.749998"
y="15.875002" />
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2165"
width="10.583333"
height="2.6458333"
x="42.333336"
y="15.875002" />
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2167"
width="10.583333"
height="2.6458333"
x="52.916664"
y="15.875002" />
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2169"
width="10.583333"
height="2.6458333"
x="63.5"
y="15.875002" />
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2171"
width="10.583333"
height="2.6458333"
x="74.083344"
y="15.875002" />
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2173"
width="10.583333"
height="2.6458333"
x="84.666672"
y="15.875002" />
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2175"
width="10.583333"
height="2.6458333"
x="95.25"
y="15.875002" />
<rect
style="fill:#ffaaaa;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect5890"
width="84.666664"
height="42.333336"
x="21.166666"
y="52.916664" />
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="25.184002"
y="59.749321"
id="text6672"><tspan
sodipodi:role="line"
id="tspan6670"
style="stroke-width:0.264583"
x="25.184002"
y="59.749321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="35.767338"
y="59.749321"
id="text6676"><tspan
sodipodi:role="line"
id="tspan6674"
style="stroke-width:0.264583"
x="35.767338"
y="59.749321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="46.35067"
y="59.749321"
id="text6680"><tspan
sodipodi:role="line"
id="tspan6678"
style="stroke-width:0.264583"
x="46.35067"
y="59.749321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="56.934002"
y="59.749321"
id="text6684"><tspan
sodipodi:role="line"
id="tspan6682"
style="stroke-width:0.264583"
x="56.934002"
y="59.749321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="67.517334"
y="59.749321"
id="text6688"><tspan
sodipodi:role="line"
id="tspan6686"
style="stroke-width:0.264583"
x="67.517334"
y="59.749321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="78.10067"
y="59.749321"
id="text6692"><tspan
sodipodi:role="line"
id="tspan6690"
style="stroke-width:0.264583"
x="78.10067"
y="59.749321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="88.684006"
y="59.749321"
id="text6696"><tspan
sodipodi:role="line"
id="tspan6694"
style="stroke-width:0.264583"
x="88.684006"
y="59.749321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="99.267326"
y="59.749321"
id="text6700"><tspan
sodipodi:role="line"
id="tspan6698"
style="stroke-width:0.264583"
x="99.267326"
y="59.749321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="25.183992"
y="70.332657"
id="text8882"><tspan
sodipodi:role="line"
id="tspan8880"
style="stroke-width:0.264583"
x="25.183992"
y="70.332657">f</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="35.76733"
y="70.332657"
id="text8886"><tspan
sodipodi:role="line"
id="tspan8884"
style="stroke-width:0.264583"
x="35.76733"
y="70.332657">f</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="46.350662"
y="70.332657"
id="text8890"><tspan
sodipodi:role="line"
id="tspan8888"
style="stroke-width:0.264583"
x="46.350662"
y="70.332657">f</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="56.933994"
y="70.332657"
id="text8894"><tspan
sodipodi:role="line"
id="tspan8892"
style="stroke-width:0.264583"
x="56.933994"
y="70.332657">f</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="67.517319"
y="70.332657"
id="text8898"><tspan
sodipodi:role="line"
id="tspan8896"
style="stroke-width:0.264583"
x="67.517319"
y="70.332657">f</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="78.100655"
y="70.332657"
id="text8902"><tspan
sodipodi:role="line"
id="tspan8900"
style="stroke-width:0.264583"
x="78.100655"
y="70.332657">f</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="88.68399"
y="70.332657"
id="text8906"><tspan
sodipodi:role="line"
id="tspan8904"
style="stroke-width:0.264583"
x="88.68399"
y="70.332657">f</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="99.267311"
y="70.332657"
id="text8910"><tspan
sodipodi:role="line"
id="tspan8908"
style="stroke-width:0.264583"
x="99.267311"
y="70.332657">f</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="25.184008"
y="80.915985"
id="text8914"><tspan
sodipodi:role="line"
id="tspan8912"
style="stroke-width:0.264583"
x="25.184008"
y="80.915985">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="35.767345"
y="80.915985"
id="text8918"><tspan
sodipodi:role="line"
id="tspan8916"
style="stroke-width:0.264583"
x="35.767345"
y="80.915985">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="46.350677"
y="80.915985"
id="text8922"><tspan
sodipodi:role="line"
id="tspan8920"
style="stroke-width:0.264583"
x="46.350677"
y="80.915985">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="56.93401"
y="80.915985"
id="text8926"><tspan
sodipodi:role="line"
id="tspan8924"
style="stroke-width:0.264583"
x="56.93401"
y="80.915985">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="67.517334"
y="80.915985"
id="text8930"><tspan
sodipodi:role="line"
id="tspan8928"
style="stroke-width:0.264583"
x="67.517334"
y="80.915985">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="78.10067"
y="80.915985"
id="text8934"><tspan
sodipodi:role="line"
id="tspan8932"
style="stroke-width:0.264583"
x="78.10067"
y="80.915985">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="88.684006"
y="80.915985"
id="text8938"><tspan
sodipodi:role="line"
id="tspan8936"
style="stroke-width:0.264583"
x="88.684006"
y="80.915985">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="99.267326"
y="80.915985"
id="text8942"><tspan
sodipodi:role="line"
id="tspan8940"
style="stroke-width:0.264583"
x="99.267326"
y="80.915985">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="25.184019"
y="91.499321"
id="text8946"><tspan
sodipodi:role="line"
id="tspan8944"
style="stroke-width:0.264583"
x="25.184019"
y="91.499321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="35.767357"
y="91.499321"
id="text8950"><tspan
sodipodi:role="line"
id="tspan8948"
style="stroke-width:0.264583"
x="35.767357"
y="91.499321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="46.350689"
y="91.499321"
id="text8954"><tspan
sodipodi:role="line"
id="tspan8952"
style="stroke-width:0.264583"
x="46.350689"
y="91.499321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="56.934021"
y="91.499321"
id="text8958"><tspan
sodipodi:role="line"
id="tspan8956"
style="stroke-width:0.264583"
x="56.934021"
y="91.499321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="67.517342"
y="91.499321"
id="text8962"><tspan
sodipodi:role="line"
id="tspan8960"
style="stroke-width:0.264583"
x="67.517342"
y="91.499321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="78.100677"
y="91.499321"
id="text8966"><tspan
sodipodi:role="line"
id="tspan8964"
style="stroke-width:0.264583"
x="78.100677"
y="91.499321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="88.684013"
y="91.499321"
id="text8970"><tspan
sodipodi:role="line"
id="tspan8968"
style="stroke-width:0.264583"
x="88.684013"
y="91.499321">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="99.267326"
y="91.499321"
id="text8974"><tspan
sodipodi:role="line"
id="tspan8972"
style="stroke-width:0.264583"
x="99.267326"
y="91.499321">0</tspan></text>
<rect
style="fill:#e6e6e6;fill-opacity:1;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none;stroke-dashoffset:0"
id="rect8976"
width="5.291666"
height="42.333336"
x="13.229167"
y="52.916664" />
<text
xml:space="preserve"
style="font-size:3.175px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="-80.778275"
y="16.759441"
id="text8980"
transform="rotate(-90)"><tspan
sodipodi:role="line"
id="tspan8978"
style="font-size:3.175px;stroke-width:0.264583"
x="-80.778275"
y="16.759441">Payload</tspan></text>
</g>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 40 KiB

618
doc/fig/event-normal.svg Normal file
View File

@ -0,0 +1,618 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- Created with Inkscape (http://www.inkscape.org/) -->
<svg
width="370"
height="200"
viewBox="0 0 97.895832 52.916669"
version="1.1"
id="svg5"
inkscape:version="1.2 (dc2aedaf03, 2022-05-15)"
sodipodi:docname="event-normal.svg"
inkscape:export-filename="event-payload.png"
inkscape:export-xdpi="300"
inkscape:export-ydpi="300"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns="http://www.w3.org/2000/svg"
xmlns:svg="http://www.w3.org/2000/svg">
<sodipodi:namedview
id="namedview7"
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1.0"
inkscape:showpageshadow="2"
inkscape:pageopacity="0.0"
inkscape:pagecheckerboard="0"
inkscape:deskcolor="#d1d1d1"
inkscape:document-units="mm"
showgrid="true"
inkscape:zoom="2.0003685"
inkscape:cx="189.71505"
inkscape:cy="152.47191"
inkscape:window-width="954"
inkscape:window-height="1025"
inkscape:window-x="0"
inkscape:window-y="24"
inkscape:window-maximized="1"
inkscape:current-layer="layer1">
<inkscape:grid
type="xygrid"
id="grid126"
spacingx="2.6458333"
spacingy="2.6458333"
originx="-10.583333"
originy="-2.6458334"
empspacing="4" />
</sodipodi:namedview>
<defs
id="defs2" />
<g
inkscape:label="Layer 1"
inkscape:groupmode="layer"
id="layer1"
transform="translate(-10.583333,-2.6458333)">
<rect
style="fill:#ffffff;stroke:none;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.600001"
id="rect326"
width="97.895836"
height="52.916668"
x="10.583333"
y="2.6458333" />
<rect
style="fill:#e6e6e6;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect2375"
width="84.666664"
height="5.2916665"
x="21.166666"
y="5.2916684" />
<rect
style="fill:#f6d5ff;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect1106"
width="10.583333"
height="10.583334"
x="21.166666"
y="21.166666" />
<rect
style="fill:#d5e5ff;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect1162"
width="10.583334"
height="10.583334"
x="31.749998"
y="21.166666" />
<rect
style="fill:#eef4d7;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect1102"
width="21.166668"
height="10.583334"
x="63.5"
y="21.166666" />
<rect
style="fill:#d5ffe6;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect1104"
width="21.166662"
height="10.583334"
x="84.666672"
y="21.166666" />
<rect
style="fill:#ffe6d5;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect2305"
width="84.666664"
height="10.583337"
x="21.166662"
y="42.33334" />
<rect
style="fill:#ffe6d5;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect1108"
width="84.666664"
height="10.583333"
x="21.166666"
y="31.750002" />
<rect
style="fill:#eeffaa;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect422"
width="21.166666"
height="10.583334"
x="42.333336"
y="21.166666" />
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="23.256979"
y="30.744894"
id="text346"><tspan
sodipodi:role="line"
id="tspan344"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="23.256979"
y="30.744894">Flags</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="34.483685"
y="30.951599"
id="text350"><tspan
sodipodi:role="line"
id="tspan348"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="34.483685"
y="30.951599">Size</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="47.357834"
y="30.832745"
id="text354"><tspan
sodipodi:role="line"
id="tspan352"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="47.357834"
y="30.832745">Model (O)</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="66.585602"
y="30.738176"
id="text358"><tspan
sodipodi:role="line"
id="tspan356"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="66.585602"
y="30.738176">Category (H)</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="89.706154"
y="30.832745"
id="text362"><tspan
sodipodi:role="line"
id="tspan360"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="89.706154"
y="30.832745">Value (e)</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="58.401604"
y="41.540619"
id="text366"><tspan
sodipodi:role="line"
id="tspan364"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="58.401604"
y="41.540619">Clock lo</tspan></text>
<rect
style="fill:#e6e6e6;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect2009"
width="21.166666"
height="7.937499"
x="21.166666"
y="10.583334" />
<rect
style="fill:#e6e6e6;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect2013"
width="21.166664"
height="7.937499"
x="42.333336"
y="10.583334" />
<rect
style="fill:#e6e6e6;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect2015"
width="21.166666"
height="7.937499"
x="63.5"
y="10.583334" />
<rect
style="fill:#e6e6e6;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none"
id="rect2017"
width="21.16666"
height="7.937499"
x="84.666672"
y="10.583334" />
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.175px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="30.794245"
y="14.38491"
id="text2087"><tspan
sodipodi:role="line"
id="tspan2085"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="30.794245"
y="14.38491">0</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.175px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="51.960911"
y="14.419791"
id="text2091"><tspan
sodipodi:role="line"
id="tspan2089"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="51.960911"
y="14.419791">1</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.175px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="73.127579"
y="14.419791"
id="text2095"><tspan
sodipodi:role="line"
id="tspan2093"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="73.127579"
y="14.419791">2</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:3.175px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="94.29425"
y="14.38491"
id="text2099"><tspan
sodipodi:role="line"
id="tspan2097"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="94.29425"
y="14.38491">3</tspan></text>
<text
xml:space="preserve"
style="font-size:2.82222px;line-height:1.25;font-family:cmr10;-inkscape-font-specification:cmr10;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="57.622669"
y="8.6726828"
id="text2155"><tspan
sodipodi:role="line"
id="tspan2153"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.82222px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="57.622669"
y="8.6726828">4 Bytes</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="25.183992"
y="27.999323"
id="text2179"><tspan
sodipodi:role="line"
id="tspan2177"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:4.23333px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="25.183992"
y="27.999323">0</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="35.741489"
y="28.066502"
id="text2183"><tspan
sodipodi:role="line"
id="tspan2181"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:4.23333px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="35.741489"
y="28.066502">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="46.346527"
y="28.00139"
id="text2207"><tspan
sodipodi:role="line"
id="tspan2205"
style="stroke-width:0.264583"
x="46.346527"
y="28.00139">4</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="56.908154"
y="28.066502"
id="text2211"><tspan
sodipodi:role="line"
id="tspan2209"
style="stroke-width:0.264583"
x="56.908154"
y="28.066502">f</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="67.513191"
y="28.00139"
id="text2215"><tspan
sodipodi:role="line"
id="tspan2213"
style="stroke-width:0.264583"
x="67.513191"
y="28.00139">4</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="78.100662"
y="27.999323"
id="text2219"><tspan
sodipodi:role="line"
id="tspan2217"
style="stroke-width:0.264583"
x="78.100662"
y="27.999323">8</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="88.699493"
y="28.00139"
id="text2223"><tspan
sodipodi:role="line"
id="tspan2221"
style="stroke-width:0.264583"
x="88.699493"
y="28.00139">6</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="99.267326"
y="27.999323"
id="text2227"><tspan
sodipodi:role="line"
id="tspan2225"
style="stroke-width:0.264583"
x="99.267326"
y="27.999323">5</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="25.226366"
y="38.582657"
id="text2231"><tspan
sodipodi:role="line"
id="tspan2229"
style="stroke-width:0.264583"
x="25.226366"
y="38.582657">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="35.692905"
y="38.582657"
id="text2235"><tspan
sodipodi:role="line"
id="tspan2233"
style="stroke-width:0.264583"
x="35.692905"
y="38.582657">1</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="46.326885"
y="38.582657"
id="text2239"><tspan
sodipodi:role="line"
id="tspan2237"
style="stroke-width:0.264583"
x="46.326885"
y="38.582657">c</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="57.004269"
y="38.582657"
id="text2243"><tspan
sodipodi:role="line"
id="tspan2241"
style="stroke-width:0.264583"
x="57.004269"
y="38.582657">5</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="67.442909"
y="38.582657"
id="text2247"><tspan
sodipodi:role="line"
id="tspan2245"
style="stroke-width:0.264583"
x="67.442909"
y="38.582657">c</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="78.100662"
y="38.582657"
id="text2251"><tspan
sodipodi:role="line"
id="tspan2249"
style="stroke-width:0.264583"
x="78.100662"
y="38.582657">f</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="88.609589"
y="38.582657"
id="text2255"><tspan
sodipodi:role="line"
id="tspan2253"
style="stroke-width:0.264583"
x="88.609589"
y="38.582657">1</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="99.289032"
y="38.582657"
id="text2259"><tspan
sodipodi:role="line"
id="tspan2257"
style="stroke-width:0.264583"
x="99.289032"
y="38.582657">d</tspan></text>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="58.403671"
y="52.123951"
id="text2303"><tspan
sodipodi:role="line"
id="tspan2301"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:2.11667px;font-family:monospace;-inkscape-font-specification:monospace;stroke-width:0.264583"
x="58.403671"
y="52.123951">Clock hi</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="25.196384"
y="49.165989"
id="text2341"><tspan
sodipodi:role="line"
id="tspan2339"
style="stroke-width:0.264583"
x="25.196384"
y="49.165989">9</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="35.789024"
y="49.165989"
id="text2345"><tspan
sodipodi:role="line"
id="tspan2343"
style="stroke-width:0.264583"
x="35.789024"
y="49.165989">6</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="46.346519"
y="49.225933"
id="text2349"><tspan
sodipodi:role="line"
id="tspan2347"
style="stroke-width:0.264583"
x="46.346519"
y="49.225933">d</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="56.951561"
y="49.165989"
id="text2353"><tspan
sodipodi:role="line"
id="tspan2351"
style="stroke-width:0.264583"
x="56.951561"
y="49.165989">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="67.406746"
y="49.225933"
id="text2357"><tspan
sodipodi:role="line"
id="tspan2355"
style="stroke-width:0.264583"
x="67.406746"
y="49.225933">1</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="77.990059"
y="49.168056"
id="text2361"><tspan
sodipodi:role="line"
id="tspan2359"
style="stroke-width:0.264583"
x="77.990059"
y="49.168056">2</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="88.683998"
y="49.165989"
id="text2365"><tspan
sodipodi:role="line"
id="tspan2363"
style="stroke-width:0.264583"
x="88.683998"
y="49.165989">0</tspan></text>
<text
xml:space="preserve"
style="font-size:4.23333px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="99.267326"
y="49.165989"
id="text2369"><tspan
sodipodi:role="line"
id="tspan2367"
style="stroke-width:0.264583"
x="99.267326"
y="49.165989">0</tspan></text>
<rect
style="fill:#e6e6e6;fill-opacity:1;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:none;stroke-dashoffset:0"
id="rect2429"
width="5.2916656"
height="31.749998"
x="13.229167"
y="21.166666" />
<text
xml:space="preserve"
style="font-size:3.175px;line-height:1.25;font-family:monospace;-inkscape-font-specification:monospace;letter-spacing:0px;word-spacing:0px;stroke-width:0.264583"
x="-42.821934"
y="17.058649"
id="text2433"
transform="rotate(-90)"><tspan
sodipodi:role="line"
id="tspan2431"
style="font-size:3.175px;stroke-width:0.264583"
x="-42.821934"
y="17.058649">Header</tspan></text>
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2161"
width="10.583333"
height="2.6458333"
x="21.166666"
y="15.875002" />
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2163"
width="10.583333"
height="2.6458333"
x="31.749998"
y="15.875002" />
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2165"
width="10.583333"
height="2.6458333"
x="42.333336"
y="15.875002" />
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2167"
width="10.583333"
height="2.6458333"
x="52.916664"
y="15.875002" />
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2169"
width="10.583333"
height="2.6458333"
x="63.5"
y="15.875002" />
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2171"
width="10.583333"
height="2.6458333"
x="74.083344"
y="15.875002" />
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2173"
width="10.583333"
height="2.6458333"
x="84.666672"
y="15.875002" />
<rect
style="fill:none;stroke:#000000;stroke-width:0.2;stroke-linecap:round;stroke-dasharray:0.2, 0.6;stroke-dashoffset:0"
id="rect2175"
width="10.583333"
height="2.6458333"
x="95.25"
y="15.875002" />
</g>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 26 KiB

159
doc/trace_spec.md Normal file
View File

@ -0,0 +1,159 @@
# Trace specification version 1
The ovni instrumentation library produces a trace with the following
specification.
The complete trace is stored in a top-level directory named "ovni".
Inside this directory you will find the loom directories with the prefix
`loom.`. The name of the loom is built from the `loom` parameter of
`ovni_proc_init()`, prefixing it with `loom.`.
Each loom directory contains one directory per process of that loom. The
name is composed of the `proc.` prefix and the PID of the process
specified in the `pid` argument to `ovni_proc_init()`.
Each process directory contains:
- The metadata file `metadata.json`.
- The thread traces with prefix `thread.`.
## Process metadata
The metadata file contains important information about the trace that is
invariant during the complete execution, and generally is required to be
available prior to processing the events in the trace.
The metadata is stored in the JSON file `metadata.json` inside each
process directory and contains the following keys:
- `version`: a number specifying the version of the metadata format.
- `app_id`: the application ID, used to distinguish between applications
running on the same loom.
- `rank`: the rank of the MPI process (optional).
- `nranks`: number of total MPI processes (optional).
- `cpus`: the array of $`N_c`$ CPUs available in the loom. Only one
process in the loom must contain this mandatory key. Each element is a
dictionary with the keys:
- `index`: containing the logical CPU index from 0 to $`N_c - 1`$.
- `phyid`: the number of the CPU as given by the operating system
(which can exceed $`N_c`$).
## Thread trace
The thread trace is a binary file composed of events joined one after
the other. Each event has a header with the following information:
- Event flags
- Payload size in a special format
- Model, category and value codes
- Time in nanoseconds
- Payload (optional)
The payload size is specified using 4 bits, with the value `0x0` for no
payload, or with value $`v`$ for $`v + 1`$ bytes of payload. This
allows us to use 16 bytes of payload with value `0xf` at the cost of
sacrificing payloads of one byte.
There are two types of events, depending of the size needed for the
payload:
- Normal: with a payload up to 16 bytes
- Jumbo: with a payload up to 2^32 bytes
## Normal events
The normal events are composed of:
- 4 bits of flags
- 4 bits of payload size
- 3 bytes for the MCV
- 8 bytes for the clock
- 0 to 16 bytes of payload
Here is an example of a normal event without payload, a total of 12
bytes:
```
% dd if=thread.552943 skip=5258 bs=1 | hexdump -C
00000000 00 4f 48 65 01 c5 cf 1d 96 d0 12 00 |.OHe........|
```
And in the following figure you can see every field annotated:
<img src="fig/event-normal.svg" alt="Normal event without payload" width="400px"/>
Another example of a normal event with 16 bytes of payload, a total of
28 bytes as reported by hexdump:
```
% dd if=thread.552943 bs=1 count=28 | hexdump -C
00000000 0f 4f 48 78 58 c1 b0 b5 95 43 11 00 00 00 00 00 |.OHxX....C......|
00000010 ff ff ff ff 00 00 00 00 00 00 00 00 |............|
```
In the following figure you can see each field annotated:
<img src="fig/event-normal-payload.svg" alt="Normal event with payload content" width="400px"/>
## Jumbo events
The jumbo events are just like normal events but they can hold large
data. The size of the jumbo data is stored as a 32 bits integer as a
normal payload, and the jumbo data just follows the event.
- 4 bits of flags
- 4 bits of payload size (always 4 with value 0x3)
- 3 bytes for the MCV
- 8 bytes for the clock
- 4 bytes of payload with the size of the jumbo data
- 0 to 2^32 bytes of jumbo data
Example of a jumbo event of 30 bytes in total, with 14 bytes of jumbo
data:
```
00000000 13 56 59 63 eb c1 4b 1a 96 d0 12 00 0e 00 00 00 |.VYc..K.........|
00000010 01 00 00 00 74 65 73 74 74 79 70 65 31 00 |....testtype1.|
```
In the following figure you can see each field annotated:
<img src="fig/event-jumbo.svg" alt="Jumbo event" width="400px"/>
## Design considerations
The trace format has been designed to be very simple, so writing a
parser library would take no more than 2 days.
The common events don't use any payload, so the size per event is kept
at the minimum of 12 bytes.
**Important:** The events are stored in disk following the endianness of
the machine where they are generated. So a trace generated with a little
endian machine would be different than on a big endian machine. Using
the same endiannes avoids the cost of serialization when writting the
trace at runtime.
The events are designed to be easily identified when looking at the
raw trace in binary, as the MCV codes can be read as ASCII characters:
```
00000000 0f 4f 48 78 58 c1 b0 b5 95 43 11 00 00 00 00 00 |.OHxX....C......|
00000010 ff ff ff ff 00 00 00 00 00 00 00 00 00 36 53 72 |.............6Sr|
00000020 ab cb b0 b5 95 43 11 00 00 36 53 73 78 c3 b9 b5 |.....C...6Ssx...|
00000030 95 43 11 00 00 36 53 40 87 a4 c2 b5 95 43 11 00 |.C...6S@.....C..|
00000040 00 36 53 68 9c 4b cb b5 95 43 11 00 00 36 53 66 |.6Sh.K...C...6Sf|
00000050 85 44 d4 b5 95 43 11 00 00 36 53 5b cb e7 dc b5 |.D...C...6S[....|
00000060 95 43 11 00 00 36 53 5d cf ca e5 b5 95 43 11 00 |.C...6S].....C..|
00000070 00 36 53 75 8c db ee b5 95 43 11 00 00 36 53 55 |.6Su.....C...6SU|
00000080 5a 70 f8 b5 95 43 11 00 00 36 55 5b 1b ae 01 b6 |Zp...C...6U[....|
00000090 95 43 11 00 00 36 55 5d aa 19 0b b6 95 43 11 00 |.C...6U].....C..|
```
This allows a human to detect signs of corruption by just visually
inspecting the trace.
## Limitations
The traces are designed to be read only forward, as they only contain
the size of each event in the header.