From 5d0f1573c2573cb46b502f5819d91d1388d6dc03 Mon Sep 17 00:00:00 2001 From: Martin Quinson Date: Mon, 23 Jan 2023 00:11:22 +0100 Subject: [PATCH] Another example gets documented (+cosmetics) --- docs/source/Models.rst | 4 ++++ examples/README.rst | 9 +++++++++ include/simgrid/s4u/Actor.hpp | 6 +++--- 3 files changed, 16 insertions(+), 3 deletions(-) diff --git a/docs/source/Models.rst b/docs/source/Models.rst index d53b16eaf9..ac3f0587ff 100644 --- a/docs/source/Models.rst +++ b/docs/source/Models.rst @@ -202,6 +202,8 @@ seconds but For more details, please refer to "Accuracy study and improvement of network simulation in the SimGrid framework" by Arnaud Legrand and Pedro Velho. +.. _models_l07: + Parallel tasks (L07) ******************** @@ -210,6 +212,8 @@ This is because this model is intended to be used for parallel tasks that are ac Max-Min objective function requires that all variables are expressed using the same unit. This is also why in reality, we have one LMM system per resource kind in the simulation, but the idea remains similar. +Use the :ref:`relevant configuration ` to select this model in your simulation. + .. _models_wifi: WiFi zones diff --git a/examples/README.rst b/examples/README.rst index c7a55a2c73..cc3559548b 100644 --- a/examples/README.rst +++ b/examples/README.rst @@ -678,6 +678,15 @@ This example illustrates how to simply read and write data on a simulated disk r This shows how to declare disks in XML. +Asynchronous raw accesses +^^^^^^^^^^^^^^^^^^^^^^^^^ + +As most other activities, raw IO accesses can be used asynchronously, as illustrated in this example. + +.. tabs:: + + .. example-tab:: examples/cpp/io-async/s4u-io-async.cpp + Filesystem plugin ^^^^^^^^^^^^^^^^^ diff --git a/include/simgrid/s4u/Actor.hpp b/include/simgrid/s4u/Actor.hpp index de7a22e978..acdcafe1c8 100644 --- a/include/simgrid/s4u/Actor.hpp +++ b/include/simgrid/s4u/Actor.hpp @@ -101,16 +101,16 @@ XBT_PUBLIC void execute(double flop, double priority); * * These objects are somewhat surprising from a modeling point of view. For example, the unit of their speed is * somewhere between flop/sec and byte/sec. Arbitrary parallel executions will simply not work with the usual platform - * models, and you must :ref:`use the ptask_L07 host model ` for that. Note that you can mix + * models, and you must :ref:`use the ptask_L07 host model ` for that. Note that you can mix * regular executions and communications with parallel executions, provided that the host model is ptask_L07. * * @endrst */ -/** Block the current actor until the built parallel execution completes */ +/** Block the current actor until the built parallel execution completes. */ XBT_PUBLIC void parallel_execute(const std::vector& hosts, const std::vector& flops_amounts, const std::vector& bytes_amounts); -/** Block the current actor until the built multi-thread execution completes */ +/** Block the current actor until the built multi-thread execution completes. */ XBT_PUBLIC void thread_execute(s4u::Host* host, double flop_amounts, int thread_count); /** Initialize a sequential execution that must then be started manually */ -- 2.20.1