1 /* JNI interface to virtual machine in Simgrid */
3 /* Copyright (c) 2006-2014. The SimGrid Team.
4 * All rights reserved. */
6 /* This program is free software; you can redistribute it and/or modify it
7 * under the terms of the license (GNU LGPL) which comes with this package. */
9 package org.simgrid.msg;
10 import java.util.ArrayList;
12 public class VM extends Host{
13 // Please note that we are not declaring a new bind variable
14 //(the bind variable has been inherited from the super class Host)
16 /* Static functions */
17 // GetByName is inherited from the super class Host
20 private static ArrayList<VM> vms= new ArrayList<>();
21 private Host currentHost;
23 /* Constructors / destructors */
25 * Create a `basic' VM (i.e. 1 core, 1GB of RAM, other values are not taken into account).
27 public VM(Host host, String name) {
28 this(host,name,1,1024, -1, null, -1,0 , 0);
33 * @param host Host node
34 * @param name name of the machine
35 * @param nCore number of core
36 * @param ramSize size of the RAM that should be allocated (in MBytes)
37 * @param netCap (not used for the moment)
38 * @param diskPath (not used for the moment)
39 * @param diskSize (not used for the moment)
40 * @param migNetSpeed (network bandwith allocated for migrations in MB/s, if you don't know put zero ;))
41 * @param dpIntensity (dirty page percentage according to migNetSpeed, [0-100], if you don't know put zero ;))
43 public VM(Host host, String name, int nCore, int ramSize,
44 int netCap, String diskPath, int diskSize, int migNetSpeed, int dpIntensity){
47 this.currentHost = host;
48 create(host, name, nCore, ramSize, netCap, diskPath, diskSize, migNetSpeed, dpIntensity);
52 public static VM[] all(){
53 VM[] allvms = new VM[vms.size()];
58 public static VM getVMByName(String name){
60 if (vm.getName().equals(name))
66 public void destroy() {
69 } catch (Exception e) {
73 private native void nativeFinalize();
76 /* JNI / Native code */
78 /* get/set property methods are inherited from the Host class. */
80 /** Returns whether the given VM is currently suspended
82 public native int isCreated();
84 /** Returns whether the given VM is currently running
86 public native int isRunning();
88 /** Returns whether the given VM is currently running
90 public native int isMigrating();
92 /** Returns whether the given VM is currently suspended
94 public native int isSuspended();
96 /** Returns whether the given VM is currently saving
98 public native int isSaving();
100 /** Returns whether the given VM is currently saved
102 public native int isSaved();
104 /** Returns whether the given VM is currently restoring its state
106 public native boolean isRestoring();
109 * Natively implemented method create the VM.
110 * @param nCore number of core
111 * @param ramSize size of the RAM that should be allocated (in MB)
112 * @param netCap (not used for the moment)
113 * @param diskPath (not used for the moment)
114 * @param diskSize (not used for the moment)
115 * @param migNetSpeed (network bandwith allocated for migrations in MB/s, if you don't know put zero ;))
116 * @param dpIntensity (dirty page intensity, a percentage of migNetSpeed [0-100], if you don't know put zero ;))
118 private native void create(Host host, String name, int nCore, int ramSize,
119 int netCap, String diskPath, int diskSize, int migNetSpeed, int dpIntensity);
123 * Set a CPU bound for a given VM.
124 * @param bound in flops/s
126 public native void setBound(double bound);
131 public native void start();
135 * Immediately kills all processes within the given VM. Any memory that they allocated will be leaked.
136 * No extra delay occurs. If you want to simulate this too, you want to use a MSG_process_sleep() or something
138 public native void shutdown();
141 * Invoke native migration routine
143 public native void internalmig(Host destination) throws Exception; // TODO add throws DoubleMigrationException (i.e. when you call migrate on a VM that is already migrating);
147 /** Change the host on which all processes are running
148 * (pre-copy is implemented)
150 public void migrate(Host destination) throws HostFailureException{
152 this.internalmig(destination);
153 } catch (Exception e){
154 Msg.info("Migration of VM "+this.getName()+" to "+destination.getName()+" is impossible ("+e.getMessage()+")");
155 throw new HostFailureException();
157 // If the migration correcly returned, then we should change the currentHost value.
158 this.currentHost = destination;
161 /** Immediately suspend the execution of all processes within the given VM
163 * No suspension cost occurs. If you want to simulate this too, you want to
164 * use a \ref File.write() before or after, depending on the exact semantic
165 * of VM suspend to you.
167 public native void suspend();
169 /** Immediately resumes the execution of all processes within the given VM
171 * No resume cost occurs. If you want to simulate this too, you want to
172 * use a \ref File.read() before or after, depending on the exact semantic
173 * of VM resume to you.
175 public native void resume();
177 /** Immediately suspend the execution of all processes within the given VM
178 * and save its state on the persistent HDD
179 * Not yet implemented (for the moment it behaves like suspend)
180 * No suspension cost occurs. If you want to simulate this too, you want to
181 * use a \ref File.write() before or after, depending on the exact semantic
182 * of VM suspend to you.
184 public native void save();
186 /** Immediately resumes the execution of all processes previously saved
187 * within the given VM
188 * Not yet implemented (for the moment it behaves like resume)
190 * No resume cost occurs. If you want to simulate this too, you want to
191 * use a \ref File.read() before or after, depending on the exact semantic
192 * of VM resume to you.
194 public native void restore();
198 * Class initializer, to initialize various JNI stuff
200 public static native void nativeInit();