X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/2539fff313cbd67c45b8490f7961e45e358d9ba2..134d9301d8336ed27bf6ccf13978bb432f08e163:/src/gras/Msg/msg.c diff --git a/src/gras/Msg/msg.c b/src/gras/Msg/msg.c index c7a5097f34..e705dbcd8f 100644 --- a/src/gras/Msg/msg.c +++ b/src/gras/Msg/msg.c @@ -2,31 +2,62 @@ /* messaging - Function related to messaging (code shared between RL and SG)*/ -/* Authors: Martin Quinson */ -/* Copyright (C) 2003 the OURAGAN project. */ +/* Copyright (c) 2003, 2004 Martin Quinson. 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. */ + * under the terms of the license (GNU LGPL) which comes with this package. */ + #include "gras/Msg/msg_private.h" #include "gras/DataDesc/datadesc_interface.h" #include "gras/Transport/transport_interface.h" /* gras_trp_chunk_send/recv */ #include "gras/Virtu/virtu_interface.h" -XBT_LOG_NEW_DEFAULT_SUBCATEGORY(msg,gras,"High level messaging"); +#define MIN(a,b) ((a) < (b) ? (a) : (b)) + +XBT_LOG_NEW_DEFAULT_SUBCATEGORY(gras_msg,gras,"High level messaging"); xbt_set_t _gras_msgtype_set = NULL; static char GRAS_header[6]; static char *make_namev(const char *name, short int ver); -/** - * gras_msg_init: - * +/* + * Creating procdata for this module + */ +static void *gras_msg_procdata_new() { + gras_msg_procdata_t res = xbt_new(s_gras_msg_procdata_t,1); + + res->msg_queue = xbt_dynar_new(sizeof(s_gras_msg_t), NULL); + res->cbl_list = xbt_dynar_new(sizeof(gras_cblist_t *),gras_cbl_free); + res->timers = xbt_dynar_new(sizeof(s_gras_timer_t), NULL); + + return (void*)res; +} + +/* + * Freeing procdata for this module + */ +static void gras_msg_procdata_free(void *data) { + gras_msg_procdata_t res = (gras_msg_procdata_t)data; + + xbt_dynar_free(&( res->msg_queue )); + xbt_dynar_free(&( res->cbl_list )); + xbt_dynar_free(&( res->timers )); + + free(res); +} + +/* + * Module registration + */ +void gras_msg_register() { + gras_procdata_add("gras_msg",gras_msg_procdata_new, gras_msg_procdata_free); +} + +/* * Initialize this submodule. */ void gras_msg_init(void) { - xbt_error_t errcode; - /* only initialize once */ if (_gras_msgtype_set != NULL) return; @@ -40,27 +71,23 @@ void gras_msg_init(void) { GRAS_header[5]=(char)GRAS_THISARCH; } -/** - * gras_msg_exit: - * +/* * Finalize the msg module - **/ + */ void gras_msg_exit(void) { VERB0("Exiting Msg"); xbt_set_free(&_gras_msgtype_set); } -/** - * gras_msgtype_free: - * +/* * Reclamed memory */ void gras_msgtype_free(void *t) { gras_msgtype_t msgtype=(gras_msgtype_t)t; if (msgtype) { - xbt_free(msgtype->name); - xbt_free(msgtype); + free(msgtype->name); + free(msgtype); } } @@ -84,25 +111,23 @@ static char *make_namev(const char *name, short int ver) { return namev; } -/** - * gras_msgtype_declare: - * @name: name as it should be used for logging messages (must be uniq) - * @payload: datadescription of the payload +/** @brief declare a new message type of the given name. It only accepts the given datadesc as payload * - * Registers a message to the GRAS mecanism. + * @param name: name as it should be used for logging messages (must be uniq) + * @param payload: datadescription of the payload */ void gras_msgtype_declare(const char *name, gras_datadesc_type_t payload) { gras_msgtype_declare_v(name, 0, payload); } -/** - * gras_msgtype_declare_v: - * @name: name as it should be used for logging messages (must be uniq) - * @version: something like versionning symbol - * @payload: datadescription of the payload +/** @brief declare a new versionned message type of the given name and payload + * + * @param name: name as it should be used for logging messages (must be uniq) + * @param version: something like versionning symbol + * @param payload: datadescription of the payload * - * Registers a message to the GRAS mecanism. Use this version instead of + * Registers a message to the GRAS mechanism. Use this version instead of * gras_msgtype_declare when you change the semantic or syntax of a message and * want your programs to be able to deal with both versions. Internally, each * will be handled as an independent message type, so you can register @@ -116,7 +141,7 @@ gras_msgtype_declare_v(const char *name, xbt_error_t errcode; gras_msgtype_t msgtype; char *namev=make_namev(name,version); - + errcode = xbt_set_get_by_name(_gras_msgtype_set, namev,(xbt_set_elm_t*)&msgtype); @@ -145,19 +170,12 @@ gras_msgtype_declare_v(const char *name, &gras_msgtype_free); } -/** - * gras_msgtype_by_name: - * - * Retrieve a datatype description from its name - */ +/** @brief retrive an existing message type from its name. */ gras_msgtype_t gras_msgtype_by_name (const char *name) { return gras_msgtype_by_namev(name,0); } -/** - * gras_msgtype_by_namev: - * - * Retrieve a datatype description from its name and version - */ + +/** @brief retrive an existing message type from its name and version. */ gras_msgtype_t gras_msgtype_by_namev(const char *name, short int version) { gras_msgtype_t res; @@ -172,16 +190,13 @@ gras_msgtype_t gras_msgtype_by_namev(const char *name, if (!res) WARN1("msgtype_by_name(%s) returns NULL",namev); if (name != namev) - xbt_free(namev); + free(namev); return res; } -/** - * gras_msg_send: - * - * Send the given message on the given socket - */ +/** \brief Send the data pointed by \a payload as a message of type + * \a msgtype to the peer \a sock */ xbt_error_t gras_msg_send(gras_socket_t sock, gras_msgtype_t msgtype, @@ -209,9 +224,7 @@ gras_msg_send(gras_socket_t sock, return no_error; } -/** - * gras_msg_recv: - * +/* * receive the next message on the given socket. */ xbt_error_t @@ -235,7 +248,7 @@ gras_msg_recv(gras_socket_t sock, TRY(gras_trp_chunk_recv(sock, header, 6)); for (cpt=0; cpt<4; cpt++) if (header[cpt] != GRAS_header[cpt]) - RAISE0(mismatch_error,"Incoming bytes do not look like a GRAS message"); + RAISE2(mismatch_error,"Incoming bytes do not look like a GRAS message (header='%.4s' not '%.4s')",header,GRAS_header); if (header[4] != GRAS_header[4]) RAISE2(mismatch_error,"GRAS protocol mismatch (got %d, use %d)", (int)header[4], (int)GRAS_header[4]); @@ -251,7 +264,7 @@ gras_msg_recv(gras_socket_t sock, "Got error %s while retrieving the type associated to messages '%s'", xbt_error_name(errcode),msg_name); /* FIXME: Survive unknown messages */ - xbt_free(msg_name); + free(msg_name); *payload_size=gras_datadesc_size((*msgtype)->ctn_type); xbt_assert2(*payload_size > 0, @@ -264,16 +277,16 @@ gras_msg_recv(gras_socket_t sock, return no_error; } -/** - * gras_msg_wait: - * @timeout: How long should we wait for this message. - * @id: id of awaited msg - * @Returns: the error code (or no_error). +/** \brief Waits for a message to come in over a given socket. * - * Waits for a message to come in over a given socket. + * @param timeout: How long should we wait for this message. + * @param msgt_want: type of awaited msg + * @param[out] expeditor: where to create a socket to answer the incomming message + * @param[out] payload: where to write the payload of the incomming message + * @return the error code (or no_error). * * Every message of another type received before the one waited will be queued - * and used by subsequent call to this function or MsgHandle(). + * and used by subsequent call to this function or gras_msg_handle(). */ xbt_error_t gras_msg_wait(double timeout, @@ -286,9 +299,9 @@ gras_msg_wait(double timeout, int payload_size_got; xbt_error_t errcode; double start, now; - gras_procdata_t *pd=gras_procdata_get(); + gras_msg_procdata_t pd=(gras_msg_procdata_t)gras_libdata_get("gras_msg"); int cpt; - gras_msg_t msg; + s_gras_msg_t msg; *expeditor = NULL; payload_got = NULL; @@ -297,7 +310,7 @@ gras_msg_wait(double timeout, RAISE0(mismatch_error, "Cannot wait for the NULL message (did msgtype_by_name fail?)"); - VERB1("Waiting for message %s",msgt_want->name); + VERB1("Waiting for message '%s'",msgt_want->name); start = now = gras_os_time(); @@ -305,7 +318,7 @@ gras_msg_wait(double timeout, if (msg.type->code == msgt_want->code) { *expeditor = msg.expeditor; memcpy(payload, msg.payload, msg.payload_size); - xbt_free(msg.payload); + free(msg.payload); xbt_dynar_cursor_rm(pd->msg_queue, &cpt); VERB0("The waited message was queued"); return no_error; @@ -317,7 +330,7 @@ gras_msg_wait(double timeout, TRY(gras_msg_recv(*expeditor, &msgt_got, &payload_got, &payload_size_got)); if (msgt_got->code == msgt_want->code) { memcpy(payload, payload_got, payload_size_got); - xbt_free(payload_got); + free(payload_got); VERB0("Got waited message"); return no_error; } @@ -338,47 +351,86 @@ gras_msg_wait(double timeout, RAISE_IMPOSSIBLE; } -/** - * gras_msg_handle: - * @timeOut: How long to wait for incoming messages - * @Returns: the error code (or no_error). +/** @brief Handle an incomming message or timer (or wait up to \a timeOut seconds) * - * Waits up to #timeOut# seconds to see if a message comes in; if so, calls the - * registered listener for that message (see RegisterCallback()). + * @param timeOut: How long to wait for incoming messages (in seconds) + * @return the error code (or no_error). + * + * Messages are passed to the callbacks. */ xbt_error_t gras_msg_handle(double timeOut) { + double untiltimer; + xbt_error_t errcode; int cpt; - gras_msg_t msg; + s_gras_msg_t msg; gras_socket_t expeditor; void *payload=NULL; int payload_size; gras_msgtype_t msgtype; - gras_procdata_t*pd=gras_procdata_get(); - gras_cblist_t *list; - gras_cb_t cb; - - + gras_msg_procdata_t pd=(gras_msg_procdata_t)gras_libdata_get("gras_msg"); + gras_cblist_t *list=NULL; + gras_msg_cb_t cb; + + int timerexpected; VERB1("Handling message within the next %.2fs",timeOut); + untiltimer = gras_msg_timer_handle(); + DEBUG2("[%.0f] Next timer in %f sec", gras_os_time(), untiltimer); + if (untiltimer == 0.0) { + /* A timer was already elapsed and handled */ + return no_error; + } + if (untiltimer != -1.0) { + timerexpected = 1; + timeOut = MIN(timeOut, untiltimer); + } else { + timerexpected = 0; + } + /* get a message (from the queue or from the net) */ if (xbt_dynar_length(pd->msg_queue)) { + DEBUG0("Get a message from the queue"); xbt_dynar_shift(pd->msg_queue,&msg); expeditor = msg.expeditor; msgtype = msg.type; payload = msg.payload; - + errcode = no_error; } else { - TRY(gras_trp_select(timeOut, &expeditor)); - TRY(gras_msg_recv(expeditor, &msgtype, &payload, &payload_size)); + errcode = gras_trp_select(timeOut, &expeditor); + if (errcode != no_error && errcode != timeout_error) + return errcode; + if (errcode != timeout_error) + TRY(gras_msg_recv(expeditor, &msgtype, &payload, &payload_size)); } - - /* handle it */ + + if (errcode == timeout_error ) { + if (timerexpected) { + + /* A timer elapsed before the arrival of any message even if we select()ed a bit */ + untiltimer = gras_msg_timer_handle(); + if (untiltimer == 0.0) { + return no_error; + } else { + xbt_assert1(untiltimer>0, "Negative timer (%f). I'm puzzeled", untiltimer); + ERROR1("No timer elapsed, in contrary to expectations (next in %f sec)", + untiltimer); + return timeout_error; + } + + } else { + /* select timeouted, and no timer elapsed. Nothing to do */ + return timeout_error; + } + + } + + /* A message was already there or arrived in the meanwhile. handle it */ xbt_dynar_foreach(pd->cbl_list,cpt,list) { if (list->id == msgtype->code) { break; @@ -394,11 +446,11 @@ gras_msg_handle(double timeOut) { } xbt_dynar_foreach(list->cbs,cpt,cb) { - INFO3("Use the callback #%d (@%p) for incomming msg %s", - cpt+1,cb,msgtype->name); + VERB3("Use the callback #%d (@%p) for incomming msg %s", + cpt+1,cb,msgtype->name); if ((*cb)(expeditor,payload)) { /* cb handled the message */ - xbt_free(payload); + free(payload); return no_error; } } @@ -413,18 +465,24 @@ gras_cbl_free(void *data){ gras_cblist_t *list=*(void**)data; if (list) { xbt_dynar_free(&( list->cbs )); - xbt_free(list); + free(list); } } +/** \brief Bind the given callback to the given message type + * + * Several callbacks can be attached to a given message type. The lastly added one will get the message first, and + * if it returns false, the message will be passed to the second one. + * And so on until one of the callbacks accepts the message. + */ void gras_cb_register(gras_msgtype_t msgtype, - gras_cb_t cb) { - gras_procdata_t *pd=gras_procdata_get(); + gras_msg_cb_t cb) { + gras_msg_procdata_t pd=(gras_msg_procdata_t)gras_libdata_get("gras_msg"); gras_cblist_t *list=NULL; int cpt; - DEBUG2("Register %p as callback to %s",cb,msgtype->name); + DEBUG2("Register %p as callback to '%s'",cb,msgtype->name); /* search the list of cb for this message on this host (creating if NULL) */ xbt_dynar_foreach(pd->cbl_list,cpt,list) { @@ -438,7 +496,7 @@ gras_cb_register(gras_msgtype_t msgtype, /* First cb? Create room */ list = xbt_new(gras_cblist_t,1); list->id = msgtype->code; - list->cbs = xbt_dynar_new(sizeof(gras_cb_t), NULL); + list->cbs = xbt_dynar_new(sizeof(gras_msg_cb_t), NULL); xbt_dynar_push(pd->cbl_list,&list); } @@ -446,13 +504,14 @@ gras_cb_register(gras_msgtype_t msgtype, xbt_dynar_insert_at(list->cbs,0,&cb); } +/** \brief Unbind the given callback from the given message type */ void gras_cb_unregister(gras_msgtype_t msgtype, - gras_cb_t cb) { + gras_msg_cb_t cb) { - gras_procdata_t *pd=gras_procdata_get(); + gras_msg_procdata_t pd=(gras_msg_procdata_t)gras_libdata_get("gras_msg"); gras_cblist_t *list; - gras_cb_t cb_cpt; + gras_msg_cb_t cb_cpt; int cpt; int found = 0;