Changeset 37525 in vbox for trunk/doc/manual/en_US

Timestamp:

Jun 17, 2011 10:09:21 AM (14 years ago)

Author:

vboxsync

Message:

Main/VirtualBox+Medium: resurrect the feature of changing the medium UUID when opening the image, which allows to resolve duplicate UUIDs without using external tools. Also fixes Medium::setIDs, which wasn't correctly working.
Frontends/*: corresponding changes.

Location:

trunk/doc/manual/en_US

Files:

• SDKRef.xml (modified) (1 diff)
• user_VBoxManage.xml (modified) (2 diffs)

trunk/doc/manual/en_US/SDKRef.xml

@@ -3448 +3448 @@
       <itemizedlist>
         <listitem>
+          <para>The method <xref linkend="IVirtualBox__openMedium"
+          xreflabel="IVirtualBox::openMedium()" /> has one more parameter
+          now, which allows resolving duplicate medium UUIDs without the need
+          for external tools.</para>
+        </listitem>
+
+        <listitem>
           <para>The <xref linkend="INetworkAdapter" xreflabel="INetworkAdapter"/>
           interface has been cleaned up. The various methods to activate an

trunk/doc/manual/en_US/user_VBoxManage.xml

@@ -1507 +1507 @@
                             [--mtype normal|writethrough|immutable|shareable]
                             [--comment <text>]
+                            [--setuuid <uuid>]
+                            [--setparentuuid <uuid>]
                             [--passthrough on|off]
                             [--bandwidthgroup name|none]
@@ -1643 +1645 @@
             server downstairs"). This is purely descriptive and not needed for
             the medium to function correctly.</para>
+          </glossdef>
+        </glossentry>
+
+        <glossentry>
+          <glossterm>setuuid, setparentuuid</glossterm>
+
+          <glossdef>
+            <para>Modifies the UUID or parent UUID of a medium before
+            attaching it to a VM. This is an expert option. Inappropriate use
+            can make the medium unusable or lead to broken VM configurations
+            if any other VM is referring to the same media already. The most
+            frequently used variant is <code>--setuuid ""</code>, which assigns
+            a new (random) UUID to an image. This is useful to resolve the
+            duplicate UUID errors if one duplicated an image using file copy
+            utilities.</para>
           </glossdef>
         </glossentry>