org/simgrid/msg/VM.java

   1 /*
   2  * JNI interface to Cloud interface in Simgrid
   3  *
   4  * Copyright 2006,2007,2010,2012 The SimGrid Team.
   5  * All right reserved.
   6  *
   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.
  10  */
  11 package org.simgrid.msg;
  12
  13 import org.simgrid.msg.Host;
  14 import org.simgrid.msg.Process;
  15
  16 public class VM {
  17         /**
  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.
  21          */
  22         private long bind = 0;
  23
  24         private int coreAmount;
  25         /**
  26          * @brief Create a new empty VM.
  27          * @bug it is expected that in the future, the coreAmount parameter will be used
  28          * to add extra constraints on the execution, but the argument is ignored for now.
  29          */
  30         public VM(Host host, int coreAmount) {
  31                 this.coreAmount = coreAmount;
  32                 start(host,coreAmount);
  33         }
  34         /**
  35          * Natively implemented method starting the VM.
  36          * @param coreAmount
  37          */
  38         private native void start(Host host, int coreAmount);
  39
  40         /**
  41          * @brief Returns a new array containing all existing VMs.
  42          */
  43         public static native VM[] all();
  44
  45         /** @brief Returns whether the given VM is currently suspended
  46          */
  47         public native boolean isSuspended();
  48         /** @brief Returns whether the given VM is currently running
  49          */
  50         public native boolean isRunning();
  51         /** @brief Add the given process into the VM.
  52          * Afterward, when the VM is migrated or suspended or whatever, the process will have the corresponding handling, too.
  53          */
  54         public native void bind(Process process);
  55         /** @brief Removes the given process from the given VM, and kill it
  56          *  Will raise a ProcessNotFound exception if the process were not binded to that VM
  57          */
  58         public native void unbind(Process process);
  59         /** @brief Immediately change the host on which all processes are running
  60          *
  61          * No migration cost occurs. If you want to simulate this too, you want to use a
  62          * Task.send() before or after, depending on whether you want to do cold or hot
  63          * migration.
  64          */
  65         public native void migrate(Host destination);
  66         /** @brief Immediately suspend the execution of all processes within the given VM
  67          *
  68          * No suspension cost occurs. If you want to simulate this too, you want to
  69          * use a \ref File.write() before or after, depending on the exact semantic
  70          * of VM suspend to you.
  71          */
  72         public native void suspend();
  73         /** @brief Immediately resumes the execution of all processes within the given VM
  74          *
  75          * No resume cost occurs. If you want to simulate this too, you want to
  76          * use a \ref File.read() before or after, depending on the exact semantic
  77          * of VM resume to you.
  78          */
  79         public native void resume();
  80
  81         public native void shutdown();
  82
  83 }