Sun Microsystems VIRTUALBOX VERSION 3.1.0_BETA2 - Manual (Page 126)

8 VBoxManage reference
VBoxManage createhd --filename <filename>
--size <megabytes>
[--format VDI|VMDK|VHD] (default: VDI)
[--variant Standard,Fixed,Split2G,Stream,ESX]
[--type normal|writethrough] (default: normal)
[--comment <comment>]
[--remember]
where the parameters mean:
filename Allows to choose a file name. Mandatory.
size Allows to define the image capacity, in 1 MiB units. Mandatory.
format Allows to choose a file format for the output file different from the file format
of the input file.
variant Allows to choose a file format variant for the output file. It is a comma-
separated list of variant flags. Not all combinations are supported, and specifying
inconsistent flags will result in an error message.
type Only honored if –remember is also specified. Defines what kind of hard disk type
this image should be.
comment Allows to attach a comment to the image.
remember Keep the destination image registered after it was successfully written.
Note: For compatibility with earlier versions of VirtualBox, the “createvdi”
command is also supported and mapped internally to the “createhd” com-
mand.
8.16 VBoxManage modifyhd
With the modifyhd command, you can change the type of an existing image between
the normal, immutable and write-through modes; see chapter
5.4 , Special image write
modes , page 81 for details.
Note: For compatibility with earlier versions of VirtualBox, the “modifyvdi”
command is also supported and mapped internally to the “modifyhd” com-
mand.
For immutable (differencing) hard disks only, the modifyhd autoreset on|off
command determines whether the disk is automatically reset on every VM startup
(again, see chapter
5.4 , Special image write modes , page 81 ). The default is “on”.
126