From 6cee149e4ad8077a5c4db40ed591232dfaff1224 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Christophe=20Thi=C3=A9ry?= Date: Tue, 24 Jan 2012 10:34:08 +0100 Subject: [PATCH 1/1] Document the new option --cfg=surf/nthreads --- ChangeLog | 2 ++ doc/options.doc | 10 ++++++++++ 2 files changed, 12 insertions(+) diff --git a/ChangeLog b/ChangeLog index 619d33bfef..9e289b3121 100644 --- a/ChangeLog +++ b/ChangeLog @@ -31,6 +31,8 @@ SimGrid (3.7) NOT RELEASED; urgency=low * Use now crosstraffic keyword instead of the terribly missleading fullduplex keyword. It is activated by default now in the current default model, use --cfg=network/crosstraffic:0 to turn it off. + * Experimental: new configuration option --cfg=surf/nthreads:N to run + analytical models in parallel with N threads (default is 1). * Ongoing refactoring the model parsing to make XML files optional (more work is needed here to fully achieve this goal) diff --git a/doc/options.doc b/doc/options.doc index 66c9c9c3a9..9d1f81aeed 100644 --- a/doc/options.doc +++ b/doc/options.doc @@ -163,6 +163,14 @@ the \b maxmin/precision item (default value: 1e-9). Changing it may speedup the simulation by discarding very small actions, at the price of a reduced numerical precision. +\subsection options_model_nthreads Parallel threads for model updates + +By default, Surf computes the analytical models sequentially to share their +resources and update their actions. It is possible to run them in parallel, +using the \b surf/nthreads item (default value: 1). +Depending on the workload of the models and their complexity, you may get a +speedup or a slowdown because of the synchronization costs of threads. + \subsection options_model_network Configuring the Network model \subsubsection options_model_network_gamma Maximal TCP window size @@ -467,6 +475,8 @@ when \b verbose-exit is set to 0 (it is to 1 by default). - \c ns3/TcpModel: \ref options_pls +- \c surf/nthreads: \ref options_model_nthreads + - \c smpi/running_power: \ref options_smpi_bench - \c smpi/display_timing: \ref options_smpi_timing - \c smpi/cpu_threshold: \ref options_smpi_bench -- 2.20.1