clear hardware-interfaces

Summary/usage

Clear hardware interfaces statistics.

Declaration and implementation

Declaration: clear_hw_interface_counters_command (src/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 (src/vnet/interface_cli.c line 1173)

Implementation: clear_tag.

clear interfaces

Summary/usage

Clear interfaces statistics.

Declaration and implementation

Declaration: clear_interface_counters_command (src/vnet/interface_cli.c line 490)

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 (src/vnet/interface_cli.c line 781)

Implementation: create_sub_interfaces.

interface

Summary/usage

Interface commands.

Declaration and implementation

Declaration: vnet_cli_interface_command (src/vnet/interface_cli.c line 427)

pcap drop trace

Summary/usage

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

Declaration and implementation

Declaration: pcap_trace_command (src/vnet/interface_output.c line 1427)

Implementation: pcap_drop_trace_command_fn.

renumber interface

Summary/usage

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

Declaration and implementation

Declaration: renumber_interface_command (src/vnet/interface_cli.c line 992)

Implementation: renumber_interface_command_fn.

set interface

Summary/usage

Interface commands.

Declaration and implementation

Declaration: vnet_cli_set_interface_command (src/vnet/interface_cli.c line 434)

set interface handoff

Summary/usage

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

Declaration and implementation

Declaration: set_interface_handoff_command (src/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 (src/vnet/interface_cli.c line 942)

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 (src/vnet/interface_cli.c line 1124)

Implementation: set_interface_mac_address.

set interface mtu

Summary/usage

set interface mtu <value> <intfc>.

Declaration and implementation

Declaration: set_interface_mtu_cmd (src/vnet/interface_cli.c line 1074)

Implementation: mtu_cmd.

set interface promiscuous

Summary/usage

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

Declaration and implementation

Declaration: set_interface_promiscuous_cmd (src/vnet/interface_cli.c line 1028)

Implementation: promiscuous_cmd.

set interface rx-mode

Summary/usage

set interface rx-mode <interface> [queue <n>] [polling | interrupt | adaptive].

Description

This command is used to assign a given interface, and optionally a given queue, to a different thread. If the 'queue' is not provided, it defaults to 0.

Example usage

Example of how to display the interface placement: vpp# show interface rx-placement

Thread 1 (vpp_wk_0):
  GigabitEthernet0/8/0 queue 0
  GigabitEthernet0/9/0 queue 0
Thread 2 (vpp_wk_1):
  GigabitEthernet0/8/0 queue 1
  GigabitEthernet0/9/0 queue 1

Example of how to assign a interface and queue to a thread: vpp# set interface placement GigabitEthernet0/8/0 queue 1 thread 1

Declaration and implementation

Declaration: cmd_set_if_rx_mode (src/vnet/interface_cli.c line 1314)

Implementation: set_interface_rx_mode.

set interface rx-placement

Summary/usage

set interface rx-placement <hw-interface> [queue <n>] [worker <n> | main].

Description

This command is used to assign a given interface, and optionally a given queue, to a different thread. If the 'queue' is not provided, it defaults to 0.

Example usage

Example of how to display the interface placement: vpp# show interface placement

Thread 1 (vpp_wk_0):
  GigabitEthernet0/8/0 queue 0
  GigabitEthernet0/9/0 queue 0
Thread 2 (vpp_wk_1):
  GigabitEthernet0/8/0 queue 1
  GigabitEthernet0/9/0 queue 1

Example of how to assign a interface and queue to a thread: vpp# set interface placement GigabitEthernet0/8/0 queue 1 thread 1

Declaration and implementation

Declaration: cmd_set_if_rx_placement (src/vnet/interface_cli.c line 1456)

Implementation: set_interface_rx_placement.

set interface state

Summary/usage

set interface state <if-name> [up|down|punt|enable].

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 (src/vnet/interface_cli.c line 830)

Implementation: set_state.

set interface tag

Summary/usage

set interface tag <intfc> <tag>.

Declaration and implementation

Declaration: set_tag_command (src/vnet/interface_cli.c line 1149)

Implementation: set_tag.

set interface unnumbered

Summary/usage

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

Declaration and implementation

Declaration: set_unnumbered_command (src/vnet/interface_cli.c line 899)

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 (src/vnet/interface_cli.c line 195)

Implementation: show_or_clear_hw_interfaces.

show interface

Summary/usage

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

Declaration and implementation

Declaration: show_sw_interfaces_command (src/vnet/interface_cli.c line 418)

Implementation: show_sw_interfaces.

show interface rx-placement

Summary/usage

show interface rx-placement.

Declaration and implementation

Declaration: show_interface_rx_placement (src/vnet/interface_cli.c line 1367)

Implementation: show_interface_rx_placement_fn.