src/simix/smx_vm.c

   1 /* Copyright (c) 2007-2012. 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/sysdep.h"
   9 #include "xbt/log.h"
  10 #include "xbt/dict.h"
  11 #include "mc/mc.h"
  12
  13 //If you need to log some stuffs, just uncomment these two lines and uses XBT_DEBUG for instance
  14 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(simix_vm, simix, "Logging specific to SIMIX (vms)");
  15
  16 /* **** create a VM **** */
  17
  18 /**
  19  * \brief Internal function to create a SIMIX host.
  20  * \param name name of the host to create
  21  * \param data some user data (may be NULL)
  22  */
  23 smx_host_t SIMIX_vm_create(const char *name, smx_host_t ind_phys_host)
  24 {
  25   /* Create surf associated resource */
  26   surf_vm_workstation_model->extension.vm_workstation.create(name, ind_phys_host);
  27
  28   smx_host_t smx_host = SIMIX_host_create(name, ind_phys_host, NULL);
  29
  30   /* We will be able to register the VM to its physical host, so that we can promptly
  31    * retrieve the list VMs on the physical host. */
  32
  33   return smx_host;
  34 }
  35
  36
  37 smx_host_t SIMIX_pre_vm_create(smx_simcall_t simcall, const char *name, smx_host_t ind_phys_host)
  38 {
  39   return SIMIX_vm_create(name, ind_phys_host);
  40 }
  41
  42
  43 /* works for VMs and PMs */
  44 static long host_get_ramsize(smx_host_t vm, int *overcommit)
  45 {
  46   s_ws_params_t params;
  47   surf_workstation_model->extension.workstation.get_params(vm, &params);
  48
  49   if (overcommit)
  50     *overcommit = params.overcommit;
  51
  52   return params.ramsize;
  53 }
  54
  55 /* **** start a VM **** */
  56 static int __can_be_started(smx_host_t vm)
  57 {
  58   smx_host_t pm = surf_vm_workstation_model->extension.vm_workstation.get_pm(vm);
  59
  60   int pm_overcommit = 0;
  61   long pm_ramsize = host_get_ramsize(pm, &pm_overcommit);
  62   long vm_ramsize = host_get_ramsize(vm, NULL);
  63
  64   if (!pm_ramsize) {
  65     /* We assume users do not want to care about ramsize. */
  66     return 1;
  67   }
  68
  69   if (pm_overcommit) {
  70     XBT_INFO("%s allows memory overcommit.", pm->key);
  71     return 1;
  72   }
  73
  74   long total_ramsize_of_vms = 0;
  75   xbt_dynar_t dyn_vms = surf_workstation_model->extension.workstation.get_vms(pm);
  76   {
  77     unsigned int cursor = 0;
  78     smx_host_t another_vm;
  79     xbt_dynar_foreach(dyn_vms, cursor, another_vm) {
  80       long another_vm_ramsize = host_get_ramsize(vm, NULL);
  81       total_ramsize_of_vms += another_vm_ramsize;
  82     }
  83   }
  84
  85   if (vm_ramsize > pm_ramsize - total_ramsize_of_vms) {
  86     XBT_WARN("cannnot start %s@%s due to memory shortage: vm_ramsize %ld, free %ld, pm_ramsize %ld (bytes).",
  87         vm->key, pm->key, vm_ramsize, pm_ramsize - total_ramsize_of_vms, pm_ramsize);
  88     xbt_dynar_free(&dyn_vms);
  89     return 0;
  90   }
  91
  92   xbt_dynar_free(&dyn_vms);
  93         return 1;
  94 }
  95
  96 void SIMIX_vm_start(smx_host_t ind_vm)
  97 {
  98   if (__can_be_started(ind_vm))
  99     SIMIX_vm_set_state(ind_vm, SURF_VM_STATE_RUNNING);
 100   else
 101     THROWF(vm_error, 0, "The VM %s cannot be started", SIMIX_host_get_name(ind_vm));
 102 }
 103
 104
 105
 106 void SIMIX_pre_vm_start(smx_simcall_t simcall, smx_host_t ind_vm)
 107 {
 108   SIMIX_vm_start(ind_vm);
 109 }
 110
 111 /* ***** set/get state of a VM ***** */
 112 void SIMIX_vm_set_state(smx_host_t ind_vm, int state)
 113 {
 114   /* jump to vm_ws_set_state */
 115   surf_vm_workstation_model->extension.vm_workstation.set_state(ind_vm, state);
 116 }
 117
 118 void SIMIX_pre_vm_set_state(smx_simcall_t simcall, smx_host_t ind_vm, int state)
 119 {
 120   SIMIX_vm_set_state(ind_vm, state);
 121 }
 122
 123 int SIMIX_vm_get_state(smx_host_t ind_vm)
 124 {
 125   return surf_vm_workstation_model->extension.vm_workstation.get_state(ind_vm);
 126 }
 127
 128 int SIMIX_pre_vm_get_state(smx_simcall_t simcall, smx_host_t ind_vm)
 129 {
 130   return SIMIX_vm_get_state(ind_vm);
 131 }
 132
 133
 134 /**
 135  * \brief Function to migrate a SIMIX VM host.
 136  *
 137  * \param host the vm host to migrate (a smx_host_t)
 138  */
 139 void SIMIX_vm_migrate(smx_host_t ind_vm, smx_host_t ind_dst_pm)
 140 {
 141   /* precopy migration makes the VM temporally paused */
 142   e_surf_vm_state_t state = SIMIX_vm_get_state(ind_vm);
 143   xbt_assert(state == SURF_VM_STATE_SUSPENDED);
 144
 145   /* jump to vm_ws_migrate(). this will update the vm location. */
 146   surf_vm_workstation_model->extension.vm_workstation.migrate(ind_vm, ind_dst_pm);
 147 }
 148
 149 void SIMIX_pre_vm_migrate(smx_simcall_t simcall, smx_host_t ind_vm, smx_host_t ind_dst_pm)
 150 {
 151   SIMIX_vm_migrate(ind_vm, ind_dst_pm);
 152 }
 153
 154
 155 /**
 156  * \brief Function to get the physical host of the given SIMIX VM host.
 157  *
 158  * \param host the vm host to get_phys_host (a smx_host_t)
 159  */
 160 void *SIMIX_vm_get_pm(smx_host_t ind_vm)
 161 {
 162   /* jump to vm_ws_get_pm(). this will return the vm name. */
 163   return surf_vm_workstation_model->extension.vm_workstation.get_pm(ind_vm);
 164 }
 165
 166 void *SIMIX_pre_vm_get_pm(smx_simcall_t simcall, smx_host_t ind_vm)
 167 {
 168   return SIMIX_vm_get_pm(ind_vm);
 169 }
 170
 171
 172 /**
 173  * \brief Function to set the CPU bound of the given SIMIX VM host.
 174  *
 175  * \param host the vm host (a smx_host_t)
 176  * \param bound bound (a double)
 177  */
 178 void SIMIX_vm_set_bound(smx_host_t ind_vm, double bound)
 179 {
 180   /* jump to vm_ws_set_vm_bound(). */
 181   surf_vm_workstation_model->extension.vm_workstation.set_vm_bound(ind_vm, bound);
 182 }
 183
 184 void SIMIX_pre_vm_set_bound(smx_simcall_t simcall, smx_host_t ind_vm, double bound)
 185 {
 186   SIMIX_vm_set_bound(ind_vm, bound);
 187 }
 188
 189
 190 /**
 191  * \brief Function to set the CPU affinity of the given SIMIX VM host.
 192  *
 193  * \param host the vm host (a smx_host_t)
 194  * \param host the pm host (a smx_host_t)
 195  * \param mask affinity mask (a unsigned long)
 196  */
 197 void SIMIX_vm_set_affinity(smx_host_t ind_vm, smx_host_t ind_pm, unsigned long mask)
 198 {
 199   /* jump to vm_ws_set_vm_affinity(). */
 200   surf_vm_workstation_model->extension.vm_workstation.set_vm_affinity(ind_vm, ind_pm, mask);
 201 }
 202
 203 void SIMIX_pre_vm_set_affinity(smx_simcall_t simcall, smx_host_t ind_vm, smx_host_t ind_pm, unsigned long mask)
 204 {
 205   SIMIX_vm_set_affinity(ind_vm, ind_pm, mask);
 206 }
 207
 208
 209 /**
 210  * \brief Function to suspend a SIMIX VM host. This function stops the exection of the
 211  * VM. All the processes on this VM will pause. The state of the VM is
 212  * preserved on memory. We can later resume it again.
 213  *
 214  * \param host the vm host to suspend (a smx_host_t)
 215  */
 216 void SIMIX_vm_suspend(smx_host_t ind_vm, smx_process_t issuer)
 217 {
 218   const char *name = SIMIX_host_get_name(ind_vm);
 219
 220   if (SIMIX_vm_get_state(ind_vm) != SURF_VM_STATE_RUNNING)
 221     THROWF(vm_error, 0, "VM(%s) is not running", name);
 222
 223   XBT_DEBUG("suspend VM(%s), where %d processes exist", name, xbt_swag_size(SIMIX_host_priv(ind_vm)->process_list));
 224
 225   /* jump to vm_ws_suspend. The state will be set. */
 226   surf_vm_workstation_model->extension.vm_workstation.suspend(ind_vm);
 227
 228   smx_process_t smx_process, smx_process_safe;
 229   xbt_swag_foreach_safe(smx_process, smx_process_safe, SIMIX_host_priv(ind_vm)->process_list) {
 230     XBT_DEBUG("suspend %s", smx_process->name);
 231     SIMIX_process_suspend(smx_process, issuer);
 232   }
 233
 234   XBT_DEBUG("suspend all processes on the VM done done");
 235 }
 236
 237 void SIMIX_pre_vm_suspend(smx_simcall_t simcall, smx_host_t ind_vm)
 238 {
 239   if (simcall->issuer->smx_host == ind_vm) {
 240     XBT_ERROR("cannot suspend the VM where I run");
 241     DIE_IMPOSSIBLE;
 242   }
 243
 244   SIMIX_vm_suspend(ind_vm, simcall->issuer);
 245
 246   XBT_DEBUG("SIMIX_pre_vm_suspend done");
 247 }
 248
 249
 250 /**
 251  * \brief Function to resume a SIMIX VM host. This function restart the execution of the
 252  * VM. All the processes on this VM will run again.
 253  *
 254  * \param host the vm host to resume (a smx_host_t)
 255  */
 256 void SIMIX_vm_resume(smx_host_t ind_vm, smx_process_t issuer)
 257 {
 258   const char *name = SIMIX_host_get_name(ind_vm);
 259
 260   if (SIMIX_vm_get_state(ind_vm) != SURF_VM_STATE_SUSPENDED)
 261     THROWF(vm_error, 0, "VM(%s) was not suspended", name);
 262
 263   XBT_DEBUG("resume VM(%s), where %d processes exist", name, xbt_swag_size(SIMIX_host_priv(ind_vm)->process_list));
 264
 265   /* jump to vm_ws_resume() */
 266   surf_vm_workstation_model->extension.vm_workstation.resume(ind_vm);
 267
 268   smx_process_t smx_process, smx_process_safe;
 269   xbt_swag_foreach_safe(smx_process, smx_process_safe, SIMIX_host_priv(ind_vm)->process_list) {
 270     XBT_DEBUG("resume %s", smx_process->name);
 271     SIMIX_process_resume(smx_process, issuer);
 272   }
 273 }
 274
 275 void SIMIX_pre_vm_resume(smx_simcall_t simcall, smx_host_t ind_vm)
 276 {
 277   SIMIX_vm_resume(ind_vm, simcall->issuer);
 278 }
 279
 280
 281 /**
 282  * \brief Function to save a SIMIX VM host.
 283  * This function is the same as vm_suspend, but the state of the VM is saved to the disk, and not preserved on memory.
 284  * We can later restore it again.
 285  *
 286  * \param host the vm host to save (a smx_host_t)
 287  */
 288 void SIMIX_vm_save(smx_host_t ind_vm, smx_process_t issuer)
 289 {
 290   const char *name = SIMIX_host_get_name(ind_vm);
 291
 292   if (SIMIX_vm_get_state(ind_vm) != SURF_VM_STATE_RUNNING)
 293     THROWF(vm_error, 0, "VM(%s) is not running", name);
 294
 295
 296   XBT_DEBUG("save VM(%s), where %d processes exist", name, xbt_swag_size(SIMIX_host_priv(ind_vm)->process_list));
 297
 298   /* jump to vm_ws_save() */
 299   surf_vm_workstation_model->extension.vm_workstation.save(ind_vm);
 300
 301   smx_process_t smx_process, smx_process_safe;
 302   xbt_swag_foreach_safe(smx_process, smx_process_safe, SIMIX_host_priv(ind_vm)->process_list) {
 303     XBT_DEBUG("suspend %s", smx_process->name);
 304     SIMIX_process_suspend(smx_process, issuer);
 305   }
 306 }
 307
 308 void SIMIX_pre_vm_save(smx_simcall_t simcall, smx_host_t ind_vm)
 309 {
 310   SIMIX_vm_save(ind_vm, simcall->issuer);
 311 }
 312
 313
 314 /**
 315  * \brief Function to restore a SIMIX VM host. This function restart the execution of the
 316  * VM. All the processes on this VM will run again.
 317  *
 318  * \param host the vm host to restore (a smx_host_t)
 319  */
 320 void SIMIX_vm_restore(smx_host_t ind_vm, smx_process_t issuer)
 321 {
 322   const char *name = SIMIX_host_get_name(ind_vm);
 323
 324   if (SIMIX_vm_get_state(ind_vm) != SURF_VM_STATE_SAVED)
 325     THROWF(vm_error, 0, "VM(%s) was not saved", name);
 326
 327   XBT_DEBUG("restore VM(%s), where %d processes exist", name, xbt_swag_size(SIMIX_host_priv(ind_vm)->process_list));
 328
 329   /* jump to vm_ws_restore() */
 330   surf_vm_workstation_model->extension.vm_workstation.resume(ind_vm);
 331
 332   smx_process_t smx_process, smx_process_safe;
 333   xbt_swag_foreach_safe(smx_process, smx_process_safe, SIMIX_host_priv(ind_vm)->process_list) {
 334     XBT_DEBUG("resume %s", smx_process->name);
 335     SIMIX_process_resume(smx_process, issuer);
 336   }
 337 }
 338
 339 void SIMIX_pre_vm_restore(smx_simcall_t simcall, smx_host_t ind_vm)
 340 {
 341   SIMIX_vm_restore(ind_vm, simcall->issuer);
 342 }
 343
 344
 345 /**
 346  * \brief Function to shutdown a SIMIX VM host. This function powers off the
 347  * VM. All the processes on this VM will be killed. But, the state of the VM is
 348  * preserved on memory. We can later start it again.
 349  *
 350  * \param host the vm host to shutdown (a smx_host_t)
 351  */
 352 void SIMIX_vm_shutdown(smx_host_t ind_vm, smx_process_t issuer)
 353 {
 354   const char *name = SIMIX_host_get_name(ind_vm);
 355
 356   if (SIMIX_vm_get_state(ind_vm) != SURF_VM_STATE_RUNNING)
 357     THROWF(vm_error, 0, "VM(%s) is not running", name);
 358
 359   XBT_DEBUG("%d processes in the VM", xbt_swag_size(SIMIX_host_priv(ind_vm)->process_list));
 360
 361   smx_process_t smx_process, smx_process_safe;
 362   xbt_swag_foreach_safe(smx_process, smx_process_safe, SIMIX_host_priv(ind_vm)->process_list) {
 363     XBT_DEBUG("shutdown %s", name);
 364     SIMIX_process_kill(smx_process, issuer);
 365   }
 366
 367   /* FIXME: we may have to do something at the surf layer, e.g., vcpu action */
 368   SIMIX_vm_set_state(ind_vm, SURF_VM_STATE_CREATED);
 369 }
 370
 371 void SIMIX_pre_vm_shutdown(smx_simcall_t simcall, smx_host_t ind_vm)
 372 {
 373   SIMIX_vm_shutdown(ind_vm, simcall->issuer);
 374 }
 375
 376
 377 /**
 378  * \brief Function to destroy a SIMIX VM host.
 379  *
 380  * \param host the vm host to destroy (a smx_host_t)
 381  */
 382 void SIMIX_vm_destroy(smx_host_t ind_vm)
 383 {
 384   /* this code basically performs a similar thing like SIMIX_host_destroy() */
 385
 386   xbt_assert((ind_vm != NULL), "Invalid parameters");
 387   const char *hostname = SIMIX_host_get_name(ind_vm);
 388
 389   /* this will call the registered callback function, i.e., SIMIX_host_destroy().  */
 390   xbt_lib_unset(host_lib, hostname, SIMIX_HOST_LEVEL, 1);
 391
 392   /* jump to vm_ws_destroy(). The surf level resource will be freed. */
 393   surf_vm_workstation_model->extension.vm_workstation.destroy(ind_vm);
 394 }
 395
 396 void SIMIX_pre_vm_destroy(smx_simcall_t simcall, smx_host_t ind_vm)
 397 {
 398   SIMIX_vm_destroy(ind_vm);
 399 }