#include"xbt/sysdep.h"
#include "xbt/error.h"
XBT_LOG_NEW_DEFAULT_SUBCATEGORY(task, msg,
- "Logging specific to MSG module (task)");
+ "Logging specific to MSG (task)");
static char sprint_buffer[64];
+/** \defgroup m_task_management Managing functions of Tasks
+ * \brief This section describes the task structure of MSG
+ * (#m_task_t) and the functions for managing it.
+ *
+ * Since most scheduling algorithms rely on a concept of task
+ * that can be either <em>computed</em> locally or
+ * <em>transferred</em> on another processor, it seems to be the
+ * right level of abstraction for our purposes. A <em>task</em>
+ * may then be defined by a <em>computing amount</em>, a
+ * <em>message size</em> and some <em>private data</em>.
+ */
+
/********************************* Task **************************************/
/** \ingroup m_task_management
* \brief Creates a new #m_task_t.
* \see m_task_t
* \return The new corresponding object.
*/
-m_task_t MSG_task_create(const char *name, long double compute_duration,
- long double message_size, void *data)
+m_task_t MSG_task_create(const char *name, double compute_duration,
+ double message_size, void *data)
{
- sim_data_task_t sim_data = xbt_new0(s_sim_data_task_t,1);
+ simdata_task_t simdata = xbt_new0(s_simdata_task_t,1);
m_task_t task = xbt_new0(s_m_task_t,1);
/* Task structure */
task->name = xbt_strdup(name);
- task->simdata = sim_data;
+ task->simdata = simdata;
task->data = data;
/* Simulator Data */
- sim_data->sleeping = xbt_dynar_new(sizeof(m_process_t),NULL);
- sim_data->computation_amount = compute_duration;
- sim_data->message_size = message_size;
+ simdata->sleeping = xbt_dynar_new(sizeof(m_process_t),NULL);
+ simdata->computation_amount = compute_duration;
+ simdata->message_size = message_size;
+ simdata->rate = -1.0;
+ simdata->using = 1;
+ simdata->sender = NULL;
+
return task;
}
return (task->data);
}
+/** \ingroup m_task_management
+ * \brief Return the sender of a #m_task_t.
+ *
+ * This functions returns the #m_process_t which sent this task
+ */
+m_process_t MSG_task_get_sender(m_task_t task)
+{
+ xbt_assert0(task, "Invalid parameters");
+ return ((simdata_task_t) task->simdata)->sender;
+}
+
+/** \ingroup m_task_management
+ * \brief Return the name of a #m_task_t.
+ *
+ * This functions returns the name of a #m_task_t as specified on creation
+ */
+const char *MSG_task_get_name(m_task_t task)
+{
+ xbt_assert0(task, "Invalid parameters");
+ return task->name;
+}
+
+
/** \ingroup m_task_management
* \brief Destroy a #m_task_t.
*
*/
MSG_error_t MSG_task_destroy(m_task_t task)
{
- sim_data_task_t sim_data = NULL;
+ simdata_task_t simdata = NULL;
surf_action_t action = NULL;
int i;
xbt_assert0((task != NULL), "Invalid parameter");
+
+ task->simdata->using--;
+ if(task->simdata->using>0) return MSG_OK;
+
xbt_assert0((xbt_dynar_length(task->simdata->sleeping)==0),
- "Task still used. Cannot destroy it now!");
+ "Task still used. There is a problem. Cannot destroy it now!");
- if(task->name) xbt_free(task->name);
+ if(task->name) free(task->name);
xbt_dynar_free(&(task->simdata->sleeping));
if(action) action->resource_type->common_public->action_free(action);
- xbt_free(task->simdata);
- xbt_free(task);
+ free(task->simdata);
+ free(task);
return MSG_OK;
}
+/** \ingroup m_task_management
+ * \brief Returns the computation amount needed to process a task #m_task_t.
+ *
+ */
+double MSG_task_get_compute_duration(m_task_t task)
+{
+ simdata_task_t simdata = NULL;
+
+ xbt_assert0((task != NULL) && (task->simdata != NULL), "Invalid parameter");
+
+ return task->simdata->computation_amount;
+}
+
+/** \ingroup m_task_management
+ * \brief Returns the size of the data attached to a task #m_task_t.
+ *
+ */
+double MSG_task_get_data_size(m_task_t task)
+{
+ simdata_task_t simdata = NULL;
+
+ xbt_assert0((task != NULL) && (task->simdata != NULL), "Invalid parameter");
+
+ return task->simdata->message_size;
+}
+
/* static MSG_error_t __MSG_task_check(m_task_t task) */
/* { */
-/* sim_data_task_t sim_data = NULL; */
+/* simdata_task_t simdata = NULL; */
/* int warning = 0; */
/* if (task == NULL) { /\* Fatal *\/ */
/* WARNING("Task uninitialized"); */
/* return MSG_FATAL; */
/* } */
-/* sim_data = task->simdata; */
+/* simdata = task->simdata; */
-/* if (sim_data == NULL) { /\* Fatal *\/ */
+/* if (simdata == NULL) { /\* Fatal *\/ */
/* WARNING("Simulator Data uninitialized"); */
/* return MSG_FATAL; */
/* } */
-/* if (sim_data->compute == NULL) { /\* Fatal if execute ... *\/ */
+/* if (simdata->compute == NULL) { /\* Fatal if execute ... *\/ */
/* WARNING("No duration set for this task"); */
/* warning++; */
/* } */
-/* if (sim_data->message_size == 0) { /\* Fatal if transfered ... *\/ */
+/* if (simdata->message_size == 0) { /\* Fatal if transfered ... *\/ */
/* WARNING("No message_size set for this task"); */
/* warning++; */
/* } */
/* static m_task_t __MSG_task_copy(m_task_t src) */
/* { */
/* m_task_t copy = NULL; */
-/* sim_data_task_t sim_data = NULL; */
+/* simdata_task_t simdata = NULL; */
/* __MSG_task_check(src); */
-/* sim_data = src->simdata; */
-/* copy = MSG_task_create(src->name, SG_getTaskCost(sim_data->compute), */
-/* sim_data->message_size, MSG_task_get_data(src)); */
+/* simdata = src->simdata; */
+/* copy = MSG_task_create(src->name, SG_getTaskCost(simdata->compute), */
+/* simdata->message_size, MSG_task_get_data(src)); */
/* return (copy); */
/* } */
MSG_error_t __MSG_task_wait_event(m_process_t process, m_task_t task)
{
+ int _cursor;
+ m_process_t proc = NULL;
+
xbt_assert0(((task != NULL)
&& (task->simdata != NULL)), "Invalid parameters");
- xbt_dynar_push(task->simdata->sleeping, process);
+ xbt_dynar_push(task->simdata->sleeping, &process);
process->simdata->waiting_task = task;
- xbt_context_yield(process->simdata->context);
+ xbt_context_yield();
process->simdata->waiting_task = NULL;
+ xbt_dynar_foreach(task->simdata->sleeping,_cursor,proc) {
+ if(proc==process)
+ xbt_dynar_remove_at(task->simdata->sleeping,_cursor,&proc);
+ }
return MSG_OK;
}