Makefile.kmk@ 34587

Last change on this file since 34587 was 34587, checked in by vboxsync, 14 years ago

Main: Bandwidth groups for disks (and later network)

This introduces two new interfaces. The first one named IBandwidthGroup
represents one I/O limit and can be assigned to several mediums which
share this limit (which works only for harddisk images with the disabled
host cache).
The second one IBandwdithControl manages the groups and can create new ones
and destroy them if not required anymore.

VBoxManage: commands to access the bandwidth groups

Syntax:
VBoxManage storageattach <uuid|vmname>

...
--bandwidthgroup <name>

--bandwidthgroup assigns the specified device to the given group.

VBoxManage bandwidthctl <uuid|vmname>

--name <name>
--add disk|network
--limit <megabytes per second>
--delete

The --name parameter gives the name of the bandwidth group.
--add creates a new group of the given type (only disk is implemented so far)

with the given name.

--limit sets the limit to the given amount of MB/s

Note that limit can be changed while the VM is running. The VM
will immediately pick up the new limit for the given group name.

--delete deletes the group with the given name if it isn't used anymore.

Trying to delete a still used group will result in an error.

Example:

VBoxManage bandwidthctl "Test VM" --name Limit --add disk --limit 20
Creates a group named Test having a 20 MB/s limit.

VBoxManage storageattach "Test VM" --storagectl "SATA Controller" --port 0 --device 0 --type hdd --medium test.vdi --bandwidthgroup Limit
Adds a new disk to the SATA controller and assigns the bandwidth group Limit to it.

VBoxManage storageattach "Test VM" --storagectl "SATA Controller" --port 0 --device 0 --type hdd --medium test.vdi --bandwidthgroup none
Removes the bandwidth limit from the disk.

VBoxManage bandwidthctl "Test VM" --name Limit --add disk --limit 10
Changes the limit of bandwidth group Limit to 10 MB/s. If the VM is running the limit will be picked up
immediately.

Property svn:eol-style set to native
Property svn:keywords set to Author Date Id Revision

File size: 3.1 KB

Line
1	# $Id: Makefile.kmk 34587 2010-12-01 20:30:02Z vboxsync $
2	## @file
3	# Sub-Makefile for VBoxManage (the cli frontend).
4	#
5
6	#
7	# Copyright (C) 2006-2007 Oracle Corporation
8	#
9	# This file is part of VirtualBox Open Source Edition (OSE), as
10	# available from http://www.virtualbox.org. This file is free software;
11	# you can redistribute it and/or modify it under the terms of the GNU
12	# General Public License (GPL) as published by the Free Software
13	# Foundation, in version 2 as it comes in the "COPYING" file of the
14	# VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15	# hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16	#
17
18	SUB_DEPTH = ../../../..
19	include $(KBUILD_PATH)/subheader.kmk
20
21	PROGRAMS += VBoxManage
22	ifdef VBOX_ONLY_DOCS
23	VBoxManage_TEMPLATE = VBOXR3NPEXE
24	VBoxManage_DEFS += VBOX_ONLY_DOCS
25	VBoxManage_SOURCES = \
26	VBoxManage.cpp \
27	VBoxManageHelp.cpp \
28	$(if $(VBOX_WITH_GUEST_PROPS),VBoxManageGuestProp.cpp) \
29	$(if $(VBOX_WITH_GUEST_CONTROL),VBoxManageGuestCtrl.cpp)
30	VBoxManage_LIBS += $(LIB_RUNTIME)
31	else # !VBOX_ONLY_DOCS
32	VBoxManage_TEMPLATE = VBOXMAINCLIENTEXE
33	VBoxManage_DEFS.win = _WIN32_WINNT=0x0500
34	VBoxManage_SOURCES = \
35	VBoxManage.cpp \
36	VBoxInternalManage.cpp \
37	VBoxManageControlVM.cpp \
38	VBoxManageDHCPServer.cpp \
39	VBoxManageDisk.cpp \
40	$(if $(VBOX_WITH_GUEST_PROPS),VBoxManageGuestProp.cpp) \
41	$(if $(VBOX_WITH_GUEST_CONTROL),VBoxManageGuestCtrl.cpp) \
42	VBoxManageHelp.cpp \
43	VBoxManageHostonly.cpp \
44	VBoxManageAppliance.cpp \
45	VBoxManageInfo.cpp \
46	VBoxManageList.cpp \
47	VBoxManageMetrics.cpp \
48	VBoxManageMisc.cpp \
49	VBoxManageModifyVM.cpp \
50	VBoxManageSnapshot.cpp \
51	VBoxManageStorageController.cpp \
52	VBoxManageUSB.cpp \
53	VBoxManageBandwidthControl.cpp
54	endif # !VBOX_ONLY_DOCS
55
56	VBoxManage_DEFS += \
57	$(if $(VBOX_WITH_AHCI), VBOX_WITH_AHCI) \
58	$(if $(VBOX_WITH_ALSA), VBOX_WITH_ALSA) \
59	$(if $(VBOX_WITH_COPYTOGUEST),VBOX_WITH_COPYTOGUEST) \
60	$(if $(VBOX_WITH_E1000),VBOX_WITH_E1000) \
61	$(if $(VBOX_WITH_GUEST_CONTROL),VBOX_WITH_GUEST_CONTROL) \
62	$(if $(VBOX_WITH_GUEST_PROPS),VBOX_WITH_GUEST_PROPS) \
63	$(if $(VBOX_WITH_HEADLESS), VBOX_WITH_HEADLESS) \
64	$(if $(VBOX_WITH_HGCM), VBOX_WITH_HGCM) \
65	$(if $(VBOX_WITH_HOSTNETIF_API), VBOX_WITH_HOSTNETIF_API) \
66	$(if $(VBOX_WITH_NETFLT), VBOX_WITH_NETFLT) \
67	$(if $(VBOX_WITH_PULSE),VBOX_WITH_PULSE) \
68	$(if $(VBOX_WITH_SCSI), VBOX_WITH_SCSI) \
69	$(if $(VBOX_WITH_SOLARIS_OSS), VBOX_WITH_SOLARIS_OSS) \
70	$(if $(VBOX_WITH_VBOXSDL), VBOX_WITH_VBOXSDL) \
71	$(if $(VBOX_WITH_VDE), VBOX_WITH_VDE) \
72	$(if $(VBOX_WITH_VIDEOHWACCEL), VBOX_WITH_VIDEOHWACCEL) \
73	$(if $(VBOX_WITH_VIRTIO),VBOX_WITH_VIRTIO)
74
75	ifneq ($(KBUILD_TARGET),win)
76	# Workaround for buggy gcc-4.3 compilers, see
77	#
78	# http://gcc.gnu.org/bugzilla/show_bug.cgi?id=36474
79	#
80	# Some later revisions of version 4.3.1 are known to work so we assume
81	# that version 4.3.2 or later has this bug definitely fixed.
82	VBoxManage_CXXFLAGS.release += \
83	$(if $(VBOX_GCC_VERSION_CXX),$(if-expr $(VBOX_GCC_VERSION_CXX) < 40300 \|\| $(VBOX_GCC_VERSION_CXX) > 40301,,--param max-fields-for-field-sensitive=0),)
84	endif
85	ifndef VBOX_ONLY_DOCS
86	VBoxManage_LIBS += $(LIB_DDU)
87	endif # !VBOX_ONLY_DOCS
88
89	include $(KBUILD_PATH)/subfooter.kmk
90

Note: See TracBrowser for help on using the repository browser.

Download in other formats:

Original Format