X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/c6e308f66a2689e0ac94c51c00e81e44be81923a..db76b8c2bb3acf20452613ccac46a9bee673f1b6:/src/msg/gos.c diff --git a/src/msg/gos.c b/src/msg/gos.c index 321bfef6fa..1055d810e7 100644 --- a/src/msg/gos.c +++ b/src/msg/gos.c @@ -1,14 +1,13 @@ -/* $Id$ */ - -/* Copyright (c) 2002-2007 Arnaud Legrand. */ -/* Copyright (c) 2007 Bruno Donassolo. */ -/* All rights reserved. */ +/* Copyright (c) 2004, 2005, 2006, 2007, 2008, 2009, 2010. 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. */ #include "msg/private.h" +#include "simix/private.h" #include "xbt/sysdep.h" +#include "mc/mc.h" #include "xbt/log.h" #include "mailbox.h" @@ -32,7 +31,7 @@ MSG_error_t MSG_get_errno(void) * This function is used for describing the behavior of an agent. It * takes only one parameter. * \param task a #m_task_t to execute on the location on which the - agent is running. + agent is running. * \return #MSG_FATAL if \a task is not properly initialized and * #MSG_OK otherwise. */ @@ -44,17 +43,31 @@ MSG_error_t MSG_task_execute(m_task_t task) CHECK_HOST(); simdata = task->simdata; - xbt_assert1((!simdata->compute) - && (task->simdata->refcount == 1), - "This task is executed somewhere else. Go fix your code! %d", task->simdata->refcount); + + xbt_assert0(simdata->host_nb == 0, + "This is a parallel task. Go to hell."); + +#ifdef HAVE_TRACING + TRACE_msg_task_execute_start(task); +#endif + + xbt_assert1((!simdata->compute) && (task->simdata->refcount == 1), + "This task is executed somewhere else. Go fix your code! %d", + task->simdata->refcount); DEBUG1("Computing on %s", MSG_process_self()->simdata->m_host->name); + if (simdata->computation_amount == 0) { +#ifdef HAVE_TRACING + TRACE_msg_task_execute_end(task); +#endif + return MSG_OK; + } simdata->refcount++; SIMIX_mutex_lock(simdata->mutex); simdata->compute = - SIMIX_action_execute(SIMIX_host_self(), task->name, - simdata->computation_amount); + SIMIX_action_execute(SIMIX_host_self(), task->name, + simdata->computation_amount); SIMIX_action_set_priority(simdata->compute, simdata->priority); /* changed to waiting action since we are always waiting one action (execute, communicate or sleep) */ @@ -76,18 +89,27 @@ MSG_error_t MSG_task_execute(m_task_t task) simdata->computation_amount = 0.0; simdata->comm = NULL; simdata->compute = NULL; +#ifdef HAVE_TRACING + TRACE_msg_task_execute_end(task); +#endif MSG_RETURN(MSG_OK); } else if (SIMIX_host_get_state(SIMIX_host_self()) == 0) { /* action ended, set comm and compute = NULL, the actions is already destroyed in the main function */ SIMIX_action_destroy(task->simdata->compute); simdata->comm = NULL; simdata->compute = NULL; +#ifdef HAVE_TRACING + TRACE_msg_task_execute_end(task); +#endif MSG_RETURN(MSG_HOST_FAILURE); } else { /* action ended, set comm and compute = NULL, the actions is already destroyed in the main function */ SIMIX_action_destroy(task->simdata->compute); simdata->comm = NULL; simdata->compute = NULL; +#ifdef HAVE_TRACING + TRACE_msg_task_execute_end(task); +#endif MSG_RETURN(MSG_TASK_CANCELLED); } } @@ -96,18 +118,18 @@ MSG_error_t MSG_task_execute(m_task_t task) * \brief Creates a new #m_task_t (a parallel one....). * * A constructor for #m_task_t taking six arguments and returning the - corresponding object. + corresponding object. * \param name a name for the object. It is for user-level information - and can be NULL. + and can be NULL. * \param host_nb the number of hosts implied in the parallel task. * \param host_list an array of \p host_nb m_host_t. * \param computation_amount an array of \p host_nb - doubles. computation_amount[i] is the total number of operations - that have to be performed on host_list[i]. + doubles. computation_amount[i] is the total number of operations + that have to be performed on host_list[i]. * \param communication_amount an array of \p host_nb* \p host_nb doubles. * \param data a pointer to any data may want to attach to the new - object. It is for user-level information and can be NULL. It can - be retrieved with the function \ref MSG_task_get_data. + object. It is for user-level information and can be NULL. It can + be retrieved with the function \ref MSG_task_get_data. * \see m_task_t * \return The new corresponding object. */ @@ -163,7 +185,8 @@ MSG_error_t MSG_parallel_task_execute(m_task_t task) && (task->simdata->refcount == 1), "This task is executed somewhere else. Go fix your code!"); - xbt_assert0(simdata->host_nb, "This is not a parallel task. Go to hell."); + xbt_assert0(simdata->host_nb, + "This is not a parallel task. Go to hell."); DEBUG1("Computing on %s", MSG_process_self()->simdata->m_host->name); @@ -171,9 +194,10 @@ MSG_error_t MSG_parallel_task_execute(m_task_t task) SIMIX_mutex_lock(simdata->mutex); simdata->compute = - SIMIX_action_parallel_execute(task->name, simdata->host_nb, - simdata->host_list, simdata->comp_amount, - simdata->comm_amount, 1.0, -1.0); + SIMIX_action_parallel_execute(task->name, simdata->host_nb, + simdata->host_list, + simdata->comp_amount, + simdata->comm_amount, 1.0, -1.0); self->simdata->waiting_action = simdata->compute; SIMIX_register_action_to_condition(simdata->compute, simdata->cond); @@ -228,10 +252,14 @@ MSG_error_t MSG_process_sleep(double nb_sec) smx_mutex_t mutex; smx_cond_t cond; +#ifdef HAVE_TRACING + TRACE_msg_process_sleep_in(MSG_process_self()); +#endif + /* create action to sleep */ act_sleep = - SIMIX_action_sleep(SIMIX_process_get_host(proc->simdata->s_process), - nb_sec); + SIMIX_action_sleep(SIMIX_process_get_host(proc->simdata->s_process), + nb_sec); mutex = SIMIX_mutex_init(); SIMIX_mutex_lock(mutex); @@ -256,14 +284,23 @@ MSG_error_t MSG_process_sleep(double nb_sec) if (SIMIX_action_get_state(act_sleep) == SURF_ACTION_DONE) { if (SIMIX_host_get_state(SIMIX_host_self()) == SURF_RESOURCE_OFF) { SIMIX_action_destroy(act_sleep); +#ifdef HAVE_TRACING + TRACE_msg_process_sleep_out(MSG_process_self()); +#endif MSG_RETURN(MSG_HOST_FAILURE); } } else { SIMIX_action_destroy(act_sleep); +#ifdef HAVE_TRACING + TRACE_msg_process_sleep_out(MSG_process_self()); +#endif MSG_RETURN(MSG_HOST_FAILURE); } SIMIX_action_destroy(act_sleep); +#ifdef HAVE_TRACING + TRACE_msg_process_sleep_out(MSG_process_self()); +#endif MSG_RETURN(MSG_OK); } @@ -272,15 +309,15 @@ MSG_error_t MSG_process_sleep(double nb_sec) * * It takes three parameters. * \param task a memory location for storing a #m_task_t. It will - hold a task when this function will return. Thus \a task should not - be equal to \c NULL and \a *task should be equal to \c NULL. If one of - those two condition does not hold, there will be a warning message. + hold a task when this function will return. Thus \a task should not + be equal to \c NULL and \a *task should be equal to \c NULL. If one of + those two condition does not hold, there will be a warning message. * \param channel the channel on which the agent should be - listening. This value has to be >=0 and < than the maximal - number of channels fixed with MSG_set_channel_number(). + listening. This value has to be >=0 and < than the maximal + number of channels fixed with MSG_set_channel_number(). * \param host the host that is to be watched. * \return #MSG_FATAL if \a task is equal to \c NULL, #MSG_WARNING - if \a *task is not equal to \c NULL, and #MSG_OK otherwise. + if \a *task is not equal to \c NULL, and #MSG_OK otherwise. */ MSG_error_t MSG_task_get_from_host(m_task_t * task, m_channel_t channel, m_host_t host) @@ -293,12 +330,12 @@ MSG_task_get_from_host(m_task_t * task, m_channel_t channel, m_host_t host) * * It takes two parameters. * \param task a memory location for storing a #m_task_t. It will - hold a task when this function will return. Thus \a task should not - be equal to \c NULL and \a *task should be equal to \c NULL. If one of - those two condition does not hold, there will be a warning message. + hold a task when this function will return. Thus \a task should not + be equal to \c NULL and \a *task should be equal to \c NULL. If one of + those two condition does not hold, there will be a warning message. * \param channel the channel on which the agent should be - listening. This value has to be >=0 and < than the maximal - number of channels fixed with MSG_set_channel_number(). + listening. This value has to be >=0 and < than the maximal + number of channels fixed with MSG_set_channel_number(). * \return #MSG_FATAL if \a task is equal to \c NULL, #MSG_WARNING * if \a *task is not equal to \c NULL, and #MSG_OK otherwise. */ @@ -312,18 +349,18 @@ MSG_error_t MSG_task_get(m_task_t * task, m_channel_t channel) * * It takes three parameters. * \param task a memory location for storing a #m_task_t. It will - hold a task when this function will return. Thus \a task should not - be equal to \c NULL and \a *task should be equal to \c NULL. If one of - those two condition does not hold, there will be a warning message. + hold a task when this function will return. Thus \a task should not + be equal to \c NULL and \a *task should be equal to \c NULL. If one of + those two condition does not hold, there will be a warning message. * \param channel the channel on which the agent should be - listening. This value has to be >=0 and < than the maximal - number of channels fixed with MSG_set_channel_number(). + listening. This value has to be >=0 and < than the maximal + number of channels fixed with MSG_set_channel_number(). * \param max_duration the maximum time to wait for a task before giving - up. In such a case, #MSG_TRANSFER_FAILURE will be returned, \a task - will not be modified and will still be - equal to \c NULL when returning. + up. In such a case, #MSG_TRANSFER_FAILURE will be returned, \a task + will not be modified and will still be + equal to \c NULL when returning. * \return #MSG_FATAL if \a task is equal to \c NULL, #MSG_WARNING - if \a *task is not equal to \c NULL, and #MSG_OK otherwise. + if \a *task is not equal to \c NULL, and #MSG_OK otherwise. */ MSG_error_t MSG_task_get_with_timeout(m_task_t * task, m_channel_t channel, @@ -346,12 +383,14 @@ MSG_task_get_ext(m_task_t * task, m_channel_t channel, double timeout, channel); return - MSG_mailbox_get_task_ext(MSG_mailbox_get_by_channel - (MSG_host_self(), channel), task, host, timeout); + MSG_mailbox_get_task_ext(MSG_mailbox_get_by_channel + (MSG_host_self(), channel), task, host, + timeout); } MSG_error_t -MSG_task_receive_from_host(m_task_t * task, const char *alias, m_host_t host) +MSG_task_receive_from_host(m_task_t * task, const char *alias, + m_host_t host) { return MSG_task_receive_ext(task, alias, -1, host); } @@ -372,10 +411,201 @@ MSG_error_t MSG_task_receive_ext(m_task_t * task, const char *alias, double timeout, m_host_t host) { - return MSG_mailbox_get_task_ext(MSG_mailbox_get_by_alias(alias), task, host, - timeout); + DEBUG1 + ("MSG_task_receive_ext: Trying to receive a message on mailbox '%s'", + alias); + return MSG_mailbox_get_task_ext(MSG_mailbox_get_by_alias(alias), task, + host, timeout); +} + +/** \ingroup msg_gos_functions + * \brief Send a task on a channel. + * + * This function takes two parameter. + * \param task a #m_task_t to send on another location. + * \param alias the channel on which the agent should put this + task. This value has to be >=0 and < than the maximal number of + channels fixed with MSG_set_channel_number(). + * \return the msg_comm_t communication. + */ +msg_comm_t MSG_task_isend(m_task_t task, const char *alias) +{ + simdata_task_t t_simdata = NULL; + m_process_t process = MSG_process_self(); + msg_mailbox_t mailbox = MSG_mailbox_get_by_alias(alias); + + CHECK_HOST(); + + /* FIXME: these functions are not tracable */ + + /* Prepare the task to send */ + t_simdata = task->simdata; + t_simdata->sender = process; + t_simdata->source = MSG_host_self(); + + xbt_assert0(t_simdata->refcount == 1, + "This task is still being used somewhere else. You cannot send it now. Go fix your code!"); + + t_simdata->refcount++; + msg_global->sent_msg++; + process->simdata->waiting_task = task; + + /* Send it by calling SIMIX network layer */ + + /* Kept for semantical compatibility with older implementation */ + if (mailbox->cond) + SIMIX_cond_signal(mailbox->cond); + + return SIMIX_network_isend(mailbox->rdv, t_simdata->message_size, + t_simdata->rate, task, sizeof(void *), + &t_simdata->comm); +} + +/** \ingroup msg_gos_functions + * \brief Listen on a channel for receiving a task from an asynchronous communication. + * + * It takes two parameters. + * \param task a memory location for storing a #m_task_t. + * \param alias the channel on which the agent should be + listening. This value has to be >=0 and < than the maximal + number of channels fixed with MSG_set_channel_number(). + * \return the msg_comm_t communication. + */ +msg_comm_t MSG_task_irecv(m_task_t * task, const char *alias) +{ + smx_comm_t comm; + smx_rdv_t rdv = MSG_mailbox_get_by_alias(alias)->rdv; + msg_mailbox_t mailbox = MSG_mailbox_get_by_alias(alias); + + CHECK_HOST(); + + /* FIXME: these functions are not tracable */ + + memset(&comm, 0, sizeof(comm)); + + /* Kept for compatibility with older implementation */ + xbt_assert1(!MSG_mailbox_get_cond(mailbox), + "A process is already blocked on this channel %s", + MSG_mailbox_get_alias(mailbox)); + + /* Sanity check */ + xbt_assert0(task, "Null pointer for the task storage"); + + if (*task) + CRITICAL0 + ("MSG_task_get() was asked to write in a non empty task struct."); + + /* Try to receive it by calling SIMIX network layer */ + return SIMIX_network_irecv(rdv, task, NULL); +} + +/** \ingroup msg_gos_functions + * \brief Test the status of a communication. + * + * It takes one parameter. + * \param comm the communication to test. + * \return the status of the communication: + * TRUE : the communication is completed + * FALSE: the communication is incompleted + * If the status is FALSE, don't forget to use MSG_process_sleep() after the test. + */ +int MSG_comm_test(msg_comm_t comm) +{ + return SIMIX_network_test(comm); +} + +/** \ingroup msg_gos_functions + * \brief After received TRUE to MSG_comm_test(), the communication must be destroyed. + * + * It takes one parameter. + * \param comm the communication to destroy. + */ +void MSG_comm_destroy(msg_comm_t comm) +{ + if (!(comm->src_proc == SIMIX_process_self())) { + m_task_t task; + task = (m_task_t) SIMIX_communication_get_src_buf(comm); + task->simdata->refcount--; + } + SIMIX_communication_destroy(comm); +} + +/** \ingroup msg_gos_functions + * \brief Wait for the completion of a communication. + * + * It takes two parameters. + * \param comm the communication to wait. + * \param timeout Wait until the communication terminates or the timeout occurs + * \return MSG_error_t + */ +MSG_error_t MSG_comm_wait(msg_comm_t comm, double timeout) +{ + xbt_ex_t e; + MSG_error_t res = MSG_OK; + TRY { + SIMIX_network_wait(comm, timeout); + + if (!(comm->src_proc == SIMIX_process_self())) { + m_task_t task; + task = (m_task_t) SIMIX_communication_get_src_buf(comm); + task->simdata->refcount--; + } + SIMIX_communication_destroy(comm); + + /* FIXME: these functions are not tracable */ + } + CATCH(e) { + switch (e.category) { + case host_error: + res = MSG_HOST_FAILURE; + break; + case network_error: + res = MSG_TRANSFER_FAILURE; + break; + case timeout_error: + res = MSG_TIMEOUT; + break; + default: + xbt_die(bprintf("Unhandled SIMIX network exception: %s", e.msg)); + } + xbt_ex_free(e); + } + return res; } +/** \ingroup msg_gos_functions +* \brief This function is called by a sender and permit to wait for each communication +* +* It takes three parameters. +* \param comm a vector of communication +* \param nb_elem is the size of the comm vector +* \param timeout for each call of MSG_comm_wait +*/ +void MSG_comm_waitall(msg_comm_t * comm, int nb_elem, double timeout) +{ + int i = 0; + for (i = 0; i < nb_elem; i++) { + MSG_comm_wait(comm[i], timeout); + } +} + +/** \ingroup msg_gos_functions +* \brief This function wait for the first completed communication +* +* It takes on parameter. +* \param comms a vector of communication +* \return the position of the completed communication from the xbt_dynar_t. +*/ +int MSG_comm_waitany(xbt_dynar_t comms) +{ + return SIMIX_network_waitany(comms); +} + +m_task_t MSG_comm_get_task(msg_comm_t comm) +{ + xbt_assert0(comm, "Invalid parameters"); + return (m_task_t) SIMIX_communication_get_src_buf(comm); +} /** \ingroup msg_gos_functions * \brief Put a task on a channel of an host and waits for the end of the @@ -384,19 +614,19 @@ MSG_task_receive_ext(m_task_t * task, const char *alias, double timeout, * This function is used for describing the behavior of an agent. It * takes three parameter. * \param task a #m_task_t to send on another location. This task - will not be usable anymore when the function will return. There is - no automatic task duplication and you have to save your parameters - before calling this function. Tasks are unique and once it has been - sent to another location, you should not access it anymore. You do - not need to call MSG_task_destroy() but to avoid using, as an - effect of inattention, this task anymore, you definitely should - renitialize it with #MSG_TASK_UNINITIALIZED. Note that this task - can be transfered iff it has been correctly created with - MSG_task_create(). + will not be usable anymore when the function will return. There is + no automatic task duplication and you have to save your parameters + before calling this function. Tasks are unique and once it has been + sent to another location, you should not access it anymore. You do + not need to call MSG_task_destroy() but to avoid using, as an + effect of inattention, this task anymore, you definitely should + renitialize it with #MSG_TASK_UNINITIALIZED. Note that this task + can be transfered iff it has been correctly created with + MSG_task_create(). * \param dest the destination of the message * \param channel the channel on which the agent should put this - task. This value has to be >=0 and < than the maximal number of - channels fixed with MSG_set_channel_number(). + task. This value has to be >=0 and < than the maximal number of + channels fixed with MSG_set_channel_number(). * \return #MSG_FATAL if \a task is not properly initialized and * #MSG_OK otherwise. Returns #MSG_HOST_FAILURE if the host on which * this function was called was shut down. Returns @@ -429,43 +659,44 @@ MSG_task_put_bounded(m_task_t task, m_host_t dest, m_channel_t channel, * This function is used for describing the behavior of an agent. It * takes four parameter. * \param task a #m_task_t to send on another location. This task - will not be usable anymore when the function will return. There is - no automatic task duplication and you have to save your parameters - before calling this function. Tasks are unique and once it has been - sent to another location, you should not access it anymore. You do - not need to call MSG_task_destroy() but to avoid using, as an - effect of inattention, this task anymore, you definitely should - renitialize it with #MSG_TASK_UNINITIALIZED. Note that this task - can be transfered iff it has been correctly created with - MSG_task_create(). + will not be usable anymore when the function will return. There is + no automatic task duplication and you have to save your parameters + before calling this function. Tasks are unique and once it has been + sent to another location, you should not access it anymore. You do + not need to call MSG_task_destroy() but to avoid using, as an + effect of inattention, this task anymore, you definitely should + renitialize it with #MSG_TASK_UNINITIALIZED. Note that this task + can be transfered iff it has been correctly created with + MSG_task_create(). * \param dest the destination of the message * \param channel the channel on which the agent should put this - task. This value has to be >=0 and < than the maximal number of - channels fixed with MSG_set_channel_number(). + task. This value has to be >=0 and < than the maximal number of + channels fixed with MSG_set_channel_number(). * \param timeout the maximum time to wait for a task before giving - up. In such a case, #MSG_TRANSFER_FAILURE will be returned, \a task - will not be modified + up. In such a case, #MSG_TRANSFER_FAILURE will be returned, \a task + will not be modified * \return #MSG_FATAL if \a task is not properly initialized and - #MSG_OK otherwise. Returns #MSG_HOST_FAILURE if the host on which - this function was called was shut down. Returns - #MSG_TRANSFER_FAILURE if the transfer could not be properly done - (network failure, dest failure, timeout...) +#MSG_OK otherwise. Returns #MSG_HOST_FAILURE if the host on which +this function was called was shut down. Returns +#MSG_TRANSFER_FAILURE if the transfer could not be properly done +(network failure, dest failure, timeout...) */ MSG_error_t -MSG_task_put_with_timeout(m_task_t task, m_host_t dest, m_channel_t channel, - double timeout) +MSG_task_put_with_timeout(m_task_t task, m_host_t dest, + m_channel_t channel, double timeout) { xbt_assert1((channel >= 0) && (channel < msg_global->max_channel), "Invalid channel %d", channel); return - MSG_mailbox_put_with_timeout(MSG_mailbox_get_by_channel(dest, channel), - task, timeout); + MSG_mailbox_put_with_timeout(MSG_mailbox_get_by_channel + (dest, channel), task, timeout); } MSG_error_t MSG_task_send(m_task_t task, const char *alias) { + DEBUG1("MSG_task_send: Trying to send a message on mailbox '%s'", alias); return MSG_task_send_with_timeout(task, alias, -1); } @@ -479,10 +710,11 @@ MSG_task_send_bounded(m_task_t task, const char *alias, double maxrate) MSG_error_t -MSG_task_send_with_timeout(m_task_t task, const char *alias, double timeout) +MSG_task_send_with_timeout(m_task_t task, const char *alias, + double timeout) { - return MSG_mailbox_put_with_timeout(MSG_mailbox_get_by_alias(alias), task, - timeout); + return MSG_mailbox_put_with_timeout(MSG_mailbox_get_by_alias(alias), + task, timeout); } int MSG_task_listen(const char *alias) @@ -497,8 +729,8 @@ int MSG_task_listen(const char *alias) * * It takes one parameter. * \param channel the channel on which the agent should be - listening. This value has to be >=0 and < than the maximal - number of channels fixed with MSG_set_channel_number(). + listening. This value has to be >=0 and < than the maximal + number of channels fixed with MSG_set_channel_number(). * \return 1 if there is a pending communication and 0 otherwise */ int MSG_task_Iprobe(m_channel_t channel) @@ -510,22 +742,22 @@ int MSG_task_Iprobe(m_channel_t channel) CHECK_HOST(); return - !MSG_mailbox_is_empty(MSG_mailbox_get_by_channel - (MSG_host_self(), channel)); + !MSG_mailbox_is_empty(MSG_mailbox_get_by_channel + (MSG_host_self(), channel)); } /** \ingroup msg_gos_functions * \brief Return the number of tasks waiting to be received on a \a - channel and sent by \a host. + channel and sent by \a host. * * It takes two parameters. * \param channel the channel on which the agent should be - listening. This value has to be >=0 and < than the maximal - number of channels fixed with MSG_set_channel_number(). + listening. This value has to be >=0 and < than the maximal + number of channels fixed with MSG_set_channel_number(). * \param host the host that is to be watched. * \return the number of tasks waiting to be received on \a channel - and sent by \a host. + and sent by \a host. */ int MSG_task_probe_from_host(int channel, m_host_t host) { @@ -536,9 +768,9 @@ int MSG_task_probe_from_host(int channel, m_host_t host) CHECK_HOST(); return - MSG_mailbox_get_count_host_waiting_tasks(MSG_mailbox_get_by_channel - (MSG_host_self(), channel), - host); + MSG_mailbox_get_count_host_waiting_tasks(MSG_mailbox_get_by_channel + (MSG_host_self(), channel), + host); } @@ -547,8 +779,8 @@ int MSG_task_listen_from_host(const char *alias, m_host_t host) CHECK_HOST(); return - MSG_mailbox_get_count_host_waiting_tasks(MSG_mailbox_get_by_alias(alias), - host); + MSG_mailbox_get_count_host_waiting_tasks(MSG_mailbox_get_by_alias + (alias), host); } /** \ingroup msg_gos_functions @@ -556,8 +788,8 @@ int MSG_task_listen_from_host(const char *alias, m_host_t host) * * It takes one parameter. * \param channel the channel on which the agent should be - listening. This value has to be >=0 and < than the maximal - number of channels fixed with MSG_set_channel_number(). + listening. This value has to be >=0 and < than the maximal + number of channels fixed with MSG_set_channel_number(). * \return -1 if there is no pending communication and the PID of the process who sent it otherwise */ int MSG_task_probe_from(m_channel_t channel) @@ -585,7 +817,8 @@ int MSG_task_listen_from(const char *alias) CHECK_HOST(); - if (NULL == (task = MSG_mailbox_get_head(MSG_mailbox_get_by_alias(alias)))) + if (NULL == + (task = MSG_mailbox_get_head(MSG_mailbox_get_by_alias(alias)))) return -1; return MSG_process_get_PID(task->simdata->sender); @@ -593,20 +826,20 @@ int MSG_task_listen_from(const char *alias) /** \ingroup msg_gos_functions * \brief Wait for at most \a max_duration second for a task reception - on \a channel. + on \a channel. * \a PID is updated with the PID of the first process that triggered this event if any. * * It takes three parameters: * \param channel the channel on which the agent should be - listening. This value has to be >=0 and < than the maximal. - number of channels fixed with MSG_set_channel_number(). + listening. This value has to be >=0 and < than the maximal. + number of channels fixed with MSG_set_channel_number(). * \param PID a memory location for storing an int. * \param timeout the maximum time to wait for a task before - giving up. In the case of a reception, *\a PID will be updated - with the PID of the first process to send a task. + giving up. In the case of a reception, *\a PID will be updated + with the PID of the first process to send a task. * \return #MSG_HOST_FAILURE if the host is shut down in the meantime - and #MSG_OK otherwise. + and #MSG_OK otherwise. */ MSG_error_t MSG_channel_select_from(m_channel_t channel, double timeout, int *PID) @@ -646,7 +879,8 @@ MSG_channel_select_from(m_channel_t channel, double timeout, int *PID) SIMIX_mutex_lock(h_simdata->mutex); xbt_assert1(!MSG_mailbox_get_cond(mailbox), - "A process is already blocked on this channel %d", channel); + "A process is already blocked on this channel %d", + channel); cond = SIMIX_cond_init(); @@ -682,7 +916,8 @@ MSG_channel_select_from(m_channel_t channel, double timeout, int *PID) } -MSG_error_t MSG_alias_select_from(const char *alias, double timeout, int *PID) +MSG_error_t MSG_alias_select_from(const char *alias, double timeout, + int *PID) { m_host_t h = NULL; simdata_host_t h_simdata = NULL;