summaryrefslogtreecommitdiffstats
path: root/docs/reference/cmdreference/interface/interface.rst
blob: a3429037e8ba5b6c4860f8a0daaf524b9063efc2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
.. _intcommands:

Interface Commands
==================

.. toctree::

.. _showintcommand:

Show Interface
==============
Shows software interface information including counters and features

Summary/Usage
-------------

.. code-block:: shell

    show interface [address|addr|features|feat] [<interface> [<interface> [..]]]

Examples
--------

Example of how to show the interface counters:

.. code-block:: console

    vpp# show int
                  Name               Idx       State          Counter          Count     
    TenGigabitEthernet86/0/0          1         up       rx packets               6569213
                                                         rx bytes              9928352943
                                                         tx packets                 50384
                                                         tx bytes                 3329279
    TenGigabitEthernet86/0/1          2        down      
    VirtualEthernet0/0/0              3         up       rx packets                 50384
                                                         rx bytes                 3329279
                                                         tx packets               6569213
                                                         tx bytes              9928352943
                                                         drops                       1498
    local0                            0        down      

Example of how to display the interface placement:

.. code-block:: console

    vpp# show interface rx-placement
    Thread 1 (vpp_wk_0):
      node dpdk-input:
        GigabitEthernet7/0/0 queue 0 (polling)
      node vhost-user-input:
        VirtualEthernet0/0/12 queue 0 (polling)
        VirtualEthernet0/0/12 queue 2 (polling)
        VirtualEthernet0/0/13 queue 0 (polling)
        VirtualEthernet0/0/13 queue 2 (polling)
    Thread 2 (vpp_wk_1):
      node dpdk-input:
        GigabitEthernet7/0/1 queue 0 (polling)
      node vhost-user-input:
        VirtualEthernet0/0/12 queue 1 (polling)
        VirtualEthernet0/0/12 queue 3 (polling)
        VirtualEthernet0/0/13 queue 1 (polling)
        VirtualEthernet0/0/13 queue 3 (polling)

Clear Interfaces
================
Clear the statistics for all interfaces (statistics associated with the
'*show interface*' command).

Summary/Usage
-------------

.. code-block:: shell

    clear interfaces

Example
-------
Example of how to clear the statistics for all interfaces:

.. code-block:: console

    vpp# clear interfaces

Set Interface Mac Address
=========================
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).


Summary/Usage
-------------

.. code-block:: shell

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

Examples
--------

Examples of how to change MAC Address of interface:

.. code-block:: console

    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

Set Interface Mtu
=================

.. toctree::

Summary/Usage
-------------

.. code-block:: shell

    set interface mtu [packet|ip4|ip6|mpls] <value> <interface>.

Set Interface Promiscuous
=========================

Summary/Usage
-------------

.. code-block:: shell

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

.. _setintstate:

Set Interface State
===================
This command is used to change the admin state (up/down) of an
interface.

If an interface is down, the optional '*punt*' flag can also be set. The
'*punt*' flag implies the interface is disabled for forwarding but punt
all traffic to slow-path. Use the '*enable*' flag to clear '*punt*' flag
(interface is still down).

Summary/Usage
-------------

.. code-block:: shell

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

Examples
--------

Example of how to configure the admin state of an interface to **up**:

.. code-block:: console

    vpp# set interface state GigabitEthernet2/0/0 up

Example of how to configure the admin state of an interface to **down**:

.. code-block:: console

    vpp# set interface state GigabitEthernet2/0/0 down