FD.io VPP  v17.04-9-g99c0734
Vector Packet Processing
src/vnet

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 1171)

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 1424)


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 1122)


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 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 (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 1147)


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.