1 /* gras message types and callback registering and retrieving */
3 /* Copyright (c) 2007, 2009, 2010. The SimGrid Team.
4 * All rights reserved. */
6 /* This program is free software; you can redistribute it and/or modify it
7 * under the terms of the license (GNU LGPL) which comes with this package. */
10 #include "gras/Msg/msg_private.h"
11 #include "gras/Virtu/virtu_interface.h"
12 #include "gras/DataDesc/datadesc_interface.h"
14 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(gras_msg, gras, "High level messaging");
16 xbt_set_t _gras_msgtype_set = NULL;
19 /* ******************************************************************** */
21 /* ******************************************************************** */
25 void gras_msgtype_free(void *t)
27 gras_msgtype_t msgtype = (gras_msgtype_t) t;
35 * Dump all declared message types (debugging purpose)
37 void gras_msgtype_dumpall(void)
39 xbt_set_cursor_t cursor;
40 gras_msgtype_t msgtype = NULL;
42 XBT_INFO("Dump of all registered messages:");
43 xbt_set_foreach(_gras_msgtype_set, cursor, msgtype) {
44 XBT_INFO(" Message name: %s (v%d) %s; %s%s%s",
45 msgtype->name, msgtype->version,
46 e_gras_msg_kind_names[msgtype->kind],
47 gras_datadesc_get_name(msgtype->ctn_type),
48 (msgtype->kind == e_gras_msg_kind_rpccall ? " -> " : ""),
50 e_gras_msg_kind_rpccall ?
51 gras_datadesc_get_name(msgtype->answer_type) : ""));
59 * Returns the versionned name of the message.
60 * It's a newly allocated string, make sure to free it.
62 static char *make_namev(const char *name, short int ver)
65 return xbt_strdup(name);
67 return bprintf("%s_v%d", name, ver);
70 /* Internal function doing the crude work of registering messages */
72 gras_msgtype_declare_ext(const char *name,
74 e_gras_msg_kind_t kind,
75 gras_datadesc_type_t payload_request,
76 gras_datadesc_type_t payload_answer)
79 gras_msgtype_t msgtype = NULL;
80 char *namev = make_namev(name, version);
81 volatile int found = 0;
86 (gras_msgtype_t) xbt_set_get_by_name(_gras_msgtype_set, namev);
90 if (e.category != not_found_error) {
99 ("Re-register version %d of message '%s' (same kind & payload, ignored).",
101 xbt_assert(msgtype->kind == kind,
102 "Message %s re-registered as a %s (it was known as a %s)",
103 namev, e_gras_msg_kind_names[kind],
104 e_gras_msg_kind_names[msgtype->kind]);
105 xbt_assert(!gras_datadesc_type_cmp
106 (msgtype->ctn_type, payload_request),
107 "Message %s re-registred with another payload (%s was %s)",
108 namev, gras_datadesc_get_name(payload_request),
109 gras_datadesc_get_name(msgtype->ctn_type));
111 xbt_assert(!gras_datadesc_type_cmp
112 (msgtype->answer_type, payload_answer),
113 "Message %s re-registred with another answer payload (%s was %s)",
114 namev, gras_datadesc_get_name(payload_answer),
115 gras_datadesc_get_name(msgtype->answer_type));
118 return; /* do really ignore it */
121 XBT_VERB("Register version %d of message '%s' "
122 "(payload: %s; answer payload: %s).",
123 version, name, gras_datadesc_get_name(payload_request),
124 gras_datadesc_get_name(payload_answer));
126 msgtype = xbt_new(s_gras_msgtype_t, 1);
127 msgtype->name = namev;
128 msgtype->name_len = strlen(namev);
129 msgtype->version = version;
130 msgtype->kind = kind;
131 msgtype->ctn_type = payload_request;
132 msgtype->answer_type = payload_answer;
134 xbt_set_add(_gras_msgtype_set, (xbt_set_elm_t) msgtype,
139 /** @brief declare a new message type of the given name. It only accepts the given datadesc as payload
141 * @param name: name as it should be used for logging messages (must be uniq)
142 * @param payload: datadescription of the payload
144 void gras_msgtype_declare(const char *name, gras_datadesc_type_t payload)
146 gras_msgtype_declare_ext(name, 0, e_gras_msg_kind_oneway, payload, NULL);
151 /** @brief declare a new versionned message type of the given name and payload
153 * @param name: name as it should be used for logging messages (must be uniq)
154 * @param version: something like versionning symbol
155 * @param payload: datadescription of the payload
157 * Registers a message to the GRAS mechanism. Use this version instead of
158 * gras_msgtype_declare when you change the semantic or syntax of a message and
159 * want your programs to be able to deal with both versions. Internally, each
160 * will be handled as an independent message type, so you can register
161 * differents for each of them.
164 gras_msgtype_declare_v(const char *name,
165 short int version, gras_datadesc_type_t payload)
168 gras_msgtype_declare_ext(name, version,
169 e_gras_msg_kind_oneway, payload, NULL);
172 /** @brief retrieve an existing message type from its name (raises an exception if it does not exist). */
173 gras_msgtype_t gras_msgtype_by_name(const char *name)
175 return gras_msgtype_by_namev(name, 0);
178 /** @brief retrieve an existing message type from its name (or NULL if it does not exist). */
179 gras_msgtype_t gras_msgtype_by_name_or_null(const char *name)
182 gras_msgtype_t res = NULL;
185 res = gras_msgtype_by_namev(name, 0);
194 /** @brief retrieve an existing message type from its name and version. */
195 gras_msgtype_t gras_msgtype_by_namev(const char *name, short int version)
197 gras_msgtype_t res = NULL;
198 char *namev = make_namev(name, version);
199 volatile int found = 0;
203 res = (gras_msgtype_t) xbt_set_get_by_name(_gras_msgtype_set, namev);
210 THROWF(not_found_error, 0, "No registred message of that name: %s",
218 /** @brief retrieve an existing message type from its name and version. */
219 gras_msgtype_t gras_msgtype_by_id(int id)
221 return (gras_msgtype_t) xbt_set_get_by_id(_gras_msgtype_set, id);
224 /* ******************************************************************** */
226 /* ******************************************************************** */
228 XBT_INLINE const char *gras_msgtype_get_name(gras_msgtype_t type)
234 /* ******************************************************************** */
236 /* ******************************************************************** */
237 void gras_cbl_free(void *data)
239 gras_cblist_t *list = *(void **) data;
241 xbt_dynar_free(&(list->cbs));
246 /** \brief Bind the given callback to the given message type
248 * Several callbacks can be attached to a given message type.
249 * The lastly added one will get the message first, and
250 * if it returns a non-null value, the message will be passed to the
251 * second one. And so on until one of the callbacks accepts the message.
253 void gras_cb_register_(gras_msgtype_t msgtype, gras_msg_cb_t cb)
255 gras_msg_procdata_t pd =
256 (gras_msg_procdata_t) gras_libdata_by_id(gras_msg_libdata_id);
257 gras_cblist_t *list = NULL;
260 XBT_DEBUG("Register %p as callback to '%s'", cb, msgtype->name);
262 /* search the list of cb for this message on this host (creating if NULL) */
263 xbt_dynar_foreach(pd->cbl_list, cpt, list) {
264 if (list->id == msgtype->code) {
271 /* First cb? Create room */
272 list = xbt_new(gras_cblist_t, 1);
273 list->id = msgtype->code;
274 list->cbs = xbt_dynar_new(sizeof(gras_msg_cb_t), NULL);
275 xbt_dynar_push(pd->cbl_list, &list);
278 /* Insert the new one into the set */
279 xbt_dynar_insert_at(list->cbs, 0, &cb);
282 /** \brief Unbind the given callback from the given message type */
283 void gras_cb_unregister_(gras_msgtype_t msgtype, gras_msg_cb_t cb)
286 gras_msg_procdata_t pd =
287 (gras_msg_procdata_t) gras_libdata_by_id(gras_msg_libdata_id);
289 gras_msg_cb_t cb_cpt;
293 /* search the list of cb for this message on this host */
294 xbt_dynar_foreach(pd->cbl_list, cpt, list) {
295 if (list->id == msgtype->code) {
302 /* Remove it from the set */
304 xbt_dynar_foreach(list->cbs, cpt, cb_cpt) {
306 xbt_dynar_cursor_rm(list->cbs, &cpt);
312 XBT_VERB("Ignoring removal of unexisting callback to msg id %d",
316 /** \brief Retrieve the expeditor of the message */
317 gras_socket_t gras_msg_cb_ctx_from(gras_msg_cb_ctx_t ctx)
319 return ctx->expeditor;
322 /* \brief Creates a new message exchange context (user should never have to) */
323 gras_msg_cb_ctx_t gras_msg_cb_ctx_new(gras_socket_t expe,
324 gras_msgtype_t msgtype,
325 unsigned long int ID,
326 int answer_due, double timeout)
328 gras_msg_cb_ctx_t res = xbt_new(s_gras_msg_cb_ctx_t, 1);
329 res->expeditor = expe;
330 res->msgtype = msgtype;
332 res->timeout = timeout;
333 res->answer_due = answer_due;
338 /* \brief Frees a message exchange context
340 * This function is mainly useful with \ref gras_msg_wait_or, ie seldom.
342 void gras_msg_cb_ctx_free(gras_msg_cb_ctx_t ctx)