8.20. VBoxManage bandwidthctl

Oracle VM VirtualBox

8.20. VBoxManage bandwidthctl

This command creates/deletes/modifies/shows bandwidth groups of the given virtual machine:

VBoxManage bandwidthctl    <uuid|vmname>
                           add <name> --type disk|network --limit <megabytes per second>[k|m|g|K|M|G] |
                           set <name> --limit <megabytes per second>[k|m|g|K|M|G] |
                           remove <name> |
                           list [--machinereadable]

The following subcommands are available:

  • add, creates a new bandwidth group of a given type.

  • set, modifies the limit for an existing bandwidth group.

  • remove, destroys a bandwidth group.

  • list, shows all bandwidth groups defined for the given VM. Use the --machinereadable option to produce the same output, but in machine readable format. This is of the form: name="value" on a line by line basis.

The parameters mean:

uuid|vmname

The VM UUID or VM Name. Mandatory.

--name

Name of the bandwidth group. Mandatory.

--type

Type of the bandwidth group. Mandatory. Two types are supported: disk and network. See Section 5.8, “Limiting bandwidth for disk images” or Section 6.10, “Limiting bandwidth for network I/O” for the description of a particular type.

--limit

Specifies the limit for the given bandwidth group. This can be changed while the VM is running. The default unit is megabytes per second. The unit can be changed by specifying one of the following suffixes: k for kilobits/s, m for megabits/s, g for gigabits/s, K for kilobytes/s, M for megabytes/s, G for gigabytes/s.

Note

The network bandwidth limits apply only to the traffic being sent by virtual machines. The traffic being received by VMs is unlimited.

Note

To remove a bandwidth group it must not be referenced by any disks or adapters in the running VM.