1 /* Copyright (c) 2018-2021. The SimGrid Team. All rights reserved. */
3 /* This program is free software; you can redistribute it and/or modify it
4 * under the terms of the license (GNU LGPL) which comes with this package. */
6 #ifndef INCLUDE_SIMGRID_ACTOR_H_
7 #define INCLUDE_SIMGRID_ACTOR_H_
9 #include <simgrid/forward.h>
15 /** @brief Actor datatype.
16 @ingroup m_actor_management
18 An actor may be defined as a <em>code</em>, with some <em>private data</em>, executing in a <em>location</em>.
20 You should not access directly to the fields of the pointed structure, but always use the provided API to interact
23 XBT_PUBLIC size_t sg_actor_count();
24 XBT_PUBLIC sg_actor_t* sg_actor_list();
26 XBT_PUBLIC sg_actor_t sg_actor_create_(const char* name, sg_host_t host, xbt_main_func_t code, int argc,
27 const char* const* argv);
28 static inline sg_actor_t sg_actor_create(const char* name, sg_host_t host, xbt_main_func_t code, int argc,
31 return sg_actor_create_(name, host, code, argc, (const char* const*)argv);
33 XBT_PUBLIC sg_actor_t sg_actor_init(const char* name, sg_host_t host);
34 /** Start the previously initialized actor.
36 * Note that argv is copied over, so you should free your own copy once the actor is started. */
37 XBT_PUBLIC void sg_actor_start_(sg_actor_t actor, xbt_main_func_t code, int argc, const char* const* argv);
38 static inline void sg_actor_start(sg_actor_t actor, xbt_main_func_t code, int argc, char* const* argv)
40 sg_actor_start_(actor, code, argc, (const char* const*)argv);
42 XBT_PUBLIC void sg_actor_set_stacksize(sg_actor_t actor, unsigned size);
44 XBT_PUBLIC void sg_actor_exit();
45 XBT_PUBLIC void sg_actor_on_exit(void_f_int_pvoid_t fun, void* data);
47 XBT_PUBLIC aid_t sg_actor_get_pid(const_sg_actor_t actor);
48 XBT_PUBLIC aid_t sg_actor_get_ppid(const_sg_actor_t actor);
49 XBT_PUBLIC sg_actor_t sg_actor_by_pid(aid_t pid);
50 XBT_ATTRIB_DEPRECATED_v331("Please use sg_actor_get_pid() instead") XBT_PUBLIC aid_t
51 sg_actor_get_PID(const_sg_actor_t actor);
52 XBT_ATTRIB_DEPRECATED_v331("Please use sg_actor_get_ppid() instead") XBT_PUBLIC aid_t
53 sg_actor_get_PPID(const_sg_actor_t actor);
54 XBT_ATTRIB_DEPRECATED_v331("Please use sg_actor_by_pid() instead") XBT_PUBLIC sg_actor_t sg_actor_by_PID(aid_t pid);
55 XBT_PUBLIC const char* sg_actor_get_name(const_sg_actor_t actor);
56 XBT_PUBLIC sg_host_t sg_actor_get_host(const_sg_actor_t actor);
57 XBT_PUBLIC const char* sg_actor_get_property_value(const_sg_actor_t actor, const char* name);
58 XBT_PUBLIC xbt_dict_t sg_actor_get_properties(const_sg_actor_t actor);
59 XBT_PUBLIC void sg_actor_suspend(sg_actor_t actor);
60 XBT_PUBLIC void sg_actor_resume(sg_actor_t actor);
61 XBT_PUBLIC int sg_actor_is_suspended(const_sg_actor_t actor);
62 XBT_PUBLIC sg_actor_t sg_actor_restart(sg_actor_t actor);
63 XBT_PUBLIC void sg_actor_set_auto_restart(sg_actor_t actor, int auto_restart);
64 XBT_PUBLIC void sg_actor_daemonize(sg_actor_t actor);
65 XBT_PUBLIC int sg_actor_is_daemon(const_sg_actor_t actor);
68 XBT_ATTRIB_DEPRECATED_v329("Please use sg_actor_set_host() instead") XBT_PUBLIC
69 void sg_actor_migrate(sg_actor_t process, sg_host_t host);
72 XBT_PUBLIC void sg_actor_set_host(sg_actor_t actor, sg_host_t host);
73 XBT_PUBLIC void sg_actor_join(const_sg_actor_t actor, double timeout);
74 XBT_PUBLIC void sg_actor_kill(sg_actor_t actor);
75 XBT_PUBLIC void sg_actor_kill_all();
76 XBT_PUBLIC void sg_actor_set_kill_time(sg_actor_t actor, double kill_time);
77 XBT_PUBLIC void sg_actor_yield();
78 XBT_PUBLIC void sg_actor_sleep_for(double duration);
79 XBT_PUBLIC void sg_actor_sleep_until(double wakeup_time);
80 XBT_PUBLIC sg_actor_t sg_actor_attach(const char* name, void* data, sg_host_t host, xbt_dict_t properties);
81 XBT_PUBLIC void sg_actor_detach();
82 XBT_PUBLIC sg_actor_t sg_actor_self();
83 XBT_PUBLIC aid_t sg_actor_self_get_pid();
84 XBT_PUBLIC aid_t sg_actor_self_get_ppid();
85 XBT_PUBLIC const char* sg_actor_self_get_name();
86 XBT_PUBLIC void* sg_actor_self_get_data();
87 XBT_PUBLIC void sg_actor_self_set_data(void* data);
88 XBT_ATTRIB_DEPRECATED_v330("Please use sg_actor_self_get_data() instead") XBT_PUBLIC void* sg_actor_self_data();
89 XBT_ATTRIB_DEPRECATED_v330("Please use sg_actor_self_set_data() instead") XBT_PUBLIC
90 void sg_actor_self_data_set(void* data);
91 XBT_ATTRIB_DEPRECATED_v330("Please use sg_actor_execute() instead") XBT_PUBLIC void sg_actor_self_execute(double flops);
92 XBT_PUBLIC void sg_actor_execute(double flops);
93 XBT_PUBLIC void sg_actor_execute_with_priority(double flops, double priority);
94 void sg_actor_parallel_execute(int host_nb, sg_host_t* host_list, double* flops_amount, double* bytes_amount);
95 XBT_PUBLIC void sg_actor_ref(const_sg_actor_t actor);
96 XBT_PUBLIC void sg_actor_unref(const_sg_actor_t actor);
97 XBT_PUBLIC void* sg_actor_get_data(const_sg_actor_t actor);
98 XBT_PUBLIC void sg_actor_set_data(sg_actor_t actor, void* userdata);
99 XBT_ATTRIB_DEPRECATED_v330("Please use sg_actor_get_data() instead") XBT_PUBLIC
100 void* sg_actor_data(const_sg_actor_t actor);
101 XBT_ATTRIB_DEPRECATED_v330("Please use sg_actor_set_data() instead") XBT_PUBLIC
102 void sg_actor_data_set(sg_actor_t actor, void* userdata);
104 XBT_PUBLIC sg_exec_t sg_actor_exec_init(double computation_amount);
105 XBT_PUBLIC sg_exec_t sg_actor_parallel_exec_init(int host_nb, const sg_host_t* host_list, double* flops_amount,
106 double* bytes_amount);
107 XBT_PUBLIC sg_exec_t sg_actor_exec_async(double computation_amount);
110 #endif /* INCLUDE_SIMGRID_ACTOR_H_ */