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

Timestamp:

Mar 9, 2009 11:22:42 AM (16 years ago)

Author:

vboxsync

Message:

OVF: implement NAT/Bridged network import/export; some network API documentation

File:

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

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

@@ -3071 +3071 @@
     <const name="Floppy" value="10" />
     <const name="CDROM" value="11" />
-    <const name="LogicalNetwork" value="12" />
-    <const name="NetworkAdapter" value="13" />
-    <const name="USBController" value="14" />
-    <const name="SoundCard" value="15" />
+    <const name="NetworkAdapter" value="12" />
+    <const name="USBController" value="13" />
+    <const name="SoundCard" value="14" />
 
   </enum>
@@ -3166 +3165 @@
       </li>
       <li>
-        "LogicalNetwork": a logical network to which virtual machines can connect. This is taken from
-        the Network section in the OVF that is shared between several virtual systems. OVF has no
-        formal description of how the network shall be set up (e.g. whether to use NAT or host interface
-        networking), but OVFs typically name the logical networks "nat" or "bridged" to suggest such
-        a configuration.
-      </li>
-      <li>
         "NetworkAdapter": a network adapter. The array item in aVboxValues[] will specify the hardware
         for the network adapter, whereas the array item in aExtraConfigValues[] will have a string
-        of the "network=&lt;nw&gt;" format, where &lt;nw&gt; must be one of the networks as specified with the
-        LogicalNetwork type.
+        of the "type=&lt;X&gt;" format, where &lt;X&gt; must be either "NAT" or "Bridged".
       </li>
       <li>
@@ -6516 +6507 @@
       <desc>Specifies whether the IP V6 is supported/enabled for the interface.</desc>
     </attribute>
-    
+
     <attribute name="IPV6Address" type="wstring" readonly="yes">
       <desc>Returns the IP V6 address of the interface.</desc>
@@ -6524 +6515 @@
       <desc>Returns the IP V6 network mask of the interface.</desc>
     </attribute>
-    
+
     <attribute name="hardwareAddress" type="wstring" readonly="yes">
       <desc>Returns the hardware address. For Ethernet it is MAC address.</desc>
@@ -6540 +6531 @@
       <desc>specifies the host interface type.</desc>
     </attribute>
-    
+
     <method name="enableStaticIpConfig">
       <desc>sets and enables the static IP V4 configuration for the given interface.</desc>
@@ -10481 +10472 @@
      wsmap="managed"
      >
+    <desc>
+        Represents a virtual network adapter that is attached to a virtual machine.
+        Each virtual machine has a fixed number of network adapter slots with one
+        instance of this attached to each of them. Call
+        <link to="IMachine::getNetworkAdapter" /> to get the network adapter that
+        is attached to a given slot in a given machine.
+
+        Each network adapter can be in one of five attachment modes, which are
+        represented by the <link to="NetworkAttachmentType" /> enumeration;
+        see the <link to="#attachmentType" /> attribute.
+    </desc>
+
     <attribute name="adapterType" type="NetworkAdapterType">
       <desc>