Commit 93f7be10 authored by Jonas Kaufmann's avatar Jonas Kaufmann Committed by Antoine Kaufmann
Browse files

doc/orchestration.rst: rework section on synchronization

parent 205d2215
...@@ -130,23 +130,22 @@ guest system and the value is an IO handle of the file to be copied over. ...@@ -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 :members: run_cmds, config_files
******************************* *******************************
Synchronized vs. Unsynchronized Unsynchronized vs. Synchronized
******************************* *******************************
For most component simulators in your experiment, you can decide whether to run SimBricks offers two modes of operation, unsynchronized and synchronized, which
them synchronized or unsynchronized by setting are defined on a per component basis. The default is the unsynchronized mode
:attr:`~simbricks.orchestration.simulators.PCIDevSim.sync_mode` or that is meant purely for functional testing. Unsynchronized components advance
:attr:`~simbricks.orchestration.simulators.QemuHost.sync`. By default, all virtual time as quickly as they possibly can, which means that measurements
simulators run unsynchronized to simulate as fast as possible. When you are taken on them are meaningless and cross-component measurements inaccurate.
conducting measurements, however, you need to run synchronized, or you won't get
meaningful performance numbers. The synchronized mode, in contrast, is meant for accurate measurements and has
to be enabled per component, for example, by setting
Running synchronized means that a simulator waits to process incoming messages :attr:`simbricks.orchestration.simulators.PCIDevSim.sync_mode` or
from connected simulators at the correct timestamps. For technical details, see :attr:`simbricks.orchestration.simulators.HostSim.sync_mode`. Running
:ref:`sec-synchronization`. In contrast, unsynchronized lets a simulator advance synchronized means that a simulator waits to process incoming messages from
its virtual time as fast as it can. It still handles and exchanges messages with connected simulators at the correct timestamps. For technical details, see
connected simulators, but it won't wait for incoming messages and instead :ref:`sec-synchronization`.
advances its virtual time when there's nothing available to process.
*************************************** ***************************************
Link Latency and Synchronization Period Link Latency and Synchronization Period
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment