X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/9532edf044eed31bcf6de22916c8824e18f373ad:/include/simdag/simdag.h..a6dbc279b78e4a84b3921b509f3138ed01399bca:/include/simgrid/simdag.h diff --git a/include/simdag/simdag.h b/include/simgrid/simdag.h similarity index 75% rename from include/simdag/simdag.h rename to include/simgrid/simdag.h index 1320955416..adcc3a0619 100644 --- a/include/simdag/simdag.h +++ b/include/simgrid/simdag.h @@ -7,13 +7,100 @@ #ifndef SIMDAG_SIMDAG_H #define SIMDAG_SIMDAG_H -#include "simdag/datatypes.h" #include "xbt/misc.h" #include "xbt/dynar.h" #include "xbt/dict.h" SG_BEGIN_DECL() +/** @brief Workstation datatype + @ingroup SD_datatypes_management + + A workstation is a place where a task can be executed. + A workstation is represented as a physical + resource with computing capabilities and has a name. + + @see SD_workstation_management */ +typedef xbt_dictelm_t SD_workstation_t; + +/** @brief Workstation access mode + @ingroup SD_datatypes_management + + By default, a workstation resource is shared, i.e. several tasks + can be executed at the same time on a workstation. The CPU power of + the workstation is shared between the running tasks on the workstation. + In sequential mode, only one task can use the workstation, and the other + tasks wait in a FIFO. + + @see SD_workstation_get_access_mode(), SD_workstation_set_access_mode() */ +typedef enum { + SD_WORKSTATION_SHARED_ACCESS, /**< @brief Several tasks can be executed at the same time */ + SD_WORKSTATION_SEQUENTIAL_ACCESS /**< @brief Only one task can be executed, the others wait in a FIFO. */ +} e_SD_workstation_access_mode_t; + +typedef enum { + SD_LINK_SHARED, + SD_LINK_FATPIPE +} e_SD_link_sharing_policy_t; + +/** @brief Link datatype + @ingroup SD_datatypes_management + + A link is a network node represented as a name, a current + bandwidth and a current latency. A route is a list of + links between two workstations. + + @see SD_link_management */ +typedef struct SD_link *SD_link_t; + +/** @brief Task datatype + @ingroup SD_datatypes_management + + A task is some computing amount that can be executed + in parallel on several workstations. A task may depend on other + tasks, this means that the task cannot start until the other tasks are done. + Each task has a \ref e_SD_task_state_t "state" indicating whether + the task is scheduled, running, done, etc. + + @see SD_task_management */ +typedef struct SD_task *SD_task_t; + +/** @brief Task states + @ingroup SD_datatypes_management + + @see SD_task_management */ +typedef enum { + SD_NOT_SCHEDULED = 0, /**< @brief Initial state (not valid for SD_watch and SD_unwatch). */ + SD_SCHEDULABLE = 0x0001, /**< @brief A task becomes SD_SCHEDULABLE as soon as its dependencies are satisfied */ + SD_SCHEDULED = 0x0002, /**< @brief A task becomes SD_SCHEDULED when you call function + SD_task_schedule. SD_simulate will execute it when it becomes SD_RUNNABLE. */ + SD_RUNNABLE = 0x0004, /**< @brief A scheduled task becomes runnable is SD_simulate as soon as its dependencies are satisfied. */ + SD_IN_FIFO = 0x0008, /**< @brief A runnable task can have to wait in a workstation fifo if the workstation is sequential */ + SD_RUNNING = 0x0010, /**< @brief An SD_RUNNABLE or SD_IN_FIFO becomes SD_RUNNING when it is launched. */ + SD_DONE = 0x0020, /**< @brief The task is successfully finished. */ + SD_FAILED = 0x0040 /**< @brief A problem occurred during the execution of the task. */ +} e_SD_task_state_t; + +/** @brief Task kinds + @ingroup SD_datatypes_management + + @see SD_task_management */ +typedef enum { + SD_TASK_NOT_TYPED = 0, /**< @brief no specified type */ + SD_TASK_COMM_E2E = 1, /**< @brief end to end communication */ + SD_TASK_COMP_SEQ = 2, /**< @brief sequential computation */ + SD_TASK_COMP_PAR_AMDAHL = 3, /**< @brief parallel computation (Amdahl's law) */ + SD_TASK_COMM_PAR_MXN_1D_BLOCK = 4 /**< @brief MxN data redistribution (1D Block distribution) */ +} e_SD_task_kind_t; + + +/** @brief Storage datatype + @ingroup SD_datatypes_management + + TODO PV: comment it ! + + @see SD_storage_management */ +typedef xbt_dictelm_t SD_storage_t; /************************** AS handling *************************************/ XBT_PUBLIC(xbt_dict_t) SD_as_router_get_properties(const char *as);