help file may be wrong on disk Bandwidth control command

[scottgus1bug]

Need a little help with the disk bandwidth control command for my "Win7CVXeams" guest (running 4.2.16).

Section 5.8 of the help file shows the following commands to limit disk bandwidth on a guest:

VBoxManage bandwidthctl "VM name" add Limit --type disk --limit 20M

VBoxManage storageattach "VM name" --controller "SATA" --port 0 --device 0 --type hdd --medium disk1.vdi --bandwidthgroup Limit

I entered the first line, with my guest's information inserted, like this:

VBoxManage bandwidthctl Win7CVXeams add CVXeams --type disk --limit 10

"VBoxManage bandwidthctl Win7CVXeams list" returns this:

Name: 'CVXeams', Type: Disk, Limit: 10 Mbytes/sec

So the first command seems to have worked.

The second command was entered like this:

VBoxManage storageattach Win7CVXeams --controller "SATA" --port 0 --device 0 --type hdd --medium G:\Win7CVXeams\Win7CVXeams.vdi --bandwidthgroup CVXeams

VBoxManage returns a list of options for the storageattach command and the error: "Unknown option: --controller" (Vboxmanage doesn't seem to know what the help file knows...)

So I delete the "--controller" and replace it with "--storagectl", making my command this:

VBoxManage storageattach Win7CVXeams --storagectl "SATA" --port 0 --device 0 --type hdd --medium G:\Win7CVXeams\Win7CVXeams.vdi --bandwidthgroup CVXeams

and the command completes.

Something I'm missing? Or does the help file need an update?

[Frank Mehnert]

You are right and we fixed the example in the docs. The next maintenance release will contain the fix. Thank you for this report!

[scottgus1bug]

Glad to help. Thanks for this amazing program!