src/simix/smx_synchro.c

   1 /* Copyright (c) 2007, 2008, 2009, 2010. The SimGrid Team.
   2  * All rights reserved.                                                     */
   3
   4 /* This program is free software; you can redistribute it and/or modify it
   5  * under the terms of the license (GNU LGPL) which comes with this package. */
   6
   7 #include "smx_private.h"
   8 #include "xbt/log.h"
   9
  10
  11 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(simix_synchro, simix,
  12                                 "Logging specific to SIMIX (synchronization)");
  13
  14 static smx_action_t SIMIX_synchro_wait(smx_host_t smx_host, double timeout);
  15 static void SIMIX_synchro_finish(smx_action_t action);
  16 static void _SIMIX_cond_wait(smx_cond_t cond, smx_mutex_t mutex, double timeout,
  17                              smx_process_t issuer, smx_simcall_t simcall);
  18 static void _SIMIX_sem_wait(smx_sem_t sem, double timeout, smx_process_t issuer,
  19                             smx_simcall_t simcall);
  20
  21 /***************************** Synchro action *********************************/
  22
  23 static smx_action_t SIMIX_synchro_wait(smx_host_t smx_host, double timeout)
  24 {
  25   XBT_IN("(%p, %f)",smx_host,timeout);
  26   smx_action_t action;
  27   action = xbt_mallocator_get(simix_global->action_mallocator);
  28   action->type = SIMIX_ACTION_SYNCHRO;
  29   action->name = xbt_strdup("synchro");
  30   action->synchro.sleep =
  31     surf_workstation_model->extension.workstation.sleep(smx_host->host, timeout);
  32
  33   surf_workstation_model->action_data_set(action->synchro.sleep, action);
  34   XBT_OUT();
  35   return action;
  36 }
  37
  38 void SIMIX_synchro_stop_waiting(smx_process_t process, smx_simcall_t simcall)
  39 {
  40   XBT_IN("(%p, %p)",process,simcall);
  41   switch (simcall->call) {
  42
  43     case SIMCALL_MUTEX_LOCK:
  44       xbt_swag_remove(process, simcall->mutex_lock.mutex->sleeping);
  45       break;
  46
  47     case SIMCALL_COND_WAIT:
  48       xbt_swag_remove(process, simcall->cond_wait.cond->sleeping);
  49       break;
  50
  51     case SIMCALL_COND_WAIT_TIMEOUT:
  52       xbt_swag_remove(process, simcall->cond_wait_timeout.cond->sleeping);
  53       break;
  54
  55     case SIMCALL_SEM_ACQUIRE:
  56       xbt_swag_remove(process, simcall->sem_acquire.sem->sleeping);
  57       break;
  58
  59     case SIMCALL_SEM_ACQUIRE_TIMEOUT:
  60       xbt_swag_remove(process, simcall->sem_acquire_timeout.sem->sleeping);
  61       break;
  62
  63     default:
  64       THROW_IMPOSSIBLE;
  65   }
  66   XBT_OUT();
  67 }
  68
  69 void SIMIX_synchro_destroy(smx_action_t action)
  70 {
  71   XBT_IN("(%p)",action);
  72   XBT_DEBUG("Destroying synchro %p", action);
  73   action->synchro.sleep->model_type->action_unref(action->synchro.sleep);
  74   xbt_free(action->name);
  75   xbt_mallocator_release(simix_global->action_mallocator, action);
  76   XBT_OUT();
  77 }
  78
  79 void SIMIX_post_synchro(smx_action_t action)
  80 {
  81   XBT_IN("(%p)",action);
  82   if (surf_workstation_model->action_state_get(action->synchro.sleep) == SURF_ACTION_FAILED)
  83     action->state = SIMIX_FAILED;
  84   else if(surf_workstation_model->action_state_get(action->synchro.sleep) == SURF_ACTION_DONE)
  85     action->state = SIMIX_SRC_TIMEOUT;
  86
  87   SIMIX_synchro_finish(action);
  88   XBT_OUT();
  89 }
  90
  91 static void SIMIX_synchro_finish(smx_action_t action)
  92 {
  93   XBT_IN("(%p)",action);
  94   smx_simcall_t simcall = xbt_fifo_shift(action->simcalls);
  95
  96   switch (action->state) {
  97
  98     case SIMIX_SRC_TIMEOUT:
  99       SMX_EXCEPTION(simcall->issuer, timeout_error, 0, "Synchro's wait timeout");
 100       break;
 101
 102     case SIMIX_FAILED:
 103         simcall->issuer->context->iwannadie = 1;
 104 //      SMX_EXCEPTION(simcall->issuer, host_error, 0, "Host failed");
 105       break;
 106
 107     default:
 108       THROW_IMPOSSIBLE;
 109       break;
 110   }
 111
 112   SIMIX_synchro_stop_waiting(simcall->issuer, simcall);
 113   simcall->issuer->waiting_action = NULL;
 114   SIMIX_synchro_destroy(action);
 115   SIMIX_simcall_answer(simcall);
 116   XBT_OUT();
 117 }
 118 /*********************************** Mutex ************************************/
 119
 120 smx_mutex_t SIMIX_pre_mutex_init(smx_simcall_t simcall){
 121   return SIMIX_mutex_init();
 122 }
 123 /**
 124  * \brief Initialize a mutex.
 125  *
 126  * Allocs and creates the data for the mutex.
 127  * \return A mutex
 128  */
 129 smx_mutex_t SIMIX_mutex_init(void)
 130 {
 131   XBT_IN("()");
 132   s_smx_process_t p;            /* useful to initialize sleeping swag */
 133
 134   smx_mutex_t mutex = xbt_new0(s_smx_mutex_t, 1);
 135   mutex->locked = 0;
 136   mutex->sleeping = xbt_swag_new(xbt_swag_offset(p, synchro_hookup));
 137   XBT_OUT();
 138   return mutex;
 139 }
 140
 141 /**
 142  * \brief Handles a mutex lock simcall.
 143  * \param simcall the simcall
 144  */
 145 void SIMIX_pre_mutex_lock(smx_simcall_t simcall, smx_mutex_t mutex)
 146 {
 147   XBT_IN("(%p)",simcall);
 148   /* FIXME: check where to validate the arguments */
 149   smx_action_t sync_act = NULL;
 150   smx_process_t process = simcall->issuer;
 151
 152   if (mutex->locked) {
 153     /* FIXME: check if the host is active ? */
 154     /* Somebody using the mutex, use a synchro action to get host failures */
 155     sync_act = SIMIX_synchro_wait(process->smx_host, -1);
 156     xbt_fifo_push(sync_act->simcalls, simcall);
 157     simcall->issuer->waiting_action = sync_act;
 158     xbt_swag_insert(simcall->issuer, mutex->sleeping);
 159   } else {
 160     /* mutex free */
 161     mutex->locked = 1;
 162     mutex->owner = simcall->issuer;
 163     SIMIX_simcall_answer(simcall);
 164   }
 165   XBT_OUT();
 166 }
 167
 168 int SIMIX_pre_mutex_trylock(smx_simcall_t simcall, smx_mutex_t mutex){
 169   return SIMIX_mutex_trylock(mutex, simcall->issuer);
 170 }
 171 /**
 172  * \brief Tries to lock a mutex.
 173  *
 174  * Tries to lock a mutex, return 1 if the mutex is unlocked, else 0.
 175  * This function does not block and wait for the mutex to be unlocked.
 176  * \param mutex The mutex
 177  * \param issuer The process that tries to acquire the mutex
 178  * \return 1 - mutex free, 0 - mutex used
 179  */
 180 int SIMIX_mutex_trylock(smx_mutex_t mutex, smx_process_t issuer)
 181 {
 182   XBT_IN("(%p, %p)",mutex,issuer);
 183   if (mutex->locked){
 184     XBT_OUT();
 185     return 0;
 186   }
 187
 188   mutex->locked = 1;
 189   mutex->owner = issuer;
 190   XBT_OUT();
 191   return 1;
 192 }
 193
 194 void SIMIX_pre_mutex_unlock(smx_simcall_t simcall, smx_mutex_t mutex){
 195    SIMIX_mutex_unlock(mutex, simcall->issuer);
 196 }
 197 /**
 198  * \brief Unlocks a mutex.
 199  *
 200  * Unlocks the mutex and gives it to a process waiting for it.
 201  * If the unlocker is not the owner of the mutex nothing happens.
 202  * If there are no process waiting, it sets the mutex as free.
 203  * \param mutex The mutex
 204  * \param issuer The process trying to unlock the mutex
 205  */
 206 void SIMIX_mutex_unlock(smx_mutex_t mutex, smx_process_t issuer)
 207 {
 208   XBT_IN("(%p, %p)",mutex,issuer);
 209   smx_process_t p;              /*process to wake up */
 210
 211   /* If the mutex is not owned by the issuer do nothing */
 212   if (issuer != mutex->owner){
 213     XBT_OUT();
 214     return;
 215   }
 216
 217   if (xbt_swag_size(mutex->sleeping) > 0) {
 218     p = xbt_swag_extract(mutex->sleeping);
 219     SIMIX_synchro_destroy(p->waiting_action);
 220     p->waiting_action = NULL;
 221     mutex->owner = p;
 222     SIMIX_simcall_answer(&p->simcall);
 223   } else {
 224     /* nobody to wake up */
 225     mutex->locked = 0;
 226     mutex->owner = NULL;
 227   }
 228   XBT_OUT();
 229 }
 230
 231 void SIMIX_pre_mutex_destroy(smx_simcall_t simcall, smx_mutex_t mutex){
 232   SIMIX_mutex_destroy(mutex);
 233 }
 234 /**
 235  * \brief Destroys a mutex.
 236  *
 237  * Destroys and frees the mutex's memory.
 238  * \param mutex A mutex
 239  */
 240 void SIMIX_mutex_destroy(smx_mutex_t mutex)
 241 {
 242   XBT_IN("(%p)",mutex);
 243   if (mutex){
 244     xbt_swag_free(mutex->sleeping);
 245     xbt_free(mutex);
 246   }
 247   XBT_OUT();
 248 }
 249
 250 /********************************* Condition **********************************/
 251
 252 smx_cond_t SIMIX_pre_cond_init(smx_simcall_t simcall){
 253   return SIMIX_cond_init();
 254 }
 255 /**
 256  * \brief Initialize a condition.
 257  *
 258  * Allocates and creates the data for the condition.
 259  * It have to be called before the use of the condition.
 260  * \return A condition
 261  */
 262 smx_cond_t SIMIX_cond_init(void)
 263 {
 264   XBT_IN("()");
 265   s_smx_process_t p;
 266   smx_cond_t cond = xbt_new0(s_smx_cond_t, 1);
 267   cond->sleeping = xbt_swag_new(xbt_swag_offset(p, synchro_hookup));
 268   cond->mutex = NULL;
 269   XBT_OUT();
 270   return cond;
 271 }
 272
 273 /**
 274  * \brief Handle a condition waiting simcall without timeouts
 275  * \param simcall the simcall
 276  */
 277 void SIMIX_pre_cond_wait(smx_simcall_t simcall, smx_cond_t cond, smx_mutex_t mutex)
 278 {
 279   XBT_IN("(%p)",simcall);
 280   smx_process_t issuer = simcall->issuer;
 281
 282   _SIMIX_cond_wait(cond, mutex, -1, issuer, simcall);
 283   XBT_OUT();
 284 }
 285
 286 /**
 287  * \brief Handle a condition waiting simcall with timeouts
 288  * \param simcall the simcall
 289  */
 290 void SIMIX_pre_cond_wait_timeout(smx_simcall_t simcall, smx_cond_t cond,
 291                                  smx_mutex_t mutex, double timeout)
 292 {
 293   XBT_IN("(%p)",simcall);
 294   smx_process_t issuer = simcall->issuer;
 295
 296   _SIMIX_cond_wait(cond, mutex, timeout, issuer, simcall);
 297   XBT_OUT();
 298 }
 299
 300
 301 static void _SIMIX_cond_wait(smx_cond_t cond, smx_mutex_t mutex, double timeout,
 302                              smx_process_t issuer, smx_simcall_t simcall)
 303 {
 304   XBT_IN("(%p, %p, %f, %p,%p)",cond,mutex,timeout,issuer,simcall);
 305   smx_action_t sync_act = NULL;
 306
 307   XBT_DEBUG("Wait condition %p", cond);
 308
 309   /* If there is a mutex unlock it */
 310   /* FIXME: what happens if the issuer is not the owner of the mutex? */
 311   if (mutex != NULL) {
 312     cond->mutex = mutex;
 313     SIMIX_mutex_unlock(mutex, issuer);
 314   }
 315
 316   sync_act = SIMIX_synchro_wait(issuer->smx_host, timeout);
 317   xbt_fifo_unshift(sync_act->simcalls, simcall);
 318   issuer->waiting_action = sync_act;
 319   xbt_swag_insert(simcall->issuer, cond->sleeping);
 320   XBT_OUT();
 321 }
 322
 323 void SIMIX_pre_cond_signal(smx_simcall_t simcall, smx_cond_t cond){
 324   SIMIX_cond_signal(cond);
 325 }
 326 /**
 327  * \brief Signalizes a condition.
 328  *
 329  * Signalizes a condition and wakes up a sleeping process.
 330  * If there are no process sleeping, no action is done.
 331  * \param cond A condition
 332  */
 333 void SIMIX_cond_signal(smx_cond_t cond)
 334 {
 335   XBT_IN("(%p)",cond);
 336   smx_process_t proc = NULL;
 337   smx_mutex_t mutex = NULL;
 338   smx_simcall_t simcall = NULL;
 339
 340   XBT_DEBUG("Signal condition %p", cond);
 341
 342   /* If there are processes waiting for the condition choose one and try
 343      to make it acquire the mutex */
 344   if ((proc = xbt_swag_extract(cond->sleeping))) {
 345
 346     /* Destroy waiter's synchro action */
 347     SIMIX_synchro_destroy(proc->waiting_action);
 348     proc->waiting_action = NULL;
 349
 350     /* Now transform the cond wait simcall into a mutex lock one */
 351     simcall = &proc->simcall;
 352     if(simcall->call == SIMCALL_COND_WAIT)
 353       mutex = simcall->cond_wait.mutex;
 354     else
 355       mutex = simcall->cond_wait_timeout.mutex;
 356
 357     simcall->call = SIMCALL_MUTEX_LOCK;
 358
 359     SIMIX_pre_mutex_lock(simcall, mutex);
 360   }
 361   XBT_OUT();
 362 }
 363
 364 void SIMIX_pre_cond_broadcast(smx_simcall_t simcall, smx_cond_t cond){
 365   SIMIX_cond_broadcast(cond);
 366 }
 367 /**
 368  * \brief Broadcasts a condition.
 369  *
 370  * Signal ALL processes waiting on a condition.
 371  * If there are no process waiting, no action is done.
 372  * \param cond A condition
 373  */
 374 void SIMIX_cond_broadcast(smx_cond_t cond)
 375 {
 376   XBT_IN("(%p)",cond);
 377   XBT_DEBUG("Broadcast condition %p", cond);
 378
 379   /* Signal the condition until nobody is waiting on it */
 380   while (xbt_swag_size(cond->sleeping)) {
 381     SIMIX_cond_signal(cond);
 382   }
 383   XBT_OUT();
 384 }
 385
 386 void SIMIX_pre_cond_destroy(smx_simcall_t simcall, smx_cond_t cond){
 387   SIMIX_cond_destroy(cond);
 388 }
 389 /**
 390  * \brief Destroys a contidion.
 391  *
 392  * Destroys and frees the condition's memory.
 393  * \param cond A condition
 394  */
 395 void SIMIX_cond_destroy(smx_cond_t cond)
 396 {
 397   XBT_IN("(%p)",cond);
 398   XBT_DEBUG("Destroy condition %p", cond);
 399
 400   if (cond != NULL) {
 401     xbt_assert(xbt_swag_size(cond->sleeping) == 0,
 402                 "Cannot destroy conditional since someone is still using it");
 403
 404     xbt_swag_free(cond->sleeping);
 405     xbt_free(cond);
 406   }
 407   XBT_OUT();
 408 }
 409
 410 /******************************** Semaphores **********************************/
 411 #define SMX_SEM_NOLIMIT 99999
 412 smx_sem_t SIMIX_pre_sem_init(smx_simcall_t simcall, unsigned int value){
 413   return SIMIX_sem_init(value);
 414 }
 415 /** @brief Initialize a semaphore */
 416 smx_sem_t SIMIX_sem_init(unsigned int value)
 417 {
 418   XBT_IN("(%u)",value);
 419   s_smx_process_t p;
 420
 421   smx_sem_t sem = xbt_new0(s_smx_sem_t, 1);
 422   sem->sleeping = xbt_swag_new(xbt_swag_offset(p, synchro_hookup));
 423   sem->value = value;
 424   XBT_OUT();
 425   return sem;
 426 }
 427
 428 void SIMIX_pre_sem_destroy(smx_simcall_t simcall, smx_sem_t sem){
 429   SIMIX_sem_destroy(sem);
 430 }
 431 /** @brief Destroys a semaphore */
 432 void SIMIX_sem_destroy(smx_sem_t sem)
 433 {
 434   XBT_IN("(%p)",sem);
 435   XBT_DEBUG("Destroy semaphore %p", sem);
 436   if (sem != NULL) {
 437     xbt_assert(xbt_swag_size(sem->sleeping) == 0,
 438                 "Cannot destroy semaphore since someone is still using it");
 439     xbt_swag_free(sem->sleeping);
 440     xbt_free(sem);
 441   }
 442   XBT_OUT();
 443 }
 444
 445 void SIMIX_pre_sem_release(smx_simcall_t simcall, smx_sem_t sem){
 446   SIMIX_sem_release(sem);
 447 }
 448 /** @brief release the semaphore
 449  *
 450  * Unlock a process waiting on the semaphore.
 451  * If no one was blocked, the semaphore capacity is increased by 1.
 452  */
 453 void SIMIX_sem_release(smx_sem_t sem)
 454 {
 455   XBT_IN("(%p)",sem);
 456   smx_process_t proc;
 457
 458   XBT_DEBUG("Sem release semaphore %p", sem);
 459   if ((proc = xbt_swag_extract(sem->sleeping))) {
 460     proc = xbt_swag_extract(sem->sleeping);
 461     SIMIX_synchro_destroy(proc->waiting_action);
 462     proc->waiting_action = NULL;
 463     SIMIX_simcall_answer(&proc->simcall);
 464   } else if (sem->value < SMX_SEM_NOLIMIT) {
 465     sem->value++;
 466   }
 467   XBT_OUT();
 468 }
 469
 470 XBT_INLINE int SIMIX_pre_sem_would_block(smx_simcall_t simcall, smx_sem_t sem){
 471   return SIMIX_sem_would_block(sem);
 472 }
 473 /** @brief Returns true if acquiring this semaphore would block */
 474 XBT_INLINE int SIMIX_sem_would_block(smx_sem_t sem)
 475 {
 476   XBT_IN("(%p)",sem);
 477   XBT_OUT();
 478   return (sem->value <= 0);
 479 }
 480
 481 int SIMIX_pre_sem_get_capacity(smx_simcall_t simcall, smx_sem_t sem){
 482   return SIMIX_sem_get_capacity(sem);
 483 }
 484 /** @brief Returns the current capacity of the semaphore */
 485 int SIMIX_sem_get_capacity(smx_sem_t sem)
 486 {
 487   XBT_IN("(%p)",sem);
 488   XBT_OUT();
 489   return sem->value;
 490 }
 491
 492 static void _SIMIX_sem_wait(smx_sem_t sem, double timeout, smx_process_t issuer,
 493                             smx_simcall_t simcall)
 494 {
 495   XBT_IN("(%p, %f, %p, %p)",sem,timeout,issuer,simcall);
 496   smx_action_t sync_act = NULL;
 497
 498   XBT_DEBUG("Wait semaphore %p (timeout:%f)", sem, timeout);
 499   if (sem->value <= 0) {
 500     sync_act = SIMIX_synchro_wait(issuer->smx_host, timeout);
 501     xbt_fifo_unshift(sync_act->simcalls, simcall);
 502     issuer->waiting_action = sync_act;
 503     xbt_swag_insert(issuer, sem->sleeping);
 504   } else {
 505     sem->value--;
 506     SIMIX_simcall_answer(simcall);
 507   }
 508   XBT_OUT();
 509 }
 510
 511 /**
 512  * \brief Handles a sem acquire simcall without timeout.
 513  * \param simcall the simcall
 514  */
 515 void SIMIX_pre_sem_acquire(smx_simcall_t simcall, smx_sem_t sem)
 516 {
 517   XBT_IN("(%p)",simcall);
 518   _SIMIX_sem_wait(sem, -1, simcall->issuer, simcall);
 519   XBT_OUT();
 520 }
 521
 522 /**
 523  * \brief Handles a sem acquire simcall with timeout.
 524  * \param simcall the simcall
 525  */
 526 void SIMIX_pre_sem_acquire_timeout(smx_simcall_t simcall, smx_sem_t sem, double timeout)
 527 {
 528   XBT_IN("(%p)",simcall);
 529   _SIMIX_sem_wait(sem, timeout, simcall->issuer, simcall);
 530   XBT_OUT();
 531 }