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

Timestamp:

Mar 12, 2010 11:25:58 AM (15 years ago)

Author:

vboxsync

Message:

Main: Introduce various I/O control settings:

• Used I/O manager (Simple,Async)
• Used I/O backend (Buffered,Unbuffered)
• I/O cache (on,off)
• I/O cache size
• Maximum I/O bandwidth used by the VM (0 for disabled)

File:

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

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

@@ -1178 +1178 @@
   </enum>
 
-
+  <enum
+   name="IoMgrType"
+   uuid="35567419-4d2a-4256-a74e-efcae33493a2"
+   >
+     <desc>
+       Type of the I/O manager used for the image files in a virtual machine.
+     </desc>
+     <const name="Simple" value="1">
+       <desc>Simple manager. Normally only used if the default one runs into an
+       error. </desc>
+     </const>
+     <const name="Async" value="2">
+       <desc>Asynchronous manager using the async I/O API on the host if present.
+       This is the default manager.</desc>
+     </const>
+   </enum>
+
+  <enum
+   name="IoBackendType"
+   uuid="2a7e16d1-4e6b-4d5d-b0c9-b9bbe6c5b2ad"
+   >
+     <desc>
+       Type of I/O backend used for the image files in a virtual machine.
+     </desc>
+     <const name="Buffered" value="1">
+       <desc>Image files will use the host cache if possible.
+       This type does not work with the Async I/O manager on Linux hosts.
+       Default on all hosts except Linux.</desc>
+     </const>
+     <const name="Unbuffered" value="2">
+       <desc>Image files will not use the host cache.
+       This should be used on OS X and Linux hosts if a high I/O load is expected
+       or many virtual machines are running to prevent I/O cache
+       related hangs. Default on Linux hosts.</desc>
+     </const>
+  </enum>
 
   <!--
@@ -4232 +4267 @@
   <interface
      name="IMachine" extends="$unknown"
-     uuid="f2816298-7408-4c44-a117-0ed8ea09b9bc"
+     uuid="8d8f6fbb-54c1-4604-b68e-17619d458611"
      wsmap="managed"
      >
@@ -4771 +4806 @@
     </attribute>
 
+    <attribute name="ioMgr" type="IoMgrType">
+      <desc>
+        Selects the I/O manager to use for the virtual machine.
+      </desc>
+    </attribute>
+
+    <attribute name="ioBackend" type="IoBackendType">
+      <desc>
+        Selects the I/O backend to use for the virtual machine.
+      </desc>
+    </attribute>
+
+    <attribute name="ioCacheEnabled" type="boolean">
+      <desc>
+        When set to @a true, the builtin I/O cache of the virtual machine
+        will be enabled.
+      </desc>
+    </attribute>
+
+    <attribute name="ioCacheSize" type="unsigned long">
+      <desc>
+        Maximum size of the I/O cache in MB.
+      </desc>
+    </attribute>
+
+    <attribute name="ioBandwidthMax" type="unsigned long">
+      <desc>
+        The maximum number of MB the VM is allowed to transfer per second.
+        0 means unlimited bandwidth.
+      </desc>
+    </attribute>
+
     <method name="setBootOrder">
       <desc>