Citrix Systems 5.6 manual Vif-create, Vif-destroy, Vif-plug, Vif-unplug

Parameter Name	Description	Type
other-config:promiscuous	true to a VIF to be	read write
	promiscuous on the bridge,
	so that it sees all traffic over
	the bridge. Useful for running
	an Intrusion Detection System
	(IDS) or similar in a VM.
network-uuid	the unique identifier/object	read only
	reference of the virtual
	network to which this VIF is
	connected
network-name-label	the descriptive name of the	read only
	virtual network to which this
	VIF is connected
io_read_kbs	average read rate in kB/s for	read only
	this VIF
io_write_kbs	average write rate in kB/s for	read only
	this VIF

vif-create

vif-createvm-uuid=<uuid_of_the_vm>device=<see below> network-uuid=<uuid_of_the_network_the_vif_will_connect_to>[mac=<mac_address>]

Create a new VIF on a VM.

Appropriate values for the device field are listed in the parameter allowed-VIF-deviceson the specified VM. Before any VIFs exist there, the allowable values are integers from 0-15.

The mac parameter is the standard MAC address in the form aa:bb:cc:dd:ee:ff. If you leave it unspecified, an appropriate random MAC address will be created. You can also explicitly set a random MAC address by specifying mac=random.

vif-destroy

vif-destroy uuid=<uuid_of_vif>

Destroy a VIF.

vif-plug

vif-pluguuid=<uuid_of_vif>

Attempt to attach the VIF while the VM is in the running state.

vif-unplug

vif-unplug uuid=<uuid_of_vif>

194