include/simdag/simdag.h

   1 #ifndef SIMDAG_SIMDAG_H
   2 #define SIMDAG_SIMDAG_H
   3
   4 #include "simdag/datatypes.h"
   5 #include "xbt/misc.h"
   6
   7 SG_BEGIN_DECL()
   8
   9 /************************** Link handling ***********************************/
  10
  11 /* private (called by SD_environment_create)
  12 SD_link_t    SD_link_create(void *data, const char *name,
  13 double bandwidth, double latency);*/
  14 void*        SD_link_get_data(SD_link_t link);
  15 void         SD_link_set_data(SD_link_t link, void *data);
  16 const char*  SD_link_get_name(SD_link_t link);
  17 double       SD_link_get_capacity(SD_link_t link);
  18 double       SD_link_get_current_bandwidth(SD_link_t link);
  19 double       SD_link_get_current_latency(SD_link_t link);
  20 /* private (called by SD_clean)
  21 void         SD_link_destroy(SD_link_t link);
  22 */
  23
  24 /************************** Workstation handling ****************************/
  25
  26 /* private (called by SD_environment_create)
  27 SD_workstation_t   SD_workstation_create(void *data, const char *name, double power,
  28   double available_power);*/
  29 SD_workstation_t   SD_workstation_get_by_name(const char *name);
  30 SD_workstation_t*  SD_workstation_get_list(void);
  31 int                SD_workstation_get_number(void);
  32 void               SD_workstation_set_data(SD_workstation_t workstation, void *data);
  33 void*              SD_workstation_get_data(SD_workstation_t workstation);
  34 const char*        SD_workstation_get_name(SD_workstation_t workstation);
  35 SD_link_t*         SD_workstation_route_get_list(SD_workstation_t src, SD_workstation_t dst);
  36 int                SD_workstation_route_get_size(SD_workstation_t src, SD_workstation_t dst);
  37 double             SD_workstation_get_power(SD_workstation_t workstation);
  38 double             SD_workstation_get_available_power(SD_workstation_t workstation);
  39 /* private (called by SD_clean)
  40 void               SD_workstation_destroy(SD_workstation_t workstation);
  41 */
  42
  43 /************************** Task handling ************************************/
  44
  45 SD_task_t         SD_task_create(const char *name, void *data, double amount);
  46 void              SD_task_schedule(SD_task_t task, int workstation_nb,
  47                                    const SD_workstation_t *workstation_list, double *computation_amount,
  48                                    double *communication_amount, double rate);
  49 void              SD_task_reset(SD_task_t task);
  50 void*             SD_task_get_data(SD_task_t task);
  51 void              SD_task_set_data(SD_task_t task, void *data);
  52 const char*       SD_task_get_name(SD_task_t task);
  53 double            SD_task_get_amount(SD_task_t task);
  54 double            SD_task_get_remaining_amount(SD_task_t task);
  55 void              SD_task_dependency_add(const char *name, void *data, SD_task_t src, SD_task_t dst);
  56 void              SD_task_dependency_remove(SD_task_t src, SD_task_t dst);
  57 void*             SD_task_dependency_get_data(SD_task_t src, SD_task_t dst);
  58 e_SD_task_state_t SD_task_get_state(SD_task_t task);
  59 /* e_SD_task_state_t can be either SD_SCHEDULED, SD_RUNNING, SD_DONE, or SD_FAILED */
  60
  61 void              SD_task_watch(SD_task_t task, e_SD_task_state_t state);
  62 /* SD_simulate will stop as soon as the state of this task is the one given in argument.
  63    Watch-point is then automatically removed */
  64
  65 void              SD_task_unwatch(SD_task_t task, e_SD_task_state_t state);
  66 void              SD_task_unschedule(SD_task_t task); /* change state and rerun */
  67 void              SD_task_destroy(SD_task_t task);
  68
  69 /************************** Global *******************************************/
  70
  71 void              SD_init(int *argc, char **argv);
  72 void              SD_create_environment(const char *platform_file);
  73 SD_task_t*        SD_simulate(double how_long); /* returns a NULL-terminated array of SD_task_t whose state has changed */
  74 void              SD_exit(void); /* cleans everything */
  75
  76 SG_END_DECL()
  77
  78 #endif