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

Page 214
Image 214
Citrix Systems 5.6 manual Vif-create, Vif-destroy, Vif-plug, Vif-unplug