XenServer Software Development Kit Guide 4.1.0

XenServer API extensions

For example, to enable TX checksumming on a virtual NIC via the xe CLI:

xe vif-param-set uuid=<VIF UUID> other-config:ethtool-tx="on"

or:

xe vif-param-set uuid=<VIF UUID> other-config:ethtool-tx="true"

To set the duplex setting on a physical NIC to half duplex via the xe CLI:

xe vif-param-set uuid=<VIF UUID> other-config:ethtool-duplex="half"

5.5.2. Miscellaneous settings

You can also set a VIF or PIF to enable promiscuous mode via the promiscuous key. For example, to

enable promiscuous mode on a physical NIC via the xe CLI:

xe pif-param-set uuid=<PIF UUID> other-config:promiscuous="on"

or:

xe pif-param-set uuid=<PIF UUID> other-config:promiscuous="true"

The VIF and PIF objects have a MTU parameter that is read-only and provide the current setting of the

maximum transmission unit for the interface. You can override the default maximum transmission unit of a

physical or virtual NIC with the mtu key via the other-config map parameter. For example, to reset the

MTU on a virtual NIC to use jumbo frames via the xe CLI:

xe vif-param-set uuid=<VIF UUID> other-config:mtu=9000

Note that changing the MTU of underlying interfaces is an advanced and experimental feature, and may

lead to unexpected side-effects if you have varying MTUs across NICs in a single resource pool.

5.6. Internationalization for SR names

The SRs created at install time now have an other_config key indicating how their names may be in-

ternationalized.

other_config["i18n-key"] may be one of

• local-hotplug-cd

• local-hotplug-disk