FD.io VPP  v17.01.1-3-gc6833f8
Vector Packet Processing
vnet/vnet

clear hardware-interfaces

Summary/usage

Clear hardware interfaces statistics.

Declaration and implementation

Declaration: clear_hw_interface_counters_command (vnet/vnet/interface_cli.c line 203)

Implementation: show_or_clear_hw_interfaces.

clear interface tag

Summary/usage

clear interface tag <intfc>.

Declaration and implementation

Declaration: clear_tag_command (vnet/vnet/interface_cli.c line 1151)

Implementation: clear_tag.

clear interfaces

Summary/usage

Clear interfaces statistics.

Declaration and implementation

Declaration: clear_interface_counters_command (vnet/vnet/interface_cli.c line 489)

Implementation: clear_interface_counters.

create sub-interfaces

Summary/usage

create sub-interfaces <nn>[-<nn>] [dot1q|dot1ad|default|untagged].

Description

Create vlan subinterfaces

Example usage
vpp# create sub-interfaces

To create a vlan subinterface 11 to process packets on 802.1q VLAN id 11, use:

 vpp# create sub GigabitEthernet2/0/0 11

This shorthand is equivalent to:
 vpp# create sub GigabitEthernet2/0/0 11 dot1q 11 exact-match

You can specify a subinterface number that is different from the vlan id:
 vpp# create sub GigabitEthernet2/0/0 11 dot1q 100

You can create qinq and q-in-any interfaces:
 vpp# create sub GigabitEthernet2/0/0 11 dot1q 100 inner-dot1q 200
 vpp# create sub GigabitEthernet2/0/0 12 dot1q 100 inner-dot1q any

You can also create dot1ad interfaces:
 vpp# create sub GigabitEthernet2/0/0 11 dot1ad 11
 vpp# create sub GigabitEthernet2/0/0 12 dot1q 100 inner-dot1q 200

Subinterfaces can be configured as either exact-match or non-exact match.
Non-exact match is the CLI default. If exact-match is specified,
packets must have the same number of vlan tags as the configuration.
For non-exact-match, packets must at least that number of tags.
L3 (routed) interfaces must be configured as exact-match.
L2 interfaces are typically configured as non-exact-match.

For example, a packet with outer vlan 100 and inner 200 would match this interface:
 vpp# create sub GigabitEthernet2/0/0 5 dot1q 100

but would not match this interface:
 vpp# create sub GigabitEthernet2/0/0 5 dot1q 100 exact-match

There are two special subinterfaces that can be configured. Subinterface untagged has no vlan tags:
 vpp# create sub GigabitEthernet2/0/0 5 untagged

The subinterface default matches any packet that does not match any other subinterface:
 vpp# create sub GigabitEthernet2/0/0 7 default

Declaration and implementation

Declaration: create_sub_interfaces_command (vnet/vnet/interface_cli.c line 780)

Implementation: create_sub_interfaces.

interface

Summary/usage

Interface commands.

Declaration and implementation

Declaration: vnet_cli_interface_command (vnet/vnet/interface_cli.c line 426)

pcap drop trace

Summary/usage

pcap drop trace on off max <nn> intfc <intfc> file <name> status.

Declaration and implementation

Declaration: pcap_trace_command (vnet/vnet/interface_output.c line 1390)

Implementation: pcap_drop_trace_command_fn.

renumber interface

Summary/usage

renumber interface <if-name> <new-dev-instance>.

Declaration and implementation

Declaration: renumber_interface_command (vnet/vnet/interface_cli.c line 972)

Implementation: renumber_interface_command_fn.

set interface

Summary/usage

Interface commands.

Declaration and implementation

Declaration: vnet_cli_set_interface_command (vnet/vnet/interface_cli.c line 433)

set interface handoff

Summary/usage

set interface handoff <interface-name> workers <workers-list> [symmetrical|asymmetrical].

Declaration and implementation

Declaration: set_interface_handoff_command (vnet/vnet/handoff.c line 354)

