src/vnet/adj/adj.c

   1 /*
   2  * Copyright (c) 2016 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 #include <vnet/adj/adj.h>
  17 #include <vnet/adj/adj_internal.h>
  18 #include <vnet/adj/adj_glean.h>
  19 #include <vnet/adj/adj_midchain.h>
  20 #include <vnet/adj/adj_mcast.h>
  21 #include <vnet/adj/adj_delegate.h>
  22 #include <vnet/fib/fib_node_list.h>
  23
  24 /* Adjacency packet/byte counters indexed by adjacency index. */
  25 vlib_combined_counter_main_t adjacency_counters = {
  26     .name = "adjacency",
  27     .stat_segment_name = "/net/adjacency",
  28 };
  29
  30 /*
  31  * the single adj pool
  32  */
  33 ip_adjacency_t *adj_pool;
  34
  35 /**
  36  * @brief Global Config for enabling per-adjacency counters.
  37  * By default these are disabled.
  38  */
  39 int adj_per_adj_counters;
  40
  41 const ip46_address_t ADJ_BCAST_ADDR = {
  42     .ip6 = {
  43         .as_u64[0] = 0xffffffffffffffff,
  44         .as_u64[1] = 0xffffffffffffffff,
  45     },
  46 };
  47
  48 /**
  49  * Adj flag names
  50  */
  51 static const char *adj_attr_names[] = ADJ_ATTR_NAMES;
  52
  53 always_inline void
  54 adj_poison (ip_adjacency_t * adj)
  55 {
  56     if (CLIB_DEBUG > 0)
  57     {
  58         clib_memset (adj, 0xfe, sizeof (adj[0]));
  59     }
  60 }
  61
  62 ip_adjacency_t *
  63 adj_alloc (fib_protocol_t proto)
  64 {
  65     ip_adjacency_t *adj;
  66     u8 need_barrier_sync = 0;
  67     vlib_main_t *vm;
  68     vm = vlib_get_main();
  69
  70     ASSERT (vm->thread_index == 0);
  71
  72     pool_get_aligned_will_expand (adj_pool, need_barrier_sync,
  73                                   CLIB_CACHE_LINE_BYTES);
  74     /* If the adj_pool will expand, stop the parade. */
  75     if (need_barrier_sync)
  76         vlib_worker_thread_barrier_sync (vm);
  77
  78     pool_get_aligned(adj_pool, adj, CLIB_CACHE_LINE_BYTES);
  79
  80     adj_poison(adj);
  81
  82     /* Validate adjacency counters. */
  83     if (need_barrier_sync == 0)
  84     {
  85         /* If the adj counter pool will expand, stop the parade */
  86         need_barrier_sync = vlib_validate_combined_counter_will_expand
  87             (&adjacency_counters, adj_get_index (adj));
  88         if (need_barrier_sync)
  89             vlib_worker_thread_barrier_sync (vm);
  90     }
  91     vlib_validate_combined_counter(&adjacency_counters,
  92                                    adj_get_index(adj));
  93
  94     /* Make sure certain fields are always initialized. */
  95     vlib_zero_combined_counter(&adjacency_counters,
  96                                adj_get_index(adj));
  97     fib_node_init(&adj->ia_node,
  98                   FIB_NODE_TYPE_ADJ);
  99
 100     adj->ia_nh_proto = proto;
 101     adj->ia_flags = 0;
 102     adj->ia_cfg_index = 0;
 103     adj->rewrite_header.sw_if_index = ~0;
 104     adj->rewrite_header.flags = 0;
 105     adj->lookup_next_index = 0;
 106     adj->ia_delegates = NULL;
 107
 108     /* lest it become a midchain in the future */
 109     clib_memset(&adj->sub_type.midchain.next_dpo, 0,
 110            sizeof(adj->sub_type.midchain.next_dpo));
 111
 112     if (need_barrier_sync)
 113         vlib_worker_thread_barrier_release (vm);
 114
 115     return (adj);
 116 }
 117
 118 static int
 119 adj_index_is_special (adj_index_t adj_index)
 120 {
 121     if (ADJ_INDEX_INVALID == adj_index)
 122         return (!0);
 123
 124     return (0);
 125 }
 126
 127 u8*
 128 format_adj_flags (u8 * s, va_list * args)
 129 {
 130     adj_flags_t af;
 131     adj_attr_t at;
 132
 133     af = va_arg (*args, int);
 134
 135     if (ADJ_FLAG_NONE == af)
 136     {
 137         return (format(s, "None"));
 138     }
 139     FOR_EACH_ADJ_ATTR(at)
 140     {
 141         if (af & (1 << at))
 142         {
 143             s = format(s, "%s ", adj_attr_names[at]);
 144         }
 145     }
 146     return (s);
 147 }
 148
 149 /**
 150  * @brief Pretty print helper function for formatting specific adjacencies.
 151  * @param s - input string to format
 152  * @param args - other args passed to format function such as:
 153  *                 - vnet_main_t
 154  *                 - ip_lookup_main_t
 155  *                 - adj_index
 156  */
 157 u8 *
 158 format_ip_adjacency (u8 * s, va_list * args)
 159 {
 160     format_ip_adjacency_flags_t fiaf;
 161     ip_adjacency_t * adj;
 162     u32 adj_index;
 163
 164     adj_index = va_arg (*args, u32);
 165     fiaf = va_arg (*args, format_ip_adjacency_flags_t);
 166
 167     if (!adj_is_valid(adj_index))
 168       return format(s, "<invalid adjacency>");
 169
 170     adj = adj_get(adj_index);
 171
 172     switch (adj->lookup_next_index)
 173     {
 174     case IP_LOOKUP_NEXT_REWRITE:
 175     case IP_LOOKUP_NEXT_BCAST:
 176         s = format (s, "%U", format_adj_nbr, adj_index, 0);
 177         break;
 178     case IP_LOOKUP_NEXT_ARP:
 179         s = format (s, "%U", format_adj_nbr_incomplete, adj_index, 0);
 180         break;
 181     case IP_LOOKUP_NEXT_GLEAN:
 182         s = format (s, "%U", format_adj_glean, adj_index, 0);
 183         break;
 184     case IP_LOOKUP_NEXT_MIDCHAIN:
 185         s = format (s, "%U", format_adj_midchain, adj_index, 2);
 186         break;
 187     case IP_LOOKUP_NEXT_MCAST:
 188         s = format (s, "%U", format_adj_mcast, adj_index, 0);
 189         break;
 190     case IP_LOOKUP_NEXT_MCAST_MIDCHAIN:
 191         s = format (s, "%U", format_adj_mcast_midchain, adj_index, 0);
 192         break;
 193     case IP_LOOKUP_NEXT_DROP:
 194     case IP_LOOKUP_NEXT_PUNT:
 195     case IP_LOOKUP_NEXT_LOCAL:
 196     case IP_LOOKUP_NEXT_ICMP_ERROR:
 197     case IP_LOOKUP_N_NEXT:
 198         break;
 199     }
 200
 201     if (fiaf & FORMAT_IP_ADJACENCY_DETAIL)
 202     {
 203         vlib_counter_t counts;
 204
 205         vlib_get_combined_counter(&adjacency_counters, adj_index, &counts);
 206         s = format (s, "\n   flags:%U", format_adj_flags, adj->ia_flags);
 207         s = format (s, "\n   counts:[%Ld:%Ld]", counts.packets, counts.bytes);
 208         s = format (s, "\n   locks:%d", adj->ia_node.fn_locks);
 209         s = format(s, "\n delegates:");
 210         s = adj_delegate_format(s, adj);
 211
 212         s = format(s, "\n children:");
 213         if (fib_node_list_get_size(adj->ia_node.fn_children))
 214         {
 215             s = format(s, "\n  ");
 216             s = fib_node_children_format(adj->ia_node.fn_children, s);
 217         }
 218     }
 219
 220     return s;
 221 }
 222
 223 int
 224 adj_recursive_loop_detect (adj_index_t ai,
 225                            fib_node_index_t **entry_indicies)
 226 {
 227     ip_adjacency_t * adj;
 228
 229     adj = adj_get(ai);
 230
 231     switch (adj->lookup_next_index)
 232     {
 233     case IP_LOOKUP_NEXT_REWRITE:
 234     case IP_LOOKUP_NEXT_ARP:
 235     case IP_LOOKUP_NEXT_GLEAN:
 236     case IP_LOOKUP_NEXT_MCAST:
 237     case IP_LOOKUP_NEXT_BCAST:
 238     case IP_LOOKUP_NEXT_DROP:
 239     case IP_LOOKUP_NEXT_PUNT:
 240     case IP_LOOKUP_NEXT_LOCAL:
 241     case IP_LOOKUP_NEXT_ICMP_ERROR:
 242     case IP_LOOKUP_N_NEXT:
 243         /*
 244          * these adjacency types are terminal graph nodes, so there's no
 245          * possibility of a loop down here.
 246          */
 247         break;
 248     case IP_LOOKUP_NEXT_MIDCHAIN:
 249     case IP_LOOKUP_NEXT_MCAST_MIDCHAIN:
 250         return (adj_ndr_midchain_recursive_loop_detect(ai, entry_indicies));
 251     }
 252
 253     return (0);
 254 }
 255
 256 /*
 257  * adj_last_lock_gone
 258  *
 259  * last lock/reference to the adj has gone, we no longer need it.
 260  */
 261 static void
 262 adj_last_lock_gone (ip_adjacency_t *adj)
 263 {
 264     vlib_main_t * vm = vlib_get_main();
 265
 266     ASSERT(0 == fib_node_list_get_size(adj->ia_node.fn_children));
 267     ADJ_DBG(adj, "last-lock-gone");
 268
 269     adj_delegate_adj_deleted(adj);
 270
 271     vlib_worker_thread_barrier_sync (vm);
 272
 273     switch (adj->lookup_next_index)
 274     {
 275     case IP_LOOKUP_NEXT_MIDCHAIN:
 276         adj_midchain_teardown(adj);
 277         /* FALL THROUGH */
 278     case IP_LOOKUP_NEXT_ARP:
 279     case IP_LOOKUP_NEXT_REWRITE:
 280     case IP_LOOKUP_NEXT_BCAST:
 281         /*
 282          * complete and incomplete nbr adjs
 283          */
 284         adj_nbr_remove(adj_get_index(adj),
 285                        adj->ia_nh_proto,
 286                        adj->ia_link,
 287                        &adj->sub_type.nbr.next_hop,
 288                        adj->rewrite_header.sw_if_index);
 289         break;
 290     case IP_LOOKUP_NEXT_GLEAN:
 291         adj_glean_remove(adj->ia_nh_proto,
 292                          adj->rewrite_header.sw_if_index);
 293         break;
 294     case IP_LOOKUP_NEXT_MCAST_MIDCHAIN:
 295         adj_midchain_teardown(adj);
 296         /* FALL THROUGH */
 297     case IP_LOOKUP_NEXT_MCAST:
 298         adj_mcast_remove(adj->ia_nh_proto,
 299                          adj->rewrite_header.sw_if_index);
 300         break;
 301     case IP_LOOKUP_NEXT_DROP:
 302     case IP_LOOKUP_NEXT_PUNT:
 303     case IP_LOOKUP_NEXT_LOCAL:
 304     case IP_LOOKUP_NEXT_ICMP_ERROR:
 305     case IP_LOOKUP_N_NEXT:
 306         /*
 307          * type not stored in any DB from which we need to remove it
 308          */
 309         break;
 310     }
 311
 312     vlib_worker_thread_barrier_release(vm);
 313
 314     fib_node_deinit(&adj->ia_node);
 315     ASSERT(0 == vec_len(adj->ia_delegates));
 316     vec_free(adj->ia_delegates);
 317     pool_put(adj_pool, adj);
 318 }
 319
 320 u32
 321 adj_dpo_get_urpf (const dpo_id_t *dpo)
 322 {
 323     ip_adjacency_t *adj;
 324
 325     adj = adj_get(dpo->dpoi_index);
 326
 327     return (adj->rewrite_header.sw_if_index);
 328 }
 329
 330 void
 331 adj_lock (adj_index_t adj_index)
 332 {
 333     ip_adjacency_t *adj;
 334
 335     if (adj_index_is_special(adj_index))
 336     {
 337         return;
 338     }
 339
 340     adj = adj_get(adj_index);
 341     ASSERT(adj);
 342
 343     ADJ_DBG(adj, "lock");
 344     fib_node_lock(&adj->ia_node);
 345 }
 346
 347 void
 348 adj_unlock (adj_index_t adj_index)
 349 {
 350     ip_adjacency_t *adj;
 351
 352     if (adj_index_is_special(adj_index))
 353     {
 354         return;
 355     }
 356
 357     adj = adj_get(adj_index);
 358     ASSERT(adj);
 359
 360     ADJ_DBG(adj, "unlock");
 361     ASSERT(adj);
 362
 363     fib_node_unlock(&adj->ia_node);
 364 }
 365
 366 u32
 367 adj_child_add (adj_index_t adj_index,
 368                fib_node_type_t child_type,
 369                fib_node_index_t child_index)
 370 {
 371     ASSERT(ADJ_INDEX_INVALID != adj_index);
 372     if (adj_index_is_special(adj_index))
 373     {
 374         return (~0);
 375     }
 376
 377     return (fib_node_child_add(FIB_NODE_TYPE_ADJ,
 378                                adj_index,
 379                                child_type,
 380                                child_index));
 381 }
 382
 383 void
 384 adj_child_remove (adj_index_t adj_index,
 385                   u32 sibling_index)
 386 {
 387     if (adj_index_is_special(adj_index))
 388     {
 389         return;
 390     }
 391
 392     fib_node_child_remove(FIB_NODE_TYPE_ADJ,
 393                           adj_index,
 394                           sibling_index);
 395 }
 396
 397 /*
 398  * Context for the walk to update the cached feature flags.
 399  */
 400 typedef struct adj_feature_update_t_
 401 {
 402     u8 arc;
 403     u8 enable;
 404 } adj_feature_update_ctx_t;
 405
 406 static adj_walk_rc_t
 407 adj_feature_update_walk_cb (adj_index_t ai,
 408                             void *arg)
 409 {
 410     adj_feature_update_ctx_t *ctx = arg;
 411     ip_adjacency_t *adj;
 412
 413     adj = adj_get(ai);
 414
 415     /*
 416      * this ugly mess matches the feature arc that is changing with affected
 417      * adjacencies
 418      */
 419     if (((ctx->arc == ip6_main.lookup_main.output_feature_arc_index) &&
 420          (VNET_LINK_IP6 == adj->ia_link)) ||
 421         ((ctx->arc == ip4_main.lookup_main.output_feature_arc_index) &&
 422          (VNET_LINK_IP4 == adj->ia_link)) ||
 423         ((ctx->arc == mpls_main.output_feature_arc_index) &&
 424          (VNET_LINK_MPLS == adj->ia_link)))
 425     {
 426         vnet_feature_main_t *fm = &feature_main;
 427         vnet_feature_config_main_t *cm;
 428
 429         cm = &fm->feature_config_mains[ctx->arc];
 430
 431         if (ctx->enable)
 432             adj->rewrite_header.flags |= VNET_REWRITE_HAS_FEATURES;
 433         else
 434             adj->rewrite_header.flags &= ~VNET_REWRITE_HAS_FEATURES;
 435
 436         adj->ia_cfg_index = vec_elt (cm->config_index_by_sw_if_index,
 437                                      adj->rewrite_header.sw_if_index);
 438     }
 439     return (ADJ_WALK_RC_CONTINUE);
 440 }
 441
 442 static void
 443 adj_feature_update (u32 sw_if_index,
 444                     u8 arc_index,
 445                     u8 is_enable,
 446                     void *data)
 447 {
 448     /*
 449      * Walk all the adjacencies on the interface to update the cached
 450      * 'has-features' flag
 451      */
 452     adj_feature_update_ctx_t ctx = {
 453         .arc = arc_index,
 454         .enable = is_enable,
 455     };
 456     adj_walk (sw_if_index, adj_feature_update_walk_cb, &ctx);
 457 }
 458
 459 static adj_walk_rc_t
 460 adj_mtu_update_walk_cb (adj_index_t ai,
 461                         void *arg)
 462 {
 463     ip_adjacency_t *adj;
 464
 465     adj = adj_get(ai);
 466
 467     vnet_rewrite_update_mtu (vnet_get_main(), adj->ia_link,
 468                              &adj->rewrite_header);
 469
 470     return (ADJ_WALK_RC_CONTINUE);
 471 }
 472
 473 static clib_error_t *
 474 adj_mtu_update (vnet_main_t * vnm, u32 sw_if_index, u32 flags)
 475 {
 476   adj_walk (sw_if_index, adj_mtu_update_walk_cb, NULL);
 477
 478   return (NULL);
 479 }
 480
 481 VNET_SW_INTERFACE_MTU_CHANGE_FUNCTION(adj_mtu_update);
 482
 483 /**
 484  * @brief Walk the Adjacencies on a given interface
 485  */
 486 void
 487 adj_walk (u32 sw_if_index,
 488           adj_walk_cb_t cb,
 489           void *ctx)
 490 {
 491     /*
 492      * walk all the neighbor adjacencies
 493      */
 494     fib_protocol_t proto;
 495
 496     FOR_EACH_FIB_IP_PROTOCOL(proto)
 497     {
 498         adj_nbr_walk(sw_if_index, proto, cb, ctx);
 499         adj_mcast_walk(sw_if_index, proto, cb, ctx);
 500     }
 501 }
 502
 503 /**
 504  * @brief Return the link type of the adjacency
 505  */
 506 vnet_link_t
 507 adj_get_link_type (adj_index_t ai)
 508 {
 509     const ip_adjacency_t *adj;
 510
 511     adj = adj_get(ai);
 512
 513     return (adj->ia_link);
 514 }
 515
 516 /**
 517  * @brief Return the sw interface index of the adjacency.
 518  */
 519 u32
 520 adj_get_sw_if_index (adj_index_t ai)
 521 {
 522     const ip_adjacency_t *adj;
 523
 524     adj = adj_get(ai);
 525
 526     return (adj->rewrite_header.sw_if_index);
 527 }
 528
 529 /**
 530  * @brief Return true if the adjacency is 'UP', i.e. can be used for forwarding
 531  * 0 is down, !0 is up.
 532  */
 533 int
 534 adj_is_up (adj_index_t ai)
 535 {
 536     return (adj_bfd_is_up(ai));
 537 }
 538
 539 /**
 540  * @brief Return the rewrite string of the adjacency
 541  */
 542 const u8*
 543 adj_get_rewrite (adj_index_t ai)
 544 {
 545     vnet_rewrite_header_t *rw;
 546     ip_adjacency_t *adj;
 547
 548     adj = adj_get(ai);
 549     rw = &adj->rewrite_header;
 550
 551     ASSERT (rw->data_bytes != 0xfefe);
 552
 553     return (rw->data - rw->data_bytes);
 554 }
 555
 556 static fib_node_t *
 557 adj_get_node (fib_node_index_t index)
 558 {
 559     ip_adjacency_t *adj;
 560
 561     adj = adj_get(index);
 562
 563     return (&adj->ia_node);
 564 }
 565
 566 #define ADJ_FROM_NODE(_node)                                            \
 567     ((ip_adjacency_t*)((char*)_node - STRUCT_OFFSET_OF(ip_adjacency_t, ia_node)))
 568
 569 static void
 570 adj_node_last_lock_gone (fib_node_t *node)
 571 {
 572     adj_last_lock_gone(ADJ_FROM_NODE(node));
 573 }
 574
 575 static fib_node_back_walk_rc_t
 576 adj_back_walk_notify (fib_node_t *node,
 577                       fib_node_back_walk_ctx_t *ctx)
 578 {
 579     ip_adjacency_t *adj;
 580
 581     adj = ADJ_FROM_NODE(node);
 582
 583     switch (adj->lookup_next_index)
 584     {
 585     case IP_LOOKUP_NEXT_MIDCHAIN:
 586         adj_midchain_delegate_restack(adj_get_index(adj));
 587         break;
 588     case IP_LOOKUP_NEXT_ARP:
 589     case IP_LOOKUP_NEXT_REWRITE:
 590     case IP_LOOKUP_NEXT_BCAST:
 591     case IP_LOOKUP_NEXT_GLEAN:
 592     case IP_LOOKUP_NEXT_MCAST:
 593     case IP_LOOKUP_NEXT_MCAST_MIDCHAIN:
 594     case IP_LOOKUP_NEXT_DROP:
 595     case IP_LOOKUP_NEXT_PUNT:
 596     case IP_LOOKUP_NEXT_LOCAL:
 597     case IP_LOOKUP_NEXT_ICMP_ERROR:
 598     case IP_LOOKUP_N_NEXT:
 599         /*
 600          * Que pasa. yo soj en el final!
 601          */
 602         ASSERT(0);
 603         break;
 604     }
 605
 606     return (FIB_NODE_BACK_WALK_CONTINUE);
 607 }
 608
 609 /*
 610  * Adjacency's graph node virtual function table
 611  */
 612 static const fib_node_vft_t adj_vft = {
 613     .fnv_get = adj_get_node,
 614     .fnv_last_lock = adj_node_last_lock_gone,
 615     .fnv_back_walk = adj_back_walk_notify,
 616 };
 617
 618 static clib_error_t *
 619 adj_module_init (vlib_main_t * vm)
 620 {
 621     fib_node_register_type(FIB_NODE_TYPE_ADJ, &adj_vft);
 622
 623     adj_nbr_module_init();
 624     adj_glean_module_init();
 625     adj_midchain_module_init();
 626     adj_mcast_module_init();
 627
 628     vnet_feature_register(adj_feature_update, NULL);
 629
 630     return (NULL);
 631 }
 632
 633 VLIB_INIT_FUNCTION (adj_module_init);
 634
 635 static clib_error_t *
 636 adj_show (vlib_main_t * vm,
 637           unformat_input_t * input,
 638           vlib_cli_command_t * cmd)
 639 {
 640     adj_index_t ai = ADJ_INDEX_INVALID;
 641     u32 sw_if_index = ~0;
 642     int summary = 0;
 643
 644     while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
 645     {
 646         if (unformat (input, "%d", &ai))
 647             ;
 648         else if (unformat (input, "summary") || unformat (input, "sum"))
 649             summary = 1;
 650         else if (unformat (input, "%U",
 651                            unformat_vnet_sw_interface, vnet_get_main(),
 652                            &sw_if_index))
 653             ;
 654         else
 655             break;
 656     }
 657
 658     if (summary)
 659     {
 660         vlib_cli_output (vm, "Number of adjacencies: %d", pool_elts(adj_pool));
 661         vlib_cli_output (vm, "Per-adjacency counters: %s",
 662                          (adj_are_counters_enabled() ?
 663                           "enabled":
 664                           "disabled"));
 665     }
 666     else
 667     {
 668         if (ADJ_INDEX_INVALID != ai)
 669         {
 670             if (pool_is_free_index(adj_pool, ai))
 671             {
 672                 vlib_cli_output (vm, "adjacency %d invalid", ai);
 673                 return 0;
 674             }
 675
 676             vlib_cli_output (vm, "[@%d] %U",
 677                              ai,
 678                              format_ip_adjacency,  ai,
 679                              FORMAT_IP_ADJACENCY_DETAIL);
 680         }
 681         else
 682         {
 683             /* *INDENT-OFF* */
 684             pool_foreach_index(ai, adj_pool,
 685             ({
 686                 if (~0 != sw_if_index &&
 687                     sw_if_index != adj_get_sw_if_index(ai))
 688                 {
 689                 }
 690                 else
 691                 {
 692                     vlib_cli_output (vm, "[@%d] %U",
 693                                      ai,
 694                                      format_ip_adjacency, ai,
 695                                      FORMAT_IP_ADJACENCY_NONE);
 696                 }
 697             }));
 698             /* *INDENT-ON* */
 699         }
 700     }
 701     return 0;
 702 }
 703
 704 /*?
 705  * Show all adjacencies.
 706  * @cliexpar
 707  * @cliexstart{sh adj}
 708  * [@0]
 709  * [@1]  glean: loop0
 710  * [@2] ipv4 via 1.0.0.2 loop0: IP4: 00:00:22:aa:bb:cc -> 00:00:11:aa:bb:cc
 711  * [@3] mpls via 1.0.0.2 loop0: MPLS: 00:00:22:aa:bb:cc -> 00:00:11:aa:bb:cc
 712  * [@4] ipv4 via 1.0.0.3 loop0: IP4: 00:00:22:aa:bb:cc -> 00:00:11:aa:bb:cc
 713  * [@5] mpls via 1.0.0.3 loop0: MPLS: 00:00:22:aa:bb:cc -> 00:00:11:aa:bb:cc
 714  * @cliexend
 715  ?*/
 716 VLIB_CLI_COMMAND (adj_show_command, static) = {
 717     .path = "show adj",
 718     .short_help = "show adj [<adj_index>] [interface] [summary]",
 719     .function = adj_show,
 720 };
 721
 722 /**
 723  * @brief CLI invoked function to enable/disable per-adj counters
 724  */
 725 static clib_error_t *
 726 adj_cli_counters_set (vlib_main_t * vm,
 727                       unformat_input_t * input,
 728                       vlib_cli_command_t * cmd)
 729 {
 730     clib_error_t *error = NULL;
 731     int enable = ~0;
 732
 733     while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
 734     {
 735         if (unformat (input, "enable"))
 736             enable = 1;
 737         else if (unformat (input, "disable"))
 738             enable = 0;
 739         else
 740             break;
 741     }
 742
 743     if (enable != ~0)
 744     {
 745         /* user requested something sensible */
 746         adj_per_adj_counters = enable;
 747     }
 748     else
 749     {
 750         error = clib_error_return (0, "specify 'enable' or 'disable'");
 751     }
 752
 753     return (error);
 754 }
 755
 756 /*?
 757  * Enable/disable per-adjacency counters. This is optional because it comes
 758  * with a non-negligible performance cost.
 759  ?*/
 760 VLIB_CLI_COMMAND (adj_cli_counters_set_command, static) = {
 761     .path = "adjacency counters",
 762     .short_help = "adjacency counters [enable|disable]",
 763     .function = adj_cli_counters_set,
 764 };