Skip to content
GitLab
Menu
Projects
Groups
Snippets
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
Menu
Open sidebar
ycai
simbricks
Commits
93f7be10
Commit
93f7be10
authored
May 07, 2024
by
Jonas Kaufmann
Committed by
Antoine Kaufmann
May 08, 2024
Browse files
doc/orchestration.rst: rework section on synchronization
parent
205d2215
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
14 additions
and
15 deletions
+14
-15
doc/user/orchestration.rst
doc/user/orchestration.rst
+14
-15
No files found.
doc/user/orchestration.rst
View file @
93f7be10
...
...
@@ -130,23 +130,22 @@ guest system and the value is an IO handle of the file to be copied over.
:members: run_cmds, config_files
*******************************
S
ynchronized vs.
Uns
ynchronized
Uns
ynchronized vs.
S
ynchronized
*******************************
For most component simulators in your experiment, you can decide whether to run
them synchronized or unsynchronized by setting
:attr:`~simbricks.orchestration.simulators.PCIDevSim.sync_mode` or
:attr:`~simbricks.orchestration.simulators.QemuHost.sync`. By default, all
simulators run unsynchronized to simulate as fast as possible. When you are
conducting measurements, however, you need to run synchronized, or you won't get
meaningful performance numbers.
Running synchronized means that a simulator waits to process incoming messages
from connected simulators at the correct timestamps. For technical details, see
:ref:`sec-synchronization`. In contrast, unsynchronized lets a simulator advance
its virtual time as fast as it can. It still handles and exchanges messages with
connected simulators, but it won't wait for incoming messages and instead
advances its virtual time when there's nothing available to process.
SimBricks offers two modes of operation, unsynchronized and synchronized, which
are defined on a per component basis. The default is the unsynchronized mode
that is meant purely for functional testing. Unsynchronized components advance
virtual time as quickly as they possibly can, which means that measurements
taken on them are meaningless and cross-component measurements inaccurate.
The synchronized mode, in contrast, is meant for accurate measurements and has
to be enabled per component, for example, by setting
:attr:`simbricks.orchestration.simulators.PCIDevSim.sync_mode` or
:attr:`simbricks.orchestration.simulators.HostSim.sync_mode`. Running
synchronized means that a simulator waits to process incoming messages from
connected simulators at the correct timestamps. For technical details, see
:ref:`sec-synchronization`.
***************************************
Link Latency and Synchronization Period
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment