FD.io VPP  v21.06-3-gbb25fbf28
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 
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  {
183  perfmon_instance_t *in = vec_elt_at_index (it->instances, j);
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 
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 
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 
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 
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 
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 
421  .path = "perfmon stop",
422  .short_help = "perfmon stop",
423  .function = perfmon_stop_command_fn,
424  .is_mp_safe = 1,
425 };
perfmon_node_stats_t
Definition: perfmon.h:129
perfmon_event_t::config
u64 config
Definition: perfmon.h:52
vec_add
#define vec_add(V, E, N)
Add N elements to end of vector V (no header, unspecified alignment)
Definition: vec.h:688
PERFMON_BUNDLE_TYPE_NODE
@ PERFMON_BUNDLE_TYPE_NODE
Definition: perfmon.h:31
unformat_user
uword unformat_user(unformat_input_t *input, unformat_function_t *func,...)
Definition: unformat.c:989
perfmon_reading_t
Definition: perfmon.h:121
perfmon_reset_command
static vlib_cli_command_t perfmon_reset_command
(constructor) VLIB_CLI_COMMAND (perfmon_reset_command)
Definition: cli.c:369
perfmon_reset
void perfmon_reset(vlib_main_t *vm)
Definition: perfmon.c:45
perfmon_main_t::active_bundle
perfmon_bundle_t * active_bundle
Definition: perfmon.h:160
TTAA_RIGHT
@ TTAA_RIGHT
Definition: table.h:55
unformat_line_input
unformat_function_t unformat_line_input
Definition: format.h:275
perfmon_event_t
Definition: perfmon.h:43
perfmon_main_t
Definition: perfmon.h:153
perfmon_instance_type_t
Definition: perfmon.h:65
perfmon_node_stats_t::n_calls
u64 n_calls
Definition: perfmon.h:132
perfmon_thread_runtime_t::n_nodes
u16 n_nodes
Definition: perfmon.h:147
show_perfmon_source_command
static vlib_cli_command_t show_perfmon_source_command
(constructor) VLIB_CLI_COMMAND (show_perfmon_source_command)
Definition: cli.c:239
perfmon_main
perfmon_main_t perfmon_main
Definition: perfmon.c:27
clib_error_return
#define clib_error_return(e, args...)
Definition: error.h:99
vlib_cli_command_t::path
char * path
Definition: cli.h:96
perfmon_bundle
Definition: perfmon.h:98
vm
vlib_main_t * vm
X-connect all packets from the HOST to the PHY.
Definition: nat44_ei.c:3047
format_perfmon_source
u8 * format_perfmon_source(u8 *s, va_list *args)
Definition: cli.c:146
unformat_input_t
struct _unformat_input_t unformat_input_t
r
vnet_hw_if_output_node_runtime_t * r
Definition: interface_output.c:1071
perfmon_main_t::active_instance_type
perfmon_instance_type_t * active_instance_type
Definition: perfmon.h:166
clib_memcpy_fast
static_always_inline void * clib_memcpy_fast(void *restrict dst, const void *restrict src, size_t n)
Definition: string.h:92
perfmon_main_t::thread_runtimes
perfmon_thread_runtime_t * thread_runtimes
Definition: perfmon.h:155
perfmon_main_t::source_by_name
uword * source_by_name
Definition: perfmon.h:159
key
typedef key
Definition: ipsec_types.api:88
unformat
uword unformat(unformat_input_t *i, const char *fmt,...)
Definition: unformat.c:978
vec_len
#define vec_len(v)
Number of elements in vector (rvalue-only, NULL tolerant)
Definition: vec_bootstrap.h:142
unformat_free
static void unformat_free(unformat_input_t *i)
Definition: format.h:155
table_set_cell_fg_color
void table_set_cell_fg_color(table_t *t, int c, int r, table_text_attr_color_t v)
Definition: table.c:205
perfmon_source
Definition: perfmon.h:81
show_perfmon_source_command_fn
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
PERFMON_BUNDLE_TYPE_THREAD
@ PERFMON_BUNDLE_TYPE_THREAD
Definition: perfmon.h:32
vec_elt_at_index
#define vec_elt_at_index(v, i)
Get vector value at index i checking that i is in bounds.
Definition: vec_bootstrap.h:203
unformat_check_input
static uword unformat_check_input(unformat_input_t *i)
Definition: format.h:163
perfmon_stop_command_fn
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
table_add_header_col
void table_add_header_col(table_t *t, int n_strings,...)
Definition: table.c:236
uword
u64 uword
Definition: types.h:112
PERFMON_BUNDLE_TYPE_SYSTEM
@ PERFMON_BUNDLE_TYPE_SYSTEM
Definition: perfmon.h:33
i
sll srl srl sll sra u16x4 i
Definition: vector_sse42.h:261
show_perfmon_stats_command_fn
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
format_unformat_error
u8 * format_unformat_error(u8 *s, va_list *va)
Definition: unformat.c:91
vec_validate
#define vec_validate(V, I)
Make sure vector is long enough for given index (no header, unspecified alignment)
Definition: vec.h:523
VLIB_CLI_COMMAND
#define VLIB_CLI_COMMAND(x,...)
Definition: cli.h:163
src
vl_api_address_t src
Definition: gre.api:54
it
save_rewrite_length must be aligned so that reass doesn t overwrite it
Definition: buffer.h:421
vlib_cli_output
void vlib_cli_output(vlib_main_t *vm, char *fmt,...)
Definition: cli.c:716
show_perfmon_stats_command
static vlib_cli_command_t show_perfmon_stats_command
(constructor) VLIB_CLI_COMMAND (show_perfmon_stats_command)
Definition: cli.c:354
perfmon_instance_t
Definition: perfmon.h:57
format_perfmon_bundle
u8 * format_perfmon_bundle(u8 *s, va_list *args)
Definition: cli.c:61
perfmon_reset_command_fn
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
vb
vnet_buffer_opaque_t * vb(void *vb_arg)
Definition: gdb_funcs.c:336
show_perfmon_active_bundle_command
static vlib_cli_command_t show_perfmon_active_bundle_command
(constructor) VLIB_CLI_COMMAND (show_perfmon_active_bundle_command)
Definition: cli.c:257
perfmon_start_command_fn
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
vec_free
#define vec_free(V)
Free vector's memory (no header).
Definition: vec.h:395
table_free
void table_free(table_t *t)
Definition: table.c:221
perfmon_main_t::group_fds
int * group_fds
Definition: perfmon.h:163
perfmon_start_command
static vlib_cli_command_t perfmon_start_command
(constructor) VLIB_CLI_COMMAND (perfmon_start_command)
Definition: cli.c:406
format_vlib_node_name
format_function_t format_vlib_node_name
Definition: node_funcs.h:1235
hash_get_mem
#define hash_get_mem(h, key)
Definition: hash.h:269
table_t
Definition: table.h:73
u64
unsigned long u64
Definition: types.h:89
format
description fragment has unexpected format
Definition: map.api:433
perfmon_main_t::bundle_by_name
uword * bundle_by_name
Definition: perfmon.h:157
u32
unsigned int u32
Definition: types.h:88
TTAC_CYAN
@ TTAC_CYAN
Definition: table.h:47
table_format_title
void table_format_title(table_t *t, char *fmt,...)
Definition: table.c:158
perfmon_main_t::is_running
int is_running
Definition: perfmon.h:161
perfmon_instance_t::name
char * name
Definition: perfmon.h:62
clib_error_return_unix
#define clib_error_return_unix(e, args...)
Definition: error.h:102
perfmon_event_t::name
char * name
Definition: perfmon.h:53
table_format_cell
void table_format_cell(table_t *t, int c, int r, char *fmt,...)
Definition: table.c:181
perfmon_thread_runtime_t
Definition: perfmon.h:144
vlib_main_t
Definition: main.h:102
show_perfmon_bundle_command
static vlib_cli_command_t show_perfmon_bundle_command
(constructor) VLIB_CLI_COMMAND (show_perfmon_bundle_command)
Definition: cli.c:138
b
vlib_buffer_t ** b
Definition: nat44_ei_out2in.c:717
u8
unsigned char u8
Definition: types.h:56
clib_error_t
Definition: clib_error.h:21
perfmon_thread_runtime_t::node_stats
perfmon_node_stats_t * node_stats
Definition: perfmon.h:148
perfmon_event_t::description
char * description
Definition: perfmon.h:54
perfmon_stop
clib_error_t * perfmon_stop(vlib_main_t *vm)
Definition: perfmon.c:262
unformat_perfmon_bundle_name
uword unformat_perfmon_bundle_name(unformat_input_t *input, va_list *args)
Definition: cli.c:21
table_add_header_row
void table_add_header_row(table_t *t, int n_strings,...)
Definition: table.c:258
show_perfmon_active_bundle_command_fn
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
perfmon_start
clib_error_t * perfmon_start(vlib_main_t *vm, perfmon_bundle_t *b)
Definition: perfmon.c:216
format_table
format_function_t format_table
Definition: table.h:84
vnet.h
table_set_cell_align
void table_set_cell_align(table_t *t, int c, int r, table_text_attr_align_t a)
Definition: table.c:198
hash_foreach_mem
#define hash_foreach_mem(key_var, value_var, h, body)
Definition: hash.h:460
vlib_cli_command_t
Definition: cli.h:92
show_perfmon_bundle_command_fn
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
unformat_perfmon_source_name
uword unformat_perfmon_source_name(unformat_input_t *input, va_list *args)
Definition: cli.c:41
perfmon_stop_command
static vlib_cli_command_t perfmon_stop_command
(constructor) VLIB_CLI_COMMAND (perfmon_stop_command)
Definition: cli.c:420
table.h
UNFORMAT_END_OF_INPUT
#define UNFORMAT_END_OF_INPUT
Definition: format.h:137