2 * JNI interface to Cloud interface in Simgrid
4 * Copyright 2006-2012 The SimGrid Team.
7 * This program is free software; you can redistribute
8 * it and/or modify it under the terms of the license
9 * (GNU LGPL) which comes with this package.
11 package org.simgrid.msg;
13 import org.simgrid.msg.Host;
14 import org.simgrid.msg.Process;
18 * This attribute represents a bind between a java task object and
19 * a native task. Even if this attribute is public you must never
20 * access to it. It is set automatically during the build of the object.
22 private long bind = 0;
24 private int coreAmount;
28 * Create a new empty VM.
29 * NOTE: it is expected that in the future, the coreAmount parameter will be used
30 * to add extra constraints on the execution, but the argument is ignored for now.
32 public VM(Host host, String name, int coreAmount) {
33 this.coreAmount = coreAmount;
35 start(host,name,coreAmount);
37 protected void finalize() {
43 protected native void destroy();
45 * Natively implemented method starting the VM.
48 private native void start(Host host, String name, int coreAmount);
50 /** Returns whether the given VM is currently suspended
52 public native boolean isSuspended();
53 /** Returns whether the given VM is currently running
55 public native boolean isRunning();
56 /** Add the given process into the VM.
57 * Afterward, when the VM is migrated or suspended or whatever, the process will have the corresponding handling, too.
59 public native void bind(Process process);
60 /** Removes the given process from the given VM, and kill it
61 * Will raise a ProcessNotFound exception if the process were not binded to that VM
63 public native void unbind(Process process);
64 /** Immediately change the host on which all processes are running
66 * No migration cost occurs. If you want to simulate this too, you want to use a
67 * Task.send() before or after, depending on whether you want to do cold or hot
70 public native void migrate(Host destination);
71 /** Immediately suspend the execution of all processes within the given VM
73 * No suspension cost occurs. If you want to simulate this too, you want to
74 * use a \ref File.write() before or after, depending on the exact semantic
75 * of VM suspend to you.
77 public native void suspend();
78 /** Immediately resumes the execution of all processes within the given VM
80 * No resume cost occurs. If you want to simulate this too, you want to
81 * use a \ref File.read() before or after, depending on the exact semantic
82 * of VM resume to you.
84 public native void resume();
86 * Immediately kills all processes within the given VM. Any memory that they allocated will be leaked.
87 * No extra delay occurs. If you want to simulate this too, you want to use a MSG_process_sleep() or something
89 public native void shutdown();
91 * Reboot the VM, restarting all the processes in it.
93 public native void reboot();
95 public String getName() {