tools/perf/util/stat.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 #ifndef __PERF_STATS_H
   3 #define __PERF_STATS_H
   4
   5 #include <linux/types.h>
   6 #include <stdio.h>
   7 #include "xyarray.h"
   8 #include "rblist.h"
   9
  10 struct stats {
  11         double n, mean, M2;
  12         u64 max, min;
  13 };
  14
  15 enum perf_stat_evsel_id {
  16         PERF_STAT_EVSEL_ID__NONE = 0,
  17         PERF_STAT_EVSEL_ID__CYCLES_IN_TX,
  18         PERF_STAT_EVSEL_ID__TRANSACTION_START,
  19         PERF_STAT_EVSEL_ID__ELISION_START,
  20         PERF_STAT_EVSEL_ID__CYCLES_IN_TX_CP,
  21         PERF_STAT_EVSEL_ID__TOPDOWN_TOTAL_SLOTS,
  22         PERF_STAT_EVSEL_ID__TOPDOWN_SLOTS_ISSUED,
  23         PERF_STAT_EVSEL_ID__TOPDOWN_SLOTS_RETIRED,
  24         PERF_STAT_EVSEL_ID__TOPDOWN_FETCH_BUBBLES,
  25         PERF_STAT_EVSEL_ID__TOPDOWN_RECOVERY_BUBBLES,
  26         PERF_STAT_EVSEL_ID__SMI_NUM,
  27         PERF_STAT_EVSEL_ID__APERF,
  28         PERF_STAT_EVSEL_ID__MAX,
  29 };
  30
  31 struct perf_stat_evsel {
  32         struct stats             res_stats[3];
  33         enum perf_stat_evsel_id  id;
  34         u64                     *group_data;
  35 };
  36
  37 enum aggr_mode {
  38         AGGR_NONE,
  39         AGGR_GLOBAL,
  40         AGGR_SOCKET,
  41         AGGR_CORE,
  42         AGGR_THREAD,
  43         AGGR_UNSET,
  44 };
  45
  46 enum {
  47         CTX_BIT_USER    = 1 << 0,
  48         CTX_BIT_KERNEL  = 1 << 1,
  49         CTX_BIT_HV      = 1 << 2,
  50         CTX_BIT_HOST    = 1 << 3,
  51         CTX_BIT_IDLE    = 1 << 4,
  52         CTX_BIT_MAX     = 1 << 5,
  53 };
  54
  55 #define NUM_CTX CTX_BIT_MAX
  56
  57 enum stat_type {
  58         STAT_NONE = 0,
  59         STAT_NSECS,
  60         STAT_CYCLES,
  61         STAT_STALLED_CYCLES_FRONT,
  62         STAT_STALLED_CYCLES_BACK,
  63         STAT_BRANCHES,
  64         STAT_CACHEREFS,
  65         STAT_L1_DCACHE,
  66         STAT_L1_ICACHE,
  67         STAT_LL_CACHE,
  68         STAT_ITLB_CACHE,
  69         STAT_DTLB_CACHE,
  70         STAT_CYCLES_IN_TX,
  71         STAT_TRANSACTION,
  72         STAT_ELISION,
  73         STAT_TOPDOWN_TOTAL_SLOTS,
  74         STAT_TOPDOWN_SLOTS_ISSUED,
  75         STAT_TOPDOWN_SLOTS_RETIRED,
  76         STAT_TOPDOWN_FETCH_BUBBLES,
  77         STAT_TOPDOWN_RECOVERY_BUBBLES,
  78         STAT_SMI_NUM,
  79         STAT_APERF,
  80         STAT_MAX
  81 };
  82
  83 struct runtime_stat {
  84         struct rblist value_list;
  85 };
  86
  87 struct perf_stat_config {
  88         enum aggr_mode  aggr_mode;
  89         bool            scale;
  90         FILE            *output;
  91         unsigned int    interval;
  92         unsigned int    timeout;
  93         int             times;
  94         struct runtime_stat *stats;
  95         int             stats_num;
  96 };
  97
  98 void update_stats(struct stats *stats, u64 val);
  99 double avg_stats(struct stats *stats);
 100 double stddev_stats(struct stats *stats);
 101 double rel_stddev_stats(double stddev, double avg);
 102
 103 static inline void init_stats(struct stats *stats)
 104 {
 105         stats->n    = 0.0;
 106         stats->mean = 0.0;
 107         stats->M2   = 0.0;
 108         stats->min  = (u64) -1;
 109         stats->max  = 0;
 110 }
 111
 112 struct perf_evsel;
 113 struct perf_evlist;
 114
 115 struct perf_aggr_thread_value {
 116         struct perf_evsel *counter;
 117         int id;
 118         double uval;
 119         u64 val;
 120         u64 run;
 121         u64 ena;
 122 };
 123
 124 bool __perf_evsel_stat__is(struct perf_evsel *evsel,
 125                            enum perf_stat_evsel_id id);
 126
 127 #define perf_stat_evsel__is(evsel, id) \
 128         __perf_evsel_stat__is(evsel, PERF_STAT_EVSEL_ID__ ## id)
 129
 130 extern struct runtime_stat rt_stat;
 131 extern struct stats walltime_nsecs_stats;
 132
 133 typedef void (*print_metric_t)(void *ctx, const char *color, const char *unit,
 134                                const char *fmt, double val);
 135 typedef void (*new_line_t )(void *ctx);
 136
 137 void runtime_stat__init(struct runtime_stat *st);
 138 void runtime_stat__exit(struct runtime_stat *st);
 139 void perf_stat__init_shadow_stats(void);
 140 void perf_stat__reset_shadow_stats(void);
 141 void perf_stat__reset_shadow_per_stat(struct runtime_stat *st);
 142 void perf_stat__update_shadow_stats(struct perf_evsel *counter, u64 count,
 143                                     int cpu, struct runtime_stat *st);
 144 struct perf_stat_output_ctx {
 145         void *ctx;
 146         print_metric_t print_metric;
 147         new_line_t new_line;
 148         bool force_header;
 149 };
 150
 151 void perf_stat__print_shadow_stats(struct perf_evsel *evsel,
 152                                    double avg, int cpu,
 153                                    struct perf_stat_output_ctx *out,
 154                                    struct rblist *metric_events,
 155                                    struct runtime_stat *st);
 156 void perf_stat__collect_metric_expr(struct perf_evlist *);
 157
 158 int perf_evlist__alloc_stats(struct perf_evlist *evlist, bool alloc_raw);
 159 void perf_evlist__free_stats(struct perf_evlist *evlist);
 160 void perf_evlist__reset_stats(struct perf_evlist *evlist);
 161 void perf_evlist__reset_prev_raw_counts(struct perf_evlist *evlist);
 162
 163 int perf_stat_process_counter(struct perf_stat_config *config,
 164                               struct perf_evsel *counter);
 165 struct perf_tool;
 166 union perf_event;
 167 struct perf_session;
 168 int perf_event__process_stat_event(struct perf_tool *tool,
 169                                    union perf_event *event,
 170                                    struct perf_session *session);
 171
 172 size_t perf_event__fprintf_stat(union perf_event *event, FILE *fp);
 173 size_t perf_event__fprintf_stat_round(union perf_event *event, FILE *fp);
 174 size_t perf_event__fprintf_stat_config(union perf_event *event, FILE *fp);
 175 #endif