memory gets properly reclaimed. This call should be at the end of the
actor's function, not in an on_exit callback.
+===============================
+Communicating without Mailboxes
+===============================
+
+Sometimes you don't want to simulate communications between actors as
+allowed by mailboxes, but you want to create a direct communication
+between two arbitrary hosts. This can arise when you write a
+high-level model of a centralized scheduler, or when you model direct
+communications such as one-sided communications in MPI or remote
+memory direct access in PGAS.
+
+For that, :cpp:func:`Comm::sendto() <simgrid::s4u::Comm::sendto()>`
+simulates a direct communication between the two specified hosts. No
+mailbox is used, and there is no rendezvous between actors. You can
+freely mix such direct communications and rendezvous-based
+communications. Alternatively, :cpp:func:`Comm::sendto_init()
+<simgrid::s4u::Comm::sendto_init()>` and
+:cpp:func:`Comm::sendto_async() <simgrid::s4u::Comm::sendto_async()>`
+create asynchronous direct communications.
+
.. _s4u_raii:
Memory Management
class Actor
==============
-.. autodoxyclass:: simgrid::s4u::Actor
+.. doxygenclass:: simgrid::s4u::Actor
.. doxygentypedef:: aid_t
from simgrid import Actor
+ .. autoclass:: simgrid.Actor
+
.. group-tab:: C
.. code:: C
#include <simgrid/actor.h>
.. doxygentypedef:: sg_actor_t
- .. cpp:type:: const s4u_Actor* const_sg_actor_t
+ .. doxygentypedef:: const_sg_actor_t
+ .. doxygenfunction:: sg_actor_ref
+ .. doxygenfunction:: sg_actor_unref
- Pointer to a constant actor object.
-
- .. autodoxymethod:: sg_actor_ref(const_sg_actor_t actor)
- .. autodoxymethod:: sg_actor_unref(const_sg_actor_t actor)
Creating actors
---------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, const std::function< void()> &code)
- .. autodoxymethod:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, F code)
- .. autodoxymethod:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, F code, Args... args)
- .. autodoxymethod:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, const std::string &function, std::vector< std::string > args)
+ .. doxygenfunction:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, const std::function< void()> &code)
+ .. doxygenfunction:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, F code)
+ .. doxygenfunction:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, F code, Args... args)
+ .. doxygenfunction:: simgrid::s4u::Actor::create(const std::string &name, s4u::Host *host, const std::string &function, std::vector< std::string > args)
- .. autodoxymethod:: simgrid::s4u::Actor::init(const std::string &name, s4u::Host *host)
- .. autodoxymethod:: simgrid::s4u::Actor::start(const std::function< void()> &code)
+ .. doxygenfunction:: simgrid::s4u::Actor::init(const std::string &name, s4u::Host *host)
+ .. doxygenfunction:: simgrid::s4u::Actor::start(const std::function< void()> &code)
+ .. doxygenfunction:: simgrid::s4u::Actor::set_stacksize
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: sg_actor_create(const char *name, sg_host_t host, xbt_main_func_t code, int argc, const char *const *argv)
- .. autodoxymethod:: sg_actor_init(const char *name, sg_host_t host)
- .. autodoxymethod:: sg_actor_start(sg_actor_t actor, xbt_main_func_t code, int argc, const char *const *argv)
+ .. doxygenfunction:: sg_actor_create(const char *name, sg_host_t host, xbt_main_func_t code, int argc, char *const *argv)
+ .. doxygenfunction:: sg_actor_init(const char *name, sg_host_t host)
+ .. doxygenfunction:: sg_actor_start(sg_actor_t actor, xbt_main_func_t code, int argc, char *const *argv)
+ .. doxygenfunction:: sg_actor_set_stacksize
- .. autodoxymethod:: sg_actor_attach(const char *name, void *data, sg_host_t host, xbt_dict_t properties)
- .. autodoxymethod:: sg_actor_detach()
+ .. doxygenfunction:: sg_actor_attach(const char *name, void *data, sg_host_t host, xbt_dict_t properties)
+ .. doxygenfunction:: sg_actor_detach()
Retrieving actors
-----------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Actor::by_pid(aid_t pid)
- .. autodoxymethod:: simgrid::s4u::Actor::self()
+ .. doxygenfunction:: simgrid::s4u::Actor::by_pid(aid_t pid)
+ .. doxygenfunction:: simgrid::s4u::Actor::self()
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: sg_actor_by_PID(aid_t pid)
- .. autodoxymethod:: sg_actor_self()
+ .. doxygenfunction:: sg_actor_by_pid(aid_t pid)
+ .. doxygenfunction:: sg_actor_self()
Querying info
-------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Actor::get_cname
- .. autodoxymethod:: simgrid::s4u::Actor::get_name
- .. autodoxymethod:: simgrid::s4u::Actor::get_pid
- .. autodoxymethod:: simgrid::s4u::Actor::get_ppid
- .. autodoxymethod:: simgrid::s4u::Actor::get_properties() const
- .. autodoxymethod:: simgrid::s4u::Actor::get_property(const std::string &key) const
- .. autodoxymethod:: simgrid::s4u::Actor::set_property(const std::string &key, const std::string &value)
+ .. doxygenfunction:: simgrid::s4u::Actor::get_cname
+ .. doxygenfunction:: simgrid::s4u::Actor::get_name
+ .. doxygenfunction:: simgrid::s4u::Actor::get_pid
+ .. doxygenfunction:: simgrid::s4u::Actor::get_ppid
+ .. doxygenfunction:: simgrid::s4u::Actor::get_properties() const
+ .. doxygenfunction:: simgrid::s4u::Actor::get_property(const std::string &key) const
+ .. doxygenfunction:: simgrid::s4u::Actor::set_property(const std::string &key, const std::string &value)
- .. autodoxymethod:: simgrid::s4u::Actor::get_host
- .. autodoxymethod:: simgrid::s4u::Actor::set_host
+ .. doxygenfunction:: simgrid::s4u::Actor::get_host
+ .. doxygenfunction:: simgrid::s4u::Actor::set_host
- .. autodoxymethod:: simgrid::s4u::Actor::get_refcount
- .. autodoxymethod:: simgrid::s4u::Actor::get_impl
+ .. doxygenfunction:: simgrid::s4u::Actor::get_refcount
+ .. doxygenfunction:: simgrid::s4u::Actor::get_impl
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: sg_actor_get_name(const_sg_actor_t actor)
- .. autodoxymethod:: sg_actor_get_PID(const_sg_actor_t actor)
- .. autodoxymethod:: sg_actor_get_PPID(const_sg_actor_t actor)
- .. autodoxymethod:: sg_actor_get_properties(const_sg_actor_t actor)
- .. autodoxymethod:: sg_actor_get_property_value(const_sg_actor_t actor, const char *name)
+ .. doxygenfunction:: sg_actor_get_name(const_sg_actor_t actor)
+ .. doxygenfunction:: sg_actor_get_pid(const_sg_actor_t actor)
+ .. doxygenfunction:: sg_actor_get_ppid(const_sg_actor_t actor)
+ .. doxygenfunction:: sg_actor_get_properties(const_sg_actor_t actor)
+ .. doxygenfunction:: sg_actor_get_property_value(const_sg_actor_t actor, const char *name)
- .. autodoxymethod:: sg_actor_get_host(const_sg_actor_t actor)
- .. autodoxymethod:: sg_actor_set_host(sg_actor_t actor, sg_host_t host)
+ .. doxygenfunction:: sg_actor_get_host(const_sg_actor_t actor)
+ .. doxygenfunction:: sg_actor_set_host(sg_actor_t actor, sg_host_t host)
- .. autodoxymethod:: sg_actor_get_data(const_sg_actor_t actor)
- .. autodoxymethod:: sg_actor_set_data(sg_actor_t actor, void *userdata)
+ .. doxygenfunction:: sg_actor_get_data(const_sg_actor_t actor)
+ .. doxygenfunction:: sg_actor_set_data(sg_actor_t actor, void *userdata)
Suspending and resuming actors
------------------------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Actor::suspend()
- .. autodoxymethod:: simgrid::s4u::Actor::resume()
- .. autodoxymethod:: simgrid::s4u::Actor::is_suspended
+ .. doxygenfunction:: simgrid::s4u::Actor::suspend()
+ .. doxygenfunction:: simgrid::s4u::Actor::resume()
+ .. doxygenfunction:: simgrid::s4u::Actor::is_suspended
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: sg_actor_suspend(sg_actor_t actor)
- .. autodoxymethod:: sg_actor_resume(sg_actor_t actor)
- .. autodoxymethod:: sg_actor_is_suspended(const_sg_actor_t actor)
+ .. doxygenfunction:: sg_actor_suspend(sg_actor_t actor)
+ .. doxygenfunction:: sg_actor_resume(sg_actor_t actor)
+ .. doxygenfunction:: sg_actor_is_suspended(const_sg_actor_t actor)
Specifying when actors should terminate
---------------------------------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Actor::kill()
- .. autodoxymethod:: simgrid::s4u::Actor::kill_all()
- .. autodoxymethod:: simgrid::s4u::Actor::set_kill_time(double time)
- .. autodoxymethod:: simgrid::s4u::Actor::get_kill_time
+ .. doxygenfunction:: simgrid::s4u::Actor::kill()
+ .. doxygenfunction:: simgrid::s4u::Actor::kill_all()
+ .. doxygenfunction:: simgrid::s4u::Actor::set_kill_time(double time)
+ .. doxygenfunction:: simgrid::s4u::Actor::get_kill_time
- .. autodoxymethod:: simgrid::s4u::Actor::restart()
- .. autodoxymethod:: simgrid::s4u::Actor::daemonize()
- .. autodoxymethod:: simgrid::s4u::Actor::is_daemon
+ .. doxygenfunction:: simgrid::s4u::Actor::restart()
+ .. doxygenfunction:: simgrid::s4u::Actor::daemonize()
+ .. doxygenfunction:: simgrid::s4u::Actor::is_daemon
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: sg_actor_kill(sg_actor_t actor)
- .. autodoxymethod:: sg_actor_kill_all()
- .. autodoxymethod:: sg_actor_set_kill_time(sg_actor_t actor, double kill_time)
+ .. doxygenfunction:: sg_actor_kill(sg_actor_t actor)
+ .. doxygenfunction:: sg_actor_kill_all()
+ .. doxygenfunction:: sg_actor_set_kill_time(sg_actor_t actor, double kill_time)
- .. autodoxymethod:: sg_actor_restart(sg_actor_t actor)
- .. autodoxymethod:: sg_actor_daemonize(sg_actor_t actor)
- .. autodoxymethod:: sg_actor_is_daemon
+ .. doxygenfunction:: sg_actor_restart(sg_actor_t actor)
+ .. doxygenfunction:: sg_actor_daemonize(sg_actor_t actor)
+ .. doxygenfunction:: sg_actor_is_daemon
.. _API_s4u_Actor_end:
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Actor::on_exit
- .. autodoxymethod:: simgrid::s4u::Actor::join() const
- .. autodoxymethod:: simgrid::s4u::Actor::join(double timeout) const
- .. autodoxymethod:: simgrid::s4u::Actor::set_auto_restart(bool autorestart)
+ .. doxygenfunction:: simgrid::s4u::Actor::on_exit
+ .. doxygenfunction:: simgrid::s4u::Actor::join() const
+ .. doxygenfunction:: simgrid::s4u::Actor::join(double timeout) const
+ .. doxygenfunction:: simgrid::s4u::Actor::set_auto_restart(bool autorestart)
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: sg_actor_join(const_sg_actor_t actor, double timeout)
- .. autodoxymethod:: sg_actor_set_auto_restart(sg_actor_t actor, int auto_restart)
+ .. doxygenfunction:: sg_actor_on_exit
+ .. doxygenfunction:: sg_actor_join(const_sg_actor_t actor, double timeout)
+ .. doxygenfunction:: sg_actor_set_auto_restart(sg_actor_t actor, int auto_restart)
Signals
-------
.. group-tab:: C++
- .. autodoxyvar:: simgrid::s4u::Actor::on_creation
- .. autodoxyvar:: simgrid::s4u::Actor::on_suspend
- .. autodoxyvar:: simgrid::s4u::Actor::on_host_change
- .. autodoxyvar:: simgrid::s4u::Actor::on_resume
- .. autodoxyvar:: simgrid::s4u::Actor::on_sleep
- .. autodoxyvar:: simgrid::s4u::Actor::on_wake_up
- .. autodoxyvar:: simgrid::s4u::Actor::on_termination
- .. autodoxyvar:: simgrid::s4u::Actor::on_destruction
+ .. doxygenvariable:: simgrid::s4u::Actor::on_creation
+ .. doxygenvariable:: simgrid::s4u::Actor::on_suspend
+ .. doxygenvariable:: simgrid::s4u::Actor::on_host_change
+ .. doxygenvariable:: simgrid::s4u::Actor::on_resume
+ .. doxygenvariable:: simgrid::s4u::Actor::on_sleep
+ .. doxygenvariable:: simgrid::s4u::Actor::on_wake_up
+ .. doxygenvariable:: simgrid::s4u::Actor::on_termination
+ .. doxygenvariable:: simgrid::s4u::Actor::on_destruction
.. _API_s4u_this_actor:
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::this_actor::get_cname()
- .. autodoxymethod:: simgrid::s4u::this_actor::get_name()
- .. autodoxymethod:: simgrid::s4u::this_actor::get_pid()
- .. autodoxymethod:: simgrid::s4u::this_actor::get_ppid()
- .. autodoxymethod:: simgrid::s4u::this_actor::is_maestro()
+ .. doxygenfunction:: simgrid::s4u::this_actor::get_cname()
+ .. doxygenfunction:: simgrid::s4u::this_actor::get_name()
+ .. doxygenfunction:: simgrid::s4u::this_actor::get_pid()
+ .. doxygenfunction:: simgrid::s4u::this_actor::get_ppid()
+ .. doxygenfunction:: simgrid::s4u::this_actor::is_maestro()
- .. autodoxymethod:: simgrid::s4u::this_actor::get_host()
- .. autodoxymethod:: simgrid::s4u::this_actor::set_host(Host *new_host)
+ .. doxygenfunction:: simgrid::s4u::this_actor::get_host()
+ .. doxygenfunction:: simgrid::s4u::this_actor::set_host(Host *new_host)
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: sg_actor_self_get_data()
- .. autodoxymethod:: sg_actor_self_set_data(void *data)
- .. autodoxymethod:: sg_actor_self_get_name()
- .. autodoxymethod:: sg_actor_self_get_pid()
- .. autodoxymethod:: sg_actor_self_get_ppid()
- .. autodoxymethod:: sg_host_self()
- .. autodoxymethod:: sg_host_self_get_name()
+ .. doxygenfunction:: sg_actor_self_get_data()
+ .. doxygenfunction:: sg_actor_self_set_data(void *data)
+ .. doxygenfunction:: sg_actor_self_get_name()
+ .. doxygenfunction:: sg_actor_self_get_pid()
+ .. doxygenfunction:: sg_actor_self_get_ppid()
+ .. doxygenfunction:: sg_host_self()
+ .. doxygenfunction:: sg_host_self_get_name()
Suspending and resuming
-----------------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::this_actor::suspend()
- .. autodoxymethod:: simgrid::s4u::this_actor::yield()
+ .. doxygenfunction:: simgrid::s4u::this_actor::suspend()
+ .. doxygenfunction:: simgrid::s4u::this_actor::yield()
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: sg_actor_yield()
+ .. doxygenfunction:: sg_actor_yield()
Logging messages
----------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::this_actor::sleep_for(double duration)
- .. autodoxymethod:: simgrid::s4u::this_actor::sleep_for(std::chrono::duration< Rep, Period > duration)
- .. autodoxymethod:: simgrid::s4u::this_actor::sleep_until(const SimulationTimePoint< Duration > &wakeup_time)
- .. autodoxymethod:: simgrid::s4u::this_actor::sleep_until(double wakeup_time)
+ .. doxygenfunction:: simgrid::s4u::this_actor::sleep_for(double duration)
+ .. doxygenfunction:: simgrid::s4u::this_actor::sleep_for(std::chrono::duration< Rep, Period > duration)
+ .. doxygenfunction:: simgrid::s4u::this_actor::sleep_until(const SimulationTimePoint< Duration > &wakeup_time)
+ .. doxygenfunction:: simgrid::s4u::this_actor::sleep_until(double wakeup_time)
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: sg_actor_sleep_for(double duration)
+ .. doxygenfunction:: sg_actor_sleep_for(double duration)
Simulating executions
---------------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::this_actor::exec_async
- .. autodoxymethod:: simgrid::s4u::this_actor::exec_init(const std::vector< s4u::Host * > &hosts, const std::vector< double > &flops_amounts, const std::vector< double > &bytes_amounts)
- .. autodoxymethod:: simgrid::s4u::this_actor::exec_init(double flops_amounts)
- .. autodoxymethod:: simgrid::s4u::this_actor::execute(double flop)
- .. autodoxymethod:: simgrid::s4u::this_actor::execute(double flop, double priority)
- .. autodoxymethod:: simgrid::s4u::this_actor::parallel_execute(const std::vector< s4u::Host * > &hosts, const std::vector< double > &flops_amounts, const std::vector< double > &bytes_amounts)
- .. autodoxymethod:: simgrid::s4u::this_actor::parallel_execute(const std::vector< s4u::Host * > &hosts, const std::vector< double > &flops_amounts, const std::vector< double > &bytes_amounts, double timeout)
+ .. doxygenfunction:: simgrid::s4u::this_actor::exec_async
+ .. doxygenfunction:: simgrid::s4u::this_actor::exec_init(const std::vector< s4u::Host * > &hosts, const std::vector< double > &flops_amounts, const std::vector< double > &bytes_amounts)
+ .. doxygenfunction:: simgrid::s4u::this_actor::exec_init(double flops_amounts)
+ .. doxygenfunction:: simgrid::s4u::this_actor::execute(double flop)
+ .. doxygenfunction:: simgrid::s4u::this_actor::execute(double flop, double priority)
+ .. doxygenfunction:: simgrid::s4u::this_actor::parallel_execute(const std::vector< s4u::Host * > &hosts, const std::vector< double > &flops_amounts, const std::vector< double > &bytes_amounts)
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: sg_actor_execute(double flops)
- .. autodoxymethod:: sg_actor_execute_with_priority(double flops, double priority)
- .. autodoxymethod:: sg_actor_exec_init(double computation_amount)
- .. autodoxymethod:: sg_actor_exec_async(double computation_amount)
+ .. doxygenfunction:: sg_actor_execute(double flops)
+ .. doxygenfunction:: sg_actor_execute_with_priority(double flops, double priority)
+ .. doxygenfunction:: sg_actor_exec_init(double computation_amount)
+ .. doxygenfunction:: sg_actor_exec_async(double computation_amount)
+ .. doxygenfunction:: sg_actor_parallel_exec_init(int host_nb, const sg_host_t* host_list, double* flops_amount, double* bytes_amount);
Exiting
-------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::this_actor::exit()
- .. autodoxymethod:: simgrid::s4u::this_actor::on_exit(const std::function< void(bool)> &fun)
+ .. doxygenfunction:: simgrid::s4u::this_actor::exit()
+ .. doxygenfunction:: simgrid::s4u::this_actor::on_exit(const std::function< void(bool)> &fun)
.. group-tab:: Python
.. autofunction:: simgrid.this_actor.exit
.. autofunction:: simgrid.this_actor.on_exit
+ .. group-tab:: c
+
+ See also :cpp:func:`sg_actor_on_exit`.
+
+ .. doxygenfunction:: sg_actor_exit
+
.. _API_s4u_Engine:
====================
Simulation Engine
====================
-.. autodoxyclass:: simgrid::s4u::Engine
+.. doxygenclass:: simgrid::s4u::Engine
Initialization
--------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Engine::Engine(int *argc, char **argv)
- .. autodoxymethod:: simgrid::s4u::Engine::is_initialized()
- .. autodoxymethod:: simgrid::s4u::Engine::shutdown()
- .. autodoxymethod:: simgrid::s4u::Engine::set_config(const std::string &str)
- .. autodoxymethod:: simgrid::s4u::Engine::set_config(const std::string &name, bool value)
- .. autodoxymethod:: simgrid::s4u::Engine::set_config(const std::string &name, double value)
- .. autodoxymethod:: simgrid::s4u::Engine::set_config(const std::string &name, int value)
- .. autodoxymethod:: simgrid::s4u::Engine::set_config(const std::string &name, const std::string &value)
+ .. doxygenfunction:: simgrid::s4u::Engine::Engine(int *argc, char **argv)
+ .. doxygenfunction:: simgrid::s4u::Engine::is_initialized()
+ .. doxygenfunction:: simgrid::s4u::Engine::shutdown()
+ .. doxygenfunction:: simgrid::s4u::Engine::set_config(const std::string &str)
+ .. doxygenfunction:: simgrid::s4u::Engine::set_config(const std::string &name, bool value)
+ .. doxygenfunction:: simgrid::s4u::Engine::set_config(const std::string &name, double value)
+ .. doxygenfunction:: simgrid::s4u::Engine::set_config(const std::string &name, int value)
+ .. doxygenfunction:: simgrid::s4u::Engine::set_config(const std::string &name, const std::string &value)
- .. autodoxymethod:: simgrid::s4u::Engine::load_deployment
- .. autodoxymethod:: simgrid::s4u::Engine::load_platform
- .. autodoxymethod:: simgrid::s4u::Engine::register_actor(const std::string &name)
- .. autodoxymethod:: simgrid::s4u::Engine::register_actor(const std::string &name, F code)
- .. autodoxymethod:: simgrid::s4u::Engine::register_default(const std::function< void(int, char **)> &code)
- .. autodoxymethod:: simgrid::s4u::Engine::register_default(const kernel::actor::ActorCodeFactory &factory)
+ .. doxygenfunction:: simgrid::s4u::Engine::load_deployment
+ .. doxygenfunction:: simgrid::s4u::Engine::load_platform
+ .. doxygenfunction:: simgrid::s4u::Engine::register_actor(const std::string &name)
+ .. doxygenfunction:: simgrid::s4u::Engine::register_actor(const std::string &name, F code)
+ .. doxygenfunction:: simgrid::s4u::Engine::register_default(const std::function< void(int, char **)> &code)
+ .. doxygenfunction:: simgrid::s4u::Engine::register_default(const kernel::actor::ActorCodeFactory &factory)
- .. autodoxymethod:: simgrid::s4u::Engine::register_function(const std::string &name, const std::function< void(int, char **)> &code)
- .. autodoxymethod:: simgrid::s4u::Engine::register_function(const std::string &name, const std::function< void(std::vector< std::string >)> &code)
- .. autodoxymethod:: simgrid::s4u::Engine::register_function(const std::string &name, const kernel::actor::ActorCodeFactory &factory)
+ .. doxygenfunction:: simgrid::s4u::Engine::register_function(const std::string &name, const std::function< void(int, char **)> &code)
+ .. doxygenfunction:: simgrid::s4u::Engine::register_function(const std::string &name, const std::function< void(std::vector< std::string >)> &code)
+ .. doxygenfunction:: simgrid::s4u::Engine::register_function(const std::string &name, const kernel::actor::ActorCodeFactory &factory)
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: simgrid_init
+ .. doxygenfunction:: simgrid_init
- .. autodoxymethod:: simgrid_load_deployment
- .. autodoxymethod:: simgrid_load_platform
- .. autodoxymethod:: simgrid_register_default
- .. autodoxymethod:: simgrid_register_function
+ .. doxygenfunction:: simgrid_load_deployment
+ .. doxygenfunction:: simgrid_load_platform
+ .. doxygenfunction:: simgrid_register_default
+ .. doxygenfunction:: simgrid_register_function
Run the simulation
------------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Engine::get_clock()
- .. autodoxymethod:: simgrid::s4u::Engine::run
+ .. doxygenfunction:: simgrid::s4u::Engine::get_clock()
+ .. doxygenfunction:: simgrid::s4u::Engine::run
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: simgrid_get_clock
- .. autodoxymethod:: simgrid_run
+ .. doxygenfunction:: simgrid_get_clock
+ .. doxygenfunction:: simgrid_run
Retrieving actors
-----------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Engine::get_actor_count
- .. autodoxymethod:: simgrid::s4u::Engine::get_all_actors
- .. autodoxymethod:: simgrid::s4u::Engine::get_filtered_actors
+ .. doxygenfunction:: simgrid::s4u::Engine::get_actor_count
+ .. doxygenfunction:: simgrid::s4u::Engine::get_all_actors
+ .. doxygenfunction:: simgrid::s4u::Engine::get_filtered_actors
.. group-tab:: C
- .. autodoxymethod:: simgrid_get_actor_count()
+ .. doxygenfunction:: simgrid_get_actor_count()
Retrieving hosts
----------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Engine::get_all_hosts
- .. autodoxymethod:: simgrid::s4u::Engine::get_host_count
- .. autodoxymethod:: simgrid::s4u::Engine::get_filtered_hosts
- .. autodoxymethod:: simgrid::s4u::Engine::host_by_name
- .. autodoxymethod:: simgrid::s4u::Engine::host_by_name_or_null
+ .. doxygenfunction:: simgrid::s4u::Engine::get_all_hosts
+ .. doxygenfunction:: simgrid::s4u::Engine::get_host_count
+ .. doxygenfunction:: simgrid::s4u::Engine::get_filtered_hosts
+ .. doxygenfunction:: simgrid::s4u::Engine::host_by_name
+ .. doxygenfunction:: simgrid::s4u::Engine::host_by_name_or_null
.. group-tab:: Python
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Engine::get_all_links
- .. autodoxymethod:: simgrid::s4u::Engine::get_link_count
- .. autodoxymethod:: simgrid::s4u::Engine::get_filtered_links
- .. autodoxymethod:: simgrid::s4u::Engine::link_by_name
- .. autodoxymethod:: simgrid::s4u::Engine::link_by_name_or_null
+ .. doxygenfunction:: simgrid::s4u::Engine::get_all_links
+ .. doxygenfunction:: simgrid::s4u::Engine::get_link_count
+ .. doxygenfunction:: simgrid::s4u::Engine::get_filtered_links
+ .. doxygenfunction:: simgrid::s4u::Engine::link_by_name
+ .. doxygenfunction:: simgrid::s4u::Engine::link_by_name_or_null
Interacting with the routing
----------------------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Engine::get_all_netpoints
- .. autodoxymethod:: simgrid::s4u::Engine::get_filtered_netzones
- .. autodoxymethod:: simgrid::s4u::Engine::get_instance()
- .. autodoxymethod:: simgrid::s4u::Engine::get_netzone_root
- .. autodoxymethod:: simgrid::s4u::Engine::netpoint_by_name_or_null
- .. autodoxymethod:: simgrid::s4u::Engine::netzone_by_name_or_null
- .. autodoxymethod:: simgrid::s4u::Engine::set_netzone_root(const NetZone *netzone)
+ .. doxygenfunction:: simgrid::s4u::Engine::get_all_netpoints
+ .. doxygenfunction:: simgrid::s4u::Engine::get_filtered_netzones
+ .. doxygenfunction:: simgrid::s4u::Engine::get_instance()
+ .. doxygenfunction:: simgrid::s4u::Engine::get_netzone_root
+ .. doxygenfunction:: simgrid::s4u::Engine::netpoint_by_name_or_null
+ .. doxygenfunction:: simgrid::s4u::Engine::netzone_by_name_or_null
+ .. doxygenfunction:: simgrid::s4u::Engine::set_netzone_root(const NetZone *netzone)
Signals
-------
.. group-tab:: C++
- .. autodoxyvar:: simgrid::s4u::Engine::on_deadlock
- .. autodoxyvar:: simgrid::s4u::Engine::on_platform_created
- .. autodoxyvar:: simgrid::s4u::Engine::on_platform_creation
- .. autodoxyvar:: simgrid::s4u::Engine::on_simulation_end
- .. autodoxyvar:: simgrid::s4u::Engine::on_time_advance
+ .. doxygenvariable:: simgrid::s4u::Engine::on_deadlock
+ .. doxygenvariable:: simgrid::s4u::Engine::on_platform_created
+ .. doxygenvariable:: simgrid::s4u::Engine::on_platform_creation
+ .. doxygenvariable:: simgrid::s4u::Engine::on_simulation_end
+ .. doxygenvariable:: simgrid::s4u::Engine::on_time_advance
.. _API_s4u_Mailbox:
class Mailbox
================
-.. autodoxyclass:: simgrid::s4u::Mailbox
+.. doxygenclass:: simgrid::s4u::Mailbox
Please also refer to the :ref:`full doc on s4u::Mailbox <s4u_mailbox>`.
engine. Once created, there is no way to destroy a mailbox before the end
of the simulation.
- .. autodoxymethod:: simgrid::s4u::Mailbox::by_name(const std::string &name)
+ .. doxygenfunction:: simgrid::s4u::Mailbox::by_name(const std::string &name)
.. group-tab:: Python
+ .. code-block:: C++
+
+ #include <simgrid/mailbox.h>
+
+ .. autoclass:: simgrid.Mailbox
+
.. automethod:: simgrid.Mailbox.by_name
+ .. group-tab:: C
+
.. code-block:: C
#include <simgrid/s4u/mailbox.h>
- .. autodoxymethod:: sg_mailbox_by_name(const char *alias)
+ .. doxygentypedef:: sg_mailbox_t
+ .. doxygentypedef:: const_sg_mailbox_t
- .. group-tab:: C
+ .. doxygenfunction:: sg_mailbox_by_name(const char *alias)
Querying info
-------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Mailbox::get_cname
- .. autodoxymethod:: simgrid::s4u::Mailbox::get_name
+ .. doxygenfunction:: simgrid::s4u::Mailbox::get_cname
+ .. doxygenfunction:: simgrid::s4u::Mailbox::get_name
.. group-tab:: Python
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Mailbox::put(void *payload, uint64_t simulated_size_in_bytes)
- .. autodoxymethod:: simgrid::s4u::Mailbox::put(void *payload, uint64_t simulated_size_in_bytes, double timeout)
- .. autodoxymethod:: simgrid::s4u::Mailbox::put_async(void *data, uint64_t simulated_size_in_bytes)
- .. autodoxymethod:: simgrid::s4u::Mailbox::put_init()
- .. autodoxymethod:: simgrid::s4u::Mailbox::put_init(void *data, uint64_t simulated_size_in_bytes)
+ .. doxygenfunction:: simgrid::s4u::Mailbox::put(void *payload, uint64_t simulated_size_in_bytes)
+ .. doxygenfunction:: simgrid::s4u::Mailbox::put(void *payload, uint64_t simulated_size_in_bytes, double timeout)
+ .. doxygenfunction:: simgrid::s4u::Mailbox::put_async(void *data, uint64_t simulated_size_in_bytes)
+ .. doxygenfunction:: simgrid::s4u::Mailbox::put_init()
+ .. doxygenfunction:: simgrid::s4u::Mailbox::put_init(void *data, uint64_t simulated_size_in_bytes)
.. group-tab:: Python
.. automethod:: simgrid.Mailbox.put
.. automethod:: simgrid.Mailbox.put_async
- .. group-tab: C
+ .. group-tab:: C
- .. autodoxymethod:: sg_mailbox_put(sg_mailbox_t mailbox, void *payload, long simulated_size_in_bytes)
- .. autodoxymethod:: sg_mailbox_put_init(sg_mailbox_t mailbox, void *payload, long simulated_size_in_bytes)
- .. autodoxymethod:: sg_mailbox_put_async(sg_mailbox_t mailbox, void *payload, long simulated_size_in_bytes)
+ .. doxygenfunction:: sg_mailbox_put(sg_mailbox_t mailbox, void *payload, long simulated_size_in_bytes)
+ .. doxygenfunction:: sg_mailbox_put_init(sg_mailbox_t mailbox, void *payload, long simulated_size_in_bytes)
+ .. doxygenfunction:: sg_mailbox_put_async(sg_mailbox_t mailbox, void *payload, long simulated_size_in_bytes)
Receiving data
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Mailbox::empty
- .. autodoxymethod:: simgrid::s4u::Mailbox::front
- .. autodoxymethod:: simgrid::s4u::Mailbox::get()
- .. autodoxymethod:: simgrid::s4u::Mailbox::get(double timeout)
- .. autodoxymethod:: simgrid::s4u::Mailbox::get_async(T **data)
- .. autodoxymethod:: simgrid::s4u::Mailbox::get_init()
- .. autodoxymethod:: simgrid::s4u::Mailbox::iprobe(int type, bool(*match_fun)(void *, void *, kernel::activity::CommImpl *), void *data)
- .. autodoxymethod:: simgrid::s4u::Mailbox::listen
- .. autodoxymethod:: simgrid::s4u::Mailbox::ready
+ .. doxygenfunction:: simgrid::s4u::Mailbox::empty
+ .. doxygenfunction:: simgrid::s4u::Mailbox::front
+ .. doxygenfunction:: simgrid::s4u::Mailbox::get()
+ .. doxygenfunction:: simgrid::s4u::Mailbox::get(double timeout)
+ .. doxygenfunction:: simgrid::s4u::Mailbox::get_async(T **data)
+ .. doxygenfunction:: simgrid::s4u::Mailbox::get_init()
+ .. doxygenfunction:: simgrid::s4u::Mailbox::iprobe(int type, bool(*match_fun)(void *, void *, kernel::activity::CommImpl *), void *data)
+ .. doxygenfunction:: simgrid::s4u::Mailbox::listen
+ .. doxygenfunction:: simgrid::s4u::Mailbox::ready
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: sg_mailbox_get(sg_mailbox_t mailbox)
- .. autodoxymethod:: sg_mailbox_get_async(sg_mailbox_t mailbox, void **data)
- .. autodoxymethod:: sg_mailbox_get_name(const_sg_mailbox_t mailbox)
- .. autodoxymethod:: sg_mailbox_listen(const char *alias)
+ .. doxygenfunction:: sg_mailbox_get(sg_mailbox_t mailbox)
+ .. doxygenfunction:: sg_mailbox_get_async(sg_mailbox_t mailbox, void **data)
+ .. doxygenfunction:: sg_mailbox_get_name(const_sg_mailbox_t mailbox)
+ .. doxygenfunction:: sg_mailbox_listen(const char *alias)
Receiving actor
---------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Mailbox::get_receiver
- .. autodoxymethod:: simgrid::s4u::Mailbox::set_receiver(ActorPtr actor)
+ .. doxygenfunction:: simgrid::s4u::Mailbox::get_receiver
+ .. doxygenfunction:: simgrid::s4u::Mailbox::set_receiver(ActorPtr actor)
.. group-tab:: C
- .. autodoxymethod:: sg_mailbox_set_receiver(const char *alias)
+ .. doxygenfunction:: sg_mailbox_set_receiver(const char *alias)
.. _API_s4u_Resource:
class Disk
=============
-.. autodoxyclass:: simgrid::s4u::Disk
+.. doxygenclass:: simgrid::s4u::Disk
Basic management
----------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Disk::get_cname() const
- .. autodoxymethod:: simgrid::s4u::Disk::get_host() const
- .. autodoxymethod:: simgrid::s4u::Disk::get_name() const
- .. autodoxymethod:: simgrid::s4u::Disk::get_properties() const
- .. autodoxymethod:: simgrid::s4u::Disk::get_property(const std::string &key) const
- .. autodoxymethod:: simgrid::s4u::Disk::get_read_bandwidth() const
- .. autodoxymethod:: simgrid::s4u::Disk::get_write_bandwidth() const
- .. autodoxymethod:: simgrid::s4u::Disk::set_property(const std::string &, const std::string &value)
+ .. doxygenfunction:: simgrid::s4u::Disk::get_cname() const
+ .. doxygenfunction:: simgrid::s4u::Disk::get_host() const
+ .. doxygenfunction:: simgrid::s4u::Disk::get_name() const
+ .. doxygenfunction:: simgrid::s4u::Disk::get_properties() const
+ .. doxygenfunction:: simgrid::s4u::Disk::get_property(const std::string &key) const
+ .. doxygenfunction:: simgrid::s4u::Disk::get_read_bandwidth() const
+ .. doxygenfunction:: simgrid::s4u::Disk::get_write_bandwidth() const
+ .. doxygenfunction:: simgrid::s4u::Disk::set_property(const std::string &, const std::string &value)
I/O operations
--------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Disk::io_init(sg_size_t size, s4u::Io::OpType type)
- .. autodoxymethod:: simgrid::s4u::Disk::read(sg_size_t size)
- .. autodoxymethod:: simgrid::s4u::Disk::read_async(sg_size_t size)
- .. autodoxymethod:: simgrid::s4u::Disk::write(sg_size_t size)
- .. autodoxymethod:: simgrid::s4u::Disk::write_async(sg_size_t size)
+ .. doxygenfunction:: simgrid::s4u::Disk::io_init(sg_size_t size, s4u::Io::OpType type) const
+ .. doxygenfunction:: simgrid::s4u::Disk::read(sg_size_t size) const
+ .. doxygenfunction:: simgrid::s4u::Disk::read_async(sg_size_t size) const
+ .. doxygenfunction:: simgrid::s4u::Disk::write(sg_size_t size) const
+ .. doxygenfunction:: simgrid::s4u::Disk::write_async(sg_size_t size) const
Signals
-------
.. group-tab:: C++
- .. autodoxyvar:: simgrid::s4u::Disk::on_creation
- .. autodoxyvar:: simgrid::s4u::Disk::on_destruction
- .. autodoxyvar:: simgrid::s4u::Disk::on_state_change
+ .. doxygenvariable:: simgrid::s4u::Disk::on_creation
+ .. doxygenvariable:: simgrid::s4u::Disk::on_destruction
+ .. doxygenvariable:: simgrid::s4u::Disk::on_state_change
.. _API_s4u_Host:
class Host
=============
-.. autodoxyclass:: simgrid::s4u::Host
+.. doxygenclass:: simgrid::s4u::Host
Basic management
----------------
idiom on hosts because SimGrid does not allow (yet) to create nor
destroy resources once the simulation is started.
- .. autodoxymethod:: simgrid::s4u::Host::destroy()
+ .. doxygenfunction:: simgrid::s4u::Host::destroy()
.. group-tab:: Python
See also :cpp:func:`simgrid::s4u::Engine::get_all_hosts`.
- .. autodoxymethod:: simgrid::s4u::Host::by_name(const std::string &name)
- .. autodoxymethod:: simgrid::s4u::Host::by_name_or_null(const std::string &name)
- .. autodoxymethod:: simgrid::s4u::Host::current()
+ .. doxygenfunction:: simgrid::s4u::Host::by_name(const std::string &name)
+ .. doxygenfunction:: simgrid::s4u::Host::by_name_or_null(const std::string &name)
+ .. doxygenfunction:: simgrid::s4u::Host::current()
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: sg_host_by_name(const char *name)
- .. autodoxymethod:: sg_host_count()
- .. autodoxymethod:: sg_host_list()
- .. autodoxymethod:: sg_hosts_as_dynar()
+ .. doxygenfunction:: sg_host_by_name(const char *name)
+ .. doxygenfunction:: sg_host_count()
+ .. doxygenfunction:: sg_host_list()
+ .. doxygenfunction:: sg_hosts_as_dynar()
Querying info
-------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Host::get_cname() const
- .. autodoxymethod:: simgrid::s4u::Host::get_core_count() const
- .. autodoxymethod:: simgrid::s4u::Host::get_name() const
- .. autodoxymethod:: simgrid::s4u::Host::get_available_speed() const
- .. autodoxymethod:: simgrid::s4u::Host::get_load() const
- .. autodoxymethod:: simgrid::s4u::Host::get_speed() const
+ .. doxygenfunction:: simgrid::s4u::Host::get_cname() const
+ .. doxygenfunction:: simgrid::s4u::Host::get_core_count() const
+ .. doxygenfunction:: simgrid::s4u::Host::get_name() const
+ .. doxygenfunction:: simgrid::s4u::Host::get_available_speed() const
+ .. doxygenfunction:: simgrid::s4u::Host::get_load() const
+ .. doxygenfunction:: simgrid::s4u::Host::get_speed() const
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: sg_host_core_count(const_sg_host_t host)
- .. autodoxymethod:: sg_host_dump(const_sg_host_t ws)
- .. autodoxymethod:: sg_host_get_name(const_sg_host_t host)
- .. autodoxymethod:: sg_host_get_load(const_sg_host_t host)
- .. autodoxymethod:: sg_host_get_speed(const_sg_host_t host)
+ .. doxygenfunction:: sg_host_core_count(const_sg_host_t host)
+ .. doxygenfunction:: sg_host_dump(const_sg_host_t ws)
+ .. doxygenfunction:: sg_host_get_name(const_sg_host_t host)
+ .. doxygenfunction:: sg_host_get_load(const_sg_host_t host)
+ .. doxygenfunction:: sg_host_get_speed(const_sg_host_t host)
User data and properties
------------------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Host::get_properties() const
- .. autodoxymethod:: simgrid::s4u::Host::get_property(const std::string &key) const
- .. autodoxymethod:: simgrid::s4u::Host::set_properties(const std::unordered_map< std::string, std::string > &properties)
- .. autodoxymethod:: simgrid::s4u::Host::set_property(const std::string &key, const std::string &value)
+ .. doxygenfunction:: simgrid::s4u::Host::get_properties() const
+ .. doxygenfunction:: simgrid::s4u::Host::get_property(const std::string &key) const
+ .. doxygenfunction:: simgrid::s4u::Host::set_properties(const std::unordered_map< std::string, std::string > &properties)
+ .. doxygenfunction:: simgrid::s4u::Host::set_property(const std::string &key, const std::string &value)
.. group-tab:: C
- .. autodoxymethod:: sg_host_set_property_value(sg_host_t host, const char *name, const char *value)
- .. autodoxymethod:: sg_host_get_properties(const_sg_host_t host)
- .. autodoxymethod:: sg_host_get_property_value(const_sg_host_t host, const char *name)
- .. autodoxymethod:: sg_host_extension_create(void(*deleter)(void *))
- .. autodoxymethod:: sg_host_extension_get(const_sg_host_t host, size_t rank)
+ .. doxygenfunction:: sg_host_set_property_value(sg_host_t host, const char *name, const char *value)
+ .. doxygenfunction:: sg_host_get_properties(const_sg_host_t host)
+ .. doxygenfunction:: sg_host_get_property_value(const_sg_host_t host, const char *name)
+ .. doxygenfunction:: sg_host_extension_create(void(*deleter)(void *))
+ .. doxygenfunction:: sg_host_extension_get(const_sg_host_t host, size_t rank)
Retrieving components
---------------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Host::add_disk(const Disk *disk)
- .. autodoxymethod:: simgrid::s4u::Host::get_actor_count() const
- .. autodoxymethod:: simgrid::s4u::Host::get_all_actors() const
- .. autodoxymethod:: simgrid::s4u::Host::get_disks() const
- .. autodoxymethod:: simgrid::s4u::Host::remove_disk(const std::string &disk_name)
+ .. doxygenfunction:: simgrid::s4u::Host::add_disk(const Disk *disk)
+ .. doxygenfunction:: simgrid::s4u::Host::get_actor_count() const
+ .. doxygenfunction:: simgrid::s4u::Host::get_all_actors() const
+ .. doxygenfunction:: simgrid::s4u::Host::get_disks() const
+ .. doxygenfunction:: simgrid::s4u::Host::remove_disk(const std::string &disk_name)
.. group-tab:: C
- .. autodoxymethod:: sg_host_get_actor_list(const_sg_host_t host, xbt_dynar_t whereto)
+ .. doxygenfunction:: sg_host_get_actor_list(const_sg_host_t host, xbt_dynar_t whereto)
On/Off
------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Host::is_on() const
- .. autodoxymethod:: simgrid::s4u::Host::turn_off()
- .. autodoxymethod:: simgrid::s4u::Host::turn_on()
+ .. doxygenfunction:: simgrid::s4u::Host::is_on() const
+ .. doxygenfunction:: simgrid::s4u::Host::turn_off()
+ .. doxygenfunction:: simgrid::s4u::Host::turn_on()
.. group-tab:: C
- .. autodoxymethod:: sg_host_is_on(const_sg_host_t host)
- .. autodoxymethod:: sg_host_turn_off(sg_host_t host)
- .. autodoxymethod:: sg_host_turn_on(sg_host_t host)
+ .. doxygenfunction:: sg_host_is_on(const_sg_host_t host)
+ .. doxygenfunction:: sg_host_turn_off(sg_host_t host)
+ .. doxygenfunction:: sg_host_turn_on(sg_host_t host)
DVFS
----
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Host::get_pstate() const
- .. autodoxymethod:: simgrid::s4u::Host::get_pstate_count() const
- .. autodoxymethod:: simgrid::s4u::Host::get_pstate_speed(int pstate_index) const
- .. autodoxymethod:: simgrid::s4u::Host::set_pstate(int pstate_index)
- .. autodoxymethod:: simgrid::s4u::Host::set_speed_profile(kernel::profile::Profile *p)
- .. autodoxymethod:: simgrid::s4u::Host::set_state_profile(kernel::profile::Profile *p)
+ .. doxygenfunction:: simgrid::s4u::Host::get_pstate() const
+ .. doxygenfunction:: simgrid::s4u::Host::get_pstate_count() const
+ .. doxygenfunction:: simgrid::s4u::Host::get_pstate_speed(int pstate_index) const
+ .. doxygenfunction:: simgrid::s4u::Host::set_pstate(int pstate_index)
+ .. doxygenfunction:: simgrid::s4u::Host::set_speed_profile(kernel::profile::Profile *p)
+ .. doxygenfunction:: simgrid::s4u::Host::set_state_profile(kernel::profile::Profile *p)
.. group-tab:: Python
.. group-tab:: C
- .. autodoxymethod:: sg_host_get_available_speed(const_sg_host_t host)
- .. autodoxymethod:: sg_host_get_nb_pstates(const_sg_host_t host)
- .. autodoxymethod:: sg_host_get_pstate(const_sg_host_t host)
- .. autodoxymethod:: sg_host_get_pstate_speed(const_sg_host_t host, int pstate_index)
- .. autodoxymethod:: sg_host_set_pstate(sg_host_t host, int pstate)
+ .. doxygenfunction:: sg_host_get_available_speed(const_sg_host_t host)
+ .. doxygenfunction:: sg_host_get_nb_pstates(const_sg_host_t host)
+ .. doxygenfunction:: sg_host_get_pstate(const_sg_host_t host)
+ .. doxygenfunction:: sg_host_get_pstate_speed(const_sg_host_t host, int pstate_index)
+ .. doxygenfunction:: sg_host_set_pstate(sg_host_t host, int pstate)
Execution
---------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Host::exec_async
- .. autodoxymethod:: simgrid::s4u::Host::execute(double flops) const
- .. autodoxymethod:: simgrid::s4u::Host::execute(double flops, double priority) const
+ .. doxygenfunction:: simgrid::s4u::Host::exec_async
+ .. doxygenfunction:: simgrid::s4u::Host::execute(double flops) const
+ .. doxygenfunction:: simgrid::s4u::Host::execute(double flops, double priority) const
Platform and routing
--------------------
+You can also start direct communications between two arbitrary hosts
+using :cpp:func:`Comm::sendto() <simgrid::s4u::Comm::sendto()>`.
+
.. tabs::
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Host::get_englobing_zone()
- .. autodoxymethod:: simgrid::s4u::Host::get_netpoint() const
- .. autodoxymethod:: simgrid::s4u::Host::route_to(const Host *dest, std::vector< Link * > &links, double *latency) const
- .. autodoxymethod:: simgrid::s4u::Host::route_to(const Host *dest, std::vector< kernel::resource::LinkImpl * > &links, double *latency) const
- .. autodoxymethod:: simgrid::s4u::Host::sendto(Host *dest, double byte_amount)
- .. autodoxymethod:: simgrid::s4u::Host::sendto_async(Host *dest, double byte_amount)
+ .. doxygenfunction:: simgrid::s4u::Host::get_englobing_zone() const
+ .. doxygenfunction:: simgrid::s4u::Host::get_netpoint() const
+ .. doxygenfunction:: simgrid::s4u::Host::route_to(const Host *dest, std::vector< Link * > &links, double *latency) const
+ .. doxygenfunction:: simgrid::s4u::Host::route_to(const Host *dest, std::vector< kernel::resource::LinkImpl * > &links, double *latency) const
.. group-tab:: C
- .. autodoxymethod:: sg_host_get_route(const_sg_host_t from, const_sg_host_t to, xbt_dynar_t links)
- .. autodoxymethod:: sg_host_get_route_bandwidth(const_sg_host_t from, const_sg_host_t to)
- .. autodoxymethod:: sg_host_get_route_latency(const_sg_host_t from, const_sg_host_t to)
- .. autodoxymethod:: sg_host_sendto(sg_host_t from, sg_host_t to, double byte_amount)
+ .. doxygenfunction:: sg_host_get_route(const_sg_host_t from, const_sg_host_t to, xbt_dynar_t links)
+ .. doxygenfunction:: sg_host_get_route_bandwidth(const_sg_host_t from, const_sg_host_t to)
+ .. doxygenfunction:: sg_host_get_route_latency(const_sg_host_t from, const_sg_host_t to)
+ .. doxygenfunction:: sg_host_sendto(sg_host_t from, sg_host_t to, double byte_amount)
Signals
-------
.. group-tab:: C++
- .. autodoxyvar:: simgrid::s4u::Host::on_creation
- .. autodoxyvar:: simgrid::s4u::Host::on_destruction
- .. autodoxyvar:: simgrid::s4u::Host::on_speed_change
- .. autodoxyvar:: simgrid::s4u::Host::on_state_change
+ .. doxygenvariable:: simgrid::s4u::Host::on_creation
+ .. doxygenvariable:: simgrid::s4u::Host::on_destruction
+ .. doxygenvariable:: simgrid::s4u::Host::on_speed_change
+ .. doxygenvariable:: simgrid::s4u::Host::on_state_change
.. _API_s4u_Link:
class Link
=============
-.. autodoxyclass:: simgrid::s4u::Link
+.. doxygenclass:: simgrid::s4u::Link
+.. doxygenclass:: simgrid::s4u::SplitDuplexLink
+.. doxygenclass:: simgrid::s4u::LinkInRoute
Basic management
----------------
See also :cpp:func:`simgrid::s4u::Engine::get_all_links`.
- .. autodoxymethod:: simgrid::s4u::Link::by_name(const std::string &name)
- .. autodoxymethod:: simgrid::s4u::Link::by_name_or_null(const std::string &name)
+ .. doxygenfunction:: simgrid::s4u::Link::by_name(const std::string &name)
+ .. doxygenfunction:: simgrid::s4u::Link::by_name_or_null(const std::string &name)
.. group-tab:: C
- .. autodoxymethod:: sg_link_by_name(const char *name)
- .. autodoxymethod:: sg_link_count()
- .. autodoxymethod:: sg_link_list()
+ .. doxygenfunction:: sg_link_by_name(const char *name)
+ .. doxygenfunction:: sg_link_count()
+ .. doxygenfunction:: sg_link_list()
Querying info
--------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Link::get_bandwidth() const
- .. autodoxymethod:: simgrid::s4u::Link::get_cname() const
- .. autodoxymethod:: simgrid::s4u::Link::get_latency() const
- .. autodoxymethod:: simgrid::s4u::Link::get_name() const
- .. autodoxymethod:: simgrid::s4u::Link::get_sharing_policy() const
- .. autodoxymethod:: simgrid::s4u::Link::get_usage() const
- .. autodoxymethod:: simgrid::s4u::Link::is_used() const
+ .. doxygenfunction:: simgrid::s4u::Link::get_bandwidth() const
+ .. doxygenfunction:: simgrid::s4u::Link::get_cname() const
+ .. doxygenfunction:: simgrid::s4u::Link::get_latency() const
+ .. doxygenfunction:: simgrid::s4u::Link::get_name() const
+ .. doxygenfunction:: simgrid::s4u::Link::get_sharing_policy() const
+ .. doxygenfunction:: simgrid::s4u::Link::get_usage() const
+ .. doxygenfunction:: simgrid::s4u::Link::is_used() const
.. group-tab:: C
- .. autodoxymethod:: sg_link_get_bandwidth(const_sg_link_t link)
- .. autodoxymethod:: sg_link_get_latency(const_sg_link_t link)
- .. autodoxymethod:: sg_link_get_name(const_sg_link_t link)
- .. autodoxymethod:: sg_link_is_shared(const_sg_link_t link)
+ .. doxygenfunction:: sg_link_get_bandwidth(const_sg_link_t link)
+ .. doxygenfunction:: sg_link_get_latency(const_sg_link_t link)
+ .. doxygenfunction:: sg_link_get_name(const_sg_link_t link)
+ .. doxygenfunction:: sg_link_is_shared(const_sg_link_t link)
Modifying characteristics
-------------------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Link::set_bandwidth(double value)
- .. autodoxymethod:: simgrid::s4u::Link::set_latency(double value)
+ .. doxygenfunction:: simgrid::s4u::Link::set_bandwidth(double value)
+ .. doxygenfunction:: simgrid::s4u::Link::set_latency(double value)
.. group-tab:: C
- .. autodoxymethod:: sg_link_set_bandwidth(sg_link_t link, double value)
- .. autodoxymethod:: sg_link_set_latency(sg_link_t link, double value)
+ .. doxygenfunction:: sg_link_set_bandwidth(sg_link_t link, double value)
+ .. doxygenfunction:: sg_link_set_latency(sg_link_t link, double value)
User data and properties
------------------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Link::get_property(const std::string &key) const
- .. autodoxymethod:: simgrid::s4u::Link::set_property(const std::string &key, const std::string &value)
+ .. doxygenfunction:: simgrid::s4u::Link::get_property(const std::string &key) const
+ .. doxygenfunction:: simgrid::s4u::Link::set_property(const std::string &key, const std::string &value)
.. group-tab:: C
- .. autodoxymethod:: sg_link_get_data(const_sg_link_t link)
- .. autodoxymethod:: sg_link_set_data(sg_link_t link, void *data)
+ .. doxygenfunction:: sg_link_get_data(const_sg_link_t link)
+ .. doxygenfunction:: sg_link_set_data(sg_link_t link, void *data)
On/Off
------
See also :cpp:func:`simgrid::s4u::Link::set_state_profile`.
- .. autodoxymethod:: simgrid::s4u::Link::is_on() const
- .. autodoxymethod:: simgrid::s4u::Link::turn_off()
- .. autodoxymethod:: simgrid::s4u::Link::turn_on()
+ .. doxygenfunction:: simgrid::s4u::Link::is_on() const
+ .. doxygenfunction:: simgrid::s4u::Link::turn_off()
+ .. doxygenfunction:: simgrid::s4u::Link::turn_on()
Dynamic profiles
----------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Link::set_bandwidth_profile(kernel::profile::Profile *profile)
- .. autodoxymethod:: simgrid::s4u::Link::set_latency_profile(kernel::profile::Profile *profile)
- .. autodoxymethod:: simgrid::s4u::Link::set_state_profile(kernel::profile::Profile *profile)
+ .. doxygenfunction:: simgrid::s4u::Link::set_bandwidth_profile(kernel::profile::Profile *profile)
+ .. doxygenfunction:: simgrid::s4u::Link::set_latency_profile(kernel::profile::Profile *profile)
+ .. doxygenfunction:: simgrid::s4u::Link::set_state_profile(kernel::profile::Profile *profile)
WIFI links
----------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Link::set_host_wifi_rate
+ .. doxygenfunction:: simgrid::s4u::Link::set_host_wifi_rate
Signals
-------
.. group-tab:: C++
- .. autodoxyvar:: simgrid::s4u::Link::on_bandwidth_change
- .. autodoxyvar:: simgrid::s4u::Link::on_communicate
- .. autodoxyvar:: simgrid::s4u::Link::on_communication_state_change
- .. autodoxyvar:: simgrid::s4u::Link::on_creation
- .. autodoxyvar:: simgrid::s4u::Link::on_destruction
- .. autodoxyvar:: simgrid::s4u::Link::on_state_change
+ .. doxygenvariable:: simgrid::s4u::Link::on_bandwidth_change
+ .. doxygenvariable:: simgrid::s4u::Link::on_communicate
+ .. doxygenvariable:: simgrid::s4u::Link::on_communication_state_change
+ .. doxygenvariable:: simgrid::s4u::Link::on_creation
+ .. doxygenvariable:: simgrid::s4u::Link::on_destruction
+ .. doxygenvariable:: simgrid::s4u::Link::on_state_change
.. _API_s4u_NetZone:
class NetZone
================
-.. autodoxyclass:: simgrid::s4u::NetZone
+.. doxygenclass:: simgrid::s4u::NetZone
Basic management
----------------
.. group-tab:: C
- .. autodoxymethod:: sg_zone_get_by_name(const char *name)
- .. autodoxymethod:: sg_zone_get_root()
+ .. doxygenfunction:: sg_zone_get_by_name(const char *name)
+ .. doxygenfunction:: sg_zone_get_root()
Querying info
--------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::NetZone::get_cname() const
- .. autodoxymethod:: simgrid::s4u::NetZone::get_name() const
+ .. doxygenfunction:: simgrid::s4u::NetZone::get_cname() const
+ .. doxygenfunction:: simgrid::s4u::NetZone::get_name() const
.. group-tab:: C
- .. autodoxymethod:: sg_zone_get_name(const_sg_netzone_t zone)
+ .. doxygenfunction:: sg_zone_get_name(const_sg_netzone_t zone)
User data and properties
------------------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::NetZone::get_properties() const
- .. autodoxymethod:: simgrid::s4u::NetZone::get_property(const std::string &key) const
- .. autodoxymethod:: simgrid::s4u::NetZone::set_property(const std::string &key, const std::string &value)
+ .. doxygenfunction:: simgrid::s4u::NetZone::get_properties() const
+ .. doxygenfunction:: simgrid::s4u::NetZone::get_property(const std::string &key) const
+ .. doxygenfunction:: simgrid::s4u::NetZone::set_property(const std::string &key, const std::string &value)
.. group-tab:: C
- .. autodoxymethod:: sg_zone_get_property_value(const_sg_netzone_t as, const char *name)
- .. autodoxymethod:: sg_zone_set_property_value(sg_netzone_t netzone, const char *name, const char *value)
+ .. doxygenfunction:: sg_zone_get_property_value(const_sg_netzone_t as, const char *name)
+ .. doxygenfunction:: sg_zone_set_property_value(sg_netzone_t netzone, const char *name, const char *value)
Retrieving components
---------------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::NetZone::get_all_hosts() const
- .. autodoxymethod:: simgrid::s4u::NetZone::get_host_count() const
+ .. doxygenfunction:: simgrid::s4u::NetZone::get_all_hosts() const
+ .. doxygenfunction:: simgrid::s4u::NetZone::get_host_count() const
.. group-tab:: C
- .. autodoxymethod:: sg_zone_get_hosts(const_sg_netzone_t zone, xbt_dynar_t whereto)
+ .. doxygenfunction:: sg_zone_get_hosts(const_sg_netzone_t zone, xbt_dynar_t whereto)
Routing data
------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::NetZone::add_bypass_route
- .. autodoxymethod:: simgrid::s4u::NetZone::add_component(kernel::routing::NetPoint *elm)
- .. autodoxymethod:: simgrid::s4u::NetZone::add_route
- .. autodoxymethod:: simgrid::s4u::NetZone::get_children() const
- .. autodoxymethod:: simgrid::s4u::NetZone::get_father()
+ .. doxygenfunction:: simgrid::s4u::NetZone::add_component(kernel::routing::NetPoint *elm)
+ .. doxygenfunction:: simgrid::s4u::NetZone::add_route
+ .. doxygenfunction:: simgrid::s4u::NetZone::add_bypass_route
+ .. doxygenfunction:: simgrid::s4u::NetZone::get_children() const
+ .. doxygenfunction:: simgrid::s4u::NetZone::get_parent() const
.. group-tab:: C
- .. autodoxymethod:: sg_zone_get_sons(const_sg_netzone_t zone, xbt_dict_t whereto)
+ .. doxygenfunction:: sg_zone_get_sons(const_sg_netzone_t zone, xbt_dict_t whereto)
Signals
-------
.. group-tab:: C++
- .. autodoxyvar:: simgrid::s4u::NetZone::on_creation
- .. autodoxyvar:: simgrid::s4u::NetZone::on_route_creation
- .. autodoxyvar:: simgrid::s4u::NetZone::on_seal
+ .. doxygenvariable:: simgrid::s4u::NetZone::on_creation
+ .. doxygenvariable:: simgrid::s4u::NetZone::on_seal
.. _API_s4u_VirtualMachine:
=======================
-.. autodoxyclass:: simgrid::s4u::VirtualMachine
+.. doxygenclass:: simgrid::s4u::VirtualMachine
Basic management
----------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::VirtualMachine::VirtualMachine(const std::string &name, Host *physical_host, int core_amount)
- .. autodoxymethod:: simgrid::s4u::VirtualMachine::VirtualMachine(const std::string &name, Host *physical_host, int core_amount, size_t ramsize)
- .. autodoxymethod:: simgrid::s4u::VirtualMachine::destroy
+ .. doxygenfunction:: simgrid::s4u::VirtualMachine::VirtualMachine(const std::string &name, Host *physical_host, int core_amount)
+ .. doxygenfunction:: simgrid::s4u::VirtualMachine::VirtualMachine(const std::string &name, Host *physical_host, int core_amount, size_t ramsize)
+ .. doxygenfunction:: simgrid::s4u::VirtualMachine::destroy
.. group-tab:: C
- .. autodoxymethod:: sg_vm_create_core
- .. autodoxymethod:: sg_vm_create_multicore
- .. autodoxymethod:: sg_vm_destroy
+ .. doxygenfunction:: sg_vm_create_core
+ .. doxygenfunction:: sg_vm_create_multicore
+ .. doxygenfunction:: sg_vm_destroy
Querying info
--------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::VirtualMachine::get_pm() const
- .. autodoxymethod:: simgrid::s4u::VirtualMachine::get_ramsize() const
- .. autodoxymethod:: simgrid::s4u::VirtualMachine::get_state() const
+ .. doxygenfunction:: simgrid::s4u::VirtualMachine::get_pm() const
+ .. doxygenfunction:: simgrid::s4u::VirtualMachine::get_ramsize() const
+ .. doxygenfunction:: simgrid::s4u::VirtualMachine::get_state() const
- .. autodoxymethod:: simgrid::s4u::VirtualMachine::set_bound(double bound)
- .. autodoxymethod:: simgrid::s4u::VirtualMachine::set_pm(Host *pm)
- .. autodoxymethod:: simgrid::s4u::VirtualMachine::set_ramsize(size_t ramsize)
+ .. doxygenfunction:: simgrid::s4u::VirtualMachine::set_bound(double bound)
+ .. doxygenfunction:: simgrid::s4u::VirtualMachine::set_pm(Host *pm)
+ .. doxygenfunction:: simgrid::s4u::VirtualMachine::set_ramsize(size_t ramsize)
.. group-tab:: C
- .. autodoxymethod:: sg_vm_get_ramsize(const_sg_vm_t vm)
- .. autodoxymethod:: sg_vm_set_bound(sg_vm_t vm, double bound)
- .. autodoxymethod:: sg_vm_set_ramsize(sg_vm_t vm, size_t size)
+ .. doxygenfunction:: sg_vm_get_ramsize(const_sg_vm_t vm)
+ .. doxygenfunction:: sg_vm_set_bound(sg_vm_t vm, double bound)
+ .. doxygenfunction:: sg_vm_set_ramsize(sg_vm_t vm, size_t size)
- .. autodoxymethod:: sg_vm_get_name
- .. autodoxymethod:: sg_vm_get_pm
- .. autodoxymethod:: sg_vm_is_created
- .. autodoxymethod:: sg_vm_is_running
- .. autodoxymethod:: sg_vm_is_suspended
+ .. doxygenfunction:: sg_vm_get_name
+ .. doxygenfunction:: sg_vm_get_pm
+ .. doxygenfunction:: sg_vm_is_created
+ .. doxygenfunction:: sg_vm_is_running
+ .. doxygenfunction:: sg_vm_is_suspended
Life cycle
----------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::VirtualMachine::resume()
- .. autodoxymethod:: simgrid::s4u::VirtualMachine::shutdown()
- .. autodoxymethod:: simgrid::s4u::VirtualMachine::start()
- .. autodoxymethod:: simgrid::s4u::VirtualMachine::suspend()
+ .. doxygenfunction:: simgrid::s4u::VirtualMachine::resume()
+ .. doxygenfunction:: simgrid::s4u::VirtualMachine::shutdown()
+ .. doxygenfunction:: simgrid::s4u::VirtualMachine::start()
+ .. doxygenfunction:: simgrid::s4u::VirtualMachine::suspend()
.. group-tab:: C
- .. autodoxymethod:: sg_vm_start
- .. autodoxymethod:: sg_vm_suspend
- .. autodoxymethod:: sg_vm_resume
- .. autodoxymethod:: sg_vm_shutdown
+ .. doxygenfunction:: sg_vm_start
+ .. doxygenfunction:: sg_vm_suspend
+ .. doxygenfunction:: sg_vm_resume
+ .. doxygenfunction:: sg_vm_shutdown
Signals
-------
.. group-tab:: C++
- .. autodoxyvar:: simgrid::s4u::VirtualMachine::on_migration_end
- .. autodoxyvar:: simgrid::s4u::VirtualMachine::on_migration_start
- .. autodoxyvar:: simgrid::s4u::VirtualMachine::on_resume
- .. autodoxyvar:: simgrid::s4u::VirtualMachine::on_shutdown
- .. autodoxyvar:: simgrid::s4u::VirtualMachine::on_start
- .. autodoxyvar:: simgrid::s4u::VirtualMachine::on_started
- .. autodoxyvar:: simgrid::s4u::VirtualMachine::on_suspend
+ .. doxygenvariable:: simgrid::s4u::VirtualMachine::on_migration_end
+ .. doxygenvariable:: simgrid::s4u::VirtualMachine::on_migration_start
+ .. doxygenvariable:: simgrid::s4u::VirtualMachine::on_resume
+ .. doxygenvariable:: simgrid::s4u::VirtualMachine::on_shutdown
+ .. doxygenvariable:: simgrid::s4u::VirtualMachine::on_start
+ .. doxygenvariable:: simgrid::s4u::VirtualMachine::on_started
+ .. doxygenvariable:: simgrid::s4u::VirtualMachine::on_suspend
.. _API_s4u_Activity:
class Activity
==============
-.. autodoxyclass:: simgrid::s4u::Activity
+.. doxygenclass:: simgrid::s4u::Activity
- **Known subclasses:**
- :ref:`Communications <API_s4u_Comm>` (started on Mailboxes and consuming links),
- :ref:`Executions <API_s4u_Exec>` (started on Host and consuming CPU resources)
- :ref:`I/O <API_s4u_Io>` (started on and consumming disks).
- See also the :ref:`section on activities <s4u_Activities>` above.
+**Known subclasses:**
+:ref:`Communications <API_s4u_Comm>` (started on Mailboxes and consuming links),
+:ref:`Executions <API_s4u_Exec>` (started on Host and consuming CPU resources)
+:ref:`I/O <API_s4u_Io>` (started on and consuming disks).
+See also the :ref:`section on activities <s4u_Activities>` above.
Basic management
----------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Activity::get_cname
- .. autodoxymethod:: simgrid::s4u::Activity::get_name
- .. autodoxymethod:: simgrid::s4u::Activity::get_remaining() const
- .. autodoxymethod:: simgrid::s4u::Activity::get_state() const
- .. autodoxymethod:: simgrid::s4u::Activity::set_remaining(double remains)
- .. autodoxymethod:: simgrid::s4u::Activity::set_state(Activity::State state)
+ .. doxygenfunction:: simgrid::s4u::Activity::get_cname
+ .. doxygenfunction:: simgrid::s4u::Activity::get_name
+ .. doxygenfunction:: simgrid::s4u::Activity::get_remaining() const
+ .. doxygenfunction:: simgrid::s4u::Activity::get_state() const
+ .. doxygenfunction:: simgrid::s4u::Activity::set_remaining(double remains)
+ .. doxygenfunction:: simgrid::s4u::Activity::set_state(Activity::State state)
Activities life cycle
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Activity::start
- .. autodoxymethod:: simgrid::s4u::Activity::cancel
- .. autodoxymethod:: simgrid::s4u::Activity::test
- .. autodoxymethod:: simgrid::s4u::Activity::wait
- .. autodoxymethod:: simgrid::s4u::Activity::wait_for
- .. autodoxymethod:: simgrid::s4u::Activity::wait_until(double time_limit)
- .. autodoxymethod:: simgrid::s4u::Activity::vetoable_start()
+ .. doxygenfunction:: simgrid::s4u::Activity::start
+ .. doxygenfunction:: simgrid::s4u::Activity::cancel
+ .. doxygenfunction:: simgrid::s4u::Activity::test
+ .. doxygenfunction:: simgrid::s4u::Activity::wait
+ .. doxygenfunction:: simgrid::s4u::Activity::wait_for
+ .. doxygenfunction:: simgrid::s4u::Activity::wait_until(double time_limit)
+ .. doxygenfunction:: simgrid::s4u::Activity::vetoable_start()
Suspending and resuming an activity
-----------------------------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Activity::suspend
- .. autodoxymethod:: simgrid::s4u::Activity::resume
- .. autodoxymethod:: simgrid::s4u::Activity::is_suspended
+ .. doxygenfunction:: simgrid::s4u::Activity::suspend
+ .. doxygenfunction:: simgrid::s4u::Activity::resume
+ .. doxygenfunction:: simgrid::s4u::Activity::is_suspended
.. _API_s4u_Comm:
class Comm
=============
-.. autodoxyclass:: simgrid::s4u::Comm
+.. doxygenclass:: simgrid::s4u::Comm
Basic management
----------------
from simgrid import Comm
+ .. autoclass:: simgrid.Comm
+
+ .. group-tab:: c
+
+ .. code:: c
+
+ #include <simgrid/comm.h>
+
+ .. doxygentypedef:: sg_comm_t
+ .. doxygentypedef:: const_sg_comm_t
+
Querying info
-------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Comm::get_dst_data_size() const
- .. autodoxymethod:: simgrid::s4u::Comm::get_mailbox() const
- .. autodoxymethod:: simgrid::s4u::Comm::get_sender() const
- .. autodoxymethod:: simgrid::s4u::Comm::set_dst_data(void **buff)
- .. autodoxymethod:: simgrid::s4u::Comm::set_dst_data(void **buff, size_t size)
- .. autodoxymethod:: simgrid::s4u::Comm::detach()
- .. autodoxymethod:: simgrid::s4u::Comm::detach(void(*clean_function)(void *))
- .. autodoxymethod:: simgrid::s4u::Comm::set_rate(double rate)
- .. autodoxymethod:: simgrid::s4u::Comm::set_src_data(void *buff)
- .. autodoxymethod:: simgrid::s4u::Comm::set_src_data(void *buff, size_t size)
- .. autodoxymethod:: simgrid::s4u::Comm::set_src_data_size(size_t size)
+ .. doxygenfunction:: simgrid::s4u::Comm::get_dst_data_size() const
+ .. doxygenfunction:: simgrid::s4u::Comm::get_mailbox() const
+ .. doxygenfunction:: simgrid::s4u::Comm::get_sender() const
+ .. doxygenfunction:: simgrid::s4u::Comm::set_dst_data(void **buff)
+ .. doxygenfunction:: simgrid::s4u::Comm::set_dst_data(void **buff, size_t size)
+ .. doxygenfunction:: simgrid::s4u::Comm::detach()
+ .. doxygenfunction:: simgrid::s4u::Comm::detach(void(*clean_function)(void *))
+ .. doxygenfunction:: simgrid::s4u::Comm::set_payload_size(double bytes)
+ .. doxygenfunction:: simgrid::s4u::Comm::set_rate(double rate)
+ .. doxygenfunction:: simgrid::s4u::Comm::set_src_data(void *buff)
+ .. doxygenfunction:: simgrid::s4u::Comm::set_src_data(void *buff, size_t size)
+ .. doxygenfunction:: simgrid::s4u::Comm::set_src_data_size(size_t size)
Life cycle
----------
+Most communications are created using :ref:`s4u_mailbox`, but you can
+also start direct communications as shown below.
+
.. tabs::
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Comm::cancel
- .. autodoxymethod:: simgrid::s4u::Comm::start
- .. autodoxymethod:: simgrid::s4u::Comm::test
- .. autodoxymethod:: simgrid::s4u::Comm::test_any(const std::vector< CommPtr > *comms)
- .. autodoxymethod:: simgrid::s4u::Comm::wait
- .. autodoxymethod:: simgrid::s4u::Comm::wait_all(const std::vector< CommPtr > *comms)
- .. autodoxymethod:: simgrid::s4u::Comm::wait_any(const std::vector< CommPtr > *comms)
- .. autodoxymethod:: simgrid::s4u::Comm::wait_any_for(const std::vector< CommPtr > *comms_in, double timeout)
- .. autodoxymethod:: simgrid::s4u::Comm::wait_for
+ .. doxygenfunction:: simgrid::s4u::Comm::sendto
+ .. doxygenfunction:: simgrid::s4u::Comm::sendto_init
+ .. doxygenfunction:: simgrid::s4u::Comm::sendto_async
+
+ .. doxygenfunction:: simgrid::s4u::Comm::cancel
+ .. doxygenfunction:: simgrid::s4u::Comm::start
+ .. doxygenfunction:: simgrid::s4u::Comm::test
+ .. doxygenfunction:: simgrid::s4u::Comm::test_any(const std::vector< CommPtr >& comms)
+ .. doxygenfunction:: simgrid::s4u::Comm::wait
+ .. doxygenfunction:: simgrid::s4u::Comm::wait_all(const std::vector< CommPtr >& comms)
+ .. doxygenfunction:: simgrid::s4u::Comm::wait_all_for(const std::vector< CommPtr >& comms, double timeout)
+ .. doxygenfunction:: simgrid::s4u::Comm::wait_any(const std::vector< CommPtr >& comms)
+ .. doxygenfunction:: simgrid::s4u::Comm::wait_any_for(const std::vector< CommPtr >& comms, double timeout)
+ .. doxygenfunction:: simgrid::s4u::Comm::wait_for
.. group-tab:: Python
- .. automethod:: simgrid.Comm.test
- .. automethod:: simgrid.Comm.wait
- .. automethod:: simgrid.Comm.wait_all
- .. automethod:: simgrid.Comm.wait_any
+ .. automethod:: simgrid.Comm.test
+ .. automethod:: simgrid.Comm.wait
+ .. automethod:: simgrid.Comm.wait_all
+ .. automethod:: simgrid.Comm.wait_any
+
+ .. group-tab:: C
+
+ .. doxygenfunction:: sg_comm_test
+ .. doxygenfunction:: sg_comm_wait
+ .. doxygenfunction:: sg_comm_wait_all
+ .. doxygenfunction:: sg_comm_wait_any
Signals
-------
.. group-tab:: C++
- .. autodoxyvar:: simgrid::s4u::Comm::on_completion
- .. autodoxyvar:: simgrid::s4u::Comm::on_start
+ .. doxygenvariable:: simgrid::s4u::Comm::on_completion
+ .. doxygenvariable:: simgrid::s4u::Comm::on_start
.. _API_s4u_Exec:
class Exec
=============
-.. autodoxyclass:: simgrid::s4u::Exec
+.. doxygenclass:: simgrid::s4u::Exec
Basic management
----------------
from simgrid import Exec
+ .. autoclass:: simgrid.Exec
+
+ .. group-tab:: C
+
+ .. code-block:: C
+
+ #include <simgrid/exec.h>
+
+ .. doxygentypedef:: sg_exec_t
+ .. doxygentypedef:: const_sg_exec_t
+
Querying info
-------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Exec::get_cost() const
- .. autodoxymethod:: simgrid::s4u::Exec::get_finish_time() const
- .. autodoxymethod:: simgrid::s4u::Exec::get_host() const
- .. autodoxymethod:: simgrid::s4u::Exec::get_host_number() const
- .. cpp:function:: double Exec::get_remaining()
-
- On sequential executions, returns the amount of flops that remain to be done;
- This cannot be used on parallel executions.
-
- .. autodoxymethod:: simgrid::s4u::Exec::get_remaining_ratio
- .. autodoxymethod:: simgrid::s4u::Exec::get_start_time() const
- .. autodoxymethod:: simgrid::s4u::Exec::set_bound(double bound)
- .. autodoxymethod:: simgrid::s4u::Exec::set_host
- .. autodoxymethod:: simgrid::s4u::Exec::set_priority(double priority)
+ .. doxygenfunction:: simgrid::s4u::Exec::get_cost() const
+ .. doxygenfunction:: simgrid::s4u::Exec::get_finish_time() const
+ .. doxygenfunction:: simgrid::s4u::Exec::get_host() const
+ .. doxygenfunction:: simgrid::s4u::Exec::get_host_number() const
+ .. doxygenfunction:: simgrid::s4u::Exec::get_remaining
+ .. doxygenfunction:: simgrid::s4u::Exec::get_remaining_ratio
+ .. doxygenfunction:: simgrid::s4u::Exec::get_start_time() const
+ .. doxygenfunction:: simgrid::s4u::Exec::set_bound(double bound)
+ .. doxygenfunction:: simgrid::s4u::Exec::set_host
+ .. doxygenfunction:: simgrid::s4u::Exec::set_priority(double priority)
.. group-tab:: Python
- .. autoattribute:: simgrid.Exec.host
- .. autoattribute:: simgrid.Exec.remaining
- .. autoattribute:: simgrid.Exec.remaining_ratio
+ .. autoattribute:: simgrid.Exec.host
+ .. autoattribute:: simgrid.Exec.remaining
+ .. autoattribute:: simgrid.Exec.remaining_ratio
+
+ .. group-tab:: C
+
+ .. doxygenfunction:: sg_exec_set_bound(sg_exec_t exec, double bound)
+ .. doxygenfunction:: sg_exec_get_name(const_sg_exec_t exec)
+ .. doxygenfunction:: sg_exec_set_name(sg_exec_t exec, const char* name)
+ .. doxygenfunction:: sg_exec_set_host(sg_exec_t exec, sg_host_t new_host)
+ .. doxygenfunction:: sg_exec_get_remaining(const_sg_exec_t exec)
+ .. doxygenfunction:: sg_exec_get_remaining_ratio(const_sg_exec_t exec)
Life cycle
----------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Exec::cancel
- .. autodoxymethod:: simgrid::s4u::Exec::set_timeout(double timeout)
- .. autodoxymethod:: simgrid::s4u::Exec::start
- .. autodoxymethod:: simgrid::s4u::Exec::test
- .. autodoxymethod:: simgrid::s4u::Exec::wait
- .. autodoxymethod:: simgrid::s4u::Exec::wait_any(std::vector< ExecPtr > *execs)
- .. autodoxymethod:: simgrid::s4u::Exec::wait_any_for(std::vector< ExecPtr > *execs, double timeout)
- .. autodoxymethod:: simgrid::s4u::Exec::wait_for
+ .. doxygenfunction:: simgrid::s4u::Exec::cancel
+ .. doxygenfunction:: simgrid::s4u::Exec::start
+ .. doxygenfunction:: simgrid::s4u::Exec::test
+ .. doxygenfunction:: simgrid::s4u::Exec::wait
+ .. doxygenfunction:: simgrid::s4u::Exec::wait_any(const std::vector< ExecPtr >& execs)
+ .. doxygenfunction:: simgrid::s4u::Exec::wait_any_for(const std::vector< ExecPtr >& execs, double timeout)
+ .. doxygenfunction:: simgrid::s4u::Exec::wait_for
.. group-tab:: Python
.. automethod:: simgrid.Exec.test
.. automethod:: simgrid.Exec.wait
+ .. group-tab:: C
+
+ .. doxygenfunction:: sg_exec_start(sg_exec_t exec)
+ .. doxygenfunction:: sg_exec_cancel(sg_exec_t exec);
+ .. doxygenfunction:: sg_exec_test(sg_exec_t exec);
+ .. doxygenfunction:: sg_exec_wait(sg_exec_t exec);
+ .. doxygenfunction:: sg_exec_wait_for(sg_exec_t exec, double timeout);
+ .. doxygenfunction:: sg_exec_wait_any_for(sg_exec_t* execs, size_t count, double timeout);
+ .. doxygenfunction:: sg_exec_wait_any(sg_exec_t* execs, size_t count);
+
Signals
-------
.. group-tab:: C++
- .. autodoxyvar:: simgrid::s4u::Exec::on_start
- .. autodoxyvar:: simgrid::s4u::Exec::on_completion
+ .. doxygenvariable:: simgrid::s4u::Exec::on_start
+ .. doxygenvariable:: simgrid::s4u::Exec::on_completion
.. _API_s4u_Io:
class Io
===========
-.. autodoxyclass:: simgrid::s4u::Io
+.. doxygenclass:: simgrid::s4u::Io
Basic management
----------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Io::get_performed_ioops() const
- .. autodoxymethod:: simgrid::s4u::Io::get_remaining
+ .. doxygenfunction:: simgrid::s4u::Io::get_performed_ioops() const
+ .. doxygenfunction:: simgrid::s4u::Io::get_remaining
Life cycle
----------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Io::cancel
- .. autodoxymethod:: simgrid::s4u::Io::start
- .. autodoxymethod:: simgrid::s4u::Io::test
- .. autodoxymethod:: simgrid::s4u::Io::wait
- .. autodoxymethod:: simgrid::s4u::Io::wait_for
+ .. doxygenfunction:: simgrid::s4u::Io::cancel
+ .. doxygenfunction:: simgrid::s4u::Io::start
+ .. doxygenfunction:: simgrid::s4u::Io::test
+ .. doxygenfunction:: simgrid::s4u::Io::wait
+ .. doxygenfunction:: simgrid::s4u::Io::wait_for
.. _API_s4u_Synchronizations:
Mutex
==============
-.. autodoxyclass:: simgrid::s4u::Mutex
+.. doxygenclass:: simgrid::s4u::Mutex
Basic management
----------------
.. doxygentypedef:: MutexPtr
- .. autodoxymethod:: simgrid::s4u::Mutex::Mutex(kernel::activity::MutexImpl *mutex)
- .. autodoxymethod:: simgrid::s4u::Mutex::create()
- .. autodoxymethod:: simgrid::s4u::Mutex::~Mutex()
+ .. doxygenfunction:: simgrid::s4u::Mutex::create()
.. group-tab:: C
Pointer to a constant mutex object.
- .. autodoxymethod:: sg_mutex_init()
- .. autodoxymethod:: sg_mutex_destroy(const_sg_mutex_t mutex)
+ .. doxygenfunction:: sg_mutex_init()
+ .. doxygenfunction:: sg_mutex_destroy(const_sg_mutex_t mutex)
Locking
-------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Mutex::lock()
- .. autodoxymethod:: simgrid::s4u::Mutex::try_lock()
- .. autodoxymethod:: simgrid::s4u::Mutex::unlock()
+ .. doxygenfunction:: simgrid::s4u::Mutex::lock()
+ .. doxygenfunction:: simgrid::s4u::Mutex::try_lock()
+ .. doxygenfunction:: simgrid::s4u::Mutex::unlock()
.. group-tab:: C
- .. autodoxymethod:: sg_mutex_lock(sg_mutex_t mutex)
- .. autodoxymethod:: sg_mutex_try_lock(sg_mutex_t mutex)
- .. autodoxymethod:: sg_mutex_unlock(sg_mutex_t mutex)
+ .. doxygenfunction:: sg_mutex_lock(sg_mutex_t mutex)
+ .. doxygenfunction:: sg_mutex_try_lock(sg_mutex_t mutex)
+ .. doxygenfunction:: sg_mutex_unlock(sg_mutex_t mutex)
.. _API_s4u_Barrier:
Barrier
================
-.. autodoxyclass:: simgrid::s4u::Barrier
+.. doxygenclass:: simgrid::s4u::Barrier
- .. tabs::
+.. tabs::
- .. group-tab:: C++
+ .. group-tab:: C++
- .. code-block:: C++
+ .. code-block:: C++
- #include <simgrid/s4u/Barrier.hpp>
+ #include <simgrid/s4u/Barrier.hpp>
- .. doxygentypedef:: BarrierPtr
+ .. doxygentypedef:: BarrierPtr
- .. autodoxymethod:: simgrid::s4u::Barrier::Barrier(unsigned int expected_actors)
- .. autodoxymethod:: simgrid::s4u::Barrier::create(unsigned int expected_actors)
- .. autodoxymethod:: simgrid::s4u::Barrier::wait()
+ .. doxygenfunction:: simgrid::s4u::Barrier::Barrier(unsigned int expected_actors)
+ .. doxygenfunction:: simgrid::s4u::Barrier::create(unsigned int expected_actors)
+ .. doxygenfunction:: simgrid::s4u::Barrier::wait()
- .. group-tab:: C
+ .. group-tab:: C
- .. code-block:: C
+ .. code-block:: C
- #include <simgrid/barrier.hpp>
+ #include <simgrid/barrier.hpp>
- .. doxygentypedef:: sg_bar_t
- .. cpp:type:: const s4u_Barrier* const_sg_bar_t
+ .. doxygentypedef:: sg_bar_t
+ .. cpp:type:: const s4u_Barrier* const_sg_bar_t
- Pointer to a constant barrier object.
+ Pointer to a constant barrier object.
- .. autodoxymethod:: sg_barrier_init(unsigned int count)
- .. autodoxymethod:: sg_barrier_destroy(const_sg_bar_t bar)
- .. autodoxymethod:: sg_barrier_wait(sg_bar_t bar)
+ .. doxygenfunction:: sg_barrier_init(unsigned int count)
+ .. doxygenfunction:: sg_barrier_destroy(const_sg_bar_t bar)
+ .. doxygenfunction:: sg_barrier_wait(sg_bar_t bar)
.. _API_s4u_ConditionVariable:
Condition variable
==========================
-.. autodoxyclass:: simgrid::s4u::ConditionVariable
+.. doxygenclass:: simgrid::s4u::ConditionVariable
Basic management
----------------
.. doxygentypedef:: ConditionVariablePtr
- .. autodoxymethod:: simgrid::s4u::ConditionVariable::create()
+ .. doxygenfunction:: simgrid::s4u::ConditionVariable::create()
.. group-tab:: C
#include <simgrid/cond.h>
.. doxygentypedef:: sg_cond_t
- .. autodoxymethod:: sg_cond_init
- .. autodoxymethod:: sg_cond_destroy
+ .. doxygentypedef:: const_sg_cond_t
+ .. doxygenfunction:: sg_cond_init
+ .. doxygenfunction:: sg_cond_destroy
Waiting and notifying
---------------------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::ConditionVariable::notify_all()
- .. autodoxymethod:: simgrid::s4u::ConditionVariable::notify_one()
- .. autodoxymethod:: simgrid::s4u::ConditionVariable::wait(s4u::MutexPtr lock)
- .. autodoxymethod:: simgrid::s4u::ConditionVariable::wait(const std::unique_lock< s4u::Mutex > &lock)
- .. autodoxymethod:: simgrid::s4u::ConditionVariable::wait(const std::unique_lock< Mutex > &lock, P pred)
- .. autodoxymethod:: simgrid::s4u::ConditionVariable::wait_for(const std::unique_lock< s4u::Mutex > &lock, double duration)
- .. autodoxymethod:: simgrid::s4u::ConditionVariable::wait_for(const std::unique_lock< s4u::Mutex > &lock, double duration, P pred)
- .. autodoxymethod:: simgrid::s4u::ConditionVariable::wait_for(const std::unique_lock< s4u::Mutex > &lock, std::chrono::duration< Rep, Period > duration)
- .. autodoxymethod:: simgrid::s4u::ConditionVariable::wait_for(const std::unique_lock< s4u::Mutex > &lock, std::chrono::duration< Rep, Period > duration, P pred)
- .. autodoxymethod:: simgrid::s4u::ConditionVariable::wait_until(const std::unique_lock< s4u::Mutex > &lock, const SimulationTimePoint< Duration > &timeout_time)
- .. autodoxymethod:: simgrid::s4u::ConditionVariable::wait_until(const std::unique_lock< s4u::Mutex > &lock, const SimulationTimePoint< Duration > &timeout_time, P pred)
- .. autodoxymethod:: simgrid::s4u::ConditionVariable::wait_until(const std::unique_lock< s4u::Mutex > &lock, double timeout_time)
- .. autodoxymethod:: simgrid::s4u::ConditionVariable::wait_until(const std::unique_lock< s4u::Mutex > &lock, double timeout_time, P pred)
+ .. doxygenfunction:: simgrid::s4u::ConditionVariable::notify_all()
+ .. doxygenfunction:: simgrid::s4u::ConditionVariable::notify_one()
+ .. doxygenfunction:: simgrid::s4u::ConditionVariable::wait(s4u::MutexPtr lock)
+ .. doxygenfunction:: simgrid::s4u::ConditionVariable::wait(const std::unique_lock< s4u::Mutex > &lock)
+ .. doxygenfunction:: simgrid::s4u::ConditionVariable::wait(const std::unique_lock< Mutex > &lock, P pred)
+ .. doxygenfunction:: simgrid::s4u::ConditionVariable::wait_for(const std::unique_lock< s4u::Mutex > &lock, double duration)
+ .. doxygenfunction:: simgrid::s4u::ConditionVariable::wait_for(const std::unique_lock< s4u::Mutex > &lock, double duration, P pred)
+ .. doxygenfunction:: simgrid::s4u::ConditionVariable::wait_for(const std::unique_lock< s4u::Mutex > &lock, std::chrono::duration< Rep, Period > duration)
+ .. doxygenfunction:: simgrid::s4u::ConditionVariable::wait_for(const std::unique_lock< s4u::Mutex > &lock, std::chrono::duration< Rep, Period > duration, P pred)
+ .. doxygenfunction:: simgrid::s4u::ConditionVariable::wait_until(const std::unique_lock< s4u::Mutex > &lock, const SimulationTimePoint< Duration > &timeout_time)
+ .. doxygenfunction:: simgrid::s4u::ConditionVariable::wait_until(const std::unique_lock< s4u::Mutex > &lock, const SimulationTimePoint< Duration > &timeout_time, P pred)
+ .. doxygenfunction:: simgrid::s4u::ConditionVariable::wait_until(const std::unique_lock< s4u::Mutex > &lock, double timeout_time)
+ .. doxygenfunction:: simgrid::s4u::ConditionVariable::wait_until(const std::unique_lock< s4u::Mutex > &lock, double timeout_time, P pred)
.. group-tab:: C
- .. autodoxymethod:: sg_cond_notify_all
- .. autodoxymethod:: sg_cond_notify_one
- .. autodoxymethod:: sg_cond_wait
- .. autodoxymethod:: sg_cond_wait_for
+ .. doxygenfunction:: sg_cond_notify_all
+ .. doxygenfunction:: sg_cond_notify_one
+ .. doxygenfunction:: sg_cond_wait
+ .. doxygenfunction:: sg_cond_wait_for
.. _API_s4u_Semaphore:
Semaphore
==================
-.. autodoxyclass:: simgrid::s4u::Semaphore
+.. doxygenclass:: simgrid::s4u::Semaphore
Basic management
#include <simgrid/s4u/Semaphore.hpp>
.. doxygentypedef:: SemaphorePtr
- .. autodoxymethod:: simgrid::s4u::Semaphore::Semaphore(unsigned int initial_capacity)
- .. autodoxymethod:: simgrid::s4u::Semaphore::~Semaphore()
- .. autodoxymethod:: simgrid::s4u::Semaphore::create(unsigned int initial_capacity)
+ .. doxygenfunction:: simgrid::s4u::Semaphore::create(unsigned int initial_capacity)
.. group-tab:: C
Pointer to a constant semaphore object.
- .. autodoxymethod:: sg_sem_init(int initial_value)
- .. autodoxymethod:: sg_sem_destroy(const_sg_sem_t sem)
+ .. doxygenfunction:: sg_sem_init(int initial_value)
+ .. doxygenfunction:: sg_sem_destroy(const_sg_sem_t sem)
Locking
-------
.. group-tab:: C++
- .. autodoxymethod:: simgrid::s4u::Semaphore::acquire()
- .. autodoxymethod:: simgrid::s4u::Semaphore::acquire_timeout(double timeout)
- .. autodoxymethod:: simgrid::s4u::Semaphore::get_capacity() const
- .. autodoxymethod:: simgrid::s4u::Semaphore::release()
- .. autodoxymethod:: simgrid::s4u::Semaphore::would_block() const
+ .. doxygenfunction:: simgrid::s4u::Semaphore::acquire()
+ .. doxygenfunction:: simgrid::s4u::Semaphore::acquire_timeout(double timeout)
+ .. doxygenfunction:: simgrid::s4u::Semaphore::get_capacity() const
+ .. doxygenfunction:: simgrid::s4u::Semaphore::release()
+ .. doxygenfunction:: simgrid::s4u::Semaphore::would_block() const
.. group-tab:: C
- .. autodoxymethod:: sg_sem_acquire(sg_sem_t sem)
- .. autodoxymethod:: sg_sem_acquire_timeout(sg_sem_t sem, double timeout)
- .. autodoxymethod:: sg_sem_get_capacity(const_sg_sem_t sem)
- .. autodoxymethod:: sg_sem_release(sg_sem_t sem)
- .. autodoxymethod:: sg_sem_would_block(const_sg_sem_t sem)
+ .. doxygenfunction:: sg_sem_acquire(sg_sem_t sem)
+ .. doxygenfunction:: sg_sem_acquire_timeout(sg_sem_t sem, double timeout)
+ .. doxygenfunction:: sg_sem_get_capacity(const_sg_sem_t sem)
+ .. doxygenfunction:: sg_sem_release(sg_sem_t sem)
+ .. doxygenfunction:: sg_sem_would_block(const_sg_sem_t sem)
.. |hr| raw:: html