Host Interface

create host-interface

Summary/usage

create host-interface name <ifname> [hw-addr <mac-addr>].

Description

Create a host interface that will attach to a linux AF_PACKET interface, one side of a veth pair. The veth pair must already exist. Once created, a new host interface will exist in VPP with the name &#39;<em>host-<ifname></em>&#39;, where &#39;<em><ifname></em>&#39; is the name of the specified veth pair. Use the &#39;<em>show interface</em>&#39; command to display host interface details.

This command has the following optional parameters:

• <b>hw-addr <mac-addr></b> - Optional ethernet address, can be in either X:X:X:X:X:X unix or X.X.X cisco format.

Example usage

Example of how to create a host interface tied to one side of an existing linux veth pair named vpp1:

vpp# create host-interface name vpp1

host-vpp1

Once the host interface is created, enable the interface using:

vpp# set interface state host-vpp1 up

Declaration and implementation

Declaration: af_packet_create_command (src/vnet/devices/af_packet/cli.c line 133)

Implementation: af_packet_create_command_fn.

delete host-interface

Summary/usage

delete host-interface name <ifname>.

Description

Delete a host interface. Use the linux interface name to identify the host interface to be deleted. In VPP, host interfaces are named as &#39;<em>host-<ifname></em>&#39;, where &#39;<em><ifname></em>&#39; is the name of the linux interface.

Example usage

Example of how to delete a host interface named host-vpp1:

vpp# delete host-interface name vpp1

Declaration and implementation

Declaration: af_packet_delete_command (src/vnet/devices/af_packet/cli.c line 190)

Implementation: af_packet_delete_command_fn.

set host-interface l4-cksum-offload

Summary/usage

set host-interface l4-cksum-offload <host-if-name> <on|off>.

Description

Set TCP/UDP offload checksum calculation. Use interface name to identify the interface to set TCP/UDP offload checksum calculation.

Example usage

Example of how to set TCP/UDP offload checksum calculation on host-vpp0:

vpp# set host-interface l4-cksum-offload host-vpp0 off

vpp# set host-interface l4-cksum-offload host-vpp0 on

Declaration and implementation

Declaration: af_packet_set_l4_cksum_offload_command (src/vnet/devices/af_packet/cli.c line 247)

Implementation: af_packet_set_l4_cksum_offload_command_fn.