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