src/surf/virtual_machine.hpp

   1 /* Copyright (c) 2004-2015. The SimGrid Team.
   2  * All rights reserved.                                                     */
   3
   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. */
   6
   7 #include <xbt/base.h>
   8
   9 #include "host_interface.hpp"
  10
  11 #ifndef VM_INTERFACE_HPP_
  12 #define VM_INTERFACE_HPP_
  13
  14 #define GUESTOS_NOISE 100 // This value corresponds to the cost of the global action associated to the VM
  15                           // It corresponds to the cost of a VM running no tasks.
  16
  17 namespace simgrid {
  18 namespace surf {
  19
  20 /***********
  21  * Classes *
  22  ***********/
  23
  24 class XBT_PRIVATE VMModel;
  25 class XBT_PRIVATE VirtualMachine;
  26
  27 /*************
  28  * Callbacks *
  29  *************/
  30
  31 /** @ingroup SURF_callbacks
  32  * @brief Callbacks fired after VM creation. Signature: `void(VirtualMachine*)`
  33  */
  34 extern XBT_PRIVATE simgrid::xbt::signal<void(simgrid::surf::VirtualMachine*)> VMCreatedCallbacks;
  35
  36 /** @ingroup SURF_callbacks
  37  * @brief Callbacks fired after VM destruction. Signature: `void(VirtualMachine*)`
  38  */
  39 extern XBT_PRIVATE simgrid::xbt::signal<void(simgrid::surf::VirtualMachine*)> VMDestructedCallbacks;
  40
  41 /** @ingroup SURF_callbacks
  42  * @brief Callbacks after VM State changes. Signature: `void(VirtualMachine*)`
  43  */
  44 extern XBT_PRIVATE simgrid::xbt::signal<void(simgrid::surf::VirtualMachine*)> VMStateChangedCallbacks;
  45
  46 /************
  47  * Resource *
  48  ************/
  49
  50 /** @ingroup SURF_vm_interface
  51  * @brief SURF VM interface class
  52  * @details A VM represent a virtual machine
  53  */
  54 class VirtualMachine : public Host {
  55 public:
  56   /**
  57    * @brief Constructor
  58    *
  59    * @param model VMModel associated to this VM
  60    * @param name The name of the VM
  61    * @param props Dictionary of properties associated to this VM
  62    * @param netElm The RoutingEdge associated to this VM
  63    * @param cpu The Cpu associated to this VM
  64    */
  65   VirtualMachine(simgrid::surf::HostModel *model, const char *name, xbt_dict_t props,
  66                         simgrid::Host *host);
  67
  68   /** @brief Destructor */
  69   ~VirtualMachine();
  70
  71   /** @brief Suspend the VM */
  72   virtual void suspend()=0;
  73
  74   /** @brief Resume the VM */
  75   virtual void resume()=0;
  76
  77   /** @brief Save the VM (Not yet implemented) */
  78   virtual void save()=0;
  79
  80   /** @brief Restore the VM (Not yet implemented) */
  81   virtual void restore()=0;
  82
  83   /** @brief Migrate the VM to the destination host */
  84   virtual void migrate(sg_host_t dest_PM)=0;
  85
  86   /** @brief Get the physical machine hosting the VM */
  87   sg_host_t getPm();
  88
  89   virtual void setBound(double bound)=0;
  90   virtual void setAffinity(Cpu *cpu, unsigned long mask)=0;
  91
  92   /* The vm object of the lower layer */
  93   CpuAction *p_action;
  94   simgrid::Host *p_hostPM;
  95
  96   void turnOn() override;
  97   void turnOff() override;
  98
  99 public:
 100   e_surf_vm_state_t getState();
 101   void setState(e_surf_vm_state_t state);
 102 protected:
 103   e_surf_vm_state_t p_vm_state = SURF_VM_STATE_CREATED;
 104
 105
 106 public:
 107   boost::intrusive::list_member_hook<> vm_hook;
 108 };
 109
 110 /*********
 111  * Model *
 112  *********/
 113 /** @ingroup SURF_vm_interface
 114  * @brief SURF VM model interface class
 115  * @details A model is an object which handle the interactions between its Resources and its Actions
 116  */
 117 class VMModel : public HostModel {
 118 public:
 119   VMModel() :HostModel(){}
 120   ~VMModel(){};
 121
 122   /**
 123    * @brief Create a new VM
 124    *
 125    * @param name The name of the new VM
 126    * @param host_PM The real machine hosting the VM
 127    *
 128    */
 129   virtual VirtualMachine *createVM(const char *name, sg_host_t host_PM)=0;
 130   void adjustWeightOfDummyCpuActions() {};
 131
 132   typedef boost::intrusive::member_hook<
 133     VirtualMachine, boost::intrusive::list_member_hook<>, &VirtualMachine::vm_hook> VmOptions;
 134   typedef boost::intrusive::list<VirtualMachine, VmOptions, boost::intrusive::constant_time_size<false> > vm_list_t;
 135   static vm_list_t ws_vms;
 136 };
 137
 138 }
 139 }
 140
 141 #endif /* VM_INTERFACE_HPP_ */