Changeset 36898 in vbox

Timestamp:

Apr 29, 2011 3:34:05 PM (14 years ago)

Author:

vboxsync

Message:

Main/Machine: first draft of method for cloning entire machines

Location:

trunk/src/VBox/Main

Files:

• idl/VirtualBox.xidl (modified) (2 diffs)
• include/MachineImpl.h (modified) (2 diffs)
• src-server/MachineImpl.cpp (modified) (1 diff)

trunk/src/VBox/Main/idl/VirtualBox.xidl

@@ -3499 +3499 @@
   <interface
     name="IMachine" extends="$unknown"
-    uuid="662c175e-a69d-40b8-a77a-1d719d0ab062"
+    uuid="59d09c78-2558-45c8-a95e-8761d70fdc95"
     wsmap="managed"
     >
@@ -5917 +5917 @@
       </param>
     </method>
+
+    <method name="cloneTo">
+      <desc>
+        Creates a clone of this machine, either as a full clone (which means
+        creating independent copies of the hard disk media), or as a linked
+        clone (which uses its own differencing media, sharing the parent media
+        with the source machine).
+
+        The target machine object must have been created previously with
+        <link to="IVirtualBox::createMachine"/>, and all the settings will be
+        transferred except the VM name, hardware UUID and the network card
+        MAC addresses. These can be set after the clone operation if required.
+        The operation is performed asynchronously, so the machine object will
+        be not be usable until the @a progress object signals completion. If
+        any step of the machine clone operation fails this will abort the
+        operation. The result will be a machine which is not a complete clone.
+        It is the responsibility of the caller to delete this incomplete
+        machine if desired with <link to="#unregister"/> and/or
+        <link to="#delete"/>.
+
+        <result name="E_INVALIDARG">
+          @a target is @c null.
+        </result>
+      </desc>
+
+      <param name="target" type="IMachine" dir="in">
+        <desc>Target machine object.</desc>
+      </param>
+      <param name="fullClone" type="boolean" dir="in">
+        <desc>Selects whether a full or linked clone is created.</desc>
+      </param>
+      <param name="progress" type="IProgress" dir="return">
+        <desc>Progress object to track the operation completion.</desc>
+      </param>
+    </method>
+
   </interface>
 

trunk/src/VBox/Main/include/MachineImpl.h

@@ -460 +460 @@
     STDMETHOD(COMGETTER(IoCacheSize)) (ULONG *aIoCacheSize);
     STDMETHOD(COMSETTER(IoCacheSize)) (ULONG  aIoCacheSize);
+    STDMETHOD(COMGETTER(PciDeviceAssignments))(ComSafeArrayOut(IPciDeviceAttachment *, aAssignments));
+    STDMETHOD(COMGETTER(BandwidthControl))(IBandwidthControl **aBandwidthControl);
 
     // IMachine methods
@@ -527 +529 @@
     STDMETHOD(AttachHostPciDevice(LONG hostAddress, LONG desiredGuestAddress, BOOL tryToUnbind));
     STDMETHOD(DetachHostPciDevice(LONG hostAddress));
-    STDMETHOD(COMGETTER(PciDeviceAssignments))(ComSafeArrayOut(IPciDeviceAttachment *, aAssignments));
-    STDMETHOD(COMGETTER(BandwidthControl))(IBandwidthControl **aBandwidthControl);
+    STDMETHOD(CloneTo(IMachine *aTarget, BOOL aFullClone, IProgress **aProgress));
     // public methods only for internal purposes
 

trunk/src/VBox/Main/src-server/MachineImpl.cpp

@@ -6027 +6027 @@
 }
 
+STDMETHODIMP Machine::CloneTo(IMachine *aTarget, BOOL aFullClone, IProgress **aProgress)
+{
+    NOREF(aTarget); NOREF(aFullClone); NOREF(aProgress);
+    ReturnComNotImplemented();
+}
+
 // public methods for internal purposes
 /////////////////////////////////////////////////////////////////////////////