5 Hardware-Interfaces Commands
6 ============================
7 This section contains those interface commands that are related to hardware-interfaces:
10 * `Show Bridge-Domain`_
11 * `Show Hardware-Interfaces`_
12 * `Clear Hardware-Interfaces`_
14 .. note:: For a complete list of CLI Debug commands refer to the Debug CLI section of the `Source Code Documents <https://docs.fd.io/vpp/18.07/clicmd.html>`_ .
22 show bridge-domain [*bridge-domain-id* [detail|int|arp| *bd-tag* ]]
27 Show a summary of all the bridge-domain instances or detailed view of a single bridge-domain.
28 Bridge-domains are created by adding an interface to a bridge using the **set interface l2 bridge** command.
32 .. code-block:: console
34 Example of displaying all bridge-domains:
36 vpp# show bridge-domain
38 ID Index Learning U-Forwrd UU-Flood Flooding ARP-Term BVI-Intf
39 0 0 off off off off off local0
40 200 1 on on on on off N/A
42 Example of displaying details of a single bridge-domains:
44 vpp# show bridge-domain 200 detail
46 ID Index Learning U-Forwrd UU-Flood Flooding ARP-Term BVI-Intf
47 200 1 on on on on off N/A
49 Interface Index SHG BVI VLAN-Tag-Rewrite
50 GigabitEthernet0/8/0.200 3 0 - none
51 GigabitEthernet0/9/0.200 4 0 - none
53 Declaration and Implementation
54 ------------------------------
56 **Declaration:** bd_show_cli (src/vnet/l2/l2_bd.c line 1151)
58 **Implementation:** bd_show
60 Show Hardware-Interfaces
61 +++++++++++++++++++++++++
62 Display more detailed information about all or a list of given
63 interfaces. The verboseness of the output can be controlled by the
64 following optional parameters:
66 - **brief**: Only show name, index and state (default for bonded
68 - **verbose**: Also display additional attributes (default for all other
70 - **detail**: Also display all remaining attributes and extended
74 To limit the output of the command to bonded interfaces and their
75 slave interfaces, use the '*bond*' optional parameter.
82 show hardware-interfaces [brief|verbose|detail] [bond] [<interface> [<interface> [..]]] [<sw_idx> [<sw_idx> [..]]].
86 Example of how to display default data for all interfaces:
88 .. code-block:: console
90 vpp# show hardware-interfaces
91 Name Idx Link Hardware
92 GigabitEthernet7/0/0 1 up GigabitEthernet7/0/0
93 Ethernet address ec:f4:bb:c0:bc:fc
95 carrier up full duplex speed 1000 mtu 9216
96 rx queues 1, rx desc 1024, tx queues 3, tx desc 1024
98 GigabitEthernet7/0/1 2 up GigabitEthernet7/0/1
99 Ethernet address ec:f4:bb:c0:bc:fd
101 carrier up full duplex speed 1000 mtu 9216
102 rx queues 1, rx desc 1024, tx queues 3, tx desc 1024
104 VirtualEthernet0/0/0 3 up VirtualEthernet0/0/0
105 Ethernet address 02:fe:a5:a9:8b:8e
106 VirtualEthernet0/0/1 4 up VirtualEthernet0/0/1
107 Ethernet address 02:fe:c0:4e:3b:b0
108 VirtualEthernet0/0/2 5 up VirtualEthernet0/0/2
109 Ethernet address 02:fe:1f:73:92:81
110 VirtualEthernet0/0/3 6 up VirtualEthernet0/0/3
111 Ethernet address 02:fe:f2:25:c4:68
115 Example of how to display *verbose* data for an interface by name and software index
116 (where 2 is the software index):
118 .. code-block:: console
120 vpp# show hardware-interfaces GigabitEthernet7/0/0 2 verbose
121 Name Idx Link Hardware
122 GigabitEthernet7/0/0 1 up GigabitEthernet7/0/0
123 Ethernet address ec:f4:bb:c0:bc:fc
125 carrier up full duplex speed 1000 mtu 9216
126 rx queues 1, rx desc 1024, tx queues 3, tx desc 1024
128 GigabitEthernet7/0/1 2 down GigabitEthernet7/0/1
129 Ethernet address ec:f4:bb:c0:bc:fd
131 carrier up full duplex speed 1000 mtu 9216
132 rx queues 1, rx desc 1024, tx queues 3, tx desc 1024
135 Clear Hardware-Interfaces
136 +++++++++++++++++++++++++
138 Clear the extended statistics for all or a list of given interfaces
139 (statistics associated with the **show hardware-interfaces** command).
145 .. code-block:: shell
147 clear hardware-interfaces [<interface> [<interface> [..]]] [<sw_idx> [<sw_idx> [..]]].
153 Example of how to clear the extended statistics for all interfaces:
156 .. code-block:: console
158 vpp# clear hardware-interfaces
160 Example of how to clear the extended statistics for an interface by name and software index
161 (where 2 is the software index):
163 .. code-block:: console
165 vpp# clear hardware-interfaces GigabitEthernet7/0/0 2