Changeset 67652 in vbox for trunk/src/VBox/Main/idl

Timestamp:

Jun 27, 2017 5:59:55 PM (8 years ago)

Author:

vboxsync

Message:

IUnattended: Some refactoring, probably not quite working right yet.

File:

• trunk/src/VBox/Main/idl/VirtualBox.xidl (modified) (5 diffs)

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

@@ -3767 +3767 @@
   <interface
     name="IUnattended" extends="$unknown"
-    uuid="47f28e07-4cb5-4d24-1e1f-42f827f70fb0"
+    uuid="cc3e4bc1-2cb1-4ac7-f26b-dedf01dd24a9"
     wsmap="managed"
     reservedMethods="4" reservedAttributes="4"
@@ -3826 +3826 @@
     </attribute>
 
-    <attribute name="auxiliaryCDPath" type="wstring">
-      <desc>
-        The path of any auxiliary CD image we might be creating.  Related
-        temporary files will appear in the same directory.
-      </desc>
-    </attribute>
-
-    <attribute name="auxiliaryFloppyPath" type="wstring">
-      <desc>
-        Where to store the auxiliary floppy we might be creating.
+    <attribute name="auxiliaryBasePath" type="wstring">
+      <desc>
+        The path + basename for auxiliary files generated by the unattended
+        installation.  This defaults to the VM folder + Unattended + VM UUID.
+
+        The files which gets generated depends on the OS being installed.  When
+        installing Windows there is currently only a auxiliaryBasePath + "floppy.img"
+        being created.  But for linux, a "cdrom.viso" and one or more configuration
+        files are generate generated.
       </desc>
     </attribute>
@@ -3846 +3845 @@
     </attribute>
 
-    <attribute name="fileWithPreparedData" type="wstring">
-      <!-- bird: Would make more sense to make this a method for loading settings from a given file, i.e.
-                 immediate feedback and ability to tweak it afterwards. -->
-      <desc>
-        A path to the file with data prepared by user.
-        The internal rule is "name = value" like "isoPath = /correct/path/to/the/iso"
-        One line - one parameter
-      </desc>
-    </attribute>
-
-    <method name="preparation">
-      <desc>
-        Preparation for running the unattended process of installation
+    <method name="loadSettings">
+      <desc>
+        Loads attributes from a file.
+
+        The internal rule is "attribute = value" like for instance
+        "isoPath = /correct/path/to/the/iso".  One line - one parameter.
+      </desc>
+
+      <param name="filename" type="wstring" dir="in">
+        <desc>File path.</desc>
+      </param>
+    </method>
+
+    <method name="prepare">
+      <desc>
+        Prepare for running the unattended process of installation.
       </desc>
     </method>
@@ -3876 +3878 @@
     </method>
 
-    <method name="reconstructVM">
+    <method name="reconfigureVM">
       <desc>
         Prepare a newly created VM to start unattended installation
@@ -3883 +3885 @@
     </method>
 
-    <method name="runInstallation">
-      <desc>
-        Run unattended installation
+    <method name="done">
+      <desc>
+        This flushes the settings and whatever else might be open before the
+        caller launches the VM.
       </desc>
     </method>