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:
7 * http://www.apache.org/licenses/LICENSE-2.0
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.
16 * interface_cli.c: interface CLI
18 * Copyright (c) 2008 Eliot Dresselhaus
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:
28 * The above copyright notice and this permission notice shall be
29 * included in all copies or substantial portions of the Software.
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.
45 #include <vnet/vnet.h>
46 #include <vnet/ip/ip.h>
47 #include <vppinfra/bitmap.h>
48 #include <vnet/fib/ip4_fib.h>
49 #include <vnet/fib/ip6_fib.h>
52 compare_interface_names (void *a1, void *a2)
57 return vnet_hw_interface_compare (vnet_get_main (), *hi1, *hi2);
61 show_or_clear_hw_interfaces (vlib_main_t * vm,
62 unformat_input_t * input,
63 vlib_cli_command_t * cmd)
65 clib_error_t *error = 0;
66 vnet_main_t *vnm = vnet_get_main ();
67 vnet_interface_main_t *im = &vnm->interface_main;
68 vnet_hw_interface_t *hi;
69 u32 hw_if_index, *hw_if_indices = 0;
70 int i, verbose = -1, is_show, show_bond = 0;
72 is_show = strstr (cmd->path, "show") != 0;
73 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
75 /* See if user wants to show a specific interface. */
77 (input, "%U", unformat_vnet_hw_interface, vnm, &hw_if_index))
78 vec_add1 (hw_if_indices, hw_if_index);
80 /* See if user wants to show an interface with a specific hw_if_index. */
81 else if (unformat (input, "%u", &hw_if_index))
82 vec_add1 (hw_if_indices, hw_if_index);
84 else if (unformat (input, "verbose"))
85 verbose = 1; /* this is also the default */
87 else if (unformat (input, "detail"))
90 else if (unformat (input, "brief"))
93 else if (unformat (input, "bond"))
97 verbose = 0; /* default to brief for link bonding */
102 error = clib_error_return (0, "unknown input `%U'",
103 format_unformat_error, input);
108 /* Gather interfaces. */
109 if (vec_len (hw_if_indices) == 0)
110 pool_foreach (hi, im->hw_interfaces,
111 vec_add1 (hw_if_indices, hi - im->hw_interfaces));
114 verbose = 1; /* default to verbose (except bond) */
119 vec_sort_with_function (hw_if_indices, compare_interface_names);
121 vlib_cli_output (vm, "%U\n", format_vnet_hw_interface, vnm, 0, verbose);
122 for (i = 0; i < vec_len (hw_if_indices); i++)
124 hi = vnet_get_hw_interface (vnm, hw_if_indices[i]);
125 if (show_bond == 0) /* show all interfaces */
126 vlib_cli_output (vm, "%U\n", format_vnet_hw_interface, vnm,
128 else if ((hi->bond_info) &&
129 (hi->bond_info != VNET_HW_INTERFACE_BOND_INFO_SLAVE))
130 { /* show only bonded interface and all its slave interfaces */
132 vnet_hw_interface_t *shi;
133 vlib_cli_output (vm, "%U\n", format_vnet_hw_interface, vnm,
137 clib_bitmap_foreach (hw_idx, hi->bond_info,
139 shi = vnet_get_hw_interface(vnm, hw_idx);
140 vlib_cli_output (vm, "%U\n",
141 format_vnet_hw_interface, vnm, shi, verbose);
149 for (i = 0; i < vec_len (hw_if_indices); i++)
151 vnet_device_class_t *dc;
153 hi = vnet_get_hw_interface (vnm, hw_if_indices[i]);
154 dc = vec_elt_at_index (im->device_classes, hi->dev_class_index);
156 if (dc->clear_counters)
157 dc->clear_counters (hi->dev_instance);
162 vec_free (hw_if_indices);
168 * Displays various information about the state of the current terminal
172 * @cliexstart{show hardware}
174 * GigabitEthernet2/0/0 up GigabitEthernet2/0/0
175 * Ethernet address 00:50:56:b7:7c:83
176 * Intel 82545em_copper
177 * link up, media 1000T full-duplex, master,
178 * 0 unprocessed, 384 total buffers on rx queue 0 ring
179 * 237 buffers in driver rx cache
180 * rx total packets 1816
181 * rx total bytes 181084
182 * rx good packets 1816
183 * rx good bytes 181084
184 * rx 65 127 byte packets 1586
185 * rx 256 511 byte packets 230
186 * tx total packets 346
187 * tx total bytes 90224
188 * tx good packets 346
189 * tx good bytes 88840
190 * tx 64 byte packets 1
191 * tx 65 127 byte packets 115
192 * tx 256 511 byte packets 230
195 VLIB_CLI_COMMAND (show_hw_interfaces_command, static) = {
196 .path = "show hardware-interfaces",
197 .short_help = "show hardware-interfaces [brief|verbose|detail] [bond] [<if-name1> <if-name2> ...]",
198 .function = show_or_clear_hw_interfaces,
203 VLIB_CLI_COMMAND (clear_hw_interface_counters_command, static) = {
204 .path = "clear hardware-interfaces",
205 .short_help = "Clear hardware interfaces statistics",
206 .function = show_or_clear_hw_interfaces,
211 sw_interface_name_compare (void *a1, void *a2)
213 vnet_sw_interface_t *si1 = a1;
214 vnet_sw_interface_t *si2 = a2;
216 return vnet_sw_interface_compare (vnet_get_main (),
217 si1->sw_if_index, si2->sw_if_index);
220 static clib_error_t *
221 show_sw_interfaces (vlib_main_t * vm,
222 unformat_input_t * input, vlib_cli_command_t * cmd)
224 clib_error_t *error = 0;
225 vnet_main_t *vnm = vnet_get_main ();
226 vnet_interface_main_t *im = &vnm->interface_main;
227 vnet_sw_interface_t *si, *sorted_sis = 0;
228 u32 sw_if_index = ~(u32) 0;
229 u8 show_addresses = 0;
230 u8 show_features = 0;
233 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
235 /* See if user wants to show specific interface */
237 (input, "%U", unformat_vnet_sw_interface, vnm, &sw_if_index))
239 si = pool_elt_at_index (im->sw_interfaces, sw_if_index);
240 vec_add1 (sorted_sis, si[0]);
242 else if (unformat (input, "address") || unformat (input, "addr"))
244 else if (unformat (input, "features") || unformat (input, "feat"))
246 else if (unformat (input, "tag"))
250 error = clib_error_return (0, "unknown input `%U'",
251 format_unformat_error, input);
256 if (show_features || show_tag)
258 if (sw_if_index == ~(u32) 0)
259 return clib_error_return (0, "Interface not specified...");
264 vnet_interface_features_show (vm, sw_if_index);
270 tag = vnet_get_sw_interface_tag (vnm, sw_if_index);
271 vlib_cli_output (vm, "%U: %s",
272 format_vnet_sw_if_index_name, vnm, sw_if_index,
273 tag ? (char *) tag : "(none)");
278 vlib_cli_output (vm, "%U\n", format_vnet_sw_interface, vnm, 0);
280 if (vec_len (sorted_sis) == 0) /* Get all interfaces */
282 /* Gather interfaces. */
284 vec_new (vnet_sw_interface_t, pool_elts (im->sw_interfaces));
285 _vec_len (sorted_sis) = 0;
286 pool_foreach (si, im->sw_interfaces, (
288 vec_add1 (sorted_sis, si[0]);
293 vec_sort_with_function (sorted_sis, sw_interface_name_compare);
298 vec_foreach (si, sorted_sis)
300 l2input_main_t *l2m = &l2input_main;
301 ip4_main_t *im4 = &ip4_main;
302 ip6_main_t *im6 = &ip6_main;
303 ip_lookup_main_t *lm4 = &im4->lookup_main;
304 ip_lookup_main_t *lm6 = &im6->lookup_main;
305 ip_interface_address_t *ia = 0;
308 u32 fib_index4 = 0, fib_index6 = 0;
311 l2_input_config_t *config;
313 if (vec_len (im4->fib_index_by_sw_if_index) > si->sw_if_index)
314 fib_index4 = vec_elt (im4->fib_index_by_sw_if_index,
317 if (vec_len (im6->fib_index_by_sw_if_index) > si->sw_if_index)
318 fib_index6 = vec_elt (im6->fib_index_by_sw_if_index,
321 fib4 = ip4_fib_get (fib_index4);
322 fib6 = ip6_fib_get (fib_index6);
324 if (si->flags & VNET_SW_INTERFACE_FLAG_UNNUMBERED)
326 (vm, "%U (%s): \n unnumbered, use %U",
327 format_vnet_sw_if_index_name,
328 vnm, si->sw_if_index,
329 (si->flags & VNET_SW_INTERFACE_FLAG_ADMIN_UP) ? "up" : "dn",
330 format_vnet_sw_if_index_name, vnm, si->unnumbered_sw_if_index);
334 vlib_cli_output (vm, "%U (%s):",
335 format_vnet_sw_if_index_name,
336 vnm, si->sw_if_index,
337 (si->flags & VNET_SW_INTERFACE_FLAG_ADMIN_UP)
341 /* Display any L2 addressing info */
342 vec_validate (l2m->configs, si->sw_if_index);
343 config = vec_elt_at_index (l2m->configs, si->sw_if_index);
346 u32 bd_id = l2input_main.bd_configs[config->bd_index].bd_id;
347 vlib_cli_output (vm, " l2 bridge bd_id %d%s%d", bd_id,
348 config->bvi ? " bvi shg " : " shg ",
351 else if (config->xconnect)
353 vlib_cli_output (vm, " l2 xconnect %U",
354 format_vnet_sw_if_index_name,
355 vnm, config->output_sw_if_index);
358 /* Display any IP4 addressing info */
360 foreach_ip_interface_address (lm4, ia, si->sw_if_index,
361 1 /* honor unnumbered */,
363 r4 = ip_interface_address_get_address (lm4, ia);
366 vlib_cli_output (vm, " %U/%d table %d",
367 format_ip4_address, r4,
373 vlib_cli_output (vm, " %U/%d",
374 format_ip4_address, r4,
380 /* Display any IP6 addressing info */
382 foreach_ip_interface_address (lm6, ia, si->sw_if_index,
383 1 /* honor unnumbered */,
385 r6 = ip_interface_address_get_address (lm6, ia);
388 vlib_cli_output (vm, " %U/%d table %d",
389 format_ip6_address, r6,
395 vlib_cli_output (vm, " %U/%d",
396 format_ip6_address, r6,
405 vec_foreach (si, sorted_sis)
407 vlib_cli_output (vm, "%U\n", format_vnet_sw_interface, vnm, si);
412 vec_free (sorted_sis);
417 VLIB_CLI_COMMAND (show_sw_interfaces_command, static) = {
418 .path = "show interfaces",
419 .short_help = "show interfaces [address|addr|features|feat] [<if-name1> <if-name2> ...]",
420 .function = show_sw_interfaces,
424 /* Root of all interface commands. */
426 VLIB_CLI_COMMAND (vnet_cli_interface_command, static) = {
428 .short_help = "Interface commands",
433 VLIB_CLI_COMMAND (vnet_cli_set_interface_command, static) = {
434 .path = "set interface",
435 .short_help = "Interface commands",
439 static clib_error_t *
440 clear_interface_counters (vlib_main_t * vm,
441 unformat_input_t * input, vlib_cli_command_t * cmd)
443 vnet_main_t *vnm = vnet_get_main ();
444 vnet_interface_main_t *im = &vnm->interface_main;
445 vlib_simple_counter_main_t *sm;
446 vlib_combined_counter_main_t *cm;
447 static vnet_main_t **my_vnet_mains;
448 int i, j, n_counters;
450 vec_reset_length (my_vnet_mains);
452 for (i = 0; i < vec_len (vnet_mains); i++)
455 vec_add1 (my_vnet_mains, vnet_mains[i]);
458 if (vec_len (vnet_mains) == 0)
459 vec_add1 (my_vnet_mains, vnm);
461 n_counters = vec_len (im->combined_sw_if_counters);
463 for (j = 0; j < n_counters; j++)
465 for (i = 0; i < vec_len (my_vnet_mains); i++)
467 im = &my_vnet_mains[i]->interface_main;
468 cm = im->combined_sw_if_counters + j;
469 vlib_clear_combined_counters (cm);
473 n_counters = vec_len (im->sw_if_counters);
475 for (j = 0; j < n_counters; j++)
477 for (i = 0; i < vec_len (my_vnet_mains); i++)
479 im = &my_vnet_mains[i]->interface_main;
480 sm = im->sw_if_counters + j;
481 vlib_clear_simple_counters (sm);
489 VLIB_CLI_COMMAND (clear_interface_counters_command, static) = {
490 .path = "clear interfaces",
491 .short_help = "Clear interfaces statistics",
492 .function = clear_interface_counters,
497 * Parse subinterface names.
499 * The following subinterface syntax is supported. The first two are for
500 * backwards compatability:
503 * - a subinterface with the name <intf-name>.<id>. The subinterface
504 * is a single dot1q vlan with vlan id <id> and exact-match semantics.
506 * <intf-name> <min_id>-<max_id>
507 * - a set of the above subinterfaces, repeating for each id
508 * in the range <min_id> to <max_id>
510 * In the following, exact-match semantics (i.e. the number of vlan tags on the
511 * packet must match the number of tags in the configuration) are used only if
512 * the keyword exact-match is present. Non-exact match is the default.
514 * <intf-name> <id> dot1q <outer_id> [exact-match]
515 * - a subinterface with the name <intf-name>.<id>. The subinterface
516 * is a single dot1q vlan with vlan id <outer_id>.
518 * <intf-name> <id> dot1q any [exact-match]
519 * - a subinterface with the name <intf-name>.<id>. The subinterface
520 * is a single dot1q vlan with any vlan id.
522 * <intf-name> <id> dot1q <outer_id> inner-dot1q <inner_id> [exact-match]
523 * - a subinterface with the name <intf-name>.<id>. The subinterface
524 * is a double dot1q vlan with outer vlan id <outer_id> and inner vlan id
527 * <intf-name> <id> dot1q <outer_id> inner-dot1q any [exact-match]
528 * - a subinterface with the name <intf-name>.<id>. The subinterface
529 * is a double dot1q vlan with outer vlan id <id> and any inner vlan id.
531 * <intf-name> <id> dot1q any inner-dot1q any [exact-match]
533 * - a subinterface with the name <intf-name>.<id>. The subinterface
534 * is a double dot1q vlan with any outer vlan id and any inner vlan id.
536 * For each of the above CLI, there is a duplicate that uses the keyword
537 * "dot1ad" in place of the first "dot1q". These interfaces use ethertype
538 * 0x88ad in place of 0x8100 for the outer ethertype. Note that for double-
539 * tagged packets the inner ethertype is always 0x8100. Also note that
540 * the dot1q and dot1ad naming spaces are independent, so it is legal to
541 * have both "Gig3/0/0.1 dot1q 100" and "Gig3/0/0.2 dot1ad 100". For example:
543 * <intf-name> <id> dot1ad <outer_id> inner-dot1q <inner_id> [exact-match]
544 * - a subinterface with the name <intf-name>.<id>. The subinterface
545 * is a double dot1ad vlan with outer vlan id <outer_id> and inner vlan
548 * <intf-name> <id> untagged
549 * - a subinterface with the name <intf-name>.<id>. The subinterface
550 * has no vlan tags. Only one can be specified per interface.
552 * <intf-name> <id> default
553 * - a subinterface with the name <intf-name>.<id>. This is associated
554 * with a packet that did not match any other configured subinterface
555 * on this interface. Only one can be specified per interface.
558 static clib_error_t *
559 parse_vlan_sub_interfaces (unformat_input_t * input,
560 vnet_sw_interface_t * template)
562 clib_error_t *error = 0;
563 u32 inner_vlan, outer_vlan;
565 if (unformat (input, "any inner-dot1q any"))
567 template->sub.eth.flags.two_tags = 1;
568 template->sub.eth.flags.outer_vlan_id_any = 1;
569 template->sub.eth.flags.inner_vlan_id_any = 1;
571 else if (unformat (input, "any"))
573 template->sub.eth.flags.one_tag = 1;
574 template->sub.eth.flags.outer_vlan_id_any = 1;
576 else if (unformat (input, "%d inner-dot1q any", &outer_vlan))
578 template->sub.eth.flags.two_tags = 1;
579 template->sub.eth.flags.inner_vlan_id_any = 1;
580 template->sub.eth.outer_vlan_id = outer_vlan;
582 else if (unformat (input, "%d inner-dot1q %d", &outer_vlan, &inner_vlan))
584 template->sub.eth.flags.two_tags = 1;
585 template->sub.eth.outer_vlan_id = outer_vlan;
586 template->sub.eth.inner_vlan_id = inner_vlan;
588 else if (unformat (input, "%d", &outer_vlan))
590 template->sub.eth.flags.one_tag = 1;
591 template->sub.eth.outer_vlan_id = outer_vlan;
595 error = clib_error_return (0, "expected dot1q config, got `%U'",
596 format_unformat_error, input);
600 if (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
602 if (unformat (input, "exact-match"))
604 template->sub.eth.flags.exact_match = 1;
612 static clib_error_t *
613 create_sub_interfaces (vlib_main_t * vm,
614 unformat_input_t * input, vlib_cli_command_t * cmd)
616 vnet_main_t *vnm = vnet_get_main ();
617 clib_error_t *error = 0;
618 u32 hw_if_index, sw_if_index;
619 vnet_hw_interface_t *hi;
620 u32 id, id_min, id_max;
621 vnet_sw_interface_t template;
624 if (!unformat_user (input, unformat_vnet_hw_interface, vnm, &hw_if_index))
626 error = clib_error_return (0, "unknown interface `%U'",
627 format_unformat_error, input);
631 memset (&template, 0, sizeof (template));
632 template.sub.eth.raw_flags = 0;
634 if (unformat (input, "%d default", &id_min))
637 template.sub.eth.flags.default_sub = 1;
639 else if (unformat (input, "%d untagged", &id_min))
642 template.sub.eth.flags.no_tags = 1;
643 template.sub.eth.flags.exact_match = 1;
645 else if (unformat (input, "%d dot1q", &id_min))
647 /* parse dot1q config */
649 error = parse_vlan_sub_interfaces (input, &template);
653 else if (unformat (input, "%d dot1ad", &id_min))
655 /* parse dot1ad config */
657 template.sub.eth.flags.dot1ad = 1;
658 error = parse_vlan_sub_interfaces (input, &template);
662 else if (unformat (input, "%d-%d", &id_min, &id_max))
664 template.sub.eth.flags.one_tag = 1;
665 template.sub.eth.flags.exact_match = 1;
669 else if (unformat (input, "%d", &id_min))
672 template.sub.eth.flags.one_tag = 1;
673 template.sub.eth.outer_vlan_id = id_min;
674 template.sub.eth.flags.exact_match = 1;
679 error = clib_error_return (0, "expected ID or ID MIN-MAX, got `%U'",
680 format_unformat_error, input);
684 hi = vnet_get_hw_interface (vnm, hw_if_index);
686 if (hi->bond_info == VNET_HW_INTERFACE_BOND_INFO_SLAVE)
689 clib_error_return (0,
690 "not allowed as %v belong to a BondEthernet interface",
695 for (id = id_min; id <= id_max; id++)
698 vnet_interface_main_t *im = &vnm->interface_main;
699 u64 sup_and_sub_key = ((u64) (hi->sw_if_index) << 32) | (u64) id;
702 p = hash_get_mem (im->sw_if_index_by_sup_and_sub, &sup_and_sub_key);
706 clib_warning ("sup sw_if_index %d, sub id %d already exists\n",
707 hi->sw_if_index, id);
711 kp = clib_mem_alloc (sizeof (*kp));
712 *kp = sup_and_sub_key;
714 template.type = VNET_SW_INTERFACE_TYPE_SUB;
715 template.flood_class = VNET_FLOOD_CLASS_NORMAL;
716 template.sup_sw_if_index = hi->sw_if_index;
717 template.sub.id = id;
719 template.sub.eth.outer_vlan_id = id;
721 error = vnet_create_sw_interface (vnm, &template, &sw_if_index);
725 hash_set (hi->sub_interface_sw_if_index_by_id, id, sw_if_index);
726 hash_set_mem (im->sw_if_index_by_sup_and_sub, kp, sw_if_index);
727 vlib_cli_output (vm, "%U\n", format_vnet_sw_if_index_name,
728 vnet_get_main (), sw_if_index);
737 * Create vlan subinterfaces
740 * @cliexstart{create sub-interfaces}
742 * To create a vlan subinterface 11 to process packets on 802.1q VLAN id 11, use:
744 * vpp# create sub GigabitEthernet2/0/0 11
746 * This shorthand is equivalent to:
747 * vpp# create sub GigabitEthernet2/0/0 11 dot1q 11 exact-match
749 * You can specify a subinterface number that is different from the vlan id:
750 * vpp# create sub GigabitEthernet2/0/0 11 dot1q 100
752 * You can create qinq and q-in-any interfaces:
753 * vpp# create sub GigabitEthernet2/0/0 11 dot1q 100 inner-dot1q 200
754 * vpp# create sub GigabitEthernet2/0/0 12 dot1q 100 inner-dot1q any
756 * You can also create dot1ad interfaces:
757 * vpp# create sub GigabitEthernet2/0/0 11 dot1ad 11
758 * vpp# create sub GigabitEthernet2/0/0 12 dot1q 100 inner-dot1q 200
760 * Subinterfaces can be configured as either exact-match or non-exact match.
761 * Non-exact match is the CLI default. If exact-match is specified,
762 * packets must have the same number of vlan tags as the configuration.
763 * For non-exact-match, packets must at least that number of tags.
764 * L3 (routed) interfaces must be configured as exact-match.
765 * L2 interfaces are typically configured as non-exact-match.
767 * For example, a packet with outer vlan 100 and inner 200 would match this interface:
768 * vpp# create sub GigabitEthernet2/0/0 5 dot1q 100
770 * but would not match this interface:
771 * vpp# create sub GigabitEthernet2/0/0 5 dot1q 100 exact-match
773 * There are two special subinterfaces that can be configured. Subinterface untagged has no vlan tags:
774 * vpp# create sub GigabitEthernet2/0/0 5 untagged
776 * The subinterface default matches any packet that does not match any other subinterface:
777 * vpp# create sub GigabitEthernet2/0/0 7 default
780 VLIB_CLI_COMMAND (create_sub_interfaces_command, static) = {
781 .path = "create sub-interfaces",
782 .short_help = "create sub-interfaces <nn>[-<nn>] [dot1q|dot1ad|default|untagged]",
783 .function = create_sub_interfaces,
787 static clib_error_t *
788 set_state (vlib_main_t * vm,
789 unformat_input_t * input, vlib_cli_command_t * cmd)
791 vnet_main_t *vnm = vnet_get_main ();
793 u32 sw_if_index, flags;
796 if (!unformat_user (input, unformat_vnet_sw_interface, vnm, &sw_if_index))
798 error = clib_error_return (0, "unknown interface `%U'",
799 format_unformat_error, input);
803 if (!unformat (input, "%U", unformat_vnet_sw_interface_flags, &flags))
805 error = clib_error_return (0, "unknown flags `%U'",
806 format_unformat_error, input);
810 error = vnet_sw_interface_set_flags (vnm, sw_if_index, flags);
821 * Interface admin up/down
824 * @cliexstart{set interface state}
825 * vpp# set interface state GigabitEthernet2/0/0 up
826 * vpp# set interface state GigabitEthernet2/0/0 down
829 VLIB_CLI_COMMAND (set_state_command, static) = {
830 .path = "set interface state",
831 .short_help = "Set interface state",
832 .function = set_state,
836 static clib_error_t *
837 set_unnumbered (vlib_main_t * vm,
838 unformat_input_t * input, vlib_cli_command_t * cmd)
840 vnet_main_t *vnm = vnet_get_main ();
841 u32 unnumbered_sw_if_index;
842 u32 inherit_from_sw_if_index;
843 vnet_sw_interface_t *si;
847 if (unformat (input, "%U use %U",
848 unformat_vnet_sw_interface, vnm, &unnumbered_sw_if_index,
849 unformat_vnet_sw_interface, vnm, &inherit_from_sw_if_index))
851 else if (unformat (input, "del %U",
852 unformat_vnet_sw_interface, vnm,
853 &unnumbered_sw_if_index))
856 return clib_error_return (0, "parse error '%U'",
857 format_unformat_error, input);
859 si = vnet_get_sw_interface (vnm, unnumbered_sw_if_index);
862 si->flags &= ~(VNET_SW_INTERFACE_FLAG_UNNUMBERED);
863 si->unnumbered_sw_if_index = (u32) ~ 0;
864 ip4_sw_interface_enable_disable (unnumbered_sw_if_index, 0);
865 ip6_sw_interface_enable_disable (unnumbered_sw_if_index, 0);
869 si->flags |= VNET_SW_INTERFACE_FLAG_UNNUMBERED;
870 si->unnumbered_sw_if_index = inherit_from_sw_if_index;
871 ip4_sw_interface_enable_disable (unnumbered_sw_if_index, 1);
872 ip6_sw_interface_enable_disable (unnumbered_sw_if_index, 1);
879 VLIB_CLI_COMMAND (set_unnumbered_command, static) = {
880 .path = "set interface unnumbered",
881 .short_help = "set interface unnumbered [<intfc> use <intfc> | del <intfc>]",
882 .function = set_unnumbered,
888 static clib_error_t *
889 set_hw_class (vlib_main_t * vm,
890 unformat_input_t * input, vlib_cli_command_t * cmd)
892 vnet_main_t *vnm = vnet_get_main ();
893 vnet_interface_main_t *im = &vnm->interface_main;
895 u32 hw_if_index, hw_class_index;
898 if (!unformat_user (input, unformat_vnet_hw_interface, vnm, &hw_if_index))
900 error = clib_error_return (0, "unknown hardware interface `%U'",
901 format_unformat_error, input);
905 if (!unformat_user (input, unformat_hash_string,
906 im->hw_interface_class_by_name, &hw_class_index))
908 error = clib_error_return (0, "unknown hardware class `%U'",
909 format_unformat_error, input);
913 error = vnet_hw_interface_set_class (vnm, hw_if_index, hw_class_index);
922 VLIB_CLI_COMMAND (set_hw_class_command, static) = {
923 .path = "set interface hw-class",
924 .short_help = "Set interface hardware class",
925 .function = set_hw_class,
929 static clib_error_t *
930 vnet_interface_cli_init (vlib_main_t * vm)
935 VLIB_INIT_FUNCTION (vnet_interface_cli_init);
937 static clib_error_t *
938 renumber_interface_command_fn (vlib_main_t * vm,
939 unformat_input_t * input,
940 vlib_cli_command_t * cmd)
943 u32 new_dev_instance;
944 vnet_main_t *vnm = vnet_get_main ();
947 if (!unformat_user (input, unformat_vnet_hw_interface, vnm, &hw_if_index))
948 return clib_error_return (0, "unknown hardware interface `%U'",
949 format_unformat_error, input);
951 if (!unformat (input, "%d", &new_dev_instance))
952 return clib_error_return (0, "new dev instance missing");
954 rv = vnet_interface_name_renumber (hw_if_index, new_dev_instance);
962 return clib_error_return (0, "vnet_interface_name_renumber returned %d",
972 VLIB_CLI_COMMAND (renumber_interface_command, static) = {
973 .path = "renumber interface",
974 .short_help = "renumber interface <if-name> <new-dev-instance>",
975 .function = renumber_interface_command_fn,
979 static clib_error_t *
980 promiscuous_cmd (vlib_main_t * vm,
981 unformat_input_t * input, vlib_cli_command_t * cmd)
983 vnet_main_t *vnm = vnet_get_main ();
985 u32 flags = ETHERNET_INTERFACE_FLAG_ACCEPT_ALL;
986 ethernet_main_t *em = ðernet_main;
987 ethernet_interface_t *eif;
989 if (unformat (input, "on %U",
990 unformat_vnet_hw_interface, vnm, &hw_if_index))
992 else if (unformat (input, "off %U",
993 unformat_ethernet_interface, vnm, &hw_if_index))
996 return clib_error_return (0, "unknown input `%U'",
997 format_unformat_error, input);
999 eif = ethernet_get_interface (em, hw_if_index);
1001 return clib_error_return (0, "not supported");
1003 ethernet_set_flags (vnm, hw_if_index, flags);
1008 VLIB_CLI_COMMAND (set_interface_promiscuous_cmd, static) = {
1009 .path = "set interface promiscuous",
1010 .short_help = "set interface promiscuous [on | off] <intfc>",
1011 .function = promiscuous_cmd,
1015 static clib_error_t *
1016 mtu_cmd (vlib_main_t * vm, unformat_input_t * input, vlib_cli_command_t * cmd)
1018 vnet_main_t *vnm = vnet_get_main ();
1019 u32 hw_if_index, mtu;
1020 u32 flags = ETHERNET_INTERFACE_FLAG_MTU;
1021 ethernet_main_t *em = ðernet_main;
1023 if (unformat (input, "%d %U", &mtu,
1024 unformat_vnet_hw_interface, vnm, &hw_if_index))
1026 vnet_hw_interface_t *hi = vnet_get_hw_interface (vnm, hw_if_index);
1027 ethernet_interface_t *eif = ethernet_get_interface (em, hw_if_index);
1030 return clib_error_return (0, "not supported");
1032 if (mtu < hi->min_supported_packet_bytes)
1033 return clib_error_return (0, "Invalid mtu (%d): "
1034 "must be >= min pkt bytes (%d)", mtu,
1035 hi->min_supported_packet_bytes);
1037 if (mtu > hi->max_supported_packet_bytes)
1038 return clib_error_return (0, "Invalid mtu (%d): must be <= (%d)", mtu,
1039 hi->max_supported_packet_bytes);
1041 if (hi->max_packet_bytes != mtu)
1043 hi->max_packet_bytes = mtu;
1044 ethernet_set_flags (vnm, hw_if_index, flags);
1048 return clib_error_return (0, "unknown input `%U'",
1049 format_unformat_error, input);
1054 VLIB_CLI_COMMAND (set_interface_mtu_cmd, static) = {
1055 .path = "set interface mtu",
1056 .short_help = "set interface mtu <value> <intfc>",
1057 .function = mtu_cmd,
1061 static clib_error_t *
1062 set_interface_mac_address (vlib_main_t * vm, unformat_input_t * input,
1063 vlib_cli_command_t * cmd)
1065 vnet_main_t *vnm = vnet_get_main ();
1066 clib_error_t *error = 0;
1067 u32 sw_if_index = ~0;
1070 if (!unformat_user (input, unformat_vnet_sw_interface, vnm, &sw_if_index))
1072 error = clib_error_return (0, "unknown interface `%U'",
1073 format_unformat_error, input);
1076 if (!unformat_user (input, unformat_ethernet_address, &mac))
1078 error = clib_error_return (0, "expected mac address `%U'",
1079 format_unformat_error, input);
1082 error = vnet_hw_interface_change_mac_address (vnm, sw_if_index, mac);
1088 * The '<em>set interface mac address </em>' command allows to set MAC address of given interface.
1089 * In case of NIC interfaces the one has to support MAC address change. A side effect of MAC address
1090 * change are changes of MAC addresses in FIB tables (ipv4 and ipv6).
1094 * Example of how to change MAC Address of interface:
1095 * @cliexcmd{set interface mac address GigabitEthernet0/8/0 aa:bb:cc:dd:ee:01}
1096 * @cliexcmd{set interface mac address host-vpp0 aa:bb:cc:dd:ee:02}
1097 * @cliexcmd{set interface mac address tap-0 aa:bb:cc:dd:ee:03}
1098 * @cliexcmd{set interface mac address pg0 aa:bb:cc:dd:ee:04}
1102 VLIB_CLI_COMMAND (set_interface_mac_address_cmd, static) = {
1103 .path = "set interface mac address",
1104 .short_help = "set interface mac address <intfc> <mac-address>",
1105 .function = set_interface_mac_address,
1109 static clib_error_t *
1110 set_tag (vlib_main_t * vm, unformat_input_t * input, vlib_cli_command_t * cmd)
1112 vnet_main_t *vnm = vnet_get_main ();
1113 u32 sw_if_index = ~0;
1116 if (!unformat (input, "%U %s", unformat_vnet_sw_interface,
1117 vnm, &sw_if_index, &tag))
1118 return clib_error_return (0, "unknown input `%U'",
1119 format_unformat_error, input);
1121 vnet_set_sw_interface_tag (vnm, tag, sw_if_index);
1127 VLIB_CLI_COMMAND (set_tag_command, static) = {
1128 .path = "set interface tag",
1129 .short_help = "set interface tag <intfc> <tag>",
1130 .function = set_tag,
1134 static clib_error_t *
1135 clear_tag (vlib_main_t * vm, unformat_input_t * input,
1136 vlib_cli_command_t * cmd)
1138 vnet_main_t *vnm = vnet_get_main ();
1139 u32 sw_if_index = ~0;
1141 if (!unformat (input, "%U", unformat_vnet_sw_interface, vnm, &sw_if_index))
1142 return clib_error_return (0, "unknown input `%U'",
1143 format_unformat_error, input);
1145 vnet_clear_sw_interface_tag (vnm, sw_if_index);
1151 VLIB_CLI_COMMAND (clear_tag_command, static) = {
1152 .path = "clear interface tag",
1153 .short_help = "clear interface tag <intfc>",
1154 .function = clear_tag,
1160 * fd.io coding-style-patch-verification: ON
1163 * eval: (c-set-style "gnu")