/** \ingroup msg_gos_functions
* \brief Listen on a channel and wait for receiving a task.
*
- * It takes two parameter.
+ * 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
*/
MSG_error_t MSG_task_get(m_task_t * task,
m_channel_t channel)
+{
+ return MSG_task_get_with_time_out(task, channel, -1);
+}
+
+/** \ingroup msg_gos_functions
+ * \brief Listen on a channel and wait for receiving a task with a timeout.
+ *
+ * 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.
+ * \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().
+ * \param timeout the maximum time to wait for a task before giving
+ up. In such a case, \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.
+ */
+
+MSG_error_t MSG_task_get_with_time_out(m_task_t * task,
+ m_channel_t channel,
+ double max_duration)
{
m_process_t process = MSG_process_self();
m_task_t t = NULL;
simdata_task_t t_simdata = NULL;
simdata_host_t h_simdata = NULL;
int warning = 0;
+ int first_time = 1;
e_surf_action_state_t state = SURF_ACTION_NOT_IN_THE_SYSTEM;
CHECK_HOST();
DEBUG2("Waiting for a task on channel %d (%s)", channel,h->name);
while ((t = xbt_fifo_shift(h_simdata->mbox[channel])) == NULL) {
+ if(max_duration>0) {
+ if(!first_time) {
+ MSG_RETURN(MSG_OK);
+ }
+ }
xbt_assert2(!(h_simdata->sleeping[channel]),
"A process (%s(%d)) is already blocked on this channel",
h_simdata->sleeping[channel]->name,
h_simdata->sleeping[channel]->simdata->PID);
h_simdata->sleeping[channel] = process; /* I'm waiting. Wake me up when you're ready */
- __MSG_process_block();
+ if(max_duration>0) {
+ __MSG_process_block(max_duration);
+ } else {
+ __MSG_process_block(-1);
+ }
if(surf_workstation_resource->extension_public->get_state(h_simdata->host)
== SURF_CPU_OFF)
MSG_RETURN(MSG_HOST_FAILURE);
h_simdata->sleeping[channel] = NULL;
+ first_time = 0;
/* OK, we should both be ready now. Are you there ? */
}
process->simdata->put_host = dest;
process->simdata->put_channel = channel;
while(!(task_simdata->comm))
- __MSG_process_block();
+ __MSG_process_block(-1);
surf_workstation_resource->common_public->action_use(task_simdata->comm);
process->simdata->put_host = NULL;
process->simdata->put_channel = -1;