X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/f3c242fa5d818b0c2986ecb06e76f691e295c698..c0706f6e5a3d8d2034aa3ba75b6a3958d899d6a0:/include/simgrid/actor.h diff --git a/include/simgrid/actor.h b/include/simgrid/actor.h index 23816c12a7..eac34be51c 100644 --- a/include/simgrid/actor.h +++ b/include/simgrid/actor.h @@ -1,6 +1,4 @@ -/* Public interface to the Link datatype */ - -/* Copyright (c) 2018. The SimGrid Team. All rights reserved. */ +/* Copyright (c) 2018-2020. The SimGrid Team. All rights reserved. */ /* This program is free software; you can redistribute it and/or modify it * under the terms of the license (GNU LGPL) which comes with this package. */ @@ -13,7 +11,7 @@ #include /* C interface */ -SG_BEGIN_DECL() +SG_BEGIN_DECL /** @brief Actor datatype. @ingroup m_actor_management @@ -22,20 +20,51 @@ SG_BEGIN_DECL() You should not access directly to the fields of the pointed structure, but always use the provided API to interact with actors. */ - -XBT_PUBLIC int sg_actor_get_PID(sg_actor_t actor); -XBT_PUBLIC int sg_actor_get_PPID(sg_actor_t actor); -XBT_PUBLIC const char* sg_actor_get_name(sg_actor_t actor); -XBT_PUBLIC sg_host_t sg_actor_get_host(sg_actor_t actor); -XBT_PUBLIC const char* sg_actor_get_property_value(sg_actor_t actor, const char* name); -XBT_PUBLIC xbt_dict_t sg_actor_get_properties(sg_actor_t actor); +XBT_PUBLIC sg_actor_t sg_actor_init(const char* name, sg_host_t host); +/** Start the previously initialized actor. + * + * Note that argv is copied over, so you should free your own copy once the actor is started. */ +XBT_PUBLIC void sg_actor_start(sg_actor_t actor, xbt_main_func_t code, int argc, char** argv); +XBT_PUBLIC aid_t sg_actor_get_PID(const_sg_actor_t actor); +XBT_PUBLIC aid_t sg_actor_get_PPID(const_sg_actor_t actor); +XBT_PUBLIC sg_actor_t sg_actor_by_PID(aid_t pid); +XBT_PUBLIC const char* sg_actor_get_name(const_sg_actor_t actor); +XBT_PUBLIC sg_host_t sg_actor_get_host(const_sg_actor_t actor); +XBT_PUBLIC const char* sg_actor_get_property_value(const_sg_actor_t actor, const char* name); +XBT_PUBLIC xbt_dict_t sg_actor_get_properties(const_sg_actor_t actor); XBT_PUBLIC void sg_actor_suspend(sg_actor_t actor); XBT_PUBLIC void sg_actor_resume(sg_actor_t actor); XBT_PUBLIC int sg_actor_is_suspended(sg_actor_t actor); XBT_PUBLIC sg_actor_t sg_actor_restart(sg_actor_t actor); +void sg_actor_set_auto_restart(sg_actor_t actor, int auto_restart); XBT_PUBLIC void sg_actor_daemonize(sg_actor_t actor); -XBT_PUBLIC void sg_actor_migrate(sg_actor_t process, sg_host_t host); -SG_END_DECL() +#ifndef DOXYGEN +XBT_ATTRIB_DEPRECATED_v329("Please use sg_actor_set_host() instead") XBT_PUBLIC + void sg_actor_migrate(sg_actor_t process, sg_host_t host); +#endif + +XBT_PUBLIC void sg_actor_set_host(sg_actor_t actor, sg_host_t host); +XBT_PUBLIC void sg_actor_join(sg_actor_t actor, double timeout); +XBT_PUBLIC void sg_actor_kill(sg_actor_t actor); +XBT_PUBLIC void sg_actor_kill_all(); +XBT_PUBLIC void sg_actor_set_kill_time(sg_actor_t actor, double kill_time); +XBT_PUBLIC void sg_actor_yield(); +XBT_PUBLIC void sg_actor_sleep_for(double duration); +XBT_PUBLIC sg_actor_t sg_actor_attach(const char* name, void* data, sg_host_t host, xbt_dict_t properties); +XBT_PUBLIC void sg_actor_detach(); +XBT_PUBLIC sg_actor_t sg_actor_self(); +XBT_PUBLIC aid_t sg_actor_self_get_pid(); +XBT_PUBLIC aid_t sg_actor_self_get_ppid(); +XBT_PUBLIC const char* sg_actor_self_get_name(); +XBT_PUBLIC void* sg_actor_self_data(); +XBT_PUBLIC void sg_actor_self_data_set(void* data); +XBT_PUBLIC void sg_actor_self_execute(double flops); +XBT_PUBLIC void sg_actor_ref(const_sg_actor_t actor); +XBT_PUBLIC void sg_actor_unref(const_sg_actor_t actor); +XBT_PUBLIC void* sg_actor_data(const_sg_actor_t actor); +XBT_PUBLIC void sg_actor_data_set(sg_actor_t actor, void* userdata); + +SG_END_DECL #endif /* INCLUDE_SIMGRID_ACTOR_H_ */