Changeset 97313 in vbox for trunk/doc/manual

Timestamp:

Oct 26, 2022 6:27:37 PM (2 years ago)

Author:

vboxsync

Message:

Frontends/VBoxManage: 'VBoxManage internalcommands createrawvmdk' no
longer works after the implementation was moved to the API as part of
xTracker #9224. Update the 'createrawvmdk' subcommand to maps its
arguments to the equivalent 'VBoxManage createmedium disk --Variant
Rawdisk ...' invocation and invoke that command instead. Also include
a warning message that the 'createrawvmdk' subcommand is deprecated and
'VBoxManage createmedium' should be used instead. bugref:9224
ticketref:21125

File:

• trunk/doc/manual/en_US/man_VBoxManage-createmedium.xml (modified) (2 diffs)

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

@@ -167 +167 @@
               </para></listitem>
             <listitem><para>
-                <literal>Formatted</literal>
-              </para><para>
-                For floppy images only. Formats the medium
-                automatically.
+                <literal>Formatted</literal> formats the medium automatically.
+                This value is valid for floppy images only.
               </para></listitem>
             <listitem><para>
@@ -209 +207 @@
     <remark role="help-scope" condition="GLOBAL" />
     <para>
-      The following command creates a new disk image file called
+      The following command creates a new disk image file named
       <filename>disk01.vdi</filename>. The file size is 1024 megabytes.
     </para>
 <screen>$ VBoxManage createmedium --filename disk01.vdi --size 1024</screen>
     <para>
-      The following command creates a new floppy disk image file called
+      The following command creates a new floppy disk image file named
       <filename>floppy01.vdi</filename>. The file size is 1 megabyte.
     </para>
 <screen>$ VBoxManage createmedium floppy --filename floppy01.img --size 1</screen>
+    <para>
+        The following command creates a raw disk image of an entire physical disk
+        on a Linux host.
+    </para>
+    <screen>$ VBoxManage createmedium disk --filename=/path/to/rawdisk.vmdk --variant=RawDisk --format=VMDK --property RawDrive=/dev/sda</screen>
   </refsect1>
 </refentry>