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.