FD.io VPP  v21.06-1-gbb7418cf9
Vector Packet Processing
cli.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2017 Cisco and/or its affiliates.
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at:
6  *
7  * http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  * See the License for the specific language governing permissions and
13  * limitations under the License.
14  */
15 
16 #define _GNU_SOURCE
17 #include <vnet/bonding/node.h>
18 #include <lacp/node.h>
19 
20 int
22 {
23  vnet_main_t *vnm = vnet_get_main ();
24  bond_main_t *bm = &bond_main;
25  member_if_t *mif;
26  bond_if_t *bif;
28  lacp_interface_details_t *r_lacpifs = NULL;
29  lacp_interface_details_t *lacpif = NULL;
30 
31  /* *INDENT-OFF* */
32  pool_foreach (mif, bm->neighbors) {
33  if (mif->lacp_enabled == 0)
34  continue;
35  vec_add2(r_lacpifs, lacpif, 1);
36  clib_memset (lacpif, 0, sizeof (*lacpif));
37  lacpif->sw_if_index = mif->sw_if_index;
38  hi = vnet_get_hw_interface (vnm, mif->hw_if_index);
39  clib_memcpy(lacpif->interface_name, hi->name,
40  MIN (ARRAY_LEN (lacpif->interface_name) - 1,
41  vec_len (hi->name)));
43  hi = vnet_get_hw_interface (vnm, bif->hw_if_index);
45  MIN (ARRAY_LEN (lacpif->bond_interface_name) - 1,
46  vec_len (hi->name)));
47  clib_memcpy (lacpif->actor_system, mif->actor.system, 6);
48  lacpif->actor_system_priority = mif->actor.system_priority;
49  lacpif->actor_key = mif->actor.key;
50  lacpif->actor_port_priority = mif->actor.port_priority;
51  lacpif->actor_port_number = mif->actor.port_number;
52  lacpif->actor_state = mif->actor.state;
53  clib_memcpy (lacpif->partner_system, mif->partner.system, 6);
54  lacpif->partner_system_priority = mif->partner.system_priority;
55  lacpif->partner_key = mif->partner.key;
56  lacpif->partner_port_priority = mif->partner.port_priority;
57  lacpif->partner_port_number = mif->partner.port_number;
58  lacpif->partner_state = mif->partner.state;
59  lacpif->rx_state = mif->rx_state;
60  lacpif->tx_state = mif->tx_state;
61  lacpif->ptx_state = mif->ptx_state;
62  lacpif->mux_state = mif->mux_state;
63  }
64  /* *INDENT-ON* */
65 
66  *out_lacpifs = r_lacpifs;
67 
68  return 0;
69 }
70 
71 static void
73 {
74  int i;
75  member_if_t *mif;
76  bond_if_t *bif;
77 
78  if (!sw_if_indices)
79  return;
80 
81  vlib_cli_output (vm, "%-55s %-32s %-32s", " ", "actor state",
82  "partner state");
83  vlib_cli_output (vm, "%-25s %-12s %-16s %-31s %-31s", "interface name",
84  "sw_if_index", "bond interface",
85  "exp/def/dis/col/syn/agg/tim/act",
86  "exp/def/dis/col/syn/agg/tim/act");
87 
88  for (i = 0; i < vec_len (sw_if_indices); i++)
89  {
90  mif = bond_get_member_by_sw_if_index (sw_if_indices[i]);
91  if (!mif || (mif->lacp_enabled == 0))
92  continue;
94  vlib_cli_output (vm,
95  "%-25U %-12d %-16U %3x %3x %3x %3x %3x %3x %3x %3x "
96  "%4x %3x %3x %3x %3x %3x %3x %3x",
98  mif->sw_if_index, mif->sw_if_index,
100  bif->sw_if_index, lacp_bit_test (mif->actor.state, 7),
101  lacp_bit_test (mif->actor.state, 6),
102  lacp_bit_test (mif->actor.state, 5),
103  lacp_bit_test (mif->actor.state, 4),
104  lacp_bit_test (mif->actor.state, 3),
105  lacp_bit_test (mif->actor.state, 2),
106  lacp_bit_test (mif->actor.state, 1),
107  lacp_bit_test (mif->actor.state, 0),
108  lacp_bit_test (mif->partner.state, 7),
109  lacp_bit_test (mif->partner.state, 6),
110  lacp_bit_test (mif->partner.state, 5),
111  lacp_bit_test (mif->partner.state, 4),
112  lacp_bit_test (mif->partner.state, 3),
113  lacp_bit_test (mif->partner.state, 2),
114  lacp_bit_test (mif->partner.state, 1),
115  lacp_bit_test (mif->partner.state, 0));
116  vlib_cli_output (vm,
117  " LAG ID: "
118  "[(%04x,%02x-%02x-%02x-%02x-%02x-%02x,%04x,%04x,%04x), "
119  "(%04x,%02x-%02x-%02x-%02x-%02x-%02x,%04x,%04x,%04x)]",
120  ntohs (mif->actor.system_priority),
121  mif->actor.system[0], mif->actor.system[1],
122  mif->actor.system[2], mif->actor.system[3],
123  mif->actor.system[4], mif->actor.system[5],
124  ntohs (mif->actor.key),
125  ntohs (mif->actor.port_priority),
126  ntohs (mif->actor.port_number),
127  ntohs (mif->partner.system_priority),
128  mif->partner.system[0], mif->partner.system[1],
129  mif->partner.system[2], mif->partner.system[3],
130  mif->partner.system[4], mif->partner.system[5],
131  ntohs (mif->partner.key),
132  ntohs (mif->partner.port_priority),
133  ntohs (mif->partner.port_number));
134  vlib_cli_output (vm,
135  " RX-state: %U, TX-state: %U, "
136  "MUX-state: %U, PTX-state: %U",
140  }
141 }
142 
143 static void
145 {
146  lacp_main_t *lm = &lacp_main;
147  member_if_t *mif;
148  lacp_state_struct *state_entry;
149  int i;
150  f64 now;
151 
152  vlib_cli_output (vm, "Number of interfaces: %d", lm->lacp_int);
153  if (!sw_if_indices)
154  return;
155 
156  now = vlib_time_now (vm);
157  for (i = 0; i < vec_len (sw_if_indices); i++)
158  {
159  mif = bond_get_member_by_sw_if_index (sw_if_indices[i]);
160  if (!mif || (mif->lacp_enabled == 0))
161  continue;
163  vnet_get_main (), mif->sw_if_index);
164  vlib_cli_output (vm, " Good LACP PDUs received: %llu",
165  mif->pdu_received);
166  vlib_cli_output (vm, " Bad LACP PDUs received: %llu",
167  mif->bad_pdu_received);
168  vlib_cli_output (vm, " LACP PDUs sent: %llu", mif->pdu_sent);
170  vlib_cli_output (vm,
171  " last LACP PDU received: %10.2f seconds ago",
172  now - mif->last_lacpdu_recd_time);
174  vlib_cli_output (vm, " last LACP PDU sent: %10.2f seconds ago",
175  now - mif->last_lacpdu_sent_time);
176  vlib_cli_output (vm, " Good Marker PDUs received: %llu",
177  mif->marker_pdu_received);
178  vlib_cli_output (vm, " Bad Marker PDUs received: %llu",
181  vlib_cli_output (vm,
182  " last Marker PDU received: %10.2f seconds ago",
183  now - mif->last_marker_pdu_recd_time);
185  vlib_cli_output (vm, " last Marker PDU sent: %10.2f seconds ago",
186  now - mif->last_marker_pdu_sent_time);
187  vlib_cli_output (vm, " debug: %d", mif->debug);
188  vlib_cli_output (vm, " loopback port: %d", mif->loopback_port);
189  vlib_cli_output (vm, " port_enabled: %d", mif->port_enabled);
190  vlib_cli_output (vm, " port moved: %d", mif->port_moved);
191  vlib_cli_output (vm, " ready_n: %d", mif->ready_n);
192  vlib_cli_output (vm, " ready: %d", mif->ready);
193  vlib_cli_output (vm, " Actor");
194  vlib_cli_output (vm, " system: %U",
195  format_ethernet_address, mif->actor.system);
196  vlib_cli_output (vm, " system priority: %u",
197  ntohs (mif->actor.system_priority));
198  vlib_cli_output (vm, " key: %u", ntohs (mif->actor.key));
199  vlib_cli_output (vm, " port priority: %u",
200  ntohs (mif->actor.port_priority));
201  vlib_cli_output (vm, " port number: %u",
202  ntohs (mif->actor.port_number));
203  vlib_cli_output (vm, " state: 0x%x", mif->actor.state);
204 
205  state_entry = (lacp_state_struct *) & lacp_state_array;
206  while (state_entry->str)
207  {
208  if (mif->actor.state & (1 << state_entry->bit))
209  vlib_cli_output (vm, " %s (%d)", state_entry->str,
210  state_entry->bit);
211  state_entry++;
212  }
213 
214  vlib_cli_output (vm, " Partner");
215  vlib_cli_output (vm, " system: %U",
216  format_ethernet_address, mif->partner.system);
217  vlib_cli_output (vm, " system priority: %u",
218  ntohs (mif->partner.system_priority));
219  vlib_cli_output (vm, " key: %u", ntohs (mif->partner.key));
220  vlib_cli_output (vm, " port priority: %u",
221  ntohs (mif->partner.port_priority));
222  vlib_cli_output (vm, " port number: %u",
223  ntohs (mif->partner.port_number));
224  vlib_cli_output (vm, " state: 0x%x", mif->partner.state);
225 
226  state_entry = (lacp_state_struct *) & lacp_state_array;
227  while (state_entry->str)
228  {
229  if (mif->partner.state & (1 << state_entry->bit))
230  vlib_cli_output (vm, " %s (%d)", state_entry->str,
231  state_entry->bit);
232  state_entry++;
233  }
234 
236  vlib_cli_output (vm, " wait while timer: not running");
237  else
238  vlib_cli_output (vm, " wait while timer: %10.2f seconds",
239  mif->wait_while_timer - now);
241  vlib_cli_output (vm, " current while timer: not running");
242  else
243  vlib_cli_output (vm, " current while timer: %10.2f seconds",
244  mif->current_while_timer - now);
246  vlib_cli_output (vm, " periodic timer: not running");
247  else
248  vlib_cli_output (vm, " periodic timer: %10.2f seconds",
249  mif->periodic_timer - now);
250  vlib_cli_output (vm, " RX-state: %U", format_rx_sm_state,
251  mif->rx_state);
252  vlib_cli_output (vm, " TX-state: %U", format_tx_sm_state,
253  mif->tx_state);
254  vlib_cli_output (vm, " MUX-state: %U", format_mux_sm_state,
255  mif->mux_state);
256  vlib_cli_output (vm, " PTX-state: %U", format_ptx_sm_state,
257  mif->ptx_state);
258  vlib_cli_output (vm, "\n");
259  }
260 }
261 
262 static clib_error_t *
264  vlib_cli_command_t * cmd)
265 {
266  bond_main_t *bm = &bond_main;
267  vnet_main_t *vnm = &vnet_main;
268  member_if_t *mif;
269  clib_error_t *error = 0;
270  u8 details = 0;
272 
274  {
275  if (unformat
276  (input, "%U", unformat_vnet_sw_interface, vnm, &sw_if_index))
277  {
278  mif = bond_get_member_by_sw_if_index (sw_if_index);
279  if (!mif)
280  {
281  error = clib_error_return (0, "interface is not a member");
282  goto done;
283  }
284  vec_add1 (sw_if_indices, mif->sw_if_index);
285  }
286  else if (unformat (input, "details"))
287  details = 1;
288  else
289  {
290  error = clib_error_return (0, "unknown input `%U'",
291  format_unformat_error, input);
292  goto done;
293  }
294  }
295 
296  if (vec_len (sw_if_indices) == 0)
297  {
298  pool_foreach (mif, bm->neighbors)
299  vec_add1 (sw_if_indices, mif->sw_if_index);
300  }
301 
302  if (details)
303  show_lacp_details (vm, sw_if_indices);
304  else
305  show_lacp (vm, sw_if_indices);
306 
307 done:
308  vec_free (sw_if_indices);
309  return error;
310 }
311 
312 /* *INDENT-OFF* */
313 VLIB_CLI_COMMAND (show_lacp_command, static) = {
314  .path = "show lacp",
315  .short_help = "show lacp [<interface>] [details]",
316  .function = show_lacp_fn,
317  .is_mp_safe = 1,
318 };
319 /* *INDENT-ON* */
320 
321 static clib_error_t *
323  vlib_cli_command_t * cmd)
324 {
325  unformat_input_t _line_input, *line_input = &_line_input;
326  clib_error_t *error = NULL;
327  lacp_main_t *lm = &lacp_main;
328  u8 onoff = 0;
329  u8 input_found = 0;
330  u32 sw_if_index = ~0;
331  member_if_t *mif;
332  vnet_main_t *vnm = vnet_get_main ();
333 
334  /* Get a line of input. */
335  if (!unformat_user (input, unformat_line_input, line_input))
336  return clib_error_return (0, "missing argument");
337 
338  while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
339  {
340  if (unformat (line_input, "%U",
341  unformat_vnet_sw_interface, vnm, &sw_if_index))
342  ;
343  if (input_found)
344  {
345  error = clib_error_return (0, "unknown input `%U'",
346  format_unformat_error, line_input);
347  goto done;
348  }
349  else if (unformat (line_input, "on"))
350  {
351  input_found = 1;
352  onoff = 1;
353  }
354  else if (unformat (line_input, "off"))
355  {
356  input_found = 1;
357  onoff = 0;
358  }
359  else
360  {
361  error = clib_error_return (0, "unknown input `%U'",
362  format_unformat_error, line_input);
363  goto done;
364  }
365  }
366 
367  if (!input_found)
368  return clib_error_return (0, "must specify on or off");
369 
370  if (sw_if_index != ~0)
371  {
372  mif = bond_get_member_by_sw_if_index (sw_if_index);
373  if (!mif)
374  return (clib_error_return
375  (0, "Please add the member interface first"));
376  mif->debug = onoff;
377  }
378  else
379  lm->debug = onoff;
380 
381 done:
382  unformat_free (line_input);
383 
384  return error;
385 }
386 
387 /* *INDENT-OFF* */
388 VLIB_CLI_COMMAND (debug_lacp_command, static) = {
389  .path = "debug lacp",
390  .short_help = "debug lacp <interface> <on | off>",
391  .function = debug_lacp_command_fn,
392 };
393 /* *INDENT-ON* */
394 
395 clib_error_t *
397 {
398  lacp_main_t *lm = &lacp_main;
399 
400  lm->vlib_main = vm;
401  lm->vnet_main = vnet_get_main ();
402 
403  return 0;
404 }
405 
407 
408 /*
409  * fd.io coding-style-patch-verification: ON
410  *
411  * Local Variables:
412  * eval: (c-set-style "gnu")
413  * End:
414  */
u8 interface_name[64]
Definition: node.h:97
vlib_main_t * vlib_main
Definition: node.h:123
u32 hw_if_index
Definition: node.h:183
u64 marker_bad_pdu_received
Definition: node.h:343
u32 sw_if_indices[VLIB_FRAME_SIZE]
#define ntohs(x)
Definition: af_xdp.bpf.c:29
volatile u32 lacp_int
Definition: node.h:136
#define pool_foreach(VAR, POOL)
Iterate through pool.
Definition: pool.h:534
static void show_lacp_details(vlib_main_t *vm, u32 *sw_if_indices)
Definition: cli.c:144
clib_memset(h->entries, 0, sizeof(h->entries[0]) *entries)
static f64 vlib_time_now(vlib_main_t *vm)
Definition: main.h:325
f64 current_while_timer
Definition: node.h:286
static vnet_hw_interface_t * vnet_get_hw_interface(vnet_main_t *vnm, u32 hw_if_index)
static bond_if_t * bond_get_bond_if_by_dev_instance(u32 dev_instance)
Definition: node.h:517
#define vec_add1(V, E)
Add 1 element to end of vector (unspecified alignment).
Definition: vec.h:607
#define vec_add2(V, P, N)
Add N elements to end of vector V, return pointer to new elements in P.
Definition: vec.h:645
uword unformat_user(unformat_input_t *input, unformat_function_t *func,...)
Definition: unformat.c:989
u8 lacp_enabled
Definition: node.h:271
int ptx_state
Definition: node.h:316
unformat_function_t unformat_vnet_sw_interface
format_function_t format_vnet_sw_if_index_name
unsigned char u8
Definition: types.h:56
int lacp_dump_ifs(lacp_interface_details_t **out_lacpifs)
Definition: cli.c:21
double f64
Definition: types.h:142
unsigned int u32
Definition: types.h:88
#define clib_memcpy(d, s, n)
Definition: string.h:197
static void show_lacp(vlib_main_t *vm, u32 *sw_if_indices)
Definition: cli.c:72
static u8 * format_rx_sm_state(u8 *s, va_list *args)
Definition: node.h:182
u8 * format_ethernet_address(u8 *s, va_list *args)
Definition: format.c:44
static u8 lacp_timer_is_running(f64 timer)
Definition: node.h:168
#define VLIB_INIT_FUNCTION(x)
Definition: init.h:172
vnet_main_t * vnet_main
Definition: node.h:124
u8 ready_n
Definition: node.h:274
f64 last_lacpdu_recd_time
Definition: node.h:295
static clib_error_t * debug_lacp_command_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: cli.c:322
u32 sw_if_index
Definition: node.h:184
#define clib_error_return(e, args...)
Definition: error.h:99
vnet_main_t * vnet_get_main(void)
u64 pdu_received
Definition: node.h:331
#define MIN(x, y)
Definition: node.h:31
unformat_function_t unformat_line_input
Definition: format.h:275
Definition: cJSON.c:88
vl_api_interface_index_t sw_if_index
Definition: wireguard.api:34
LACP interface details struct.
Definition: node.h:94
struct _unformat_input_t unformat_input_t
u8 debug
Definition: node.h:139
f64 last_lacpdu_sent_time
Definition: node.h:292
lacp_port_info_t partner
Definition: node.h:254
vnet_main_t vnet_main
Definition: misc.c:43
vlib_main_t * vm
X-connect all packets from the HOST to the PHY.
Definition: nat44_ei.c:3047
member_if_t * neighbors
Definition: node.h:370
u8 bond_interface_name[64]
Definition: node.h:102
#define UNFORMAT_END_OF_INPUT
Definition: format.h:137
sll srl srl sll sra u16x4 i
Definition: vector_sse42.h:261
#define vec_free(V)
Free vector&#39;s memory (no header).
Definition: vec.h:395
int mux_state
Definition: node.h:315
static u8 * format_mux_sm_state(u8 *s, va_list *args)
Definition: node.h:222
#define ARRAY_LEN(x)
Definition: clib.h:70
lacp_main_t lacp_main
Definition: lacp.c:26
f64 last_marker_pdu_sent_time
Definition: node.h:298
#define VLIB_CLI_COMMAND(x,...)
Definition: cli.h:163
void vlib_cli_output(vlib_main_t *vm, char *fmt,...)
Definition: cli.c:716
bond_main_t bond_main
Definition: node.c:25
static member_if_t * bond_get_member_by_sw_if_index(u32 sw_if_index)
Definition: node.h:525
static u8 * format_ptx_sm_state(u8 *s, va_list *args)
Definition: node.h:242
int rx_state
Definition: node.h:313
int tx_state
Definition: node.h:314
u8 ready
Definition: node.h:277
f64 wait_while_timer
Definition: node.h:310
vl_api_ip4_address_t hi
Definition: arp.api:37
f64 periodic_timer
Definition: node.h:304
u8 debug
Definition: node.h:227
static clib_error_t * show_lacp_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: cli.c:263
#define vec_len(v)
Number of elements in vector (rvalue-only, NULL tolerant)
static void unformat_free(unformat_input_t *i)
Definition: format.h:155
u8 loopback_port
Definition: node.h:325
u8 port_enabled
Definition: node.h:265
static int lacp_bit_test(u8 val, u8 bit)
Definition: node.h:262
u64 pdu_sent
Definition: node.h:337
u32 sw_if_index
Definition: node.h:218
u8 * format_unformat_error(u8 *s, va_list *va)
Definition: unformat.c:91
f64 now
static u8 * format_tx_sm_state(u8 *s, va_list *args)
Definition: node.h:202
u64 bad_pdu_received
Definition: node.h:334
u32 hw_if_index
Definition: node.h:245
f64 last_marker_pdu_recd_time
Definition: node.h:301
lacp_port_info_t actor
Definition: node.h:255
lacp_state_struct lacp_state_array[]
Definition: node.c:21
clib_error_t * lacp_cli_init(vlib_main_t *vm)
Definition: cli.c:396
u8 port_moved
Definition: node.h:283
uword unformat(unformat_input_t *i, const char *fmt,...)
Definition: unformat.c:978
static uword unformat_check_input(unformat_input_t *i)
Definition: format.h:163
u64 marker_pdu_received
Definition: node.h:340
u32 bif_dev_instance
Definition: node.h:323