XenServer Administrator's Guide 4.1.0

Command line interface
86
The VIF objects can be listed with the standard object listing command (xe vif-list), and the parameters
manipulated with the standard parameter commands. See Section 5.3.2, “Low-level param commands” for
details.
VIF parameters
VIFs have the following parameters:
Parameter Name Description Type
uuid The unique identifier/object reference for
the VIF
read only
vm-uuid The unique identifier/object reference for
the VM that this VIF resides on
read only
vm-name-label The name of the VM that this VIF resides
on
read only
allowed-operations a list of the operations allowed in this state read only set parameter
current-operations a list of the operations that are currently in
progress on this VIF
read only set parameter
device integer label of this VIF, indicating the
order in which VIF backends were created
read only
MAC MAC address of VIF, as exposed to the
VM
read only
MTU Maximum Transmission Unit of the VIF in
bytes. This parameter is read-only, but you
can override the MTU setting with the mtu
key via the other-config map parameter.
For example, to reset the MTU on a virtual
NIC to use jumbo frames:
xe vif-param-set uuid=<VIF UUID> \
other-config:mtu=9000
read only
currently-attached true if the device is currently attached read only
qos_algorithm_type QoS algorithm to use read/write
qos_algorithm_params parameters for the chosen QoS algorithm read/write map parameter
qos_supported_algorithmssupported QoS algorithms for this VIF read only set parameter
other-config A list of key/value pairs that specify
additional configuration parameters for this
VIF.
read/write map parameter
network-uuid The unique identifier/object reference of
the virtual network to which this VIF is
connected
read only
network-name-label The descriptive name of the virtual network
to which this VIF is connected
read only
io_read_kbs average read rate in kB/s for this VIF read only
io_write_kbs average write rate in kB/s for this VIF read only
vif-metrics-last-updated Timestamp of the date and time that the
metrics for the VIF were read, in the form
yyyymmddThh:mm:ss z, where z is the
read only