Implementation: set_interface_handoff_command_fn.

set interface hw-class

Summary/usage

Set interface hardware class.

Declaration and implementation

Declaration: set_hw_class_command (vnet/vnet/interface_cli.c line 922)

Implementation: set_hw_class.

set interface mac address

Summary/usage

set interface mac address <intfc> <mac-address>.

Description

The 'set interface mac address ' command allows to set MAC address of given interface. In case of NIC interfaces the one has to support MAC address change. A side effect of MAC address change are changes of MAC addresses in FIB tables (ipv4 and ipv6).

Example usage
Example of how to change MAC Address of interface:
vpp# set interface mac address GigabitEthernet0/8/0 aa:bb:cc:dd:ee:01
vpp# set interface mac address host-vpp0 aa:bb:cc:dd:ee:02
vpp# set interface mac address tap-0 aa:bb:cc:dd:ee:03
vpp# set interface mac address pg0 aa:bb:cc:dd:ee:04

Declaration and implementation

Declaration: set_interface_mac_address_cmd (vnet/vnet/interface_cli.c line 1102)

Implementation: set_interface_mac_address.

set interface mtu

Summary/usage

set interface mtu <value> <intfc>.

Declaration and implementation

Declaration: set_interface_mtu_cmd (vnet/vnet/interface_cli.c line 1054)

Implementation: mtu_cmd.

set interface promiscuous

Summary/usage

set interface promiscuous [on | off] <intfc>.

Declaration and implementation

Declaration: set_interface_promiscuous_cmd (vnet/vnet/interface_cli.c line 1008)

Implementation: promiscuous_cmd.

set interface state

Summary/usage

Set interface state.

Description

Interface admin up/down

Example usage
vpp# set interface state
 vpp# set interface state GigabitEthernet2/0/0 up
 vpp# set interface state GigabitEthernet2/0/0 down

Declaration and implementation

Declaration: set_state_command (vnet/vnet/interface_cli.c line 829)

Implementation: set_state.

set interface tag

Summary/usage

set interface tag <intfc> <tag>.

Declaration and implementation

Declaration: set_tag_command (vnet/vnet/interface_cli.c line 1127)

Implementation: set_tag.

set interface unnumbered

Summary/usage

set interface unnumbered [<intfc> use <intfc> | del <intfc>].

Declaration and implementation

Declaration: set_unnumbered_command (vnet/vnet/interface_cli.c line 879)

Implementation: set_unnumbered.

show hardware-interfaces

Summary/usage

show hardware-interfaces [brief|verbose|detail] [bond] [<if-name1> <if-name2> ...].

Description

Displays various information about the state of the current terminal session.

Example usage
vpp# show hardware
Name                Link  Hardware
GigabitEthernet2/0/0               up   GigabitEthernet2/0/0
Ethernet address 00:50:56:b7:7c:83
Intel 82545em_copper
  link up, media 1000T full-duplex, master,
  0 unprocessed, 384 total buffers on rx queue 0 ring
  237 buffers in driver rx cache
  rx total packets                                    1816
  rx total bytes                                    181084
  rx good packets                                     1816
  rx good bytes                                     181084
  rx 65 127 byte packets                              1586
  rx 256 511 byte packets                              230
  tx total packets                                     346
  tx total bytes                                     90224
  tx good packets                                      346
  tx good bytes                                      88840
  tx 64 byte packets                                     1
  tx 65 127 byte packets                               115
  tx 256 511 byte packets                              230

Declaration and implementation

Declaration: show_hw_interfaces_command (vnet/vnet/interface_cli.c line 195)

Implementation: show_or_clear_hw_interfaces.

show interfaces

Summary/usage

show interfaces [address|addr|features|feat] [<if-name1> <if-name2> ...].

Declaration and implementation

Declaration: show_sw_interfaces_command (vnet/vnet/interface_cli.c line 417)

Implementation: show_sw_interfaces.