2 *------------------------------------------------------------------
3 * Copyright (c) 2018 Cisco and/or its affiliates.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at:
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 *------------------------------------------------------------------
20 #include <sys/types.h>
23 #include <vlibapi/api.h>
24 #include <vlibmemory/api.h>
27 vl_api_show_histogram_command (vlib_main_t * vm,
28 unformat_input_t * input,
29 vlib_cli_command_t * cli_cmd)
34 for (i = 0; i < SLEEP_N_BUCKETS; i++)
36 total_counts += vector_rate_histogram[i];
39 if (total_counts == 0)
41 vlib_cli_output (vm, "No control-plane activity.");
48 percent = ((f64) vector_rate_histogram[SLEEP_##n##_US]) \
49 / (f64) total_counts; \
51 vlib_cli_output (vm, "Sleep %3d us: %llu, %.2f%%",n, \
52 vector_rate_histogram[SLEEP_##n##_US], \
55 foreach_histogram_bucket;
62 * Display the binary api sleep-time histogram
65 VLIB_CLI_COMMAND (cli_show_api_histogram_command, static) =
67 .path = "show api histogram",
68 .short_help = "show api histogram",
69 .function = vl_api_show_histogram_command,
74 vl_api_clear_histogram_command (vlib_main_t * vm,
75 unformat_input_t * input,
76 vlib_cli_command_t * cli_cmd)
80 for (i = 0; i < SLEEP_N_BUCKETS; i++)
81 vector_rate_histogram[i] = 0;
86 * Clear the binary api sleep-time histogram
89 VLIB_CLI_COMMAND (cli_clear_api_histogram_command, static) =
91 .path = "clear api histogram",
92 .short_help = "clear api histogram",
93 .function = vl_api_clear_histogram_command,
98 vl_api_client_command (vlib_main_t * vm,
99 unformat_input_t * input, vlib_cli_command_t * cli_cmd)
101 vl_api_registration_t **regpp, *regp;
104 api_main_t *am = &api_main;
105 u32 *confused_indices = 0;
107 if (!pool_elts (am->vl_clients))
109 vlib_cli_output (vm, "Shared memory clients");
110 vlib_cli_output (vm, "%20s %8s %14s %18s %s",
111 "Name", "PID", "Queue Length", "Queue VA", "Health");
114 pool_foreach (regpp, am->vl_clients,
120 if (regp->unanswered_pings > 0)
121 health = "questionable";
125 q = regp->vl_input_queue;
127 vlib_cli_output (vm, "%20s %8d %14d 0x%016llx %s\n",
128 regp->name, q->consumer_pid, q->cursize,
133 clib_warning ("NULL client registration index %d",
134 regpp - am->vl_clients);
135 vec_add1 (confused_indices, regpp - am->vl_clients);
140 /* This should "never happen," but if it does, fix it... */
141 if (PREDICT_FALSE (vec_len (confused_indices) > 0))
144 for (i = 0; i < vec_len (confused_indices); i++)
146 pool_put_index (am->vl_clients, confused_indices[i]);
149 vec_free (confused_indices);
151 if (am->missing_clients)
152 vlib_cli_output (vm, "%u messages with missing clients",
153 am->missing_clients);
155 vl_sock_api_dump_clients (vm, am);
160 static clib_error_t *
161 vl_api_status_command (vlib_main_t * vm,
162 unformat_input_t * input, vlib_cli_command_t * cli_cmd)
164 api_main_t *am = &api_main;
166 /* check if rx_trace and tx_trace are not null pointers */
167 if (am->rx_trace == 0)
169 vlib_cli_output (vm, "RX Trace disabled\n");
173 if (am->rx_trace->enabled == 0)
174 vlib_cli_output (vm, "RX Trace disabled\n");
176 vlib_cli_output (vm, "RX Trace enabled\n");
179 if (am->tx_trace == 0)
181 vlib_cli_output (vm, "TX Trace disabled\n");
185 if (am->tx_trace->enabled == 0)
186 vlib_cli_output (vm, "TX Trace disabled\n");
188 vlib_cli_output (vm, "TX Trace enabled\n");
195 VLIB_CLI_COMMAND (cli_show_api_command, static) =
198 .short_help = "Show API information",
203 * Display current api client connections
206 VLIB_CLI_COMMAND (cli_show_api_clients_command, static) =
208 .path = "show api clients",
209 .short_help = "Client information",
210 .function = vl_api_client_command,
215 * Display the current api message tracing status
218 VLIB_CLI_COMMAND (cli_show_api_status_command, static) =
220 .path = "show api trace-status",
221 .short_help = "Display API trace status",
222 .function = vl_api_status_command,
226 static clib_error_t *
227 vl_api_message_table_command (vlib_main_t * vm,
228 unformat_input_t * input,
229 vlib_cli_command_t * cli_cmd)
231 api_main_t *am = &api_main;
235 if (unformat (input, "verbose"))
240 vlib_cli_output (vm, "%-4s %s", "ID", "Name");
242 vlib_cli_output (vm, "%-4s %-40s %6s %7s", "ID", "Name", "Bounce",
245 for (i = 1; i < vec_len (am->msg_names); i++)
249 vlib_cli_output (vm, "%-4d %s", i,
250 am->msg_names[i] ? am->msg_names[i] :
255 vlib_cli_output (vm, "%-4d %-40s %6d %7d", i,
256 am->msg_names[i] ? am->msg_names[i] :
257 " [no handler]", am->message_bounce[i],
266 * Display the current api message decode tables
269 VLIB_CLI_COMMAND (cli_show_api_message_table_command, static) =
271 .path = "show api message-table",
272 .short_help = "Message Table",
273 .function = vl_api_message_table_command,
278 range_compare (vl_api_msg_range_t * a0, vl_api_msg_range_t * a1)
280 int len0, len1, clen;
282 len0 = vec_len (a0->name);
283 len1 = vec_len (a1->name);
284 clen = len0 < len1 ? len0 : len1;
285 return (strncmp ((char *) a0->name, (char *) a1->name, clen));
289 format_api_msg_range (u8 * s, va_list * args)
291 vl_api_msg_range_t *rp = va_arg (*args, vl_api_msg_range_t *);
294 s = format (s, "%-50s%9s%9s", "Name", "First-ID", "Last-ID");
296 s = format (s, "%-50s%9d%9d", rp->name, rp->first_msg_id,
302 static clib_error_t *
303 vl_api_show_plugin_command (vlib_main_t * vm,
304 unformat_input_t * input,
305 vlib_cli_command_t * cli_cmd)
307 api_main_t *am = &api_main;
308 vl_api_msg_range_t *rp = 0;
311 if (vec_len (am->msg_ranges) == 0)
313 vlib_cli_output (vm, "No plugin API message ranges configured...");
317 rp = vec_dup (am->msg_ranges);
319 vec_sort_with_function (rp, range_compare);
321 vlib_cli_output (vm, "Plugin API message ID ranges...\n");
322 vlib_cli_output (vm, "%U", format_api_msg_range, 0 /* header */ );
324 for (i = 0; i < vec_len (rp); i++)
325 vlib_cli_output (vm, "%U", format_api_msg_range, rp + i);
333 * Display the plugin binary API message range table
336 VLIB_CLI_COMMAND (cli_show_api_plugin_command, static) =
338 .path = "show api plugin",
339 .short_help = "show api plugin",
340 .function = vl_api_show_plugin_command,
353 format_vl_msg_api_trace_status (u8 * s, va_list * args)
355 api_main_t *am = va_arg (*args, api_main_t *);
356 vl_api_trace_which_t which = va_arg (*args, vl_api_trace_which_t);
362 case VL_API_TRACE_TX:
364 trace_name = "TX trace";
367 case VL_API_TRACE_RX:
369 trace_name = "RX trace";
378 s = format (s, "%s: not yet configured.\n", trace_name);
382 s = format (s, "%s: used %d of %d items, %s enabled, %s wrapped\n",
383 trace_name, vec_len (tp->traces), tp->nitems,
384 tp->enabled ? "is" : "is not", tp->wrapped ? "has" : "has not");
388 void vl_msg_api_custom_dump_configure (api_main_t * am)
389 __attribute__ ((weak));
391 vl_msg_api_custom_dump_configure (api_main_t * am)
396 vl_msg_api_process_file (vlib_main_t * vm, u8 * filename,
397 u32 first_index, u32 last_index,
398 vl_api_replay_t which)
400 vl_api_trace_file_header_t *hp;
405 u8 endian_swap_needed = 0;
406 api_main_t *am = &api_main;
409 void **saved_print_handlers = 0;
411 fd = open ((char *) filename, O_RDONLY);
415 vlib_cli_output (vm, "Couldn't open %s\n", filename);
419 if (fstat (fd, &statb) < 0)
421 vlib_cli_output (vm, "Couldn't stat %s\n", filename);
426 if (!(statb.st_mode & S_IFREG) || (statb.st_size < sizeof (*hp)))
428 vlib_cli_output (vm, "File not plausible: %s\n", filename);
433 file_size = statb.st_size;
434 file_size = (file_size + 4095) & ~(4096);
436 hp = mmap (0, file_size, PROT_READ, MAP_PRIVATE, fd, 0);
438 if (hp == (vl_api_trace_file_header_t *) MAP_FAILED)
440 vlib_cli_output (vm, "mmap failed: %s\n", filename);
446 if ((clib_arch_is_little_endian && hp->endian == VL_API_BIG_ENDIAN)
447 || (clib_arch_is_big_endian && hp->endian == VL_API_LITTLE_ENDIAN))
448 endian_swap_needed = 1;
450 if (endian_swap_needed)
451 nitems = ntohl (hp->nitems);
455 if (last_index == (u32) ~ 0)
457 last_index = nitems - 1;
460 if (first_index >= nitems || last_index >= nitems)
462 vlib_cli_output (vm, "Range (%d, %d) outside file range (0, %d)\n",
463 first_index, last_index, nitems - 1);
464 munmap (hp, file_size);
469 "Note: wrapped/incomplete trace, results may vary\n");
471 if (which == CUSTOM_DUMP)
473 saved_print_handlers = (void **) vec_dup (am->msg_print_handlers);
474 vl_msg_api_custom_dump_configure (am);
478 msg = (u8 *) (hp + 1);
480 for (i = 0; i < first_index; i++)
486 size = clib_host_to_net_u32 (*(u32 *) msg);
489 if (clib_arch_is_little_endian)
490 msg_id = ntohs (*((u16 *) msg));
492 msg_id = *((u16 *) msg);
494 cfgp = am->api_trace_cfg + msg_id;
497 vlib_cli_output (vm, "Ugh: msg id %d no trace config\n", msg_id);
498 munmap (hp, file_size);
505 am->replay_in_progress = 1;
507 for (; i <= last_index; i++)
515 vlib_cli_output (vm, "---------- trace %d -----------\n", i);
517 size = clib_host_to_net_u32 (*(u32 *) msg);
520 if (clib_arch_is_little_endian)
521 msg_id = ntohs (*((u16 *) msg));
523 msg_id = *((u16 *) msg);
525 cfgp = am->api_trace_cfg + msg_id;
528 vlib_cli_output (vm, "Ugh: msg id %d no trace config\n", msg_id);
529 munmap (hp, file_size);
531 am->replay_in_progress = 0;
535 /* Copy the buffer (from the read-only mmap'ed file) */
536 vec_validate (tmpbuf, size - 1 + sizeof (uword));
537 clib_memcpy (tmpbuf + sizeof (uword), msg, size);
538 memset (tmpbuf, 0xf, sizeof (uword));
541 * Endian swap if needed. All msg data is supposed to be
542 * in network byte order. All msg handlers are supposed to
543 * know that. The generic message dumpers don't know that.
544 * One could fix apigen, I suppose.
546 if ((which == DUMP && clib_arch_is_little_endian) || endian_swap_needed)
548 void (*endian_fp) (void *);
549 if (msg_id >= vec_len (am->msg_endian_handlers)
550 || (am->msg_endian_handlers[msg_id] == 0))
552 vlib_cli_output (vm, "Ugh: msg id %d no endian swap\n", msg_id);
553 munmap (hp, file_size);
555 am->replay_in_progress = 0;
558 endian_fp = am->msg_endian_handlers[msg_id];
559 (*endian_fp) (tmpbuf + sizeof (uword));
562 /* msg_id always in network byte order */
563 if (clib_arch_is_little_endian)
565 msg_idp = (u16 *) (tmpbuf + sizeof (uword));
573 if (msg_id < vec_len (am->msg_print_handlers) &&
574 am->msg_print_handlers[msg_id])
576 u8 *(*print_fp) (void *, void *);
578 print_fp = (void *) am->msg_print_handlers[msg_id];
579 (*print_fp) (tmpbuf + sizeof (uword), vm);
583 vlib_cli_output (vm, "Skipping msg id %d: no print fcn\n",
590 if (msg_id < vec_len (am->msg_print_handlers) &&
591 am->msg_print_handlers[msg_id])
595 u8 *(*print_fp) (void *, void *);
597 print_fp = (void *) am->msg_print_handlers[msg_id];
599 vlib_cli_output (vm, "/*");
601 (*print_fp) (tmpbuf + sizeof (uword), vm);
602 vlib_cli_output (vm, "*/\n");
604 s = format (0, "static u8 * vl_api_%s_%d[%d] = {",
605 am->msg_names[msg_id], i,
606 am->api_trace_cfg[msg_id].size);
608 for (j = 0; j < am->api_trace_cfg[msg_id].size; j++)
611 s = format (s, "\n ");
612 s = format (s, "0x%02x,", tmpbuf[sizeof (uword) + j]);
614 s = format (s, "\n};\n%c", 0);
615 vlib_cli_output (vm, (char *) s);
621 if (msg_id < vec_len (am->msg_print_handlers) &&
622 am->msg_print_handlers[msg_id] && cfgp->replay_enable)
624 void (*handler) (void *);
626 handler = (void *) am->msg_handlers[msg_id];
628 if (!am->is_mp_safe[msg_id])
629 vl_msg_api_barrier_sync ();
630 (*handler) (tmpbuf + sizeof (uword));
631 if (!am->is_mp_safe[msg_id])
632 vl_msg_api_barrier_release ();
636 if (cfgp->replay_enable)
637 vlib_cli_output (vm, "Skipping msg id %d: no handler\n",
644 _vec_len (tmpbuf) = 0;
648 if (saved_print_handlers)
650 clib_memcpy (am->msg_print_handlers, saved_print_handlers,
651 vec_len (am->msg_print_handlers) * sizeof (void *));
652 vec_free (saved_print_handlers);
655 munmap (hp, file_size);
657 am->replay_in_progress = 0;
660 static clib_error_t *
661 api_trace_command_fn (vlib_main_t * vm,
662 unformat_input_t * input, vlib_cli_command_t * cmd)
664 u32 nitems = 256 << 10;
665 api_main_t *am = &api_main;
666 vl_api_trace_which_t which = VL_API_TRACE_RX;
669 u32 last = (u32) ~ 0;
673 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
675 if (unformat (input, "on") || unformat (input, "enable"))
677 if (unformat (input, "nitems %d", &nitems))
679 vl_msg_api_trace_configure (am, which, nitems);
680 vl_msg_api_trace_onoff (am, which, 1 /* on */ );
682 else if (unformat (input, "off"))
684 vl_msg_api_trace_onoff (am, which, 0);
686 else if (unformat (input, "save %s", &filename))
689 if (strstr ((char *) filename, "..")
690 || index ((char *) filename, '/'))
692 vlib_cli_output (vm, "illegal characters in filename '%s'",
697 chroot_filename = format (0, "/tmp/%s%c", filename, 0);
701 fp = fopen ((char *) chroot_filename, "w");
704 vlib_cli_output (vm, "Couldn't create %s\n", chroot_filename);
707 rv = vl_msg_api_trace_save (am, which, fp);
710 vlib_cli_output (vm, "API Trace data not present\n");
712 vlib_cli_output (vm, "File for writing is closed\n");
714 vlib_cli_output (vm, "Error while writing header to file\n");
716 vlib_cli_output (vm, "Error while writing trace to file\n");
719 "Error while writing end of buffer trace to file\n");
722 "Error while writing start of buffer trace to file\n");
724 vlib_cli_output (vm, "Unkown error while saving: %d", rv);
726 vlib_cli_output (vm, "API trace saved to %s\n", chroot_filename);
727 vec_free (chroot_filename);
729 else if (unformat (input, "dump %s", &filename))
731 vl_msg_api_process_file (vm, filename, first, last, DUMP);
733 else if (unformat (input, "custom-dump %s", &filename))
735 vl_msg_api_process_file (vm, filename, first, last, CUSTOM_DUMP);
737 else if (unformat (input, "replay %s", &filename))
739 vl_msg_api_process_file (vm, filename, first, last, REPLAY);
741 else if (unformat (input, "initializers %s", &filename))
743 vl_msg_api_process_file (vm, filename, first, last, INITIALIZERS);
745 else if (unformat (input, "tx"))
747 which = VL_API_TRACE_TX;
749 else if (unformat (input, "first %d", &first))
753 else if (unformat (input, "last %d", &last))
757 else if (unformat (input, "status"))
759 vlib_cli_output (vm, "%U", format_vl_msg_api_trace_status,
762 else if (unformat (input, "free"))
764 vl_msg_api_trace_onoff (am, which, 0);
765 vl_msg_api_trace_free (am, which);
767 else if (unformat (input, "post-mortem-on"))
768 vl_msg_api_post_mortem_dump_enable_disable (1 /* enable */ );
769 else if (unformat (input, "post-mortem-off"))
770 vl_msg_api_post_mortem_dump_enable_disable (0 /* enable */ );
772 return clib_error_return (0, "unknown input `%U'",
773 format_unformat_error, input);
779 * Display, replay, or save a binary API trace
783 VLIB_CLI_COMMAND (api_trace_command, static) =
786 .short_help = "api trace [on|off][first <n>][last <n>][status][free]"
787 "[post-mortem-on][dump|custom-dump|save|replay <file>]",
788 .function = api_trace_command_fn,
792 static clib_error_t *
793 vl_api_trace_command (vlib_main_t * vm,
794 unformat_input_t * input, vlib_cli_command_t * cli_cmd)
797 vl_api_trace_which_t which = VL_API_TRACE_RX;
798 api_main_t *am = &api_main;
800 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
802 if (unformat (input, "rx nitems %u", &nitems) || unformat (input, "rx"))
804 else if (unformat (input, "tx nitems %u", &nitems)
805 || unformat (input, "tx"))
807 which = VL_API_TRACE_RX;
810 else if (unformat (input, "on rx"))
812 vl_msg_api_trace_onoff (am, VL_API_TRACE_RX, 1);
814 else if (unformat (input, "on tx"))
816 vl_msg_api_trace_onoff (am, VL_API_TRACE_TX, 1);
818 else if (unformat (input, "on"))
820 vl_msg_api_trace_onoff (am, VL_API_TRACE_RX, 1);
822 else if (unformat (input, "off"))
824 vl_msg_api_trace_onoff (am, VL_API_TRACE_RX, 0);
825 vl_msg_api_trace_onoff (am, VL_API_TRACE_TX, 0);
827 else if (unformat (input, "free"))
829 vl_msg_api_trace_onoff (am, VL_API_TRACE_RX, 0);
830 vl_msg_api_trace_onoff (am, VL_API_TRACE_TX, 0);
831 vl_msg_api_trace_free (am, VL_API_TRACE_RX);
832 vl_msg_api_trace_free (am, VL_API_TRACE_TX);
834 else if (unformat (input, "debug on"))
836 am->msg_print_flag = 1;
838 else if (unformat (input, "debug off"))
840 am->msg_print_flag = 0;
843 return clib_error_return (0, "unknown input `%U'",
844 format_unformat_error, input);
849 if (vl_msg_api_trace_configure (am, which, nitems))
851 vlib_cli_output (vm, "warning: trace configure error (%d, %d)",
859 * Control the binary API trace mechanism
862 VLIB_CLI_COMMAND (trace, static) =
864 .path = "set api-trace [on][on tx][on rx][off][free][debug on][debug off]",
865 .short_help = "API trace",
866 .function = vl_api_trace_command,
870 static clib_error_t *
871 api_trace_config_fn (vlib_main_t * vm, unformat_input_t * input)
873 u32 nitems = 256 << 10;
874 vl_api_trace_which_t which = VL_API_TRACE_RX;
875 api_main_t *am = &api_main;
877 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
879 if (unformat (input, "on") || unformat (input, "enable"))
881 if (unformat (input, "nitems %d", &nitems))
883 vl_msg_api_trace_configure (am, which, nitems);
884 vl_msg_api_trace_onoff (am, which, 1 /* on */ );
885 vl_msg_api_post_mortem_dump_enable_disable (1 /* enable */ );
887 else if (unformat (input, "save-api-table %s",
888 &am->save_msg_table_filename))
891 return clib_error_return (0, "unknown input `%U'",
892 format_unformat_error, input);
898 * This module has three configuration parameters:
899 * "on" or "enable" - enables binary api tracing
900 * "nitems <nnn>" - sets the size of the circular buffer to <nnn>
901 * "save-api-table <filename>" - dumps the API message table to /tmp/<filename>
903 VLIB_CONFIG_FUNCTION (api_trace_config_fn, "api-trace");
905 static clib_error_t *
906 api_queue_config_fn (vlib_main_t * vm, unformat_input_t * input)
908 api_main_t *am = &api_main;
911 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
913 if (unformat (input, "length %d", &nitems) ||
914 (unformat (input, "len %d", &nitems)))
917 am->vlib_input_queue_length = nitems;
919 clib_warning ("vlib input queue length %d too small, ignored",
923 return clib_error_return (0, "unknown input `%U'",
924 format_unformat_error, input);
929 VLIB_CONFIG_FUNCTION (api_queue_config_fn, "api-queue");
932 extract_name (u8 * s)
938 while (vec_len (rv) && rv[vec_len (rv)] != '_')
941 rv[vec_len (rv)] = 0;
954 for (i = vec_len (rv) - 1; i >= 0; i--)
958 vec_delete (rv, i + 1, 0);
972 } msg_table_unserialize_t;
975 table_id_cmp (void *a1, void *a2)
977 msg_table_unserialize_t *n1 = a1;
978 msg_table_unserialize_t *n2 = a2;
980 return (n1->msg_index - n2->msg_index);
984 table_name_and_crc_cmp (void *a1, void *a2)
986 msg_table_unserialize_t *n1 = a1;
987 msg_table_unserialize_t *n2 = a2;
989 return strcmp ((char *) n1->name_and_crc, (char *) n2->name_and_crc);
992 static clib_error_t *
993 dump_api_table_file_command_fn (vlib_main_t * vm,
994 unformat_input_t * input,
995 vlib_cli_command_t * cmd)
998 api_main_t *am = &api_main;
999 serialize_main_t _sm, *sm = &_sm;
1000 clib_error_t *error;
1004 int compare_current = 0;
1005 int numeric_sort = 0;
1006 msg_table_unserialize_t *table = 0, *item;
1008 u32 ndifferences = 0;
1010 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
1012 if (unformat (input, "file %s", &filename))
1014 else if (unformat (input, "compare-current")
1015 || unformat (input, "compare"))
1016 compare_current = 1;
1017 else if (unformat (input, "numeric"))
1020 return clib_error_return (0, "unknown input `%U'",
1021 format_unformat_error, input);
1024 if (numeric_sort && compare_current)
1025 return clib_error_return
1026 (0, "Comparison and numeric sorting are incompatible");
1029 return clib_error_return (0, "File not specified");
1031 /* Load the serialized message table from the table dump */
1033 error = unserialize_open_clib_file (sm, (char *) filename);
1038 unserialize_integer (sm, &nmsgs, sizeof (u32));
1040 for (i = 0; i < nmsgs; i++)
1042 msg_index = unserialize_likely_small_unsigned_integer (sm);
1043 unserialize_cstring (sm, (char **) &name_and_crc);
1044 vec_add2 (table, item, 1);
1045 item->msg_index = msg_index;
1046 item->name_and_crc = name_and_crc;
1047 item->name = extract_name (name_and_crc);
1048 item->crc = extract_crc (name_and_crc);
1049 item->which = 0; /* file */
1051 serialize_close (sm);
1053 /* Compare with the current image? */
1054 if (compare_current)
1056 /* Append the current message table */
1057 u8 *tblv = vl_api_serialize_message_table (am, 0);
1059 serialize_open_vector (sm, tblv);
1060 unserialize_integer (sm, &nmsgs, sizeof (u32));
1062 for (i = 0; i < nmsgs; i++)
1064 msg_index = unserialize_likely_small_unsigned_integer (sm);
1065 unserialize_cstring (sm, (char **) &name_and_crc);
1067 vec_add2 (table, item, 1);
1068 item->msg_index = msg_index;
1069 item->name_and_crc = name_and_crc;
1070 item->name = extract_name (name_and_crc);
1071 item->crc = extract_crc (name_and_crc);
1072 item->which = 1; /* current_image */
1077 /* Sort the table. */
1079 vec_sort_with_function (table, table_id_cmp);
1081 vec_sort_with_function (table, table_name_and_crc_cmp);
1083 if (compare_current)
1088 * In this case, the recovered table will have two entries per
1089 * API message. So, if entries i and i+1 match, the message definitions
1090 * are identical. Otherwise, the crc is different, or a message is
1091 * present in only one of the tables.
1093 vlib_cli_output (vm, "%=60s %s", "Message Name", "Result");
1095 for (i = 0; i < vec_len (table);)
1097 /* Last message lonely? */
1098 if (i == vec_len (table) - 1)
1104 /* Identical pair? */
1106 ((char *) table[i].name_and_crc,
1107 (char *) table[i + 1].name_and_crc,
1108 vec_len (table[i].name_and_crc)))
1116 /* Only in one of two tables? */
1117 if (strncmp ((char *) table[i].name, (char *) table[i + 1].name,
1118 vec_len (table[i].name)))
1121 vlib_cli_output (vm, "%-60s only in %s",
1122 table[i].name, table[i].which ?
1127 /* In both tables, but with different signatures */
1128 vlib_cli_output (vm, "%-60s definition changed", table[i].name);
1131 if (ndifferences == 0)
1132 vlib_cli_output (vm, "No api message signature differences found.");
1134 vlib_cli_output (vm, "Found %u api message signature differences",
1139 /* Dump the table, sorted as shown above */
1140 vlib_cli_output (vm, "%=60s %=8s %=10s", "Message name", "MsgID", "CRC");
1142 for (i = 0; i < vec_len (table); i++)
1145 vlib_cli_output (vm, "%-60s %8u %10s", item->name,
1146 item->msg_index, item->crc);
1150 for (i = 0; i < vec_len (table); i++)
1152 vec_free (table[i].name_and_crc);
1153 vec_free (table[i].name);
1154 vec_free (table[i].crc);
1163 * Displays a serialized API message decode table, sorted by message name
1166 * @cliexstart{show api dump file <filename>}
1167 * Message name MsgID CRC
1168 * accept_session 407 8e2a127e
1169 * accept_session_reply 408 67d8c22a
1170 * add_node_next 549 e4202993
1171 * add_node_next_reply 550 e89d6eed
1177 * Compares a serialized API message decode table with the current image
1180 * @cliexstart{show api dump file <filename> compare}
1181 * ip_add_del_route definition changed
1182 * ip_table_add_del definition changed
1183 * l2_macs_event only in image
1184 * vnet_ip4_fib_counters only in file
1185 * vnet_ip4_nbr_counters only in file
1190 * Display a serialized API message decode table, compare a saved
1191 * decode table with the current image, to establish API differences.
1195 VLIB_CLI_COMMAND (dump_api_table_file, static) =
1197 .path = "show api dump",
1198 .short_help = "show api dump file <filename> [numeric | compare-current]",
1199 .function = dump_api_table_file_command_fn,
1204 * fd.io coding-style-patch-verification: ON
1207 * eval: (c-set-style "gnu")