8.37. VBoxManage mediumio

Medium content access.

Synopsis

VBoxManage mediumio < --disk=uuid|filename | --dvd=uuid|filename | --floppy=uuid|filename > [--password-file=-|filename] formatfat [--quick]

VBoxManage mediumio < --disk=uuid|filename | --dvd=uuid|filename | --floppy=uuid|filename > [--password-file=-|filename] cat [--hex] [--offset=byte-offset] [--size=bytes] [--output=-|filename]

VBoxManage mediumio < --disk=uuid|filename | --dvd=uuid|filename | --floppy=uuid|filename > [--password-file=-|filename] stream [--format=image-format] [--variant=image-variant] [--output=-|filename]

Description

Common options

The subcommands of mediumio all operate on a medium which need to be specified, optionally with an encryption password. The following common options can be placed before or after the sub-command:

--disk=uuid|filename

Either the UUID or filename of a harddisk image, e.g. VDI, VMDK, VHD, ++.

--dvd=uuid|filename

Either the UUID or filename of a DVD image, e.g. ISO, DMG, CUE.

--floppy=uuid|filename

Either the UUID or filename of a floppy image, e.g. IMG.

--password-file=-|filename

The name of a file containing the medium encryption password. If - is specified, the password will be read from stdin.

mediumio formatfat

VBoxManage mediumio < --disk=uuid|filename | --dvd=uuid|filename | --floppy=uuid|filename > [--password-file=-|filename] formatfat [--quick]

Formats a floppy medium with the FAT file system. This will erase the content of the medium.

--quick

Quickformat the medium.

mediumio cat

VBoxManage mediumio < --disk=uuid|filename | --dvd=uuid|filename | --floppy=uuid|filename > [--password-file=-|filename] cat [--hex] [--offset=byte-offset] [--size=bytes] [--output=-|filename]

Dumps the medium content to stdout or the specified file.

--hex

Dump as hex bytes.

--offset

The byte offset in the medium to start.

--size

The number of bytes to dump.

--output

The output filename. As usual - is take to mean stdout.

mediumio stream

VBoxManage mediumio < --disk=uuid|filename | --dvd=uuid|filename | --floppy=uuid|filename > [--password-file=-|filename] stream [--format=image-format] [--variant=image-variant] [--output=-|filename]

Converts the medium to a streamable format and dumps it to the given output.

--format

The format of the destination image.

--variant

The medium variant for the destination.

--output

The output filename. As usual - is take to mean stdout.