1 /* Copyright (c) 2012-2013. The SimGrid Team.
2 * All rights reserved. */
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. */
7 #include "msg_private.h"
8 #include "xbt/sysdep.h"
11 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(msg_vm, msg,
12 "Cloud-oriented parts of the MSG API");
14 /** @brief Create a new (empty) VMs.
17 * @bug it is expected that in the future, the coreAmount parameter will be used
18 * to add extra constraints on the execution, but the argument is ignored for now.
21 msg_vm_t MSG_vm_start(msg_host_t location, const char *name, int coreAmount) {
22 msg_vm_t res = xbt_new0(s_msg_vm_t,1);
23 res->all_vms_hookup.prev = NULL;
24 res->host_vms_hookup.prev = NULL;
25 res->state = msg_vm_state_running;
26 res->location = location;
27 res->coreAmount = coreAmount;
28 res->name = xbt_strdup(name);
29 res->processes = xbt_dynar_new(sizeof(msg_process_t),NULL);
31 xbt_swag_insert(res,msg_global->vms);
32 xbt_swag_insert(res, MSG_host_priv(location)->vms);
35 TRACE_msg_vm_create(name, location);
41 /** @brief Returns a newly constructed dynar containing all existing VMs in the system.
44 * Don't forget to free the dynar after use.
46 xbt_dynar_t MSG_vms_as_dynar(void) {
47 xbt_dynar_t res = xbt_dynar_new(sizeof(msg_vm_t),NULL);
49 xbt_swag_foreach(vm,msg_global->vms) {
50 xbt_dynar_push(res,&vm);
55 /** @brief Returns whether the given VM is currently suspended
58 int MSG_vm_is_suspended(msg_vm_t vm) {
59 return vm->state == msg_vm_state_suspended;
61 /** @brief Returns whether the given VM is currently running
64 int MSG_vm_is_running(msg_vm_t vm) {
65 return vm->state == msg_vm_state_running;
67 /** @brief Add the given process into the VM.
70 * Afterward, when the VM is migrated or suspended or whatever, the process will have the corresponding handling, too.
73 void MSG_vm_bind(msg_vm_t vm, msg_process_t process) {
74 /* check if the process is already in a VM */
75 simdata_process_t simdata = simcall_process_get_data(process);
77 msg_vm_t old_vm = simdata->vm;
78 int pos = xbt_dynar_search(old_vm->processes,&process);
79 xbt_dynar_remove_at(old_vm->processes,pos, NULL);
81 /* check if the host is in the right host */
82 if (simdata->m_host != vm->location) {
83 MSG_process_migrate(process,vm->location);
87 XBT_DEBUG("binding Process %s to %p",MSG_process_get_name(process),vm);
89 xbt_dynar_push_as(vm->processes,msg_process_t,process);
91 /** @brief Removes the given process from the given VM, and kill it
94 * Will raise a not_found exception if the process were not bound to that VM
96 void MSG_vm_unbind(msg_vm_t vm, msg_process_t process) {
97 int pos = xbt_dynar_search(vm->processes,process);
98 xbt_dynar_remove_at(vm->processes,pos, NULL);
99 MSG_process_kill(process);
102 /** @brief Immediately change the host on which all processes are running.
105 * No migration cost occurs. If you want to simulate this too, you want to use a
106 * MSG_task_send() before or after, depending on whether you want to do cold or hot
109 void MSG_vm_migrate(msg_vm_t vm, msg_host_t destination) {
111 msg_process_t process;
112 xbt_dynar_foreach(vm->processes,cpt,process) {
113 MSG_process_migrate(process,destination);
115 xbt_swag_remove(vm, MSG_host_priv(vm->location)->vms);
116 xbt_swag_insert_at_tail(vm, MSG_host_priv(destination)->vms);
119 TRACE_msg_vm_change_host(vm,vm->location,destination);
122 vm->location = destination;
125 /** @brief Immediately suspend the execution of all processes within the given VM.
128 * No suspension cost occurs. If you want to simulate this too, you want to
129 * use a \ref MSG_file_write() before or after, depending on the exact semantic
130 * of VM suspend to you.
132 void MSG_vm_suspend(msg_vm_t vm) {
134 msg_process_t process;
135 xbt_dynar_foreach(vm->processes,cpt,process) {
136 XBT_DEBUG("suspend process %s of host %s",MSG_process_get_name(process),MSG_host_get_name(MSG_process_get_host(process)));
137 MSG_process_suspend(process);
141 TRACE_msg_vm_suspend(vm);
145 /** @brief Immediately resumes the execution of all processes within the given VM.
148 * No resume cost occurs. If you want to simulate this too, you want to
149 * use a \ref MSG_file_read() before or after, depending on the exact semantic
150 * of VM resume to you.
152 void MSG_vm_resume(msg_vm_t vm) {
154 msg_process_t process;
155 xbt_dynar_foreach(vm->processes,cpt,process) {
156 XBT_DEBUG("resume process %s of host %s",MSG_process_get_name(process),MSG_host_get_name(MSG_process_get_host(process)));
157 MSG_process_resume(process);
161 TRACE_msg_vm_resume(vm);
165 /** @brief Immediately kills all processes within the given VM. Any memory that they allocated will be leaked.
168 * No extra delay occurs. If you want to simulate this too, you want to
169 * use a #MSG_process_sleep() or something. I'm not quite sure.
171 void MSG_vm_shutdown(msg_vm_t vm)
173 msg_process_t process;
174 XBT_DEBUG("%lu processes in the VM", xbt_dynar_length(vm->processes));
175 while (!xbt_dynar_is_empty(vm->processes)) {
176 process = xbt_dynar_get_as(vm->processes,0,msg_process_t);
177 MSG_process_kill(process);
181 TRACE_msg_vm_kill(vm);
188 * \brief Reboot the VM, restarting all the processes in it.
190 void MSG_vm_reboot(msg_vm_t vm)
192 xbt_dynar_t process_list = xbt_dynar_new(sizeof(msg_process_t), NULL);
193 msg_process_t process;
196 xbt_dynar_foreach(vm->processes, cpt, process) {
197 xbt_dynar_push_as(process_list, msg_process_t, process);
200 xbt_dynar_foreach(process_list, cpt, process) {
201 msg_process_t new_process = MSG_process_restart(process);
202 MSG_vm_bind(vm, new_process);
205 xbt_dynar_free(&process_list);
208 /** @brief Destroy a msg_vm_t.
211 void MSG_vm_destroy(msg_vm_t vm) {
213 msg_process_t process;
214 xbt_dynar_foreach(vm->processes,cpt,process) {
216 simdata_process_t simdata = simcall_process_get_data(process);
221 TRACE_msg_vm_end(vm);
225 xbt_dynar_free(&vm->processes);