FD.io VPP  v19.08-27-gf4dcae4
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  slave_if_t *sif;
26  bond_if_t *bif;
28  lacp_interface_details_t *r_lacpifs = NULL;
30 
31  /* *INDENT-OFF* */
32  pool_foreach (sif, bm->neighbors,
33  if ((sif->port_enabled == 0) || (sif->lacp_enabled == 0))
34  continue;
35  vec_add2(r_lacpifs, lacpif, 1);
36  clib_memset (lacpif, 0, sizeof (*lacpif));
37  lacpif->sw_if_index = sif->sw_if_index;
38  hi = vnet_get_hw_interface (vnm, sif->hw_if_index);
39  clib_memcpy(lacpif->interface_name, hi->name,
40  MIN (ARRAY_LEN (lacpif->interface_name) - 1,
41  strlen ((const char *) hi->name)));
43  hi = vnet_get_hw_interface (vnm, bif->hw_if_index);
45  MIN (ARRAY_LEN (lacpif->bond_interface_name) - 1,
46  strlen ((const char *) hi->name)));
47  clib_memcpy (lacpif->actor_system, sif->actor.system, 6);
48  lacpif->actor_system_priority = sif->actor.system_priority;
49  lacpif->actor_key = sif->actor.key;
50  lacpif->actor_port_priority = sif->actor.port_priority;
51  lacpif->actor_port_number = sif->actor.port_number;
52  lacpif->actor_state = sif->actor.state;
53  clib_memcpy (lacpif->partner_system, sif->partner.system, 6);
54  lacpif->partner_system_priority = sif->partner.system_priority;
55  lacpif->partner_key = sif->partner.key;
56  lacpif->partner_port_priority = sif->partner.port_priority;
57  lacpif->partner_port_number = sif->partner.port_number;
58  lacpif->partner_state = sif->partner.state;
59  lacpif->rx_state = sif->rx_state;
60  lacpif->tx_state = sif->tx_state;
61  lacpif->ptx_state = sif->ptx_state;
62  lacpif->mux_state = sif->mux_state;
63  );
64  /* *INDENT-ON* */
65 
66  *out_lacpifs = r_lacpifs;
67 
68  return 0;
69 }
70 
71 static void
72 show_lacp (vlib_main_t * vm, u32 * sw_if_indices)
73 {
74  int i;
75  slave_if_t *sif;
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  sif = bond_get_slave_by_sw_if_index (sw_if_indices[i]);
91  if (!sif || (sif->port_enabled == 0) || (sif->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  sif->sw_if_index, sif->sw_if_index,
100  bif->sw_if_index, lacp_bit_test (sif->actor.state, 7),
101  lacp_bit_test (sif->actor.state, 6),
102  lacp_bit_test (sif->actor.state, 5),
103  lacp_bit_test (sif->actor.state, 4),
104  lacp_bit_test (sif->actor.state, 3),
105  lacp_bit_test (sif->actor.state, 2),
106  lacp_bit_test (sif->actor.state, 1),
107  lacp_bit_test (sif->actor.state, 0),
108  lacp_bit_test (sif->partner.state, 7),
109  lacp_bit_test (sif->partner.state, 6),
110  lacp_bit_test (sif->partner.state, 5),
111  lacp_bit_test (sif->partner.state, 4),
112  lacp_bit_test (sif->partner.state, 3),
113  lacp_bit_test (sif->partner.state, 2),
114  lacp_bit_test (sif->partner.state, 1),
115  lacp_bit_test (sif->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 (sif->actor.system_priority),
121  sif->actor.system[0], sif->actor.system[1],
122  sif->actor.system[2], sif->actor.system[3],
123  sif->actor.system[4], sif->actor.system[5],
124  ntohs (sif->actor.key),
125  ntohs (sif->actor.port_priority),
126  ntohs (sif->actor.port_number),
127  ntohs (sif->partner.system_priority),
128  sif->partner.system[0], sif->partner.system[1],
129  sif->partner.system[2], sif->partner.system[3],
130  sif->partner.system[4], sif->partner.system[5],
131  ntohs (sif->partner.key),
132  ntohs (sif->partner.port_priority),
133  ntohs (sif->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
144 show_lacp_details (vlib_main_t * vm, u32 * sw_if_indices)
145 {
146  lacp_main_t *lm = &lacp_main;
147  slave_if_t *sif;
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  sif = bond_get_slave_by_sw_if_index (sw_if_indices[i]);
160  if (!sif || (sif->port_enabled == 0) || (sif->lacp_enabled == 0))
161  continue;
163  vnet_get_main (), sif->sw_if_index);
164  vlib_cli_output (vm, " Good LACP PDUs received: %llu",
165  sif->pdu_received);
166  vlib_cli_output (vm, " Bad LACP PDUs received: %llu",
167  sif->bad_pdu_received);
168  vlib_cli_output (vm, " LACP PDUs sent: %llu", sif->pdu_sent);
170  vlib_cli_output (vm,
171  " last LACP PDU received: %10.2f seconds ago",
172  now - sif->last_lacpdu_recd_time);
174  vlib_cli_output (vm, " last LACP PDU sent: %10.2f seconds ago",
175  now - sif->last_lacpdu_sent_time);
176  vlib_cli_output (vm, " Good Marker PDUs received: %llu",
177  sif->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 - sif->last_marker_pdu_recd_time);
185  vlib_cli_output (vm, " last Marker PDU sent: %10.2f seconds ago",
186  now - sif->last_marker_pdu_sent_time);
187  vlib_cli_output (vm, " debug: %d", sif->debug);
188  vlib_cli_output (vm, " loopback port: %d", sif->loopback_port);
189  vlib_cli_output (vm, " port moved: %d", sif->port_moved);
190  vlib_cli_output (vm, " ready_n: %d", sif->ready_n);
191  vlib_cli_output (vm, " ready: %d", sif->ready);
192  vlib_cli_output (vm, " Actor");
193  vlib_cli_output (vm, " system: %U",
194  format_ethernet_address, sif->actor.system);
195  vlib_cli_output (vm, " system priority: %u",
196  ntohs (sif->actor.system_priority));
197  vlib_cli_output (vm, " key: %u", ntohs (sif->actor.key));
198  vlib_cli_output (vm, " port priority: %u",
199  ntohs (sif->actor.port_priority));
200  vlib_cli_output (vm, " port number: %u",
201  ntohs (sif->actor.port_number));
202  vlib_cli_output (vm, " state: 0x%x", sif->actor.state);
203 
204  state_entry = (lacp_state_struct *) & lacp_state_array;
205  while (state_entry->str)
206  {
207  if (sif->actor.state & (1 << state_entry->bit))
208  vlib_cli_output (vm, " %s (%d)", state_entry->str,
209  state_entry->bit);
210  state_entry++;
211  }
212 
213  vlib_cli_output (vm, " Partner");
214  vlib_cli_output (vm, " system: %U",
215  format_ethernet_address, sif->partner.system);
216  vlib_cli_output (vm, " system priority: %u",
217  ntohs (sif->partner.system_priority));
218  vlib_cli_output (vm, " key: %u", ntohs (sif->partner.key));
219  vlib_cli_output (vm, " port priority: %u",
220  ntohs (sif->partner.port_priority));
221  vlib_cli_output (vm, " port number: %u",
222  ntohs (sif->partner.port_number));
223  vlib_cli_output (vm, " state: 0x%x", sif->partner.state);
224 
225  state_entry = (lacp_state_struct *) & lacp_state_array;
226  while (state_entry->str)
227  {
228  if (sif->partner.state & (1 << state_entry->bit))
229  vlib_cli_output (vm, " %s (%d)", state_entry->str,
230  state_entry->bit);
231  state_entry++;
232  }
233 
235  vlib_cli_output (vm, " wait while timer: not running");
236  else
237  vlib_cli_output (vm, " wait while timer: %10.2f seconds",
238  sif->wait_while_timer - now);
240  vlib_cli_output (vm, " current while timer: not running");
241  else
242  vlib_cli_output (vm, " current while timer: %10.2f seconds",
243  sif->current_while_timer - now);
245  vlib_cli_output (vm, " periodic timer: not running");
246  else
247  vlib_cli_output (vm, " periodic timer: %10.2f seconds",
248  sif->periodic_timer - now);
249  vlib_cli_output (vm, " RX-state: %U", format_rx_sm_state,
250  sif->rx_state);
251  vlib_cli_output (vm, " TX-state: %U", format_tx_sm_state,
252  sif->tx_state);
253  vlib_cli_output (vm, " MUX-state: %U", format_mux_sm_state,
254  sif->mux_state);
255  vlib_cli_output (vm, " PTX-state: %U", format_ptx_sm_state,
256  sif->ptx_state);
257  vlib_cli_output (vm, "\n");
258  }
259 }
260 
261 static clib_error_t *
263  vlib_cli_command_t * cmd)
264 {
265  bond_main_t *bm = &bond_main;
266  vnet_main_t *vnm = &vnet_main;
267  slave_if_t *sif;
268  clib_error_t *error = 0;
269  u8 details = 0;
270  u32 sw_if_index, *sw_if_indices = 0;
271 
273  {
274  if (unformat
275  (input, "%U", unformat_vnet_sw_interface, vnm, &sw_if_index))
276  {
277  sif = bond_get_slave_by_sw_if_index (sw_if_index);
278  if (!sif)
279  {
280  error = clib_error_return (0, "interface is not enslaved");
281  goto done;
282  }
283  vec_add1 (sw_if_indices, sif->sw_if_index);
284  }
285  else if (unformat (input, "details"))
286  details = 1;
287  else
288  {
289  error = clib_error_return (0, "unknown input `%U'",
290  format_unformat_error, input);
291  goto done;
292  }
293  }
294 
295  if (vec_len (sw_if_indices) == 0)
296  {
297  pool_foreach (sif, bm->neighbors,
298  vec_add1 (sw_if_indices, sif->sw_if_index);
299  );
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 };
318 /* *INDENT-ON* */
319 
320 static clib_error_t *
322  vlib_cli_command_t * cmd)
323 {
324  unformat_input_t _line_input, *line_input = &_line_input;
325  clib_error_t *error = NULL;
326  lacp_main_t *lm = &lacp_main;
327  u8 onoff = 0;
328  u8 input_found = 0;
329  u32 sw_if_index = ~0;
330  slave_if_t *sif;
331  vnet_main_t *vnm = vnet_get_main ();
332 
333  /* Get a line of input. */
334  if (!unformat_user (input, unformat_line_input, line_input))
335  return clib_error_return (0, "missing argument");
336 
337  while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
338  {
339  if (unformat (line_input, "%U",
340  unformat_vnet_sw_interface, vnm, &sw_if_index))
341  ;
342  if (input_found)
343  {
344  error = clib_error_return (0, "unknown input `%U'",
345  format_unformat_error, line_input);
346  goto done;
347  }
348  else if (unformat (line_input, "on"))
349  {
350  input_found = 1;
351  onoff = 1;
352  }
353  else if (unformat (line_input, "off"))
354  {
355  input_found = 1;
356  onoff = 0;
357  }
358  else
359  {
360  error = clib_error_return (0, "unknown input `%U'",
361  format_unformat_error, line_input);
362  goto done;
363  }
364  }
365 
366  if (!input_found)
367  return clib_error_return (0, "must specify on or off");
368 
369  if (sw_if_index != ~0)
370  {
371  sif = bond_get_slave_by_sw_if_index (sw_if_index);
372  if (!sif)
373  return (clib_error_return (0, "Please enslave the interface first"));
374  sif->debug = onoff;
375  }
376  else
377  lm->debug = onoff;
378 
379 done:
380  unformat_free (line_input);
381 
382  return error;
383 }
384 
385 /* *INDENT-OFF* */
386 VLIB_CLI_COMMAND (debug_lacp_command, static) = {
387  .path = "debug lacp",
388  .short_help = "debug lacp <interface> <on | off>",
389  .function = debug_lacp_command_fn,
390 };
391 /* *INDENT-ON* */
392 
393 clib_error_t *
395 {
396  lacp_main_t *lm = &lacp_main;
397 
398  lm->vlib_main = vm;
399  lm->vnet_main = vnet_get_main ();
400 
401  return 0;
402 }
403 
405 
406 /*
407  * fd.io coding-style-patch-verification: ON
408  *
409  * Local Variables:
410  * eval: (c-set-style "gnu")
411  * End:
412  */
static void show_lacp_details(vlib_main_t *vm, u32 *sw_if_indices)
Definition: cli.c:144
u8 interface_name[64]
Definition: node.h:95
vmrglw vmrglh hi
vlib_main_t * vlib_main
Definition: node.h:121
u32 hw_if_index
Definition: node.h:176
vnet_main_t * vnet_get_main(void)
Definition: misc.c:46
volatile u32 lacp_int
Definition: node.h:134
f64 last_lacpdu_recd_time
Definition: node.h:287
#define NULL
Definition: clib.h:58
static f64 vlib_time_now(vlib_main_t *vm)
Definition: main.h:258
static vnet_hw_interface_t * vnet_get_hw_interface(vnet_main_t *vnm, u32 hw_if_index)
int tx_state
Definition: node.h:306
int lacp_dump_ifs(lacp_interface_details_t **out_lacpifs)
Definition: cli.c:21
#define vec_add1(V, E)
Add 1 element to end of vector (unspecified alignment).
Definition: vec.h:522
#define vec_add2(V, P, N)
Add N elements to end of vector V, return pointer to new elements in P.
Definition: vec.h:560
int i
bond_main_t bond_main
Definition: node.c:25
uword unformat_user(unformat_input_t *input, unformat_function_t *func,...)
Definition: unformat.c:989
clib_memset(h->entries, 0, sizeof(h->entries[0])*entries)
lacp_state_struct lacp_state_array[]
Definition: node.c:21
unformat_function_t unformat_vnet_sw_interface
u64 pdu_received
Definition: node.h:323
f64 current_while_timer
Definition: node.h:278
format_function_t format_vnet_sw_if_index_name
unsigned char u8
Definition: types.h:56
static clib_error_t * show_lacp_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: cli.c:262
double f64
Definition: types.h:142
#define clib_memcpy(d, s, n)
Definition: string.h:180
f64 periodic_timer
Definition: node.h:296
static u8 * format_rx_sm_state(u8 *s, va_list *args)
Definition: node.h:180
u8 * format_ethernet_address(u8 *s, va_list *args)
Definition: format.c:44
static u8 lacp_timer_is_running(f64 timer)
Definition: node.h:166
#define pool_foreach(VAR, POOL, BODY)
Iterate through pool.
Definition: pool.h:493
vl_api_interface_index_t sw_if_index
Definition: gre.api:50
#define VLIB_INIT_FUNCTION(x)
Definition: init.h:173
vnet_main_t * vnet_main
Definition: node.h:122
f64 last_marker_pdu_recd_time
Definition: node.h:293
u32 sw_if_index
Definition: node.h:177
u64 bad_pdu_received
Definition: node.h:326
lacp_port_info_t actor
Definition: node.h:247
u64 marker_pdu_received
Definition: node.h:332
#define clib_error_return(e, args...)
Definition: error.h:99
unsigned int u32
Definition: types.h:88
#define MIN(x, y)
Definition: node.h:31
unformat_function_t unformat_line_input
Definition: format.h:283
u8 ready
Definition: node.h:269
LACP interface details struct.
Definition: node.h:92
f64 last_marker_pdu_sent_time
Definition: node.h:290
struct _unformat_input_t unformat_input_t
u8 port_moved
Definition: node.h:275
u8 debug
Definition: node.h:137
vnet_main_t vnet_main
Definition: misc.c:43
int ptx_state
Definition: node.h:308
u8 bond_interface_name[64]
Definition: node.h:100
#define UNFORMAT_END_OF_INPUT
Definition: format.h:145
u32 sw_if_index
Definition: node.h:213
vlib_main_t * vm
Definition: buffer.c:312
lacp_port_info_t partner
Definition: node.h:246
#define vec_free(V)
Free vector&#39;s memory (no header).
Definition: vec.h:341
static u8 * format_mux_sm_state(u8 *s, va_list *args)
Definition: node.h:220
int rx_state
Definition: node.h:305
#define ARRAY_LEN(x)
Definition: clib.h:62
lacp_main_t lacp_main
Definition: lacp.c:25
f64 last_lacpdu_sent_time
Definition: node.h:284
static clib_error_t * debug_lacp_command_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: cli.c:321
#define VLIB_CLI_COMMAND(x,...)
Definition: cli.h:155
u8 loopback_port
Definition: node.h:317
static bond_if_t * bond_get_master_by_dev_instance(u32 dev_instance)
Definition: node.h:495
u32 bif_dev_instance
Definition: node.h:315
static u8 * format_ptx_sm_state(u8 *s, va_list *args)
Definition: node.h:240
u8 debug
Definition: node.h:222
u8 ready_n
Definition: node.h:266
clib_error_t * lacp_cli_init(vlib_main_t *vm)
Definition: cli.c:394
u8 lacp_enabled
Definition: node.h:263
u64 pdu_sent
Definition: node.h:329
#define vec_len(v)
Number of elements in vector (rvalue-only, NULL tolerant)
static void show_lacp(vlib_main_t *vm, u32 *sw_if_indices)
Definition: cli.c:72
static void unformat_free(unformat_input_t *i)
Definition: format.h:163
static int lacp_bit_test(u8 val, u8 bit)
Definition: node.h:260
u8 * format_unformat_error(u8 *s, va_list *va)
Definition: unformat.c:91
slave_if_t * neighbors
Definition: node.h:353
static u8 * format_tx_sm_state(u8 *s, va_list *args)
Definition: node.h:200
u8 port_enabled
Definition: node.h:257
static slave_if_t * bond_get_slave_by_sw_if_index(u32 sw_if_index)
Definition: node.h:503
void vlib_cli_output(vlib_main_t *vm, char *fmt,...)
Definition: cli.c:768
f64 wait_while_timer
Definition: node.h:302
u32 hw_if_index
Definition: node.h:240
int mux_state
Definition: node.h:307
u64 marker_bad_pdu_received
Definition: node.h:335
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:171