X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/a3427ca7c9f8f2563bb982044e1082cc8f3cdd1e..410bd96d9c3c8c33f6e7ea94afc45bde1e32dc4c:/include/gras/process.h diff --git a/include/gras/process.h b/include/gras/process.h index c19ee65599..3d5b95d6e2 100644 --- a/include/gras/process.h +++ b/include/gras/process.h @@ -11,26 +11,13 @@ #define GRAS_PROCESS_H #include "xbt/misc.h" /* SG_BEGIN_DECL */ +#include "xbt/dict.h" SG_BEGIN_DECL() -/* ************************************************************************** - * Initializing the processes - * **************************************************************************/ -/** - * gras_process_init: - * - * Perform the various intialisations needed by gras. Each process must run it - */ -void gras_process_init(void); - -/** - * gras_process_exit: - * - * Frees the memory allocated by gras. Processes should run it - */ -void gras_process_exit(void); - +void gras_agent_spawn(const char *name, void *data, xbt_main_func_t code, int argc, char *argv[], xbt_dict_t properties); + + /****************************************************************************/ /* Manipulating User Data */ /****************************************************************************/ @@ -45,7 +32,11 @@ void gras_process_exit(void); * * Use the \ref gras_userdata_new macro to create a new user data (or malloc it * and use \ref gras_userdata_set yourself), and \ref gras_userdata_get to - * retrieve a reference to it. + * retrieve a reference to it. + * + * + * For more info on this, you may want to check the relevant lesson of the GRAS tutorial: + * \ref GRAS_tut_tour_globals */ /* @{ */ @@ -53,16 +44,24 @@ void gras_process_exit(void); * \brief Get the data associated with the current process. * \ingroup GRAS_globals */ -void *gras_userdata_get(void); +XBT_PUBLIC(void*) gras_userdata_get(void); /** * \brief Set the data associated with the current process. * \ingroup GRAS_globals */ -void gras_userdata_set(void *ud); - -/** \brief Malloc and set the data associated with the current process. */ -#define gras_userdata_new(type) (gras_userdata_set(xbt_new0(type,1)),gras_userdata_get()) +XBT_PUBLIC(void*) gras_userdata_set(void *ud); + +/** \brief Malloc and set the data associated with the current process. + * + * @warnig gras_userdata_new() expects the pointed type, not the + * pointer type. We know it'a a bit troublesome, but it seems like + * the only solution since this macro has to compute the size to + * malloc and should thus know the pointed type. + * + * You'll find an example in the tutorial: \ref GRAS_tut_tour_globals + */ +#define gras_userdata_new(type) ((type*)gras_userdata_set(xbt_new0(type,1))) /* @} */ SG_END_DECL()