FD.io VPP  v21.06
Vector Packet Processing
cli.c
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2020 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/vnet.h>
17 #include <perfmon/perfmon.h>
18 #include <perfmon/table.h>
19 
20 uword
22 {
24  perfmon_bundle_t **b = va_arg (*args, perfmon_bundle_t **);
25  uword *p;
26  u8 *str = 0;
27 
28  if (unformat (input, "%s", &str) == 0)
29  return 0;
30 
31  p = hash_get_mem (pm->bundle_by_name, str);
32 
33  if (p)
34  b[0] = (perfmon_bundle_t *) p[0];
35 
36  vec_free (str);
37  return p ? 1 : 0;
38 }
39 
40 uword
42 {
44  perfmon_source_t **b = va_arg (*args, perfmon_source_t **);
45  uword *p;
46  u8 *str = 0;
47 
48  if (unformat (input, "%s", &str) == 0)
49  return 0;
50 
51  p = hash_get_mem (pm->source_by_name, str);
52 
53  if (p)
54  b[0] = (perfmon_source_t *) p[0];
55 
56  vec_free (str);
57  return p ? 1 : 0;
58 }
59 
60 u8 *
61 format_perfmon_bundle (u8 *s, va_list *args)
62 {
63  perfmon_bundle_t *b = va_arg (*args, perfmon_bundle_t *);
64  int verbose = va_arg (*args, int);
65 
66  const char *bundle_type[] = {
67  [PERFMON_BUNDLE_TYPE_NODE] = "node",
68  [PERFMON_BUNDLE_TYPE_THREAD] = "thread",
69  [PERFMON_BUNDLE_TYPE_SYSTEM] = "system",
70  };
71 
72  if (b == 0)
73  return format (s, "%-20s%-10s%-20s%s", "Name", "Type", "Source",
74  "Description");
75 
76  if (verbose)
77  {
78  s = format (s, "name: %s\n", b->name);
79  s = format (s, "description: %s\n", b->description);
80  s = format (s, "source: %s\n", b->src->name);
81  for (int i = 0; i < b->n_events; i++)
82  {
83  perfmon_event_t *e = b->src->events + b->events[i];
84  s = format (s, "event %u: %s\n", i, e->name);
85  }
86  }
87  else
88  s = format (s, "%-20s%-10s%-20s%s", b->name, bundle_type[b->type],
89  b->src->name, b->description);
90 
91  return s;
92 }
93 
94 static clib_error_t *
96  vlib_cli_command_t *cmd)
97 {
99  unformat_input_t _line_input, *line_input = &_line_input;
100  perfmon_bundle_t *b = 0, **vb = 0;
101  int verbose = 0;
102 
103  if (unformat_user (input, unformat_line_input, line_input))
104  {
105  while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
106  {
107  if (unformat (line_input, "verbose"))
108  verbose = 1;
109  else if (unformat (line_input, "%U", unformat_perfmon_bundle_name,
110  &b))
111  vec_add (vb, &b, 1);
112  else
113  return clib_error_return (0, "unknown input `%U'",
114  format_unformat_error, line_input);
115  }
116  unformat_free (line_input);
117  }
118 
119  if (vb == 0)
120  {
121  char *key;
122  hash_foreach_mem (key, b, pm->bundle_by_name, vec_add (vb, &b, 1););
123  }
124  else
125  verbose = 1;
126 
127  if (verbose == 0)
128  vlib_cli_output (vm, "%U\n", format_perfmon_bundle, 0, 0);
129 
130  for (int i = 0; i < vec_len (vb); i++)
131  if (!vb[i]->cpu_supports || vb[i]->cpu_supports ())
132  vlib_cli_output (vm, "%U\n", format_perfmon_bundle, vb[i], verbose);
133 
134  vec_free (vb);
135  return 0;
136 }
137 
138 VLIB_CLI_COMMAND (show_perfmon_bundle_command, static) = {
139  .path = "show perfmon bundle",
140  .short_help = "show perfmon bundle [<bundle-name>] [verbose]",
141  .function = show_perfmon_bundle_command_fn,
142  .is_mp_safe = 1,
143 };
144 
145 u8 *
146 format_perfmon_source (u8 *s, va_list *args)
147 {
148  perfmon_source_t *src = va_arg (*args, perfmon_source_t *);
149  int verbose = va_arg (*args, int);
150 
151  if (src == 0)
152  return format (s, "%-20s%-9s %s", "Name", "NumEvents", "Description");
153 
154  if (verbose)
155  {
156  s = format (s, "name: %s\n", src->name);
157  s = format (s, "description: %s\n", src->description);
158  s = format (s, "Events:\n");
159  for (int i = 0; i < src->n_events; i++)
160  {
161  perfmon_event_t *e = src->events + i;
162  s = format (s, " %s", e->name);
163  if (src->format_config)
164  s = format (s, " (%U)\n", src->format_config, e->config);
165  else
166  s = format (s, " (0x%x)\n", e->config);
167  if (e->description)
168  s = format (s, " %s\n", e->description);
169  }
170 
171  if (src->instances_by_type)
172  {
173  s = format (s, "Instances:\n");
174  for (int i = 0; i < vec_len (src->instances_by_type); i++)
175  {
177  it = vec_elt_at_index (src->instances_by_type, i);
178  if (vec_len (it->instances) == 0)
179  continue;
180  s = format (s, " %s:\n ", it->name);
181  for (int j = 0; j < vec_len (it->instances); j++)
182  {
184  s = format (s, " %s", in->name);
185  }
186  s = format (s, "\n");
187  }
188  }
189  }
190  else
191  s = format (s, "%-20s%9u %s", src->name, src->n_events, src->description);
192 
193  return s;
194 }
195 
196 static clib_error_t *
198  vlib_cli_command_t *cmd)
199 {
201  unformat_input_t _line_input, *line_input = &_line_input;
202  perfmon_source_t *s = 0, **vs = 0;
203  int verbose = 0;
204 
205  if (unformat_user (input, unformat_line_input, line_input))
206  {
207  while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
208  {
209  if (unformat (line_input, "verbose"))
210  verbose = 1;
211  else if (unformat (line_input, "%U", unformat_perfmon_source_name,
212  &s))
213  vec_add (vs, &s, 1);
214  else
215  return clib_error_return (0, "unknown input `%U'",
216  format_unformat_error, line_input);
217  }
218  unformat_free (line_input);
219  }
220 
221  if (vs == 0)
222  {
223  char *key;
224  hash_foreach_mem (key, s, pm->source_by_name, vec_add (vs, &s, 1););
225  }
226  else
227  verbose = 1;
228 
229  if (verbose == 0)
230  vlib_cli_output (vm, "%U\n", format_perfmon_source, 0, 0);
231 
232  for (int i = 0; i < vec_len (vs); i++)
233  vlib_cli_output (vm, "%U\n", format_perfmon_source, vs[i], verbose);
234 
235  vec_free (vs);
236  return 0;
237 }
238 
239 VLIB_CLI_COMMAND (show_perfmon_source_command, static) = {
240  .path = "show perfmon source",
241  .short_help = "show perfmon source [<source-name>] [verbose]",
242  .function = show_perfmon_source_command_fn,
243  .is_mp_safe = 1,
244 };
245 
246 static clib_error_t *
248  unformat_input_t *input,
249  vlib_cli_command_t *cmd)
250 {
252 
254  return 0;
255 }
256 
257 VLIB_CLI_COMMAND (show_perfmon_active_bundle_command, static) = {
258  .path = "show perfmon active-bundle",
259  .short_help = "show perfmon active-bundle",
261  .is_mp_safe = 1,
262 };
263 
264 static clib_error_t *
266  vlib_cli_command_t *cmd)
267 {
270  clib_error_t *err = 0;
271  table_t table = {}, *t = &table;
272  u32 n_instances;
273  perfmon_reading_t *r, *readings = 0;
275  perfmon_instance_t *in;
276  u8 *s = 0;
277  int n_row = 0;
278 
279  if (b == 0)
280  return clib_error_return (0, "no bundle selected");
281 
282  n_instances = vec_len (it->instances);
283  vec_validate (readings, n_instances - 1);
284 
285  /*Only perform read() for THREAD or SYSTEM bundles*/
286  for (int i = 0; i < n_instances && b->type != PERFMON_BUNDLE_TYPE_NODE; i++)
287  {
288  in = vec_elt_at_index (it->instances, i);
289  r = vec_elt_at_index (readings, i);
290 
291  if (read (pm->group_fds[i], r, (b->n_events + 3) * sizeof (u64)) == -1)
292  {
293  err = clib_error_return_unix (0, "read");
294  goto done;
295  }
296  }
297 
298  table_format_title (t, "%s", b->description);
299 
300  table_add_header_col (t, 0);
301  table_add_header_row (t, 0);
302 
303  if (b->column_headers)
304  {
305  char **hdr = b->column_headers;
306  while (hdr[0])
307  table_format_cell (t, -1, n_row++, "%s", hdr++[0]);
308  }
309 
310  int col = 0;
311  for (int i = 0; i < n_instances; i++)
312  {
313  in = vec_elt_at_index (it->instances, i);
314  r = vec_elt_at_index (readings, i);
315  table_format_cell (t, col, -1, "%s", in->name);
316  if (b->type == PERFMON_BUNDLE_TYPE_NODE)
317  {
319  tr = vec_elt_at_index (pm->thread_runtimes, i);
320  for (int j = 0; j < tr->n_nodes; j++)
321  if (tr->node_stats[j].n_calls)
322  {
324  table_format_cell (t, ++col, -1, "%U", format_vlib_node_name,
325  vm, j);
326  table_set_cell_align (t, col, -1, TTAA_RIGHT);
327  table_set_cell_fg_color (t, col, -1, TTAC_CYAN);
328  clib_memcpy_fast (&ns, tr->node_stats + j, sizeof (ns));
329 
330  for (int j = 0; j < n_row; j++)
331  table_format_cell (t, col, j, "%U", b->format_fn, &ns, j);
332  }
333  }
334  else
335  {
336  for (int j = 0; j < n_row; j++)
337  table_format_cell (t, i, j, "%U", b->format_fn, r, j);
338  }
339  col++;
340  }
341 
342  vlib_cli_output (vm, "%U\n", format_table, t);
343  table_free (t);
344 
345  if (b->footer)
346  vlib_cli_output (vm, "\n%s\n", b->footer);
347 
348 done:
349  vec_free (readings);
350  vec_free (s);
351  return err;
352 }
353 
354 VLIB_CLI_COMMAND (show_perfmon_stats_command, static) = {
355  .path = "show perfmon statistics",
356  .short_help = "show perfmon statistics [raw]",
357  .function = show_perfmon_stats_command_fn,
358  .is_mp_safe = 1,
359 };
360 
361 static clib_error_t *
363  vlib_cli_command_t *cmd)
364 {
365  perfmon_reset (vm);
366  return 0;
367 }
368 
369 VLIB_CLI_COMMAND (perfmon_reset_command, static) = {
370  .path = "perfmon reset",
371  .short_help = "perfmon reset",
372  .function = perfmon_reset_command_fn,
373  .is_mp_safe = 1,
374 };
375 
376 static clib_error_t *
378  vlib_cli_command_t *cmd)
379 {
381  unformat_input_t _line_input, *line_input = &_line_input;
382  perfmon_bundle_t *b = 0;
383 
384  if (pm->is_running)
385  return clib_error_return (0, "please stop first");
386 
387  if (unformat_user (input, unformat_line_input, line_input) == 0)
388  return clib_error_return (0, "please specify bundle name");
389 
390  while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
391  {
392  if (unformat (line_input, "bundle %U", unformat_perfmon_bundle_name, &b))
393  ;
394  else
395  return clib_error_return (0, "unknown input '%U'",
396  format_unformat_error, line_input);
397  }
398  unformat_free (line_input);
399 
400  if (b == 0)
401  return clib_error_return (0, "please specify bundle name");
402 
403  return perfmon_start (vm, b);
404 }
405 
406 VLIB_CLI_COMMAND (perfmon_start_command, static) = {
407  .path = "perfmon start",
408  .short_help = "perfmon start bundle [<bundle-name>]",
409  .function = perfmon_start_command_fn,
410  .is_mp_safe = 1,
411 };
412 
413 static clib_error_t *
415  vlib_cli_command_t *cmd)
416 {
417  return perfmon_stop (vm);
418 }
419 
420 VLIB_CLI_COMMAND (perfmon_stop_command, static) = {
421  .path = "perfmon stop",
422  .short_help = "perfmon stop",
423  .function = perfmon_stop_command_fn,
424  .is_mp_safe = 1,
425 };
char * footer
Definition: perfmon.h:103
#define vec_validate(V, I)
Make sure vector is long enough for given index (no header, unspecified alignment) ...
Definition: vec.h:524
char * name
Definition: perfmon.h:53
clib_error_t * perfmon_stop(vlib_main_t *vm)
Definition: perfmon.c:262
uword * source_by_name
Definition: perfmon.h:159
format_function_t format_vlib_node_name
Definition: node_funcs.h:1235
perfmon_bundle_t * active_bundle
Definition: perfmon.h:160
uword unformat_perfmon_source_name(unformat_input_t *input, va_list *args)
Definition: cli.c:41
vnet_hw_if_output_node_runtime_t * r
unsigned long u64
Definition: types.h:89
static clib_error_t * perfmon_stop_command_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: cli.c:414
perfmon_instance_t * instances
Definition: perfmon.h:68
void table_format_title(table_t *t, char *fmt,...)
Definition: table.c:158
perfmon_node_stats_t * node_stats
Definition: perfmon.h:148
perfmon_thread_runtime_t * thread_runtimes
Definition: perfmon.h:155
vl_api_address_t src
Definition: gre.api:54
uword unformat_user(unformat_input_t *input, unformat_function_t *func,...)
Definition: unformat.c:989
format_function_t * format_config
Definition: perfmon.h:89
char * name
Definition: perfmon.h:100
void table_set_cell_align(table_t *t, int c, int r, table_text_attr_align_t a)
Definition: table.c:198
perfmon_main_t perfmon_main
Definition: perfmon.c:27
unsigned char u8
Definition: types.h:56
vlib_buffer_t ** b
void perfmon_reset(vlib_main_t *vm)
Definition: perfmon.c:45
vnet_buffer_opaque_t * vb(void *vb_arg)
Definition: gdb_funcs.c:336
unsigned int u32
Definition: types.h:88
#define vec_add(V, E, N)
Add N elements to end of vector V (no header, unspecified alignment)
Definition: vec.h:689
u32 events[PERF_MAX_EVENTS]
Definition: perfmon.h:106
static clib_error_t * perfmon_reset_command_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: cli.c:362
void table_set_cell_fg_color(table_t *t, int c, int r, table_text_attr_color_t v)
Definition: table.c:205
perfmon_instance_type_t * active_instance_type
Definition: perfmon.h:166
description fragment has unexpected format
Definition: map.api:433
#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
perfmon_source_t * src
Definition: perfmon.h:117
unformat_function_t unformat_line_input
Definition: format.h:275
static clib_error_t * show_perfmon_stats_command_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: cli.c:265
static clib_error_t * show_perfmon_bundle_command_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: cli.c:95
format_function_t * format_fn
Definition: perfmon.h:113
struct _unformat_input_t unformat_input_t
#define clib_error_return_unix(e, args...)
Definition: error.h:102
char * description
Definition: perfmon.h:84
vlib_main_t * vm
X-connect all packets from the HOST to the PHY.
Definition: nat44_ei.c:3047
#define hash_foreach_mem(key_var, value_var, h, body)
Definition: hash.h:461
static clib_error_t * show_perfmon_active_bundle_command_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: cli.c:247
void table_free(table_t *t)
Definition: table.c:221
#define UNFORMAT_END_OF_INPUT
Definition: format.h:137
perfmon_event_t * events
Definition: perfmon.h:86
perfmon_bundle_type_t type
Definition: perfmon.h:104
sll srl srl sll sra u16x4 i
Definition: vector_sse42.h:261
#define vec_free(V)
Free vector&#39;s memory (no header).
Definition: vec.h:395
Definition: table.h:73
u8 * format_perfmon_source(u8 *s, va_list *args)
Definition: cli.c:146
#define VLIB_CLI_COMMAND(x,...)
Definition: cli.h:163
static clib_error_t * perfmon_start_command_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: cli.c:377
void vlib_cli_output(vlib_main_t *vm, char *fmt,...)
Definition: cli.c:716
uword unformat_perfmon_bundle_name(unformat_input_t *input, va_list *args)
Definition: cli.c:21
perfmon_instance_type_t * instances_by_type
Definition: perfmon.h:88
char ** column_headers
Definition: perfmon.h:112
u32 n_events
Definition: perfmon.h:87
static_always_inline void * clib_memcpy_fast(void *restrict dst, const void *restrict src, size_t n)
Definition: string.h:92
int is_running
Definition: perfmon.h:161
format_function_t format_table
Definition: table.h:84
typedef key
Definition: ipsec_types.api:88
void table_add_header_col(table_t *t, int n_strings,...)
Definition: table.c:236
u8 * format_perfmon_bundle(u8 *s, va_list *args)
Definition: cli.c:61
#define vec_len(v)
Number of elements in vector (rvalue-only, NULL tolerant)
int * group_fds
Definition: perfmon.h:163
u64 uword
Definition: types.h:112
static void unformat_free(unformat_input_t *i)
Definition: format.h:155
#define hash_get_mem(h, key)
Definition: hash.h:269
void table_format_cell(table_t *t, int c, int r, char *fmt,...)
Definition: table.c:181
u8 * format_unformat_error(u8 *s, va_list *va)
Definition: unformat.c:91
char * name
Definition: perfmon.h:83
static clib_error_t * show_perfmon_source_command_fn(vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd)
Definition: cli.c:197
save_rewrite_length must be aligned so that reass doesn t overwrite it
Definition: buffer.h:421
uword * bundle_by_name
Definition: perfmon.h:157
char * description
Definition: perfmon.h:101
char * description
Definition: perfmon.h:54
clib_error_t * perfmon_start(vlib_main_t *vm, perfmon_bundle_t *b)
Definition: perfmon.c:216
uword unformat(unformat_input_t *i, const char *fmt,...)
Definition: unformat.c:978
static uword unformat_check_input(unformat_input_t *i)
Definition: format.h:163
void table_add_header_row(table_t *t, int n_strings,...)
Definition: table.c:258