Gitiles
Code Review Sign In
gerrit.nordix.org / fdio / vpp / 034bd1067eddb700c6d2bc67974056fe00012310 / . / docs / reference / cmdreference / show / show.rst
blob: 61c536045945ce580a7f012b667bc2c792e73368 [file] [log] [blame]
Scott Keeler6c892302018-10-26 09:12:15 -0400[diff] [blame]1.. _interface:
2
3.. toctree::
4
5.. 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>`_ .
6
7Show Bridge-Domain
8===================
9
10`Show Bridge-Domain <../interface/hardware.html#show-bridge-domain>`_
11
12Show Interface
13================
14
15`Show Interface <../interface/basic.html#show-interface>`_
16
17Show IP Arp
18============
19
20Summary/Usage
21---------------
22
23show ip arp
24
25Description
26------------
27
28Display all the IPv4 ARP entries.
29
30Example Usage
31--------------
32Example of how to display the IPv4 ARP table:
33
34.. code-block:: console
35
36 vpp# **show ip arp**
37 Time FIB IP4 Flags Ethernet Interface
38 346.3028 0 6.1.1.3 de:ad:be:ef:ba:be GigabitEthernet2/0/0
39 3077.4271 0 6.1.1.4 S de:ad:be:ef:ff:ff GigabitEthernet2/0/0
40 2998.6409 1 6.2.2.3 de:ad:be:ef:00:01 GigabitEthernet2/0/0
41 Proxy arps enabled for:
42 Fib_index 0 6.0.0.1 - 6.0.0.11
43
44
45Declaration and Implementation
46-------------------------------
47
48**Declaration:** show_ip4_arp_command (src/vnet/ethernet/arp.c line 1465)
49
50**Implementation:** show_ip4_arp
51
52Show IP Fib
53=============
54
55Summary/Usage
56---------------
57
58show ip fib [summary] [table <*table-id*>] [index <*fib-id*>] [<*ip4-addr*>[/<*mask*>]] [mtrie] [detail]
59
60Description
61------------
62
63This command displays the IPv4 FIB Tables (VRF Tables) and the route entries for each table.
64
65.. note::
66 This command will run for a long time when the FIB tables are comprised of
Paul Vinciguerra7fa3dd22019-10-27 17:28:10 -0400[diff] [blame]67 millions of entries. For those scenarios, consider displaying a single table or summary mode.
Scott Keeler6c892302018-10-26 09:12:15 -0400[diff] [blame]68
69Example Usage
70--------------
71Example of how to display all the IPv4 FIB tables:
72
73.. code-block:: console
74
75 vpp# **show ip fib**
76
77 ipv4-VRF:0, fib_index 0, flow hash: src dst sport dport proto
78 0.0.0.0/0
79 unicast-ip4-chain
80 [@0]: dpo-load-balance: [index:0 buckets:1 uRPF:0 to:[0:0]]
81 [0] [@0]: dpo-drop ip6
82 0.0.0.0/32
83 unicast-ip4-chain
84 [@0]: dpo-load-balance: [index:1 buckets:1 uRPF:1 to:[0:0]]
85 [0] [@0]: dpo-drop ip6
86 6.0.1.2/32
87 unicast-ip4-chain
88 [@0]: dpo-load-balance: [index:30 buckets:1 uRPF:29 to:[0:0]]
89 [0] [@3]: arp-ipv4: via 6.0.0.1 af_packet0
90 7.0.0.1/32
91 unicast-ip4-chain
92 [@0]: dpo-load-balance: [index:31 buckets:4 uRPF:30 to:[0:0]]
93 [0] [@3]: arp-ipv4: via 6.0.0.2 af_packet0
94 [1] [@3]: arp-ipv4: via 6.0.0.2 af_packet0
95 [2] [@3]: arp-ipv4: via 6.0.0.2 af_packet0
96 [3] [@3]: arp-ipv4: via 6.0.0.1 af_packet0
97 224.0.0.0/8
98 unicast-ip4-chain
99 [@0]: dpo-load-balance: [index:3 buckets:1 uRPF:3 to:[0:0]]
100 [0] [@0]: dpo-drop ip6
101 240.0.0.0/8
102 unicast-ip4-chain
103 [@0]: dpo-load-balance: [index:2 buckets:1 uRPF:2 to:[0:0]]
104 [0] [@0]: dpo-drop ip6
105 255.255.255.255/32
106 unicast-ip4-chain
107 [@0]: dpo-load-balance: [index:4 buckets:1 uRPF:4 to:[0:0]]
108 [0] [@0]: dpo-drop ip6
109 ipv4-VRF:7, fib_index 1, flow hash: src dst sport dport proto
110 0.0.0.0/0
111 unicast-ip4-chain
112 [@0]: dpo-load-balance: [index:12 buckets:1 uRPF:11 to:[0:0]]
113 [0] [@0]: dpo-drop ip6
114 0.0.0.0/32
115 unicast-ip4-chain
116 [@0]: dpo-load-balance: [index:13 buckets:1 uRPF:12 to:[0:0]]
117 [0] [@0]: dpo-drop ip6
118 172.16.1.0/24
119 unicast-ip4-chain
120 [@0]: dpo-load-balance: [index:17 buckets:1 uRPF:16 to:[0:0]]
121 [0] [@4]: ipv4-glean: af_packet0
122 172.16.1.1/32
123 unicast-ip4-chain
124 [@0]: dpo-load-balance: [index:18 buckets:1 uRPF:17 to:[1:84]]
125 [0] [@2]: dpo-receive: 172.16.1.1 on af_packet0
126 172.16.1.2/32
127 unicast-ip4-chain
128 [@0]: dpo-load-balance: [index:21 buckets:1 uRPF:20 to:[0:0]]
129 [0] [@5]: ipv4 via 172.16.1.2 af_packet0: IP4: 02:fe:9e:70:7a:2b -> 26:a5:f6:9c:3a:36
130 172.16.2.0/24
131 unicast-ip4-chain
132 [@0]: dpo-load-balance: [index:19 buckets:1 uRPF:18 to:[0:0]]
133 [0] [@4]: ipv4-glean: af_packet1
134 172.16.2.1/32
135 unicast-ip4-chain
136 [@0]: dpo-load-balance: [index:20 buckets:1 uRPF:19 to:[0:0]]
137 [0] [@2]: dpo-receive: 172.16.2.1 on af_packet1
138 224.0.0.0/8
139 unicast-ip4-chain
140 [@0]: dpo-load-balance: [index:15 buckets:1 uRPF:14 to:[0:0]]
141 [0] [@0]: dpo-drop ip6
142 240.0.0.0/8
143 unicast-ip4-chain
144 [@0]: dpo-load-balance: [index:14 buckets:1 uRPF:13 to:[0:0]]
145 [0] [@0]: dpo-drop ip6
146 255.255.255.255/32
147 unicast-ip4-chain
148 [@0]: dpo-load-balance: [index:16 buckets:1 uRPF:15 to:[0:0]]
149 [0] [@0]: dpo-drop ip6
150
151Example of how to display a single IPv4 FIB table:
152
153.. code-block:: console
154
155 vpp# **show ip fib table 7**
156
157 ipv4-VRF:7, fib_index 1, flow hash: src dst sport dport proto
158 0.0.0.0/0
159 unicast-ip4-chain
160 [@0]: dpo-load-balance: [index:12 buckets:1 uRPF:11 to:[0:0]]
161 [0] [@0]: dpo-drop ip6
162 0.0.0.0/32
163 unicast-ip4-chain
164 [@0]: dpo-load-balance: [index:13 buckets:1 uRPF:12 to:[0:0]]
165 [0] [@0]: dpo-drop ip6
166 172.16.1.0/24
167 unicast-ip4-chain
168 [@0]: dpo-load-balance: [index:17 buckets:1 uRPF:16 to:[0:0]]
169 [0] [@4]: ipv4-glean: af_packet0
170 172.16.1.1/32
171 unicast-ip4-chain
172 [@0]: dpo-load-balance: [index:18 buckets:1 uRPF:17 to:[1:84]]
173 [0] [@2]: dpo-receive: 172.16.1.1 on af_packet0
174 172.16.1.2/32
175 unicast-ip4-chain
176 [@0]: dpo-load-balance: [index:21 buckets:1 uRPF:20 to:[0:0]]
177 [0] [@5]: ipv4 via 172.16.1.2 af_packet0: IP4: 02:fe:9e:70:7a:2b -*> 26:a5:f6:9c:3a:36
178 172.16.2.0/24
179 unicast-ip4-chain
180 [@0]: dpo-load-balance: [index:19 buckets:1 uRPF:18 to:[0:0]]
181 [0] [@4]: ipv4-glean: af_packet1
182 172.16.2.1/32
183 unicast-ip4-chain
184 [@0]: dpo-load-balance: [index:20 buckets:1 uRPF:19 to:[0:0]]
185 [0] [@2]: dpo-receive: 172.16.2.1 on af_packet1
186 224.0.0.0/8
187 unicast-ip4-chain
188 [@0]: dpo-load-balance: [index:15 buckets:1 uRPF:14 to:[0:0]]
189 [0] [@0]: dpo-drop ip6
190 240.0.0.0/8
191 unicast-ip4-chain
192 [@0]: dpo-load-balance: [index:14 buckets:1 uRPF:13 to:[0:0]]
193 [0] [@0]: dpo-drop ip6
194 255.255.255.255/32
195 unicast-ip4-chain
196 [@0]: dpo-load-balance: [index:16 buckets:1 uRPF:15 to:[0:0]]
197 [0] [@0]: dpo-drop ip6
198
199Example of how to display a summary of all IPv4 FIB tables:
200
201.. code-block:: console
202
203 vpp# **show ip fib summary**
204
205 ipv4-VRF:0, fib_index 0, flow hash: src dst sport dport proto
206 Prefix length Count
207 0 1
208 8 2
209 32 4
210 ipv4-VRF:7, fib_index 1, flow hash: src dst sport dport proto
211 Prefix length Count
212 0 1
213 8 2
214 24 2
215 32 4
216
217Declaration and Implementation
218-------------------------------
219
220**Declaration:** ip4_show_fib_command (src/vnet/fib/ip4_fib.c line 873)
221
222**Implementation:** ip4_show_fib
223
224Show L2fib
225============
226
227Summary/Usage
228------------------
229
230show l2fib [all] | [bd_id <*nn*> | bd_index <*nn*>] [learn | add] | [raw]
231
232Description
233------------
234
235This command displays the MAC Address entries of the L2 FIB table.
236Output can be filtered to just get the number of MAC Addresses or display each
237MAC Address for all bridge domains or just a single bridge domain.
238
239Example Usage
240--------------
241Example of how to display the number of MAC Address entries in the L2 FIB table:
242
243
244.. code-block:: console
245
246 vpp# **show l2fib**
247
248 3 l2fib entries
249
250 Example of how to display all the MAC Address entries in the L2 FIB table:
251
252 vpp# **show l2fib all**
253
254 Mac Address BD Idx Interface Index static filter bvi refresh timestamp
255 52:54:00:53:18:33 1 GigabitEthernet0/8/0.200 3 0 0 0 0 0
256 52:54:00:53:18:55 1 GigabitEthernet0/8/0.200 3 1 0 0 0 0
257 52:54:00:53:18:77 1 N/A -1 1 1 0 0 0
258 3 l2fib entries
259
260Declaration and Implementation
261-------------------------------
262
263**Declaration:** show_l2fib_cli (src/vnet/l2/l2_fib.c line 311)
264
265**Implementation:** show_l2fib
266
267Show Trace
268===========
269
270Summary/Usage
271--------------
272
273show trace buffer [max COUNT]
274
275Declaration and Implementation
276------------------------------
277
278**Declaration:** show_trace_cli (src/vlib/trace.c line 347)
279
280**Implementation:** cli_show_trace_buffer
281
282Show Vhost-User
283================
284
285`Show Vhost-User <../vhost/vhostuser.html#show-vhost-user>`_
286