Changeset 93480 in vbox for trunk/doc/manual

Timestamp:

Jan 28, 2022 4:09:52 PM (3 years ago)

Author:

vboxsync

Message:

Main/Appliance: Allow users to specify a different storage controller
and/or controller port for hard disks when importing a VM. bugref:5027

'VBoxManage import foo.ova -n' has always presented a --controller
option for hard disks but the code to implement this had never been
implemented. This changeset adds the --controller functionality and
also includes a --port option for changing the controller port as well.

File:

• trunk/doc/manual/en_US/man_VBoxManage-import.xml (modified) (3 diffs)

trunk/doc/manual/en_US/man_VBoxManage-import.xml

@@ -70 +70 @@
       <!-- <arg>&#45;&#45;controller=<replaceable>n</replaceable></arg> -->
       <arg>--disk=<replaceable>path</replaceable></arg>
+      <arg>--controller=<replaceable>index</replaceable></arg>
+      <arg>--port=<replaceable>n</replaceable></arg>
     </cmdsynopsis>
 
@@ -379 +381 @@
  7: Guest memory: 2048 MB (change with "--vsys 0 --memory &lt;MB&gt;")
  8: Sound card (appliance expects "ensoniq1371", can change on import)
-    (disable with "--vsys 0 --unit 5 --ignore")
+    (disable with "--vsys 0 --unit 8 --ignore")
  9: USB controller
-    (disable with "--vsys 0 --unit 6 --ignore")
+    (disable with "--vsys 0 --unit 9 --ignore")
 10: Network adapter: orig bridged, config 2, extra type=bridged
 11: Floppy
-    (disable with "--vsys 0 --unit 8 --ignore")
+    (disable with "--vsys 0 --unit 11 --ignore")
 12: SCSI controller, type BusLogic
-    (change with "--vsys 0 --unit 9 --scsitype {BusLogic|LsiLogic}";
-    disable with "--vsys 0 --unit 9 --ignore")
+    (change with "--vsys 0 --unit 12 --scsitype {BusLogic|LsiLogic}";
+    disable with "--vsys 0 --unit 12 --ignore")
 13: IDE controller, type PIIX4
-    (disable with "--vsys 0 --unit 10 --ignore")
+    (disable with "--vsys 0 --unit 13 --ignore")
 14: Hard disk image: source image=Windows10.vmdk,
-      target path=/home/user1/disks/Windows10.vmdk, controller=9;channel=0
-    (change target path with "--vsys 0 --unit 11 --disk &lt;path&gt;";
-    disable with "--vsys 0 --unit 11 --ignore")</screen>
+      target path=/home/user1/disks/Windows10.vmdk, controller=12;channel=0
+    (change target path with "--vsys 0 --unit 14 --disk &lt;path&gt;";
+    change controller with "--vsys 0 --unit 14 --controller &lt;index&gt;";
+    change controller port with "--vsys 0 --unit 14 --port &lt;n&gt;";
+    disable with "--vsys 0 --unit 14 --ignore")</screen>
     <para>
       The dry run output lists and numbers the individual configuration
@@ -416 +420 @@
       Item 14 indicates the hard disk image and the
       <option>--disk</option> option specifies the target path where the
-      image will be stored. The default value is specified in the OVF file.
+      image will be stored, the <option>--controller</option> option specifies
+      which controller the disk will be attached to, and the
+      <option>--port</option> option specifies which port on the controller the
+      disk will be attached to.  The default values are specified in the OVF file.
     </para>
     <para>