include/sysemu/stats.h

   1 /*
   2  * Copyright (c) 2022 Oracle and/or its affiliates.
   3  *
   4  * This work is licensed under the terms of the GNU GPL, version 2.
   5  * See the COPYING file in the top-level directory.
   6  */
   7
   8 #ifndef STATS_H
   9 #define STATS_H
  10
  11 #include "qapi/qapi-types-stats.h"
  12
  13 typedef void StatRetrieveFunc(StatsResultList **result, StatsTarget target,
  14                               strList *names, strList *targets, Error **errp);
  15 typedef void SchemaRetrieveFunc(StatsSchemaList **result, Error **errp);
  16
  17 /*
  18  * Register callbacks for the QMP query-stats command.
  19  *
  20  * @provider: stats provider checked against QMP command arguments
  21  * @stats_fn: routine to query stats:
  22  * @schema_fn: routine to query stat schemas:
  23  */
  24 void add_stats_callbacks(StatsProvider provider,
  25                          StatRetrieveFunc *stats_fn,
  26                          SchemaRetrieveFunc *schemas_fn);
  27
  28 /*
  29  * Helper routines for adding stats entries to the results lists.
  30  */
  31 void add_stats_entry(StatsResultList **, StatsProvider, const char *id,
  32                      StatsList *stats_list);
  33 void add_stats_schema(StatsSchemaList **, StatsProvider, StatsTarget,
  34                       StatsSchemaValueList *);
  35
  36 /*
  37  * True if a string matches the filter passed to the stats_fn callback,
  38  * false otherwise.
  39  *
  40  * Note that an empty list means no filtering, i.e. all strings will
  41  * return true.
  42  */
  43 bool apply_str_list_filter(const char *string, strList *list);
  44
  45 #endif /* STATS_H */