FD.io VPP  v19.04.4-rc0-5-ge88582fac
Vector Packet Processing
interface_cli.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2015 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  * interface_cli.c: interface CLI
17  *
18  * Copyright (c) 2008 Eliot Dresselhaus
19  *
20  * Permission is hereby granted, free of charge, to any person obtaining
21  * a copy of this software and associated documentation files (the
22  * "Software"), to deal in the Software without restriction, including
23  * without limitation the rights to use, copy, modify, merge, publish,
24  * distribute, sublicense, and/or sell copies of the Software, and to
25  * permit persons to whom the Software is furnished to do so, subject to
26  * the following conditions:
27  *
28  * The above copyright notice and this permission notice shall be
29  * included in all copies or substantial portions of the Software.
30  *
31  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
32  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
33  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
34  * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
35  * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
36  * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
37  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
38  */
39 
40 /**
41  * @file
42  * @brief Interface CLI.
43  *
44  * Source code for several CLI interface commands.
45  *
46  */
47 
48 #include <vnet/vnet.h>
49 #include <vnet/ip/ip.h>
50 #include <vppinfra/bitmap.h>
51 #include <vnet/fib/ip4_fib.h>
52 #include <vnet/fib/ip6_fib.h>
53 #include <vnet/l2/l2_output.h>
54 #include <vnet/l2/l2_input.h>
55 
56 static int
57 compare_interface_names (void *a1, void *a2)
58 {
59  u32 *hi1 = a1;
60  u32 *hi2 = a2;
61 
62  return vnet_hw_interface_compare (vnet_get_main (), *hi1, *hi2);
63 }
64 
65 static clib_error_t *
67  unformat_input_t * input,
68  vlib_cli_command_t * cmd)
69 {
70  clib_error_t *error = 0;
71  vnet_main_t *vnm = vnet_get_main ();
74  u32 hw_if_index, *hw_if_indices = 0;
75  int i, verbose = -1, is_show, show_bond = 0;
76 
77  is_show = strstr (cmd->path, "show") != 0;
79  {
80  /* See if user wants to show a specific interface. */
81  if (unformat
82  (input, "%U", unformat_vnet_hw_interface, vnm, &hw_if_index))
83  vec_add1 (hw_if_indices, hw_if_index);
84 
85  /* See if user wants to show an interface with a specific hw_if_index. */
86  else if (unformat (input, "%u", &hw_if_index))
87  vec_add1 (hw_if_indices, hw_if_index);
88 
89  else if (unformat (input, "verbose"))
90  verbose = 1; /* this is also the default */
91 
92  else if (unformat (input, "detail"))
93  verbose = 2;
94 
95  else if (unformat (input, "brief"))
96  verbose = 0;
97 
98  else if (unformat (input, "bond"))
99  {
100  show_bond = 1;
101  if (verbose < 0)
102  verbose = 0; /* default to brief for link bonding */
103  }
104 
105  else
106  {
107  error = clib_error_return (0, "unknown input `%U'",
108  format_unformat_error, input);
109  goto done;
110  }
111  }
112 
113  /* Gather interfaces. */
114  if (vec_len (hw_if_indices) == 0)
115  pool_foreach (hi, im->hw_interfaces,
116  vec_add1 (hw_if_indices, hi - im->hw_interfaces));
117 
118  if (verbose < 0)
119  verbose = 1; /* default to verbose (except bond) */
120 
121  if (is_show)
122  {
123  /* Sort by name. */
125 
126  vlib_cli_output (vm, "%U\n", format_vnet_hw_interface, vnm, 0, verbose);
127  for (i = 0; i < vec_len (hw_if_indices); i++)
128  {
129  hi = vnet_get_hw_interface (vnm, hw_if_indices[i]);
130  if (show_bond == 0) /* show all interfaces */
131  vlib_cli_output (vm, "%U\n", format_vnet_hw_interface, vnm,
132  hi, verbose);
133  else if ((hi->bond_info) &&
135  { /* show only bonded interface and all its slave interfaces */
136  int hw_idx;
137  vnet_hw_interface_t *shi;
138  vlib_cli_output (vm, "%U\n", format_vnet_hw_interface, vnm,
139  hi, verbose);
140 
141  /* *INDENT-OFF* */
142  clib_bitmap_foreach (hw_idx, hi->bond_info,
143  ({
144  shi = vnet_get_hw_interface(vnm, hw_idx);
145  vlib_cli_output (vm, "%U\n",
146  format_vnet_hw_interface, vnm, shi, verbose);
147  }));
148  /* *INDENT-ON* */
149  }
150  }
151  }
152  else
153  {
154  for (i = 0; i < vec_len (hw_if_indices); i++)
155  {
157 
158  hi = vnet_get_hw_interface (vnm, hw_if_indices[i]);
160 
161  if (dc->clear_counters)
162  dc->clear_counters (hi->dev_instance);
163  }
164  }
165 
166 done:
167  vec_free (hw_if_indices);
168  return error;
169 }
170 
171 /*?
172  * Display more detailed information about all or a list of given interfaces.
173  * The verboseness of the output can be controlled by the following optional
174  * parameters:
175  * - brief: Only show name, index and state (default for bonded interfaces).
176  * - verbose: Also display additional attributes (default for all other interfaces).
177  * - detail: Also display all remaining attributes and extended statistics.
178  *
179  * To limit the output of the command to bonded interfaces and their slave
180  * interfaces, use the '<em>bond</em>' optional parameter.
181  *
182  * @cliexpar
183  * Example of how to display default data for all interfaces:
184  * @cliexstart{show hardware-interfaces}
185  * Name Idx Link Hardware
186  * GigabitEthernet7/0/0 1 up GigabitEthernet7/0/0
187  * Ethernet address ec:f4:bb:c0:bc:fc
188  * Intel e1000
189  * carrier up full duplex speed 1000 mtu 9216
190  * rx queues 1, rx desc 1024, tx queues 3, tx desc 1024
191  * cpu socket 0
192  * GigabitEthernet7/0/1 2 up GigabitEthernet7/0/1
193  * Ethernet address ec:f4:bb:c0:bc:fd
194  * Intel e1000
195  * carrier up full duplex speed 1000 mtu 9216
196  * rx queues 1, rx desc 1024, tx queues 3, tx desc 1024
197  * cpu socket 0
198  * VirtualEthernet0/0/0 3 up VirtualEthernet0/0/0
199  * Ethernet address 02:fe:a5:a9:8b:8e
200  * VirtualEthernet0/0/1 4 up VirtualEthernet0/0/1
201  * Ethernet address 02:fe:c0:4e:3b:b0
202  * VirtualEthernet0/0/2 5 up VirtualEthernet0/0/2
203  * Ethernet address 02:fe:1f:73:92:81
204  * VirtualEthernet0/0/3 6 up VirtualEthernet0/0/3
205  * Ethernet address 02:fe:f2:25:c4:68
206  * local0 0 down local0
207  * local
208  * @cliexend
209  * Example of how to display '<em>verbose</em>' data for an interface by name and
210  * software index (where 2 is the software index):
211  * @cliexstart{show hardware-interfaces GigabitEthernet7/0/0 2 verbose}
212  * Name Idx Link Hardware
213  * GigabitEthernet7/0/0 1 up GigabitEthernet7/0/0
214  * Ethernet address ec:f4:bb:c0:bc:fc
215  * Intel e1000
216  * carrier up full duplex speed 1000 mtu 9216
217  * rx queues 1, rx desc 1024, tx queues 3, tx desc 1024
218  * cpu socket 0
219  * GigabitEthernet7/0/1 2 down GigabitEthernet7/0/1
220  * Ethernet address ec:f4:bb:c0:bc:fd
221  * Intel e1000
222  * carrier up full duplex speed 1000 mtu 9216
223  * rx queues 1, rx desc 1024, tx queues 3, tx desc 1024
224  * cpu socket 0
225  * @cliexend
226  ?*/
227 /* *INDENT-OFF* */
228 VLIB_CLI_COMMAND (show_hw_interfaces_command, static) = {
229  .path = "show hardware-interfaces",
230  .short_help = "show hardware-interfaces [brief|verbose|detail] [bond] "
231  "[<interface> [<interface> [..]]] [<sw_idx> [<sw_idx> [..]]]",
232  .function = show_or_clear_hw_interfaces,
233 };
234 /* *INDENT-ON* */
235 
236 
237 /*?
238  * Clear the extended statistics for all or a list of given interfaces
239  * (statistics associated with the '<em>show hardware-interfaces</em>' command).
240  *
241  * @cliexpar
242  * Example of how to clear the extended statistics for all interfaces:
243  * @cliexcmd{clear hardware-interfaces}
244  * Example of how to clear the extended statistics for an interface by
245  * name and software index (where 2 is the software index):
246  * @cliexcmd{clear hardware-interfaces GigabitEthernet7/0/0 2}
247  ?*/
248 /* *INDENT-OFF* */
249 VLIB_CLI_COMMAND (clear_hw_interface_counters_command, static) = {
250  .path = "clear hardware-interfaces",
251  .short_help = "clear hardware-interfaces "
252  "[<interface> [<interface> [..]]] [<sw_idx> [<sw_idx> [..]]]",
253  .function = show_or_clear_hw_interfaces,
254 };
255 /* *INDENT-ON* */
256 
257 static int
258 sw_interface_name_compare (void *a1, void *a2)
259 {
260  vnet_sw_interface_t *si1 = a1;
261  vnet_sw_interface_t *si2 = a2;
262 
264  si1->sw_if_index, si2->sw_if_index);
265 }
266 
267 static clib_error_t *
269  unformat_input_t * input, vlib_cli_command_t * cmd)
270 {
271  clib_error_t *error = 0;
272  vnet_main_t *vnm = vnet_get_main ();
273  unformat_input_t _linput, *linput = &_linput;
275  vnet_sw_interface_t *si, *sorted_sis = 0;
276  u32 sw_if_index = ~(u32) 0;
277  u8 show_addresses = 0;
278  u8 show_features = 0;
279  u8 show_tag = 0;
280  int verbose = 0;
281 
282  /*
283  * Get a line of input. Won't work if the user typed
284  * "show interface" and nothing more.
285  */
286  if (unformat_user (input, unformat_line_input, linput))
287  {
288  while (unformat_check_input (linput) != UNFORMAT_END_OF_INPUT)
289  {
290  /* See if user wants to show specific interface */
291  if (unformat
292  (linput, "%U", unformat_vnet_sw_interface, vnm, &sw_if_index))
293  {
294  si = pool_elt_at_index (im->sw_interfaces, sw_if_index);
295  vec_add1 (sorted_sis, si[0]);
296  }
297  else if (unformat (linput, "address") || unformat (linput, "addr"))
298  show_addresses = 1;
299  else if (unformat (linput, "features") || unformat (linput, "feat"))
300  show_features = 1;
301  else if (unformat (linput, "tag"))
302  show_tag = 1;
303  else if (unformat (linput, "verbose"))
304  verbose = 1;
305  else
306  {
307  error = clib_error_return (0, "unknown input `%U'",
308  format_unformat_error, linput);
309  goto done;
310  }
311  }
312  unformat_free (linput);
313  }
314  if (show_features || show_tag)
315  {
316  if (sw_if_index == ~(u32) 0)
317  return clib_error_return (0, "Interface not specified...");
318  }
319 
320  if (show_features)
321  {
322  vnet_interface_features_show (vm, sw_if_index, verbose);
323 
324  l2_input_config_t *l2_input = l2input_intf_config (sw_if_index);
325  u32 fb = l2_input->feature_bitmap;
326  /* intf input features are masked by bridge domain */
327  if (l2_input->bridge)
328  fb &= l2input_bd_config (l2_input->bd_index)->feature_bitmap;
329  vlib_cli_output (vm, "\nl2-input:\n%U", format_l2_input_features, fb,
330  1);
331 
332  l2_output_config_t *l2_output = l2output_intf_config (sw_if_index);
333  vlib_cli_output (vm, "\nl2-output:");
334  if (l2_output->out_vtr_flag)
335  vlib_cli_output (vm, "%10s (%s)", "VTR", "--internal--");
337  l2_output->feature_bitmap, 1);
338  return 0;
339  }
340  if (show_tag)
341  {
342  u8 *tag;
343  tag = vnet_get_sw_interface_tag (vnm, sw_if_index);
344  vlib_cli_output (vm, "%U: %s",
345  format_vnet_sw_if_index_name, vnm, sw_if_index,
346  tag ? (char *) tag : "(none)");
347  return 0;
348  }
349 
350  if (!show_addresses)
351  vlib_cli_output (vm, "%U\n", format_vnet_sw_interface, vnm, 0);
352 
353  if (vec_len (sorted_sis) == 0) /* Get all interfaces */
354  {
355  /* Gather interfaces. */
356  sorted_sis =
358  _vec_len (sorted_sis) = 0;
359  /* *INDENT-OFF* */
360  pool_foreach (si, im->sw_interfaces,
361  ({
362  int visible = vnet_swif_is_api_visible (si);
363  if (visible)
364  vec_add1 (sorted_sis, si[0]);}
365  ));
366  /* *INDENT-ON* */
367  /* Sort by name. */
369  }
370 
371  if (show_addresses)
372  {
373  vec_foreach (si, sorted_sis)
374  {
375  ip4_main_t *im4 = &ip4_main;
376  ip6_main_t *im6 = &ip6_main;
377  ip_lookup_main_t *lm4 = &im4->lookup_main;
378  ip_lookup_main_t *lm6 = &im6->lookup_main;
379  ip_interface_address_t *ia = 0;
380  u32 fib_index4 = 0, fib_index6 = 0;
381 
383  fib_index4 = vec_elt (im4->fib_index_by_sw_if_index,
384  si->sw_if_index);
385 
387  fib_index6 = vec_elt (im6->fib_index_by_sw_if_index,
388  si->sw_if_index);
389 
390  ip4_fib_t *fib4 = ip4_fib_get (fib_index4);
391  ip6_fib_t *fib6 = ip6_fib_get (fib_index6);
392 
395  (vm, "%U (%s): \n unnumbered, use %U",
397  (si->flags & VNET_SW_INTERFACE_FLAG_ADMIN_UP) ? "up" : "dn",
399  else
401  (vm, "%U (%s):",
403  (si->flags & VNET_SW_INTERFACE_FLAG_ADMIN_UP) ? "up" : "dn");
404 
405  /* Display any L2 info */
407  if (l2_input->bridge)
408  {
409  bd_main_t *bdm = &bd_main;
411  vlib_cli_output (vm, " L2 bridge bd-id %d idx %d shg %d %s",
412  bd_id, bd_find_index (bdm, bd_id), l2_input->shg,
413  l2_input->bvi ? "bvi" : " ");
414  }
415  else if (l2_input->xconnect)
416  vlib_cli_output (vm, " L2 xconnect %U",
418  l2_input->output_sw_if_index);
419 
420  /* *INDENT-OFF* */
421  /* Display any IP4 addressing info */
423  1 /* honor unnumbered */,
424  ({
425  ip4_address_t *r4 = ip_interface_address_get_address (lm4, ia);
426  if (fib4->table_id)
427  vlib_cli_output (vm, " L3 %U/%d ip4 table-id %d fib-idx %d",
428  format_ip4_address, r4, ia->address_length,
429  fib4->table_id,
430  ip4_fib_index_from_table_id (fib4->table_id));
431  else
432  vlib_cli_output (vm, " L3 %U/%d",
433  format_ip4_address, r4, ia->address_length);
434  }));
435  /* *INDENT-ON* */
436 
437  /* *INDENT-OFF* */
438  /* Display any IP6 addressing info */
440  1 /* honor unnumbered */,
441  ({
442  ip6_address_t *r6 = ip_interface_address_get_address (lm6, ia);
443  if (fib6->table_id)
444  vlib_cli_output (vm, " L3 %U/%d ip6 table-id %d fib-idx %d",
445  format_ip6_address, r6, ia->address_length,
446  fib6->table_id,
447  ip6_fib_index_from_table_id (fib6->table_id));
448  else
449  vlib_cli_output (vm, " L3 %U/%d",
450  format_ip6_address, r6, ia->address_length);
451  }));
452  /* *INDENT-ON* */
453  }
454  }
455  else
456  {
457  vec_foreach (si, sorted_sis)
458  {
459  vlib_cli_output (vm, "%U\n", format_vnet_sw_interface, vnm, si);
460  }
461  }
462 
463 done:
464  vec_free (sorted_sis);
465  return error;
466 }
467 
468 /* *INDENT-OFF* */
469 VLIB_CLI_COMMAND (show_sw_interfaces_command, static) = {
470  .path = "show interface",
471  .short_help = "show interface [address|addr|features|feat] [<interface> [<interface> [..]]] [verbose]",
472  .function = show_sw_interfaces,
473  .is_mp_safe = 1,
474 };
475 /* *INDENT-ON* */
476 
477 /* Root of all interface commands. */
478 /* *INDENT-OFF* */
479 VLIB_CLI_COMMAND (vnet_cli_interface_command, static) = {
480  .path = "interface",
481  .short_help = "Interface commands",
482 };
483 /* *INDENT-ON* */
484 
485 /* *INDENT-OFF* */
486 VLIB_CLI_COMMAND (vnet_cli_set_interface_command, static) = {
487  .path = "set interface",
488  .short_help = "Interface commands",
489 };
490 /* *INDENT-ON* */
491 
492 static clib_error_t *
494  unformat_input_t * input, vlib_cli_command_t * cmd)
495 {
496  vnet_main_t *vnm = vnet_get_main ();
500  static vnet_main_t **my_vnet_mains;
501  int i, j, n_counters;
502 
503  vec_reset_length (my_vnet_mains);
504 
505  for (i = 0; i < vec_len (vnet_mains); i++)
506  {
507  if (vnet_mains[i])
508  vec_add1 (my_vnet_mains, vnet_mains[i]);
509  }
510 
511  if (vec_len (vnet_mains) == 0)
512  vec_add1 (my_vnet_mains, vnm);
513 
514  n_counters = vec_len (im->combined_sw_if_counters);
515 
516  for (j = 0; j < n_counters; j++)
517  {
518  for (i = 0; i < vec_len (my_vnet_mains); i++)
519  {
520  im = &my_vnet_mains[i]->interface_main;
521  cm = im->combined_sw_if_counters + j;
523  }
524  }
525 
526  n_counters = vec_len (im->sw_if_counters);
527 
528  for (j = 0; j < n_counters; j++)
529  {
530  for (i = 0; i < vec_len (my_vnet_mains); i++)
531  {
532  im = &my_vnet_mains[i]->interface_main;
533  sm = im->sw_if_counters + j;
535  }
536  }
537 
538  return 0;
539 }
540 
541 /*?
542  * Clear the statistics for all interfaces (statistics associated with the
543  * '<em>show interface</em>' command).
544  *
545  * @cliexpar
546  * Example of how to clear the statistics for all interfaces:
547  * @cliexcmd{clear interfaces}
548  ?*/
549 /* *INDENT-OFF* */
550 VLIB_CLI_COMMAND (clear_interface_counters_command, static) = {
551  .path = "clear interfaces",
552  .short_help = "clear interfaces",
553  .function = clear_interface_counters,
554 };
555 /* *INDENT-ON* */
556 
557 /**
558  * Parse subinterface names.
559  *
560  * The following subinterface syntax is supported. The first two are for
561  * backwards compatability:
562  *
563  * <intf-name> <id>
564  * - a subinterface with the name <intf-name>.<id>. The subinterface
565  * is a single dot1q vlan with vlan id <id> and exact-match semantics.
566  *
567  * <intf-name> <min_id>-<max_id>
568  * - a set of the above subinterfaces, repeating for each id
569  * in the range <min_id> to <max_id>
570  *
571  * In the following, exact-match semantics (i.e. the number of vlan tags on the
572  * packet must match the number of tags in the configuration) are used only if
573  * the keyword exact-match is present. Non-exact match is the default.
574  *
575  * <intf-name> <id> dot1q <outer_id> [exact-match]
576  * - a subinterface with the name <intf-name>.<id>. The subinterface
577  * is a single dot1q vlan with vlan id <outer_id>.
578  *
579  * <intf-name> <id> dot1q any [exact-match]
580  * - a subinterface with the name <intf-name>.<id>. The subinterface
581  * is a single dot1q vlan with any vlan id.
582  *
583  * <intf-name> <id> dot1q <outer_id> inner-dot1q <inner_id> [exact-match]
584  * - a subinterface with the name <intf-name>.<id>. The subinterface
585  * is a double dot1q vlan with outer vlan id <outer_id> and inner vlan id
586  * <inner_id>.
587  *
588  * <intf-name> <id> dot1q <outer_id> inner-dot1q any [exact-match]
589  * - a subinterface with the name <intf-name>.<id>. The subinterface
590  * is a double dot1q vlan with outer vlan id <id> and any inner vlan id.
591  *
592  * <intf-name> <id> dot1q any inner-dot1q any [exact-match]
593  *
594  * - a subinterface with the name <intf-name>.<id>. The subinterface
595  * is a double dot1q vlan with any outer vlan id and any inner vlan id.
596  *
597  * For each of the above CLI, there is a duplicate that uses the keyword
598  * "dot1ad" in place of the first "dot1q". These interfaces use ethertype
599  * 0x88ad in place of 0x8100 for the outer ethertype. Note that for double-
600  * tagged packets the inner ethertype is always 0x8100. Also note that
601  * the dot1q and dot1ad naming spaces are independent, so it is legal to
602  * have both "Gig3/0/0.1 dot1q 100" and "Gig3/0/0.2 dot1ad 100". For example:
603  *
604  * <intf-name> <id> dot1ad <outer_id> inner-dot1q <inner_id> [exact-match]
605  * - a subinterface with the name <intf-name>.<id>. The subinterface
606  * is a double dot1ad vlan with outer vlan id <outer_id> and inner vlan
607  * id <inner_id>.
608  *
609  * <intf-name> <id> untagged
610  * - a subinterface with the name <intf-name>.<id>. The subinterface
611  * has no vlan tags. Only one can be specified per interface.
612  *
613  * <intf-name> <id> default
614  * - a subinterface with the name <intf-name>.<id>. This is associated
615  * with a packet that did not match any other configured subinterface
616  * on this interface. Only one can be specified per interface.
617  */
618 
619 static clib_error_t *
621  vnet_sw_interface_t * template)
622 {
623  clib_error_t *error = 0;
624  u32 inner_vlan, outer_vlan;
625 
626  if (unformat (input, "any inner-dot1q any"))
627  {
628  template->sub.eth.flags.two_tags = 1;
629  template->sub.eth.flags.outer_vlan_id_any = 1;
630  template->sub.eth.flags.inner_vlan_id_any = 1;
631  }
632  else if (unformat (input, "any"))
633  {
634  template->sub.eth.flags.one_tag = 1;
635  template->sub.eth.flags.outer_vlan_id_any = 1;
636  }
637  else if (unformat (input, "%d inner-dot1q any", &outer_vlan))
638  {
639  template->sub.eth.flags.two_tags = 1;
640  template->sub.eth.flags.inner_vlan_id_any = 1;
641  template->sub.eth.outer_vlan_id = outer_vlan;
642  }
643  else if (unformat (input, "%d inner-dot1q %d", &outer_vlan, &inner_vlan))
644  {
645  template->sub.eth.flags.two_tags = 1;
646  template->sub.eth.outer_vlan_id = outer_vlan;
647  template->sub.eth.inner_vlan_id = inner_vlan;
648  }
649  else if (unformat (input, "%d", &outer_vlan))
650  {
651  template->sub.eth.flags.one_tag = 1;
652  template->sub.eth.outer_vlan_id = outer_vlan;
653  }
654  else
655  {
656  error = clib_error_return (0, "expected dot1q config, got `%U'",
657  format_unformat_error, input);
658  goto done;
659  }
660 
662  {
663  if (unformat (input, "exact-match"))
664  {
665  template->sub.eth.flags.exact_match = 1;
666  }
667  }
668 
669 done:
670  return error;
671 }
672 
673 static clib_error_t *
675  unformat_input_t * input, vlib_cli_command_t * cmd)
676 {
677  vnet_main_t *vnm = vnet_get_main ();
678  clib_error_t *error = 0;
679  u32 hw_if_index, sw_if_index;
681  u32 id, id_min, id_max;
682  vnet_sw_interface_t template;
683 
684  hw_if_index = ~0;
685  if (!unformat_user (input, unformat_vnet_hw_interface, vnm, &hw_if_index))
686  {
687  error = clib_error_return (0, "unknown interface `%U'",
688  format_unformat_error, input);
689  goto done;
690  }
691 
692  clib_memset (&template, 0, sizeof (template));
693  template.sub.eth.raw_flags = 0;
694 
695  if (unformat (input, "%d default", &id_min))
696  {
697  id_max = id_min;
698  template.sub.eth.flags.default_sub = 1;
699  }
700  else if (unformat (input, "%d untagged", &id_min))
701  {
702  id_max = id_min;
703  template.sub.eth.flags.no_tags = 1;
704  template.sub.eth.flags.exact_match = 1;
705  }
706  else if (unformat (input, "%d dot1q", &id_min))
707  {
708  /* parse dot1q config */
709  id_max = id_min;
710  error = parse_vlan_sub_interfaces (input, &template);
711  if (error)
712  goto done;
713  }
714  else if (unformat (input, "%d dot1ad", &id_min))
715  {
716  /* parse dot1ad config */
717  id_max = id_min;
718  template.sub.eth.flags.dot1ad = 1;
719  error = parse_vlan_sub_interfaces (input, &template);
720  if (error)
721  goto done;
722  }
723  else if (unformat (input, "%d-%d", &id_min, &id_max))
724  {
725  template.sub.eth.flags.one_tag = 1;
726  template.sub.eth.flags.exact_match = 1;
727  if (id_min > id_max)
728  goto id_error;
729  }
730  else if (unformat (input, "%d", &id_min))
731  {
732  id_max = id_min;
733  template.sub.eth.flags.one_tag = 1;
734  template.sub.eth.outer_vlan_id = id_min;
735  template.sub.eth.flags.exact_match = 1;
736  }
737  else
738  {
739  id_error:
740  error = clib_error_return (0, "expected ID or ID MIN-MAX, got `%U'",
741  format_unformat_error, input);
742  goto done;
743  }
744 
745  hi = vnet_get_hw_interface (vnm, hw_if_index);
746 
748  {
749  error =
751  "not allowed as %v belong to a BondEthernet interface",
752  hi->name);
753  goto done;
754  }
755 
756  for (id = id_min; id <= id_max; id++)
757  {
758  uword *p;
760  u64 sup_and_sub_key = ((u64) (hi->sw_if_index) << 32) | (u64) id;
761  u64 *kp;
762 
763  p = hash_get_mem (im->sw_if_index_by_sup_and_sub, &sup_and_sub_key);
764  if (p)
765  {
766  if (CLIB_DEBUG > 0)
767  clib_warning ("sup sw_if_index %d, sub id %d already exists\n",
768  hi->sw_if_index, id);
769  continue;
770  }
771 
772  kp = clib_mem_alloc (sizeof (*kp));
773  *kp = sup_and_sub_key;
774 
775  template.type = VNET_SW_INTERFACE_TYPE_SUB;
776  template.flood_class = VNET_FLOOD_CLASS_NORMAL;
777  template.sup_sw_if_index = hi->sw_if_index;
778  template.sub.id = id;
779  if (id_min < id_max)
780  template.sub.eth.outer_vlan_id = id;
781 
782  error = vnet_create_sw_interface (vnm, &template, &sw_if_index);
783  if (error)
784  goto done;
785 
786  hash_set (hi->sub_interface_sw_if_index_by_id, id, sw_if_index);
787  hash_set_mem (im->sw_if_index_by_sup_and_sub, kp, sw_if_index);
789  vnet_get_main (), sw_if_index);
790  }
791 
792 done:
793  return error;
794 }
795 
796 /*?
797  * This command is used to add VLAN IDs to interfaces, also known as subinterfaces.
798  * The primary input to this command is the '<em>interface</em>' and '<em>subId</em>'
799  * (subinterface Id) parameters. If no additional VLAN ID is provide, the VLAN ID is
800  * assumed to be the '<em>subId</em>'. The VLAN ID and '<em>subId</em>' can be different,
801  * but this is not recommended.
802  *
803  * This command has several variations:
804  * - <b>create sub-interfaces <interface> <subId></b> - Create a subinterface to
805  * process packets with a given 802.1q VLAN ID (same value as the '<em>subId</em>').
806  *
807  * - <b>create sub-interfaces <interface> <subId> default</b> - Adding the
808  * '<em>default</em>' parameter indicates that packets with VLAN IDs that do not
809  * match any other subinterfaces should be sent to this subinterface.
810  *
811  * - <b>create sub-interfaces <interface> <subId> untagged</b> - Adding the
812  * '<em>untagged</em>' parameter indicates that packets no VLAN IDs should be sent
813  * to this subinterface.
814  *
815  * - <b>create sub-interfaces <interface> <subId>-<subId></b> - Create a range of
816  * subinterfaces to handle a range of VLAN IDs.
817  *
818  * - <b>create sub-interfaces <interface> <subId> dot1q|dot1ad <vlanId>|any [exact-match]</b> -
819  * Use this command to specify the outer VLAN ID, to either be explicit or to make the
820  * VLAN ID different from the '<em>subId</em>'.
821  *
822  * - <b>create sub-interfaces <interface> <subId> dot1q|dot1ad <vlanId>|any inner-dot1q
823  * <vlanId>|any [exact-match]</b> - Use this command to specify the outer VLAN ID and
824  * the inner VLAN ID.
825  *
826  * When '<em>dot1q</em>' or '<em>dot1ad</em>' is explicitly entered, subinterfaces
827  * can be configured as either exact-match or non-exact match. Non-exact match is the CLI
828  * default. If '<em>exact-match</em>' is specified, packets must have the same number of
829  * VLAN tags as the configuration. For non-exact-match, packets must at least that number
830  * of tags. L3 (routed) interfaces must be configured as exact-match. L2 interfaces are
831  * typically configured as non-exact-match. If '<em>dot1q</em>' or '<em>dot1ad</em>' is NOT
832  * entered, then the default behavior is exact-match.
833  *
834  * Use the '<em>show interface</em>' command to display all subinterfaces.
835  *
836  * @cliexpar
837  * @parblock
838  * Example of how to create a VLAN subinterface 11 to process packets on 802.1q VLAN ID 11:
839  * @cliexcmd{create sub-interfaces GigabitEthernet2/0/0 11}
840  *
841  * The previous example is shorthand and is equivalent to:
842  * @cliexcmd{create sub-interfaces GigabitEthernet2/0/0 11 dot1q 11 exact-match}
843  *
844  *
845  * Example of how to create a subinterface number that is different from the VLAN ID:
846  * @cliexcmd{create sub-interfaces GigabitEthernet2/0/0 11 dot1q 100}
847  *
848  *
849  * Examples of how to create q-in-q and q-in-any subinterfaces:
850  * @cliexcmd{create sub-interfaces GigabitEthernet2/0/0 11 dot1q 100 inner-dot1q 200}
851  * @cliexcmd{create sub-interfaces GigabitEthernet2/0/0 12 dot1q 100 inner-dot1q any}
852  *
853  * Examples of how to create dot1ad interfaces:
854  * @cliexcmd{create sub-interfaces GigabitEthernet2/0/0 11 dot1ad 11}
855  * @cliexcmd{create sub-interfaces GigabitEthernet2/0/0 12 dot1ad 100 inner-dot1q 200}
856  *
857  *
858  * Examples of '<em>exact-match</em>' versus non-exact match. A packet with
859  * outer VLAN 100 and inner VLAN 200 would match this interface, because the default
860  * is non-exact match:
861  * @cliexcmd{create sub-interfaces GigabitEthernet2/0/0 5 dot1q 100}
862  *
863  * However, the same packet would NOT match this interface because '<em>exact-match</em>'
864  * is specified and only one VLAN is configured, but packet contains two VLANs:
865  * @cliexcmd{create sub-interfaces GigabitEthernet2/0/0 5 dot1q 100 exact-match}
866  *
867  *
868  * Example of how to created a subinterface to process untagged packets:
869  * @cliexcmd{create sub-interfaces GigabitEthernet2/0/0 5 untagged}
870  *
871  * Example of how to created a subinterface to process any packet with a VLAN ID that
872  * does not match any other subinterface:
873  * @cliexcmd{create sub-interfaces GigabitEthernet2/0/0 7 default}
874  *
875  * When subinterfaces are created, they are in the down state. Example of how to
876  * enable a newly created subinterface:
877  * @cliexcmd{set interface GigabitEthernet2/0/0.7 up}
878  * @endparblock
879  ?*/
880 /* *INDENT-OFF* */
881 VLIB_CLI_COMMAND (create_sub_interfaces_command, static) = {
882  .path = "create sub-interfaces",
883  .short_help = "create sub-interfaces <interface> "
884  "{<subId> [default|untagged]} | "
885  "{<subId>-<subId>} | "
886  "{<subId> dot1q|dot1ad <vlanId>|any [inner-dot1q <vlanId>|any] [exact-match]}",
887  .function = create_sub_interfaces,
888 };
889 /* *INDENT-ON* */
890 
891 static clib_error_t *
893  unformat_input_t * input, vlib_cli_command_t * cmd)
894 {
895  vnet_main_t *vnm = vnet_get_main ();
896  clib_error_t *error;
898 
899  sw_if_index = ~0;
900  if (!unformat_user (input, unformat_vnet_sw_interface, vnm, &sw_if_index))
901  {
902  error = clib_error_return (0, "unknown interface `%U'",
903  format_unformat_error, input);
904  goto done;
905  }
906 
907  if (!unformat (input, "%U", unformat_vnet_sw_interface_flags, &flags))
908  {
909  error = clib_error_return (0, "unknown flags `%U'",
910  format_unformat_error, input);
911  goto done;
912  }
913 
914  error = vnet_sw_interface_set_flags (vnm, sw_if_index, flags);
915  if (error)
916  goto done;
917 
918 done:
919  return error;
920 }
921 
922 
923 /*?
924  * This command is used to change the admin state (up/down) of an interface.
925  *
926  * If an interface is down, the optional '<em>punt</em>' flag can also be set.
927  * The '<em>punt</em>' flag implies the interface is disabled for forwarding
928  * but punt all traffic to slow-path. Use the '<em>enable</em>' flag to clear
929  * '<em>punt</em>' flag (interface is still down).
930  *
931  * @cliexpar
932  * Example of how to configure the admin state of an interface to '<em>up</em?':
933  * @cliexcmd{set interface state GigabitEthernet2/0/0 up}
934  * Example of how to configure the admin state of an interface to '<em>down</em?':
935  * @cliexcmd{set interface state GigabitEthernet2/0/0 down}
936  ?*/
937 /* *INDENT-OFF* */
938 VLIB_CLI_COMMAND (set_state_command, static) = {
939  .path = "set interface state",
940  .short_help = "set interface state <interface> [up|down|punt|enable]",
941  .function = set_state,
942 };
943 /* *INDENT-ON* */
944 
945 static clib_error_t *
947  unformat_input_t * input, vlib_cli_command_t * cmd)
948 {
949  vnet_main_t *vnm = vnet_get_main ();
950  u32 unnumbered_sw_if_index = ~0;
951  u32 inherit_from_sw_if_index = ~0;
952  int enable = 1;
953 
954  if (unformat (input, "%U use %U",
955  unformat_vnet_sw_interface, vnm, &unnumbered_sw_if_index,
956  unformat_vnet_sw_interface, vnm, &inherit_from_sw_if_index))
957  enable = 1;
958  else if (unformat (input, "del %U",
960  &unnumbered_sw_if_index))
961  enable = 0;
962  else
963  return clib_error_return (0, "parse error '%U'",
964  format_unformat_error, input);
965 
966  if (~0 == unnumbered_sw_if_index)
967  return clib_error_return (0, "Specify the unnumbered interface");
968  if (enable && ~0 == inherit_from_sw_if_index)
969  return clib_error_return (0, "When enabling unnumbered specify the"
970  " IP enabled interface that it uses");
971 
972  vnet_sw_interface_update_unnumbered (unnumbered_sw_if_index,
973  inherit_from_sw_if_index, enable);
974 
975  return (NULL);
976 }
977 
978 /* *INDENT-OFF* */
979 VLIB_CLI_COMMAND (set_unnumbered_command, static) = {
980  .path = "set interface unnumbered",
981  .short_help = "set interface unnumbered [<interface> use <interface> | del <interface>]",
982  .function = set_unnumbered,
983 };
984 /* *INDENT-ON* */
985 
986 
987 
988 static clib_error_t *
990  unformat_input_t * input, vlib_cli_command_t * cmd)
991 {
992  vnet_main_t *vnm = vnet_get_main ();
994  clib_error_t *error;
995  u32 hw_if_index, hw_class_index;
996 
997  hw_if_index = ~0;
998  if (!unformat_user (input, unformat_vnet_hw_interface, vnm, &hw_if_index))
999  {
1000  error = clib_error_return (0, "unknown hardware interface `%U'",
1001  format_unformat_error, input);
1002  goto done;
1003  }
1004 
1005  if (!unformat_user (input, unformat_hash_string,
1006  im->hw_interface_class_by_name, &hw_class_index))
1007  {
1008  error = clib_error_return (0, "unknown hardware class `%U'",
1009  format_unformat_error, input);
1010  goto done;
1011  }
1012 
1013  error = vnet_hw_interface_set_class (vnm, hw_if_index, hw_class_index);
1014  if (error)
1015  goto done;
1016 
1017 done:
1018  return error;
1019 }
1020 
1021 /* *INDENT-OFF* */
1022 VLIB_CLI_COMMAND (set_hw_class_command, static) = {
1023  .path = "set interface hw-class",
1024  .short_help = "Set interface hardware class",
1025  .function = set_hw_class,
1026 };
1027 /* *INDENT-ON* */
1028 
1029 static clib_error_t *
1031 {
1032  return 0;
1033 }
1034 
1036 
1037 static clib_error_t *
1039  unformat_input_t * input,
1040  vlib_cli_command_t * cmd)
1041 {
1042  u32 hw_if_index;
1043  u32 new_dev_instance;
1044  vnet_main_t *vnm = vnet_get_main ();
1045  int rv;
1046 
1047  if (!unformat_user (input, unformat_vnet_hw_interface, vnm, &hw_if_index))
1048  return clib_error_return (0, "unknown hardware interface `%U'",
1049  format_unformat_error, input);
1050 
1051  if (!unformat (input, "%d", &new_dev_instance))
1052  return clib_error_return (0, "new dev instance missing");
1053 
1054  rv = vnet_interface_name_renumber (hw_if_index, new_dev_instance);
1055 
1056  switch (rv)
1057  {
1058  case 0:
1059  break;
1060 
1061  default:
1062  return clib_error_return (0, "vnet_interface_name_renumber returned %d",
1063  rv);
1064 
1065  }
1066 
1067  return 0;
1068 }
1069 
1070 
1071 /* *INDENT-OFF* */
1072 VLIB_CLI_COMMAND (renumber_interface_command, static) = {
1073  .path = "renumber interface",
1074  .short_help = "renumber interface <interface> <new-dev-instance>",
1075  .function = renumber_interface_command_fn,
1076 };
1077 /* *INDENT-ON* */
1078 
1079 static clib_error_t *
1081  unformat_input_t * input, vlib_cli_command_t * cmd)
1082 {
1083  vnet_main_t *vnm = vnet_get_main ();
1084  u32 hw_if_index;
1087  ethernet_interface_t *eif;
1088 
1089  if (unformat (input, "on %U",
1090  unformat_vnet_hw_interface, vnm, &hw_if_index))
1091  ;
1092  else if (unformat (input, "off %U",
1093  unformat_ethernet_interface, vnm, &hw_if_index))
1094  flags = 0;
1095  else
1096  return clib_error_return (0, "unknown input `%U'",
1097  format_unformat_error, input);
1098 
1099  eif = ethernet_get_interface (em, hw_if_index);
1100  if (!eif)
1101  return clib_error_return (0, "not supported");
1102 
1103  ethernet_set_flags (vnm, hw_if_index, flags);
1104  return 0;
1105 }
1106 
1107 /* *INDENT-OFF* */
1108 VLIB_CLI_COMMAND (set_interface_promiscuous_cmd, static) = {
1109  .path = "set interface promiscuous",
1110  .short_help = "set interface promiscuous [on|off] <interface>",
1111  .function = promiscuous_cmd,
1112 };
1113 /* *INDENT-ON* */
1114 
1115 static clib_error_t *
1117 {
1118  vnet_main_t *vnm = vnet_get_main ();
1119  u32 hw_if_index, sw_if_index, mtu;
1121  u32 mtus[VNET_N_MTU] = { 0, 0, 0, 0 };
1122 
1123  if (unformat (input, "%d %U", &mtu,
1124  unformat_vnet_hw_interface, vnm, &hw_if_index))
1125  {
1126  /*
1127  * Change physical MTU on interface. Only supported for Ethernet
1128  * interfaces
1129  */
1130  vnet_hw_interface_t *hi = vnet_get_hw_interface (vnm, hw_if_index);
1131  ethernet_interface_t *eif = ethernet_get_interface (em, hw_if_index);
1132 
1133  if (!eif)
1134  return clib_error_return (0, "not supported");
1135 
1136  if (mtu < hi->min_supported_packet_bytes)
1137  return clib_error_return (0, "Invalid mtu (%d): "
1138  "must be >= min pkt bytes (%d)", mtu,
1140 
1141  if (mtu > hi->max_supported_packet_bytes)
1142  return clib_error_return (0, "Invalid mtu (%d): must be <= (%d)", mtu,
1144 
1145  vnet_hw_interface_set_mtu (vnm, hw_if_index, mtu);
1146  goto done;
1147  }
1148  else if (unformat (input, "packet %d %U", &mtu,
1149  unformat_vnet_sw_interface, vnm, &sw_if_index))
1150  /* Set default packet MTU (including L3 header */
1151  mtus[VNET_MTU_L3] = mtu;
1152  else if (unformat (input, "ip4 %d %U", &mtu,
1153  unformat_vnet_sw_interface, vnm, &sw_if_index))
1154  mtus[VNET_MTU_IP4] = mtu;
1155  else if (unformat (input, "ip6 %d %U", &mtu,
1156  unformat_vnet_sw_interface, vnm, &sw_if_index))
1157  mtus[VNET_MTU_IP6] = mtu;
1158  else if (unformat (input, "mpls %d %U", &mtu,
1159  unformat_vnet_sw_interface, vnm, &sw_if_index))
1160  mtus[VNET_MTU_MPLS] = mtu;
1161  else
1162  return clib_error_return (0, "unknown input `%U'",
1163  format_unformat_error, input);
1164 
1165  vnet_sw_interface_set_protocol_mtu (vnm, sw_if_index, mtus);
1166 
1167 done:
1168  return 0;
1169 }
1170 
1171 /* *INDENT-OFF* */
1172 VLIB_CLI_COMMAND (set_interface_mtu_cmd, static) = {
1173  .path = "set interface mtu",
1174  .short_help = "set interface mtu [packet|ip4|ip6|mpls] <value> <interface>",
1175  .function = mtu_cmd,
1176 };
1177 /* *INDENT-ON* */
1178 
1179 static clib_error_t *
1181  vlib_cli_command_t * cmd)
1182 {
1183  vnet_main_t *vnm = vnet_get_main ();
1184  vnet_sw_interface_t *si = NULL;
1185  clib_error_t *error = 0;
1186  u32 sw_if_index = ~0;
1187  u8 mac[6] = { 0 };
1188 
1189  if (!unformat_user (input, unformat_vnet_sw_interface, vnm, &sw_if_index))
1190  {
1191  error = clib_error_return (0, "unknown interface `%U'",
1192  format_unformat_error, input);
1193  goto done;
1194  }
1195  if (!unformat_user (input, unformat_ethernet_address, mac))
1196  {
1197  error = clib_error_return (0, "expected mac address `%U'",
1198  format_unformat_error, input);
1199  goto done;
1200  }
1201  si = vnet_get_sw_interface (vnm, sw_if_index);
1202  error = vnet_hw_interface_change_mac_address (vnm, si->hw_if_index, mac);
1203 done:
1204  return error;
1205 }
1206 
1207 /*?
1208  * The '<em>set interface mac address </em>' command allows to set MAC address of given interface.
1209  * In case of NIC interfaces the one has to support MAC address change. A side effect of MAC address
1210  * change are changes of MAC addresses in FIB tables (ipv4 and ipv6).
1211  *
1212  * @cliexpar
1213  * @parblock
1214  * Example of how to change MAC Address of interface:
1215  * @cliexcmd{set interface mac address GigabitEthernet0/8/0 aa:bb:cc:dd:ee:01}
1216  * @cliexcmd{set interface mac address host-vpp0 aa:bb:cc:dd:ee:02}
1217  * @cliexcmd{set interface mac address tap-0 aa:bb:cc:dd:ee:03}
1218  * @cliexcmd{set interface mac address pg0 aa:bb:cc:dd:ee:04}
1219  * @endparblock
1220 ?*/
1221 /* *INDENT-OFF* */
1222 VLIB_CLI_COMMAND (set_interface_mac_address_cmd, static) = {
1223  .path = "set interface mac address",
1224  .short_help = "set interface mac address <interface> <mac-address>",
1225  .function = set_interface_mac_address,
1226 };
1227 /* *INDENT-ON* */
1228 
1229 static clib_error_t *
1231 {
1232  vnet_main_t *vnm = vnet_get_main ();
1233  u32 sw_if_index = ~0;
1234  u8 *tag = 0;
1235 
1236  if (!unformat (input, "%U %s", unformat_vnet_sw_interface,
1237  vnm, &sw_if_index, &tag))
1238  return clib_error_return (0, "unknown input `%U'",
1239  format_unformat_error, input);
1240 
1241  vnet_set_sw_interface_tag (vnm, tag, sw_if_index);
1242 
1243  return 0;
1244 }
1245 
1246 /* *INDENT-OFF* */
1247 VLIB_CLI_COMMAND (set_tag_command, static) = {
1248  .path = "set interface tag",
1249  .short_help = "set interface tag <interface> <tag>",
1250  .function = set_tag,
1251 };
1252 /* *INDENT-ON* */
1253 
1254 static clib_error_t *
1256  vlib_cli_command_t * cmd)
1257 {
1258  vnet_main_t *vnm = vnet_get_main ();
1259  u32 sw_if_index = ~0;
1260 
1261  if (!unformat (input, "%U", unformat_vnet_sw_interface, vnm, &sw_if_index))
1262  return clib_error_return (0, "unknown input `%U'",
1263  format_unformat_error, input);
1264 
1265  vnet_clear_sw_interface_tag (vnm, sw_if_index);
1266 
1267  return 0;
1268 }
1269 
1270 /* *INDENT-OFF* */
1271 VLIB_CLI_COMMAND (clear_tag_command, static) = {
1272  .path = "clear interface tag",
1273  .short_help = "clear interface tag <interface>",
1274  .function = clear_tag,
1275 };
1276 /* *INDENT-ON* */
1277 
1278 static clib_error_t *
1280  unformat_input_t * input, vlib_cli_command_t * cmd)
1281 {
1282  vnet_main_t *vnm = vnet_get_main ();
1283  u32 sw_if_index = ~0;
1284  u8 enable = 0;
1285 
1286  if (!unformat (input, "%U", unformat_vnet_sw_interface, vnm, &sw_if_index));
1287  else if (unformat (input, "enable"))
1288  enable = 1;
1289  else if (unformat (input, "disable"))
1290  enable = 0;
1291  else
1292  return clib_error_return (0, "unknown input: `%U'",
1293  format_unformat_error, input);
1294 
1295  if (~0 == sw_if_index)
1296  return clib_error_return (0, "specify an interface: `%U'",
1297  format_unformat_error, input);
1298 
1299  vnet_sw_interface_ip_directed_broadcast (vnm, sw_if_index, enable);
1300 
1301  return 0;
1302 }
1303 
1304 /*?
1305  * This command is used to enable/disable IP directed broadcast
1306  * If directed broadcast is enabled a packet sent to the interface's
1307  * subnet broadcast address will be sent L2 broadcast on the interface,
1308  * otherwise it is dropped.
1309  ?*/
1310 /* *INDENT-OFF* */
1311 VLIB_CLI_COMMAND (set_ip_directed_broadcast_command, static) = {
1312  .path = "set interface ip directed-broadcast",
1313  .short_help = "set interface enable <interface> <enable|disable>",
1314  .function = set_ip_directed_broadcast,
1315 };
1316 /* *INDENT-ON* */
1317 
1318 static clib_error_t *
1321 {
1322  vnet_hw_interface_t *hw = vnet_get_hw_interface (vnm, hw_if_index);
1323  vnet_device_class_t *dev_class =
1325  clib_error_t *error;
1326  vnet_hw_interface_rx_mode old_mode;
1327  int rv;
1328 
1330  mode = hw->default_rx_mode;
1331 
1332  rv = vnet_hw_interface_get_rx_mode (vnm, hw_if_index, queue_id, &old_mode);
1333  switch (rv)
1334  {
1335  case 0:
1336  if (old_mode == mode)
1337  return 0; /* same rx-mode, no change */
1338  break;
1339  case VNET_API_ERROR_INVALID_INTERFACE:
1340  return clib_error_return (0, "invalid interface");
1341  case VNET_API_ERROR_INVALID_QUEUE:
1342  return clib_error_return (0, "invalid queue");
1343  default:
1344  return clib_error_return (0, "unknown error");
1345  }
1346 
1347  if (dev_class->rx_mode_change_function)
1348  {
1349  error = dev_class->rx_mode_change_function (vnm, hw_if_index, queue_id,
1350  mode);
1351  if (error)
1352  return (error);
1353  }
1354 
1355  rv = vnet_hw_interface_set_rx_mode (vnm, hw_if_index, queue_id, mode);
1356  switch (rv)
1357  {
1358  case 0:
1359  break;
1360  case VNET_API_ERROR_UNSUPPORTED:
1361  return clib_error_return (0, "unsupported");
1362  case VNET_API_ERROR_INVALID_INTERFACE:
1363  return clib_error_return (0, "invalid interface");
1364  case VNET_API_ERROR_INVALID_QUEUE:
1365  return clib_error_return (0, "invalid queue");
1366  default:
1367  return clib_error_return (0, "unknown error");
1368  }
1369 
1370  return 0;
1371 }
1372 
1373 clib_error_t *
1375  u8 queue_id_valid, u32 queue_id,
1377 {
1378  clib_error_t *error = 0;
1379  vnet_hw_interface_t *hw;
1380  int i;
1381 
1382  hw = vnet_get_hw_interface (vnm, hw_if_index);
1383 
1384  if (queue_id_valid == 0)
1385  {
1386  for (i = 0; i < vec_len (hw->dq_runtime_index_by_queue); i++)
1387  {
1388  error = set_hw_interface_rx_mode (vnm, hw_if_index, i, mode);
1389  if (error)
1390  break;
1391  }
1392  hw->default_rx_mode = mode;
1393  }
1394  else
1395  error = set_hw_interface_rx_mode (vnm, hw_if_index, queue_id, mode);
1396 
1397  return (error);
1398 }
1399 
1400 static clib_error_t *
1402  vlib_cli_command_t * cmd)
1403 {
1404  clib_error_t *error = 0;
1405  unformat_input_t _line_input, *line_input = &_line_input;
1406  vnet_main_t *vnm = vnet_get_main ();
1407  u32 hw_if_index = (u32) ~ 0;
1408  u32 queue_id = (u32) ~ 0;
1410  u8 queue_id_valid = 0;
1411 
1412  if (!unformat_user (input, unformat_line_input, line_input))
1413  return 0;
1414 
1415  while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1416  {
1417  if (unformat
1418  (line_input, "%U", unformat_vnet_hw_interface, vnm, &hw_if_index))
1419  ;
1420  else if (unformat (line_input, "queue %d", &queue_id))
1421  queue_id_valid = 1;
1422  else if (unformat (line_input, "polling"))
1424  else if (unformat (line_input, "interrupt"))
1426  else if (unformat (line_input, "adaptive"))
1428  else
1429  {
1430  error = clib_error_return (0, "parse error: '%U'",
1431  format_unformat_error, line_input);
1432  unformat_free (line_input);
1433  return error;
1434  }
1435  }
1436 
1437  unformat_free (line_input);
1438 
1439  if (hw_if_index == (u32) ~ 0)
1440  return clib_error_return (0, "please specify valid interface name");
1441 
1443  return clib_error_return (0, "please specify valid rx-mode");
1444 
1445  error = set_hw_interface_change_rx_mode (vnm, hw_if_index, queue_id_valid,
1446  queue_id, mode);
1447 
1448  return (error);
1449 }
1450 
1451 /*?
1452  * This command is used to assign the RX packet processing mode (polling,
1453  * interrupt, adaptive) of the a given interface, and optionally a
1454  * given queue. If the '<em>queue</em>' is not provided, the '<em>mode</em>'
1455  * is applied to all queues of the interface. Not all interfaces support
1456  * all modes. To display the current rx-mode use the command
1457  * '<em>show interface rx-placement</em>'.
1458  *
1459  * @cliexpar
1460  * Example of how to assign rx-mode to all queues on an interface:
1461  * @cliexcmd{set interface rx-mode VirtualEthernet0/0/12 polling}
1462  * Example of how to assign rx-mode to one queue of an interface:
1463  * @cliexcmd{set interface rx-mode VirtualEthernet0/0/12 queue 0 interrupt}
1464  * Example of how to display the rx-mode of all interfaces:
1465  * @cliexstart{show interface rx-placement}
1466  * Thread 1 (vpp_wk_0):
1467  * node dpdk-input:
1468  * GigabitEthernet7/0/0 queue 0 (polling)
1469  * node vhost-user-input:
1470  * VirtualEthernet0/0/12 queue 0 (interrupt)
1471  * VirtualEthernet0/0/12 queue 2 (polling)
1472  * VirtualEthernet0/0/13 queue 0 (polling)
1473  * VirtualEthernet0/0/13 queue 2 (polling)
1474  * Thread 2 (vpp_wk_1):
1475  * node dpdk-input:
1476  * GigabitEthernet7/0/1 queue 0 (polling)
1477  * node vhost-user-input:
1478  * VirtualEthernet0/0/12 queue 1 (polling)
1479  * VirtualEthernet0/0/12 queue 3 (polling)
1480  * VirtualEthernet0/0/13 queue 1 (polling)
1481  * VirtualEthernet0/0/13 queue 3 (polling)
1482  * @cliexend
1483 ?*/
1484 /* *INDENT-OFF* */
1485 VLIB_CLI_COMMAND (cmd_set_if_rx_mode,static) = {
1486  .path = "set interface rx-mode",
1487  .short_help = "set interface rx-mode <interface> [queue <n>] [polling | interrupt | adaptive]",
1488  .function = set_interface_rx_mode,
1489 };
1490 /* *INDENT-ON* */
1491 
1492 static clib_error_t *
1494  vlib_cli_command_t * cmd)
1495 {
1496  u8 *s = 0;
1497  vnet_main_t *vnm = vnet_get_main ();
1500  vlib_node_t *pn = vlib_get_node_by_name (vm, (u8 *) "device-input");
1501  uword si;
1502  int index = 0;
1503 
1504  /* *INDENT-OFF* */
1505  foreach_vlib_main (({
1507  ({
1508  rt = vlib_node_get_runtime_data (this_vlib_main, si);
1509 
1510  if (vec_len (rt->devices_and_queues))
1511  s = format (s, " node %U:\n", format_vlib_node_name, vm, si);
1512 
1513  vec_foreach (dq, rt->devices_and_queues)
1514  {
1515  vnet_hw_interface_t *hi = vnet_get_hw_interface (vnm,
1516  dq->hw_if_index);
1517  s = format (s, " %U queue %u (%U)\n",
1518  format_vnet_sw_if_index_name, vnm, hi->sw_if_index,
1519  dq->queue_id,
1520  format_vnet_hw_interface_rx_mode, dq->mode);
1521  }
1522  }));
1523  if (vec_len (s) > 0)
1524  {
1525  vlib_cli_output(vm, "Thread %u (%s):\n%v", index,
1526  vlib_worker_threads[index].name, s);
1527  vec_reset_length (s);
1528  }
1529  index++;
1530  }));
1531  /* *INDENT-ON* */
1532 
1533  vec_free (s);
1534  return 0;
1535 }
1536 
1537 /*?
1538  * This command is used to display the interface and queue worker
1539  * thread placement.
1540  *
1541  * @cliexpar
1542  * Example of how to display the interface placement:
1543  * @cliexstart{show interface rx-placement}
1544  * Thread 1 (vpp_wk_0):
1545  * node dpdk-input:
1546  * GigabitEthernet7/0/0 queue 0 (polling)
1547  * node vhost-user-input:
1548  * VirtualEthernet0/0/12 queue 0 (polling)
1549  * VirtualEthernet0/0/12 queue 2 (polling)
1550  * VirtualEthernet0/0/13 queue 0 (polling)
1551  * VirtualEthernet0/0/13 queue 2 (polling)
1552  * Thread 2 (vpp_wk_1):
1553  * node dpdk-input:
1554  * GigabitEthernet7/0/1 queue 0 (polling)
1555  * node vhost-user-input:
1556  * VirtualEthernet0/0/12 queue 1 (polling)
1557  * VirtualEthernet0/0/12 queue 3 (polling)
1558  * VirtualEthernet0/0/13 queue 1 (polling)
1559  * VirtualEthernet0/0/13 queue 3 (polling)
1560  * @cliexend
1561 ?*/
1562 /* *INDENT-OFF* */
1563 VLIB_CLI_COMMAND (show_interface_rx_placement, static) = {
1564  .path = "show interface rx-placement",
1565  .short_help = "show interface rx-placement",
1566  .function = show_interface_rx_placement_fn,
1567 };
1568 /* *INDENT-ON* */
1569 
1570 clib_error_t *
1571 set_hw_interface_rx_placement (u32 hw_if_index, u32 queue_id,
1572  u32 thread_index, u8 is_main)
1573 {
1574  vnet_main_t *vnm = vnet_get_main ();
1576  clib_error_t *error = 0;
1578  int rv;
1579 
1580  if (is_main)
1581  thread_index = 0;
1582  else
1583  thread_index += vdm->first_worker_thread_index;
1584 
1585  if (thread_index > vdm->last_worker_thread_index)
1586  return clib_error_return (0,
1587  "please specify valid worker thread or main");
1588 
1589  rv = vnet_hw_interface_get_rx_mode (vnm, hw_if_index, queue_id, &mode);
1590 
1591  if (rv)
1592  return clib_error_return (0, "not found");
1593 
1594  rv = vnet_hw_interface_unassign_rx_thread (vnm, hw_if_index, queue_id);
1595 
1596  if (rv)
1597  return clib_error_return (0, "not found");
1598 
1599  vnet_hw_interface_assign_rx_thread (vnm, hw_if_index, queue_id,
1600  thread_index);
1601  vnet_hw_interface_set_rx_mode (vnm, hw_if_index, queue_id, mode);
1602 
1603  return (error);
1604 }
1605 
1606 static clib_error_t *
1608  vlib_cli_command_t * cmd)
1609 {
1610  clib_error_t *error = 0;
1611  unformat_input_t _line_input, *line_input = &_line_input;
1612  vnet_main_t *vnm = vnet_get_main ();
1613  u32 hw_if_index = (u32) ~ 0;
1614  u32 queue_id = (u32) 0;
1615  u32 thread_index = (u32) ~ 0;
1616  u8 is_main = 0;
1617 
1618  if (!unformat_user (input, unformat_line_input, line_input))
1619  return 0;
1620 
1621  while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1622  {
1623  if (unformat
1624  (line_input, "%U", unformat_vnet_hw_interface, vnm, &hw_if_index))
1625  ;
1626  else if (unformat (line_input, "queue %d", &queue_id))
1627  ;
1628  else if (unformat (line_input, "main", &thread_index))
1629  is_main = 1;
1630  else if (unformat (line_input, "worker %d", &thread_index))
1631  ;
1632  else
1633  {
1634  error = clib_error_return (0, "parse error: '%U'",
1635  format_unformat_error, line_input);
1636  unformat_free (line_input);
1637  return error;
1638  }
1639  }
1640 
1641  unformat_free (line_input);
1642 
1643  if (hw_if_index == (u32) ~ 0)
1644  return clib_error_return (0, "please specify valid interface name");
1645 
1646  error = set_hw_interface_rx_placement (hw_if_index, queue_id, thread_index,
1647  is_main);
1648 
1649  return (error);
1650 }
1651 
1652 /*?
1653  * This command is used to assign a given interface, and optionally a
1654  * given queue, to a different thread. If the '<em>queue</em>' is not provided,
1655  * it defaults to 0. The '<em>worker</em>' parameter is zero based and the index
1656  * in the thread name, for example, 0 in the thread name '<em>vpp_wk_0</em>'.
1657  *
1658  * @cliexpar
1659  * Example of how to display the interface placement:
1660  * @cliexstart{show interface rx-placement}
1661  * Thread 1 (vpp_wk_0):
1662  * node dpdk-input:
1663  * GigabitEthernet7/0/0 queue 0 (polling)
1664  * node vhost-user-input:
1665  * VirtualEthernet0/0/12 queue 0 (polling)
1666  * VirtualEthernet0/0/12 queue 2 (polling)
1667  * VirtualEthernet0/0/13 queue 0 (polling)
1668  * VirtualEthernet0/0/13 queue 2 (polling)
1669  * Thread 2 (vpp_wk_1):
1670  * node dpdk-input:
1671  * GigabitEthernet7/0/1 queue 0 (polling)
1672  * node vhost-user-input:
1673  * VirtualEthernet0/0/12 queue 1 (polling)
1674  * VirtualEthernet0/0/12 queue 3 (polling)
1675  * VirtualEthernet0/0/13 queue 1 (polling)
1676  * VirtualEthernet0/0/13 queue 3 (polling)
1677  * @cliexend
1678  * Example of how to assign a interface and queue to a worker thread:
1679  * @cliexcmd{set interface rx-placement VirtualEthernet0/0/12 queue 1 worker 0}
1680  * Example of how to display the interface placement:
1681  * @cliexstart{show interface rx-placement}
1682  * Thread 1 (vpp_wk_0):
1683  * node dpdk-input:
1684  * GigabitEthernet7/0/0 queue 0 (polling)
1685  * node vhost-user-input:
1686  * VirtualEthernet0/0/12 queue 0 (polling)
1687  * VirtualEthernet0/0/12 queue 1 (polling)
1688  * VirtualEthernet0/0/12 queue 2 (polling)
1689  * VirtualEthernet0/0/13 queue 0 (polling)
1690  * VirtualEthernet0/0/13 queue 2 (polling)
1691  * Thread 2 (vpp_wk_1):
1692  * node dpdk-input:
1693  * GigabitEthernet7/0/1 queue 0 (polling)
1694  * node vhost-user-input:
1695  * VirtualEthernet0/0/12 queue 3 (polling)
1696  * VirtualEthernet0/0/13 queue 1 (polling)
1697  * VirtualEthernet0/0/13 queue 3 (polling)
1698  * @cliexend
1699 ?*/
1700 /* *INDENT-OFF* */
1701 VLIB_CLI_COMMAND (cmd_set_if_rx_placement,static) = {
1702  .path = "set interface rx-placement",
1703  .short_help = "set interface rx-placement <interface> [queue <n>] "
1704  "[worker <n> | main]",
1705  .function = set_interface_rx_placement,
1706  .is_mp_safe = 1,
1707 };
1708 /* *INDENT-ON* */
1709 
1710 static inline clib_error_t *
1712  unformat_input_t * input,
1713  vlib_cli_command_t * cmd, int rx_tx)
1714 {
1715 #define PCAP_DEF_PKT_TO_CAPTURE (1000)
1716 
1717  unformat_input_t _line_input, *line_input = &_line_input;
1718  u8 *filename;
1719  u8 *chroot_filename = 0;
1720  u32 max = 0;
1721  int enabled = 0;
1722  int errorFlag = 0;
1723  clib_error_t *error = 0;
1724  vnet_main_t *vnm = vnet_get_main ();
1725 
1726  /* Get a line of input. */
1727  if (!unformat_user (input, unformat_line_input, line_input))
1728  return 0;
1729 
1730  while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
1731  {
1732  if (unformat (line_input, "on"))
1733  {
1734  if (vm->pcap[rx_tx].pcap_enable == 0)
1735  {
1736  enabled = 1;
1737  }
1738  else
1739  {
1740  vlib_cli_output (vm, "pcap %s capture already on...",
1741  (rx_tx == VLIB_RX) ? "rx" : "tx");
1742  errorFlag = 1;
1743  break;
1744  }
1745  }
1746  else if (unformat (line_input, "off"))
1747  {
1748  if (vm->pcap[rx_tx].pcap_enable)
1749  {
1751  (vm, "captured %d pkts...",
1752  vm->pcap[rx_tx].pcap_main.n_packets_captured);
1753  if (vm->pcap[rx_tx].pcap_main.n_packets_captured)
1754  {
1755  vm->pcap[rx_tx].pcap_main.n_packets_to_capture =
1756  vm->pcap[rx_tx].pcap_main.n_packets_captured;
1757  error = pcap_write (&vm->pcap[rx_tx].pcap_main);
1758  if (error)
1759  clib_error_report (error);
1760  else
1761  vlib_cli_output (vm, "saved to %s...",
1762  vm->pcap[rx_tx].pcap_main.file_name);
1763  }
1764 
1765  vm->pcap[rx_tx].pcap_enable = 0;
1766  }
1767  else
1768  {
1769  vlib_cli_output (vm, "pcap %s capture already off...",
1770  (rx_tx == VLIB_RX) ? "rx" : "tx");
1771  errorFlag = 1;
1772  break;
1773  }
1774  }
1775  else if (unformat (line_input, "max %d", &max))
1776  {
1777  if (vm->pcap[rx_tx].pcap_enable)
1778  {
1780  (vm,
1781  "can't change max value while pcap tx capture active...");
1782  errorFlag = 1;
1783  break;
1784  }
1785  vm->pcap[rx_tx].pcap_main.n_packets_to_capture = max;
1786  }
1787  else if (unformat (line_input, "intfc %U",
1789  &vm->pcap[rx_tx].pcap_sw_if_index))
1790  ;
1791 
1792  else if (unformat (line_input, "intfc any"))
1793  {
1794  vm->pcap[rx_tx].pcap_sw_if_index = 0;
1795  }
1796  else if (unformat (line_input, "file %s", &filename))
1797  {
1798  if (vm->pcap[rx_tx].pcap_enable)
1799  {
1801  (vm, "can't change file while pcap tx capture active...");
1802  errorFlag = 1;
1803  break;
1804  }
1805 
1806  /* Brain-police user path input */
1807  if (strstr ((char *) filename, "..")
1808  || index ((char *) filename, '/'))
1809  {
1810  vlib_cli_output (vm, "illegal characters in filename '%s'",
1811  filename);
1812  vlib_cli_output (vm, "Hint: .. and / are not allowed.");
1813  vec_free (filename);
1814  errorFlag = 1;
1815  break;
1816  }
1817 
1818  chroot_filename = format (0, "/tmp/%s%c", filename, 0);
1819  vec_free (filename);
1820  }
1821  else if (unformat (line_input, "status"))
1822  {
1823  if (vm->pcap[rx_tx].pcap_sw_if_index == 0)
1824  {
1826  (vm, "max is %d for any interface to file %s",
1827  vm->pcap[rx_tx].pcap_main.n_packets_to_capture ?
1830  vm->pcap[rx_tx].pcap_main.file_name ?
1831  (u8 *) vm->pcap[rx_tx].pcap_main.file_name :
1832  (u8 *) "/tmp/vpe.pcap");
1833  }
1834  else
1835  {
1836  vlib_cli_output (vm, "max is %d for interface %U to file %s",
1838  ? vm->pcap[rx_tx].
1842  vm->pcap_sw_if_index,
1843  vm->pcap[rx_tx].
1844  pcap_main.file_name ? (u8 *) vm->pcap[rx_tx].
1845  pcap_main.file_name : (u8 *) "/tmp/vpe.pcap");
1846  }
1847 
1848  if (vm->pcap[rx_tx].pcap_enable == 0)
1849  {
1850  vlib_cli_output (vm, "pcap %s capture is off...",
1851  (rx_tx == VLIB_RX) ? "rx" : "tx");
1852  }
1853  else
1854  {
1855  vlib_cli_output (vm, "pcap %s capture is on: %d of %d pkts...",
1856  (rx_tx == VLIB_RX) ? "rx" : "tx",
1857  vm->pcap[rx_tx].pcap_main.n_packets_captured,
1858  vm->pcap[rx_tx].
1860  }
1861  break;
1862  }
1863 
1864  else
1865  {
1866  error = clib_error_return (0, "unknown input `%U'",
1867  format_unformat_error, line_input);
1868  errorFlag = 1;
1869  break;
1870  }
1871  }
1872  unformat_free (line_input);
1873 
1874 
1875  if (errorFlag == 0)
1876  {
1877  /* Since no error, save configured values. */
1878  if (chroot_filename)
1879  {
1880  if (vm->pcap[rx_tx].pcap_main.file_name)
1881  vec_free (vm->pcap[rx_tx].pcap_main.file_name);
1882  vec_add1 (chroot_filename, 0);
1883  vm->pcap[rx_tx].pcap_main.file_name = (char *) chroot_filename;
1884  }
1885 
1886  if (max)
1887  vm->pcap[rx_tx].pcap_main.n_packets_to_capture = max;
1888 
1889  if (enabled)
1890  {
1891  if (vm->pcap[rx_tx].pcap_main.file_name == 0)
1892  vm->pcap[rx_tx].pcap_main.file_name
1893  = (char *) format (0, "/tmp/vpe.pcap%c", 0);
1894 
1895  vm->pcap[rx_tx].pcap_main.n_packets_captured = 0;
1896  vm->pcap[rx_tx].pcap_main.packet_type = PCAP_PACKET_TYPE_ethernet;
1897  if (vm->pcap[rx_tx].pcap_main.lock == 0)
1898  clib_spinlock_init (&(vm->pcap[rx_tx].pcap_main.lock));
1899  vm->pcap[rx_tx].pcap_enable = 1;
1900  vlib_cli_output (vm, "pcap %s capture on...",
1901  rx_tx == VLIB_RX ? "rx" : "tx");
1902  }
1903  }
1904  else if (chroot_filename)
1905  vec_free (chroot_filename);
1906 
1907  return error;
1908 }
1909 
1910 static clib_error_t *
1912  unformat_input_t * input, vlib_cli_command_t * cmd)
1913 {
1914  return pcap_trace_command_internal (vm, input, cmd, VLIB_RX);
1915 }
1916 
1917 static clib_error_t *
1919  unformat_input_t * input, vlib_cli_command_t * cmd)
1920 {
1921  return pcap_trace_command_internal (vm, input, cmd, VLIB_TX);
1922 }
1923 
1924 
1925 /*?
1926  * This command is used to start or stop a packet capture, or show
1927  * the status of packet capture. Note that both "pcap rx trace" and
1928  * "pcap tx trace" are implemented. The command syntax is identical,
1929  * simply substitute rx for tx as needed.
1930  *
1931  * This command has the following optional parameters:
1932  *
1933  * - <b>on|off</b> - Used to start or stop a packet capture.
1934  *
1935  * - <b>max <nn></b> - Depth of local buffer. Once '<em>nn</em>' number
1936  * of packets have been received, buffer is flushed to file. Once another
1937  * '<em>nn</em>' number of packets have been received, buffer is flushed
1938  * to file, overwriting previous write. If not entered, value defaults
1939  * to 100. Can only be updated if packet capture is off.
1940  *
1941  * - <b>intfc <interface>|any</b> - Used to specify a given interface,
1942  * or use '<em>any</em>' to run packet capture on all interfaces.
1943  * '<em>any</em>' is the default if not provided. Settings from a previous
1944  * packet capture are preserved, so '<em>any</em>' can be used to reset
1945  * the interface setting.
1946  *
1947  * - <b>file <name></b> - Used to specify the output filename. The file will
1948  * be placed in the '<em>/tmp</em>' directory, so only the filename is
1949  * supported. Directory should not be entered. If file already exists, file
1950  * will be overwritten. If no filename is provided, '<em>/tmp/vpe.pcap</em>'
1951  * will be used. Can only be updated if packet capture is off.
1952  *
1953  * - <b>status</b> - Displays the current status and configured attributes
1954  * associated with a packet capture. If packet capture is in progress,
1955  * '<em>status</em>' also will return the number of packets currently in
1956  * the local buffer. All additional attributes entered on command line
1957  * with '<em>status</em>' will be ignored and not applied.
1958  *
1959  * @cliexpar
1960  * Example of how to display the status of a tx packet capture when off:
1961  * @cliexstart{pcap tx trace status}
1962  * max is 100, for any interface to file /tmp/vpe.pcap
1963  * pcap tx capture is off...
1964  * @cliexend
1965  * Example of how to start a tx packet capture:
1966  * @cliexstart{pcap tx trace on max 35 intfc GigabitEthernet0/8/0 file vppTest.pcap}
1967  * pcap tx capture on...
1968  * @cliexend
1969  * Example of how to display the status of a tx packet capture in progress:
1970  * @cliexstart{pcap tx trace status}
1971  * max is 35, for interface GigabitEthernet0/8/0 to file /tmp/vppTest.pcap
1972  * pcap tx capture is on: 20 of 35 pkts...
1973  * @cliexend
1974  * Example of how to stop a tx packet capture:
1975  * @cliexstart{vppctl pcap tx trace off}
1976  * captured 21 pkts...
1977  * saved to /tmp/vppTest.pcap...
1978  * @cliexend
1979 ?*/
1980 /* *INDENT-OFF* */
1981 
1982 VLIB_CLI_COMMAND (pcap_tx_trace_command, static) = {
1983  .path = "pcap tx trace",
1984  .short_help =
1985  "pcap tx trace [on|off] [max <nn>] [intfc <interface>|any] [file <name>] [status]",
1986  .function = pcap_tx_trace_command_fn,
1987 };
1988 VLIB_CLI_COMMAND (pcap_rx_trace_command, static) = {
1989  .path = "pcap rx trace",
1990  .short_help =
1991  "pcap rx trace [on|off] [max <nn>] [intfc <interface>|any] [file <name>] [status]",
1992  .function = pcap_rx_trace_command_fn,
1993 };
1994 /* *INDENT-ON* */
1995 
1996 
1997 /*
1998  * fd.io coding-style-patch-verification: ON
1999  *
2000  * Local Variables:
2001  * eval: (c-set-style "gnu")
2002  * End:
2003  */
uword * sibling_bitmap
Definition: node.h:339
unformat_function_t unformat_vnet_hw_interface
#define foreach_ip_interface_address(lm, a, sw_if_index, loop, body)
Definition: lookup.h:182
u32 sw_if_index
Definition: ipsec_gre.api:37
static clib_error_t * clear_interface_counters(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
u8 * format_l2_input_features(u8 *s, va_list *args)
Definition: l2_input.c:68
vmrglw vmrglh hi
pcap_main_t pcap_main
Definition: main.h:65
format_function_t format_vnet_sw_interface
static clib_error_t * create_sub_interfaces(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
#define hash_set(h, key, value)
Definition: hash.h:255
char * file_name
File name of pcap output.
Definition: pcap.h:162
u32 flags
Definition: vhost_user.h:115
static clib_error_t * promiscuous_cmd(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
static clib_error_t * set_hw_class(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
clib_error_t * set_hw_interface_rx_placement(u32 hw_if_index, u32 queue_id, u32 thread_index, u8 is_main)
static int sw_interface_name_compare(void *a1, void *a2)
void vnet_sw_interface_ip_directed_broadcast(vnet_main_t *vnm, u32 sw_if_index, u8 enable)
Definition: interface.c:675
static clib_error_t * set_state(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
uword first_worker_thread_index
Definition: devices.h:53
u32 n_packets_to_capture
Number of packets to capture.
Definition: pcap.h:165
static ip6_fib_t * ip6_fib_get(fib_node_index_t index)
Definition: ip6_fib.h:166
static clib_error_t * set_interface_mac_address(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
vnet_main_t * vnet_get_main(void)
Definition: misc.c:47
u8 * format_l2_output_features(u8 *s, va_list *args)
Definition: l2_output.c:45
unformat_function_t unformat_hash_string
Definition: hash.h:719
vnet_interface_main_t interface_main
Definition: vnet.h:56
unsigned long u64
Definition: types.h:89
l2_input_config_t * l2input_intf_config(u32 sw_if_index)
Get a pointer to the config for the given interface.
Definition: l2_input.c:526
#define NULL
Definition: clib.h:58
clib_memset(h->entries, 0, sizeof(h->entries[0]) *entries)
vnet_main_t ** vnet_mains
Definition: misc.c:44
static vnet_hw_interface_t * vnet_get_hw_interface(vnet_main_t *vnm, u32 hw_if_index)
#define vec_add1(V, E)
Add 1 element to end of vector (unspecified alignment).
Definition: vec.h:522
word vnet_sw_interface_compare(vnet_main_t *vnm, uword sw_if_index0, uword sw_if_index1)
Definition: interface.c:1186
int vnet_interface_name_renumber(u32 sw_if_index, u32 new_show_dev_instance)
Definition: interface.c:1355
static void vnet_clear_sw_interface_tag(vnet_main_t *vnm, u32 sw_if_index)
static clib_error_t * set_tag(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
int i
static clib_error_t * renumber_interface_command_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
uword unformat_user(unformat_input_t *input, unformat_function_t *func,...)
Definition: unformat.c:983
#define hash_set_mem(h, key, value)
Definition: hash.h:275
ip_lookup_main_t lookup_main
Definition: ip4.h:98
static vnet_sw_interface_t * vnet_get_sw_interface(vnet_main_t *vnm, u32 sw_if_index)
uword * sub_interface_sw_if_index_by_id
Definition: interface.h:542
u32 * fib_index_by_sw_if_index
Table index indexed by software interface.
Definition: ip4.h:112
u8 * format(u8 *s, const char *fmt,...)
Definition: format.c:424
unformat_function_t unformat_vnet_sw_interface
struct _vnet_device_class vnet_device_class_t
uword * dq_runtime_index_by_queue
Definition: interface.h:566
format_function_t format_vnet_sw_if_index_name
unsigned char u8
Definition: types.h:56
#define vec_reset_length(v)
Reset vector length to zero NULL-pointer tolerant.
uword last_worker_thread_index
Definition: devices.h:54
ethernet_main_t ethernet_main
Definition: init.c:45
vnet_hw_interface_rx_mode
Definition: interface.h:52
format_function_t format_vnet_hw_interface
uword flags
Definition: clib_error.h:29
clib_spinlock_t lock
spinlock to protect e.g.
Definition: pcap.h:159
void vlib_clear_combined_counters(vlib_combined_counter_main_t *cm)
Clear a collection of combined counters.
Definition: counter.c:60
#define pool_foreach(VAR, POOL, BODY)
Iterate through pool.
Definition: pool.h:493
#define VLIB_INIT_FUNCTION(x)
Definition: init.h:163
u32 output_sw_if_index
Definition: l2_input.h:35
static vnet_device_class_t * vnet_get_device_class(vnet_main_t *vnm, u32 dev_class_index)
#define vec_new(T, N)
Create new vector of given type and length (unspecified alignment, no header).
Definition: vec.h:311
vlib_combined_counter_main_t * combined_sw_if_counters
Definition: interface.h:824
static clib_error_t * parse_vlan_sub_interfaces(unformat_input_t *input, vnet_sw_interface_t *template)
Parse subinterface names.
#define vec_elt_at_index(v, i)
Get vector value at index i checking that i is in bounds.
#define clib_error_return(e, args...)
Definition: error.h:99
unsigned int u32
Definition: types.h:88
static clib_error_t * set_unnumbered(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
A collection of simple counters.
Definition: counter.h:57
void vnet_sw_interface_set_protocol_mtu(vnet_main_t *vnm, u32 sw_if_index, u32 mtu[])
Definition: interface.c:654
static clib_error_t * mtu_cmd(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
unformat_function_t unformat_line_input
Definition: format.h:282
static void clib_spinlock_init(clib_spinlock_t *p)
Definition: lock.h:57
u32 max_supported_packet_bytes
Definition: interface.h:533
int pcap_enable
Definition: main.h:63
vnet_hw_interface_t * hw_interfaces
Definition: interface.h:801
vlib_worker_thread_t * vlib_worker_threads
Definition: threads.c:36
#define clib_bitmap_foreach(i, ai, body)
Macro to iterate across set bits in a bitmap.
Definition: bitmap.h:361
l2_output_config_t * l2output_intf_config(u32 sw_if_index)
Get a pointer to the config for the given interface.
Definition: l2_output.c:616
#define pool_elt_at_index(p, i)
Returns pointer to element at given index.
Definition: pool.h:514
u32 bd_id
Definition: gbp.api:269
struct _unformat_input_t unformat_input_t
int vnet_hw_interface_get_rx_mode(vnet_main_t *vnm, u32 hw_if_index, u16 queue_id, vnet_hw_interface_rx_mode *mode)
Definition: devices.c:313
uword * sw_if_index_by_sup_and_sub
Definition: interface.h:818
vnet_sw_interface_flags_t flags
Definition: interface.h:684
clib_error_t * set_hw_interface_change_rx_mode(vnet_main_t *vnm, u32 hw_if_index, u8 queue_id_valid, u32 queue_id, vnet_hw_interface_rx_mode mode)
static clib_error_t * show_sw_interfaces(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
vlib_simple_counter_main_t * sw_if_counters
Definition: interface.h:823
word vnet_hw_interface_compare(vnet_main_t *vnm, uword hw_if_index0, uword hw_if_index1)
Definition: interface.c:1200
static clib_error_t * set_interface_rx_placement(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
void vnet_sw_interface_update_unnumbered(u32 unnumbered_sw_if_index, u32 ip_sw_if_index, u8 enable)
Definition: interface.c:1475
u32 pcap_sw_if_index
Definition: main.h:64
#define foreach_vlib_main(body)
Definition: threads.h:235
u8 name[64]
Definition: memclnt.api:152
static int compare_interface_names(void *a1, void *a2)
Definition: interface_cli.c:57
uword * hw_interface_class_by_name
Definition: interface.h:811
The IPv4 FIB.
Definition: ip4_fib.h:39
#define VNET_HW_INTERFACE_BOND_INFO_SLAVE
Definition: interface.h:553
#define UNFORMAT_END_OF_INPUT
Definition: format.h:144
u32 pcap_sw_if_index
Definition: main.h:154
vlib_main_t * vm
Definition: buffer.c:312
static clib_error_t * clear_tag(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
void vnet_interface_features_show(vlib_main_t *vm, u32 sw_if_index, int verbose)
Display the set of driver features configured on a specific interface Called by "show interface" hand...
Definition: feature.c:379
#define vec_free(V)
Free vector&#39;s memory (no header).
Definition: vec.h:341
static ip4_fib_t * ip4_fib_get(u32 index)
Get the FIB at the given index.
Definition: ip4_fib.h:113
Definition: ip6.h:69
#define clib_warning(format, args...)
Definition: error.h:59
#define ETHERNET_INTERFACE_FLAG_ACCEPT_ALL
Definition: ethernet.h:141
vlib_node_t * vlib_get_node_by_name(vlib_main_t *vm, u8 *name)
Definition: node.c:45
static_always_inline l2_bridge_domain_t * l2input_bd_config(u32 bd_index)
Definition: l2_input.h:85
static void show_bond(vlib_main_t *vm)
Definition: cli.c:692
clib_error_t * pcap_write(pcap_main_t *pm)
Write PCAP file.
Definition: pcap.c:89
vl_api_vxlan_gbp_api_tunnel_mode_t mode
Definition: vxlan_gbp.api:44
static clib_error_t * show_or_clear_hw_interfaces(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: interface_cli.c:66
#define VLIB_CLI_COMMAND(x,...)
Definition: cli.h:155
uword unformat_ethernet_address(unformat_input_t *input, va_list *args)
Definition: format.c:233
void vnet_hw_interface_assign_rx_thread(vnet_main_t *vnm, u32 hw_if_index, u16 queue_id, uword thread_index)
Definition: devices.c:139
ip6_main_t ip6_main
Definition: ip6_forward.c:2688
ip_lookup_main_t lookup_main
Definition: ip6.h:179
IPv4 main type.
Definition: ip4.h:96
static void vnet_set_sw_interface_tag(vnet_main_t *vnm, u8 *tag, u32 sw_if_index)
static clib_error_t * pcap_tx_trace_command_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
static clib_error_t * pcap_trace_command_internal(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd, int rx_tx)
Bitmaps built as vectors of machine words.
#define clib_error_report(e)
Definition: error.h:113
char * path
Definition: cli.h:95
static u8 * vnet_get_sw_interface_tag(vnet_main_t *vnm, u32 sw_if_index)
static void * clib_mem_alloc(uword size)
Definition: mem.h:132
uword unformat_ethernet_interface(unformat_input_t *input, va_list *args)
Definition: interface.c:257
#define vec_elt(v, i)
Get vector value at index i.
pcap_packet_type_t packet_type
Packet type.
Definition: pcap.h:168
Definition: defs.h:47
void vnet_hw_interface_set_mtu(vnet_main_t *vnm, u32 hw_if_index, u32 mtu)
Definition: interface.c:702
l2input_main_t l2input_main
Definition: l2_input.c:128
ethernet_interface_t * ethernet_get_interface(ethernet_main_t *em, u32 hw_if_index)
Definition: interface.c:886
u32 feature_bitmap
Definition: l2_bd.h:69
#define vec_len(v)
Number of elements in vector (rvalue-only, NULL tolerant)
unformat_function_t unformat_vnet_sw_interface_flags
static clib_error_t * pcap_rx_trace_command_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
static clib_error_t * vnet_interface_cli_init(vlib_main_t *vm)
u64 uword
Definition: types.h:112
#define vec_sort_with_function(vec, f)
Sort a vector using the supplied element comparison function.
Definition: vec.h:980
static void unformat_free(unformat_input_t *i)
Definition: format.h:162
vnet_sw_interface_t * sw_interfaces
Definition: interface.h:815
static clib_error_t * set_ip_directed_broadcast(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
static clib_error_t * set_hw_interface_rx_mode(vnet_main_t *vnm, u32 hw_if_index, u32 queue_id, vnet_hw_interface_rx_mode mode)
l2_bridge_domain_t * bd_configs
Definition: l2_input.h:64
A collection of combined counters.
Definition: counter.h:188
#define hash_get_mem(h, key)
Definition: hash.h:269
int vnet_hw_interface_unassign_rx_thread(vnet_main_t *vnm, u32 hw_if_index, u16 queue_id)
Definition: devices.c:188
vnet_pcap_t pcap[VLIB_N_RX_TX]
Definition: main.h:149
u8 * format_unformat_error(u8 *s, va_list *va)
Definition: unformat.c:91
u32 min_supported_packet_bytes
Definition: interface.h:530
void vlib_clear_simple_counters(vlib_simple_counter_main_t *cm)
Clear a collection of simple counters.
Definition: counter.c:43
ip4_main_t ip4_main
Global ip4 main structure.
Definition: ip4_forward.c:905
clib_error_t * vnet_sw_interface_set_flags(vnet_main_t *vnm, u32 sw_if_index, vnet_sw_interface_flags_t flags)
Definition: interface.c:513
#define vec_foreach(var, vec)
Vector iterator.
vnet_hw_interface_rx_mode default_rx_mode
Definition: interface.h:563
vnet_device_class_t * device_classes
Definition: interface.h:808
u32 bd_find_index(bd_main_t *bdm, u32 bd_id)
Get a bridge domain.
Definition: l2_bd.c:69
int vnet_hw_interface_set_rx_mode(vnet_main_t *vnm, u32 hw_if_index, u16 queue_id, vnet_hw_interface_rx_mode mode)
Definition: devices.c:253
u32 id
Definition: udp.api:45
static clib_error_t * set_interface_rx_mode(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
clib_error_t * vnet_hw_interface_change_mac_address(vnet_main_t *vnm, u32 hw_if_index, const u8 *mac_address)
Definition: interface.c:1466
clib_error_t * vnet_create_sw_interface(vnet_main_t *vnm, vnet_sw_interface_t *template, u32 *sw_if_index)
Definition: interface.c:566
bd_main_t bd_main
Definition: l2_bd.c:44
#define PCAP_DEF_PKT_TO_CAPTURE
vl_api_mac_address_t mac
Definition: gbp.api:120
void vlib_cli_output(vlib_main_t *vm, char *fmt,...)
Definition: cli.c:762
u32 * fib_index_by_sw_if_index
Definition: ip6.h:194
u32 n_packets_captured
Number of packets currently captured.
Definition: pcap.h:171
static clib_error_t * show_interface_rx_placement_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
vnet_device_main_t vnet_device_main
Definition: devices.c:22
uword unformat(unformat_input_t *i, const char *fmt,...)
Definition: unformat.c:972
Definition: defs.h:46
static uword unformat_check_input(unformat_input_t *i)
Definition: format.h:170
u32 ethernet_set_flags(vnet_main_t *vnm, u32 hw_if_index, u32 flags)
Definition: interface.c:372
clib_error_t * vnet_hw_interface_set_class(vnet_main_t *vnm, u32 hw_if_index, u32 hw_class_index)
Definition: interface.c:1150
pcap_main_t pcap_main
Definition: pcap2cinit.c:26
static uword pool_elts(void *v)
Number of active elements in a pool.
Definition: pool.h:128