7.41. VBoxManage mediumio

Medium content access.

7.41.1. 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]

7.41.2. Description

7.41.2.1. 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.

7.41.2.2. 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.

7.41.2.3. 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.

7.41.2.4. 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.