1 /* Copyright (c) 2007-2015. The SimGrid Team. All rights reserved. */
3 /* This program is free software; you can redistribute it and/or modify it
4 * under the terms of the license (GNU LGPL) which comes with this package. */
7 #include "simgrid/s4u/VirtualMachine.hpp"
8 #include "smx_private.h"
9 #include "src/surf/HostImpl.hpp"
10 #include "src/surf/VirtualMachineImpl.hpp"
12 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(simix_vm, simix, "Logging specific to SIMIX Virtual Machines");
14 /* works for VMs and PMs */
15 static long host_get_ramsize(sg_host_t vm, int *overcommit)
18 static_cast<simgrid::s4u::VirtualMachine*>(vm)->parameters(¶ms);
21 *overcommit = params.overcommit;
23 return params.ramsize;
26 /* **** start a VM **** */
27 static int __can_be_started(sg_host_t vm)
29 sg_host_t pm = surf_vm_get_pm(vm);
31 int pm_overcommit = 0;
32 long pm_ramsize = host_get_ramsize(pm, &pm_overcommit);
33 long vm_ramsize = host_get_ramsize(vm, nullptr);
36 /* We assume users do not want to care about ramsize. */
41 XBT_VERB("%s allows memory overcommit.", sg_host_get_name(pm));
45 long total_ramsize_of_vms = 0;
46 xbt_dynar_t dyn_vms = pm->pimpl_->getVms();
48 unsigned int cursor = 0;
50 xbt_dynar_foreach(dyn_vms, cursor, another_vm) {
51 long another_vm_ramsize = host_get_ramsize(vm, nullptr);
52 total_ramsize_of_vms += another_vm_ramsize;
56 if (vm_ramsize > pm_ramsize - total_ramsize_of_vms) {
57 XBT_WARN("cannnot start %s@%s due to memory shortage: vm_ramsize %ld, free %ld, pm_ramsize %ld (bytes).",
58 sg_host_get_name(vm), sg_host_get_name(pm),
59 vm_ramsize, pm_ramsize - total_ramsize_of_vms, pm_ramsize);
60 xbt_dynar_free(&dyn_vms);
67 void SIMIX_vm_start(sg_host_t vm)
69 if (__can_be_started(vm))
70 static_cast<simgrid::surf::VirtualMachineImpl*>(vm->pimpl_)->setState(SURF_VM_STATE_RUNNING);
72 THROWF(vm_error, 0, "The VM %s cannot be started", vm->name().c_str());
76 e_surf_vm_state_t SIMIX_vm_get_state(sg_host_t vm)
78 return static_cast<simgrid::surf::VirtualMachineImpl*>(vm->pimpl_)->getState();
82 * @brief Function to migrate a SIMIX VM host.
84 * @param host the vm host to migrate (a sg_host_t)
86 void SIMIX_vm_migrate(sg_host_t vm, sg_host_t dst_pm)
88 /* precopy migration makes the VM temporally paused */
89 xbt_assert(SIMIX_vm_get_state(vm) == SURF_VM_STATE_SUSPENDED);
91 /* jump to vm_ws_xigrate(). this will update the vm location. */
92 surf_vm_migrate(vm, dst_pm);
96 * @brief Encompassing simcall to prevent the removal of the src or the dst node at the end of a VM migration
97 * The simcall actually invokes the following calls:
98 * simcall_vm_migrate(vm, dst_pm);
99 * simcall_vm_resume(vm);
101 * It is called at the end of the migration_rx_fun function from msg/msg_vm.c
103 * @param vm VM to migrate
104 * @param src_pm Source physical host
105 * @param dst_pmt Destination physical host
107 void SIMIX_vm_migratefrom_resumeto(sg_host_t vm, sg_host_t src_pm, sg_host_t dst_pm)
109 /* Update the vm location */
110 SIMIX_vm_migrate(vm, dst_pm);
113 smx_actor_t self = SIMIX_process_self();
114 SIMIX_vm_resume(vm, self);
118 * @brief Function to get the physical host of the given SIMIX VM host.
120 * @param host the vm host to get_phys_host (a sg_host_t)
122 void *SIMIX_vm_get_pm(sg_host_t host)
124 return surf_vm_get_pm(host);
128 * @brief Function to set the CPU bound of the given SIMIX VM host.
130 * @param host the vm host (a sg_host_t)
131 * @param bound bound (a double)
133 void SIMIX_vm_set_bound(sg_host_t vm, double bound)
135 surf_vm_set_bound(vm, bound);
139 * @brief Function to suspend a SIMIX VM host. This function stops the execution of the
140 * VM. All the processes on this VM will pause. The state of the VM is
141 * preserved on memory. We can later resume it again.
143 * @param vm the vm host to suspend (a sg_host_t)
145 void SIMIX_vm_suspend(sg_host_t vm, smx_actor_t issuer)
147 if (SIMIX_vm_get_state(vm) != SURF_VM_STATE_RUNNING)
148 THROWF(vm_error, 0, "VM(%s) is not running", vm->name().c_str());
150 XBT_DEBUG("suspend VM(%s), where %d processes exist", vm->name().c_str(), xbt_swag_size(sg_host_simix(vm)->process_list));
152 /* jump to vm_ws_suspend. The state will be set. */
155 smx_actor_t smx_process, smx_process_safe;
156 xbt_swag_foreach_safe(smx_process, smx_process_safe, sg_host_simix(vm)->process_list) {
157 XBT_DEBUG("suspend %s", smx_process->name.c_str());
158 SIMIX_process_suspend(smx_process, issuer);
161 XBT_DEBUG("suspend all processes on the VM done done");
164 void simcall_HANDLER_vm_suspend(smx_simcall_t simcall, sg_host_t vm)
166 xbt_assert(simcall->issuer->host != vm, "cannot suspend the VM where I run");
168 SIMIX_vm_suspend(vm, simcall->issuer);
170 XBT_DEBUG("simcall_HANDLER_vm_suspend done");
175 * @brief Function to resume a SIMIX VM host. This function restart the execution of the
176 * VM. All the processes on this VM will run again.
178 * @param vm the vm host to resume (a sg_host_t)
180 void SIMIX_vm_resume(sg_host_t vm, smx_actor_t issuer)
182 if (SIMIX_vm_get_state(vm) != SURF_VM_STATE_SUSPENDED)
183 THROWF(vm_error, 0, "VM(%s) was not suspended", vm->name().c_str());
185 XBT_DEBUG("resume VM(%s), where %d processes exist",
186 vm->name().c_str(), xbt_swag_size(sg_host_simix(vm)->process_list));
188 /* jump to vm_ws_resume() */
191 smx_actor_t smx_process, smx_process_safe;
192 xbt_swag_foreach_safe(smx_process, smx_process_safe, sg_host_simix(vm)->process_list) {
193 XBT_DEBUG("resume %s", smx_process->name.c_str());
194 SIMIX_process_resume(smx_process, issuer);
198 void simcall_HANDLER_vm_resume(smx_simcall_t simcall, sg_host_t vm)
200 SIMIX_vm_resume(vm, simcall->issuer);
205 * @brief Function to save a SIMIX VM host.
206 * This function is the same as vm_suspend, but the state of the VM is saved to the disk, and not preserved on memory.
207 * We can later restore it again.
209 * @param vm the vm host to save (a sg_host_t)
211 void SIMIX_vm_save(sg_host_t vm, smx_actor_t issuer)
213 const char *name = sg_host_get_name(vm);
215 if (SIMIX_vm_get_state(vm) != SURF_VM_STATE_RUNNING)
216 THROWF(vm_error, 0, "VM(%s) is not running", name);
218 XBT_DEBUG("save VM(%s), where %d processes exist", name, xbt_swag_size(sg_host_simix(vm)->process_list));
220 /* jump to vm_ws_save() */
223 smx_actor_t smx_process, smx_process_safe;
224 xbt_swag_foreach_safe(smx_process, smx_process_safe, sg_host_simix(vm)->process_list) {
225 XBT_DEBUG("suspend %s", smx_process->name.c_str());
226 SIMIX_process_suspend(smx_process, issuer);
230 void simcall_HANDLER_vm_save(smx_simcall_t simcall, sg_host_t vm)
232 SIMIX_vm_save(vm, simcall->issuer);
237 * @brief Function to restore a SIMIX VM host. This function restart the execution of the
238 * VM. All the processes on this VM will run again.
240 * @param vm the vm host to restore (a sg_host_t)
242 void SIMIX_vm_restore(sg_host_t vm, smx_actor_t issuer)
244 if (SIMIX_vm_get_state(vm) != SURF_VM_STATE_SAVED)
245 THROWF(vm_error, 0, "VM(%s) was not saved", vm->name().c_str());
247 XBT_DEBUG("restore VM(%s), where %d processes exist",
248 vm->name().c_str(), xbt_swag_size(sg_host_simix(vm)->process_list));
250 /* jump to vm_ws_restore() */
253 smx_actor_t smx_process, smx_process_safe;
254 xbt_swag_foreach_safe(smx_process, smx_process_safe, sg_host_simix(vm)->process_list) {
255 XBT_DEBUG("resume %s", smx_process->name.c_str());
256 SIMIX_process_resume(smx_process, issuer);
260 void simcall_HANDLER_vm_restore(smx_simcall_t simcall, sg_host_t vm)
262 SIMIX_vm_restore(vm, simcall->issuer);
267 * @brief Function to shutdown a SIMIX VM host. This function powers off the
268 * VM. All the processes on this VM will be killed. But, the state of the VM is
269 * preserved on memory. We can later start it again.
271 * @param vm the VM to shutdown (a sg_host_t)
273 void SIMIX_vm_shutdown(sg_host_t vm, smx_actor_t issuer)
275 if (SIMIX_vm_get_state(vm) != SURF_VM_STATE_RUNNING)
276 THROWF(vm_error, 0, "VM(%s) is not running", vm->name().c_str());
278 XBT_DEBUG("shutdown VM %s, that contains %d processes",
279 vm->name().c_str(),xbt_swag_size(sg_host_simix(vm)->process_list));
281 smx_actor_t smx_process, smx_process_safe;
282 xbt_swag_foreach_safe(smx_process, smx_process_safe, sg_host_simix(vm)->process_list) {
283 XBT_DEBUG("kill %s", smx_process->name.c_str());
284 SIMIX_process_kill(smx_process, issuer);
287 /* FIXME: we may have to do something at the surf layer, e.g., vcpu action */
288 static_cast<simgrid::surf::VirtualMachineImpl*>(vm->pimpl_)->setState(SURF_VM_STATE_CREATED);
291 void simcall_HANDLER_vm_shutdown(smx_simcall_t simcall, sg_host_t vm)
293 SIMIX_vm_shutdown(vm, simcall->issuer);
297 * @brief Function to destroy a SIMIX VM host.
299 * @param vm the vm host to destroy (a sg_host_t)
301 void SIMIX_vm_destroy(sg_host_t vm)
303 /* this code basically performs a similar thing like SIMIX_host_destroy() */
304 XBT_DEBUG("destroy %s", vm->name().c_str());
306 /* FIXME: this is really strange that everything fails if the next line is removed.
307 * This is as if we shared these data with the PM, which definitely should not be the case...
309 * We need to test that suspending a VM does not suspends the processes running on its PM, for example.
310 * Or we need to simplify this code enough to make it actually readable (but this sounds harder than testing)
312 vm->extension_set<simgrid::simix::Host>(nullptr);
314 /* Don't free these things twice: they are the ones of my physical host */
315 vm->pimpl_cpu = nullptr;
316 vm->pimpl_netcard = nullptr;