pads:gaia-apis
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
pads:gaia-apis [2010/11/10 13:23] – gdangelo | pads:gaia-apis [2017/12/20 07:48] (current) – gdangelo | ||
---|---|---|---|
Line 97: | Line 97: | ||
//none// | //none// | ||
- | |||
- | ---- | ||
- | |||
**Return value:** | **Return value:** | ||
Line 119: | Line 116: | ||
**Description**: | **Description**: | ||
- | Returns the length of the time-step | + | Returns the length of the timestep |
**Notes**: | **Notes**: | ||
Line 127: | Line 124: | ||
**Return value:** | **Return value:** | ||
- | The time-step | + | The timestep |
---- | ---- | ||
Line 208: | Line 205: | ||
//none// | //none// | ||
+ | |||
+ | ---- | ||
Line 236: | Line 235: | ||
//none// | //none// | ||
+ | |||
+ | ---- | ||
Line 253: | Line 254: | ||
The default value of E3_EVENT_COUNTDOWN is 30 events. | The default value of E3_EVENT_COUNTDOWN is 30 events. | ||
- | |||
**Return value:** | **Return value:** | ||
//none// | //none// | ||
+ | |||
+ | ---- | ||
Line 275: | Line 277: | ||
^ Migration heuristic | ^ Migration heuristic | ||
| MIGR_OFF | | MIGR_OFF | ||
- | | MIGR_ON / MIGR_E1 | + | | MIGR_ON / MIGR_E1 |
| MIGR_E2 | | MIGR_E2 | ||
Line 288: | Line 290: | ||
//none// | //none// | ||
+ | |||
+ | ---- | ||
Line 300: | Line 304: | ||
**Description**: | **Description**: | ||
- | All the implemented migration heuristics are based on the evaluation of the outbound UNICAST traffic generated by each Simulated Entity. The migration factor is a tuning parameters of the heuristics: a low value would increase the number of migrations, conversely a higher value would reduce the number of migrations (default value = 3). | + | All the implemented migration heuristics are based on the evaluation of the outbound UNICAST traffic generated by each Simulated Entity. The migration factor is a tuning parameters of the heuristics: a low value would increase the number of migrations, conversely a higher value would reduce the number of migrations (default value = 3). |
**Notes**: | **Notes**: | ||
Line 309: | Line 313: | ||
//none// | //none// | ||
+ | |||
+ | ---- | ||
Line 321: | Line 327: | ||
**Description**: | **Description**: | ||
- | The migration heuristic 1 (MIGR_ON / MIGR_E1) uses a sliding window mechanism to evaluate the communication pattern of each SE (HISTORY_SLOTS, | + | The migration heuristic 1 (MIGR_ON / MIGR_E1) uses a sliding window mechanism to evaluate the communication pattern of each SE (HISTORY_SLOTS, |
**Notes**: | **Notes**: | ||
Line 330: | Line 336: | ||
//none// | //none// | ||
+ | |||
+ | ---- | ||
Line 342: | Line 350: | ||
**Description**: | **Description**: | ||
- | The migration heuristics 2 and 3 (MIGR_E2 / MIGR_E3) are based on the a sliding-windows | + | The migration heuristics 2 and 3 (MIGR_E2 / MIGR_E3) are based on the a sliding |
**Notes**: | **Notes**: | ||
Line 351: | Line 359: | ||
//none// | //none// | ||
+ | |||
+ | ---- | ||
+ | |||
=== GAIA_SetMigration() | === GAIA_SetMigration() | ||
Line 362: | Line 373: | ||
**Description**: | **Description**: | ||
- | All the implemented migration heuristics are based on the evaluation of the outbound UNICAST traffic generated by each SE (also called events). | + | All the implemented migration heuristics are based on the evaluation of the outbound UNICAST traffic generated by each SE (also called events). |
^ Migration heuristic | ^ Migration heuristic | ||
| MIGR_OFF | | MIGR_OFF | ||
- | | MIGR_ON / MIGR_E1 | + | | MIGR_ON / MIGR_E1 |
- | | MIGR_E2 | + | | MIGR_E2 |
- | | MIGR_E3 | + | | MIGR_E3 |
\\ | \\ | ||
Line 378: | Line 389: | ||
* GAIA_SetMT(): | * GAIA_SetMT(): | ||
* GAIA_SetMF(): | * GAIA_SetMF(): | ||
+ | * E1_HISTORY_SLOTS, | ||
* E2_EVENT_HISTORY_SIZE, | * E2_EVENT_HISTORY_SIZE, | ||
* E3_EVENT_COUNTDOWN, | * E3_EVENT_COUNTDOWN, | ||
- | * HISTORY_SLOTS, | ||
**Return value:** | **Return value:** | ||
//none// | //none// | ||
+ | |||
+ | ---- | ||
+ | |||
==== Load Balancing ==== | ==== Load Balancing ==== | ||
Line 407: | Line 421: | ||
//none// | //none// | ||
+ | |||
+ | ---- | ||
Line 430: | Line 446: | ||
**Notes**: | **Notes**: | ||
- | The message time-stamp has to respect the constraints given by the synchronization algorithm (time-stepped). | + | The message time-stamp has to respect the constraints given by the synchronization algorithm (timestepped). |
**Return value:** | **Return value:** | ||
//none// | //none// | ||
+ | |||
+ | ---- | ||
Line 456: | Line 474: | ||
**Notes**: | **Notes**: | ||
- | * The message time-stamp has to respect the constraints given by the synchronization algorithm (time-stepped). | + | * The message time-stamp has to respect the constraints given by the synchronization algorithm (timestepped). |
* This API has the exactly the same semantic of GAIA_Send(). For performance reasons, in this case the message is contained in an array instead of a String. | * This API has the exactly the same semantic of GAIA_Send(). For performance reasons, in this case the message is contained in an array instead of a String. | ||
Line 464: | Line 482: | ||
//none// | //none// | ||
+ | |||
+ | ---- | ||
Line 484: | Line 504: | ||
**Notes**: | **Notes**: | ||
- | * The message time-stamp has to respect the constraints given by the synchronization algorithm (time-stepped). | + | * The message time-stamp has to respect the constraints given by the synchronization algorithm (timestepped). |
* Given that the message is delivered also to the SE that is originating it, it must be carefully managed to avoid loops. | * Given that the message is delivered also to the SE that is originating it, it must be carefully managed to avoid loops. | ||
Line 491: | Line 511: | ||
//none// | //none// | ||
+ | |||
+ | ---- | ||
Line 511: | Line 533: | ||
**Notes**: | **Notes**: | ||
- | * The message time-stamp has to respect the constraints given by the synchronization algorithm (time-stepped). | + | * The message time-stamp has to respect the constraints given by the synchronization algorithm (timestepped). |
* Given that the message is delivered also to the SE that is originating it, it must be carefully managed to avoid loops. | * Given that the message is delivered also to the SE that is originating it, it must be carefully managed to avoid loops. | ||
Line 521: | Line 543: | ||
//none// | //none// | ||
+ | |||
+ | ---- | ||
Line 550: | Line 574: | ||
Returns the message (String). | Returns the message (String). | ||
+ | ---- | ||
Line 580: | Line 605: | ||
Returns the message (byte-array). | Returns the message (byte-array). | ||
+ | |||
+ | ---- | ||
Line 610: | Line 637: | ||
//none// | //none// | ||
+ | |||
+ | |||
+ | ---- | ||
===== C bindings ===== | ===== C bindings ===== | ||
Line 620: | Line 650: | ||
void GAIA_SetMF (float); | void GAIA_SetMF (float); | ||
void GAIA_SetMT (unsigned int); | void GAIA_SetMT (unsigned int); | ||
+ | void GAIA_SetCountDown ( int ); | ||
+ | void GAIA_SetHistorySlots (int ); | ||
+ | void GAIA_SetEventHistorySize (int ); | ||
void GAIA_SetMigration (int); | void GAIA_SetMigration (int); | ||
void GAIA_SetLoadBalancing (int); | void GAIA_SetLoadBalancing (int); | ||
Line 633: | Line 666: | ||
Please refer to the description of the Java binding to have an introduction to the provided APIs. | Please refer to the description of the Java binding to have an introduction to the provided APIs. | ||
- | |||
pads/gaia-apis.1289395391.txt.gz · Last modified: 2010/11/10 13:23 by gdangelo