linux/tools/perf/util/stat.h
<<
>>
Prefs
   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 <sys/types.h>
   8#include <sys/time.h>
   9#include <sys/resource.h>
  10#include <sys/wait.h>
  11#include "xyarray.h"
  12#include "rblist.h"
  13#include "perf.h"
  14#include "event.h"
  15
  16struct stats {
  17        double n, mean, M2;
  18        u64 max, min;
  19};
  20
  21enum perf_stat_evsel_id {
  22        PERF_STAT_EVSEL_ID__NONE = 0,
  23        PERF_STAT_EVSEL_ID__CYCLES_IN_TX,
  24        PERF_STAT_EVSEL_ID__TRANSACTION_START,
  25        PERF_STAT_EVSEL_ID__ELISION_START,
  26        PERF_STAT_EVSEL_ID__CYCLES_IN_TX_CP,
  27        PERF_STAT_EVSEL_ID__TOPDOWN_TOTAL_SLOTS,
  28        PERF_STAT_EVSEL_ID__TOPDOWN_SLOTS_ISSUED,
  29        PERF_STAT_EVSEL_ID__TOPDOWN_SLOTS_RETIRED,
  30        PERF_STAT_EVSEL_ID__TOPDOWN_FETCH_BUBBLES,
  31        PERF_STAT_EVSEL_ID__TOPDOWN_RECOVERY_BUBBLES,
  32        PERF_STAT_EVSEL_ID__SMI_NUM,
  33        PERF_STAT_EVSEL_ID__APERF,
  34        PERF_STAT_EVSEL_ID__MAX,
  35};
  36
  37struct perf_stat_evsel {
  38        struct stats             res_stats[3];
  39        enum perf_stat_evsel_id  id;
  40        u64                     *group_data;
  41};
  42
  43enum aggr_mode {
  44        AGGR_NONE,
  45        AGGR_GLOBAL,
  46        AGGR_SOCKET,
  47        AGGR_DIE,
  48        AGGR_CORE,
  49        AGGR_THREAD,
  50        AGGR_UNSET,
  51};
  52
  53enum {
  54        CTX_BIT_USER    = 1 << 0,
  55        CTX_BIT_KERNEL  = 1 << 1,
  56        CTX_BIT_HV      = 1 << 2,
  57        CTX_BIT_HOST    = 1 << 3,
  58        CTX_BIT_IDLE    = 1 << 4,
  59        CTX_BIT_MAX     = 1 << 5,
  60};
  61
  62#define NUM_CTX CTX_BIT_MAX
  63
  64enum stat_type {
  65        STAT_NONE = 0,
  66        STAT_NSECS,
  67        STAT_CYCLES,
  68        STAT_STALLED_CYCLES_FRONT,
  69        STAT_STALLED_CYCLES_BACK,
  70        STAT_BRANCHES,
  71        STAT_CACHEREFS,
  72        STAT_L1_DCACHE,
  73        STAT_L1_ICACHE,
  74        STAT_LL_CACHE,
  75        STAT_ITLB_CACHE,
  76        STAT_DTLB_CACHE,
  77        STAT_CYCLES_IN_TX,
  78        STAT_TRANSACTION,
  79        STAT_ELISION,
  80        STAT_TOPDOWN_TOTAL_SLOTS,
  81        STAT_TOPDOWN_SLOTS_ISSUED,
  82        STAT_TOPDOWN_SLOTS_RETIRED,
  83        STAT_TOPDOWN_FETCH_BUBBLES,
  84        STAT_TOPDOWN_RECOVERY_BUBBLES,
  85        STAT_SMI_NUM,
  86        STAT_APERF,
  87        STAT_MAX
  88};
  89
  90struct runtime_stat {
  91        struct rblist value_list;
  92};
  93
  94typedef int (*aggr_get_id_t)(struct perf_stat_config *config,
  95                             struct cpu_map *m, int cpu);
  96
  97struct perf_stat_config {
  98        enum aggr_mode           aggr_mode;
  99        bool                     scale;
 100        bool                     no_inherit;
 101        bool                     identifier;
 102        bool                     csv_output;
 103        bool                     interval_clear;
 104        bool                     metric_only;
 105        bool                     null_run;
 106        bool                     ru_display;
 107        bool                     big_num;
 108        bool                     no_merge;
 109        bool                     walltime_run_table;
 110        FILE                    *output;
 111        unsigned int             interval;
 112        unsigned int             timeout;
 113        unsigned int             initial_delay;
 114        unsigned int             unit_width;
 115        unsigned int             metric_only_len;
 116        int                      times;
 117        int                      run_count;
 118        int                      print_free_counters_hint;
 119        int                      print_mixed_hw_group_error;
 120        struct runtime_stat     *stats;
 121        int                      stats_num;
 122        const char              *csv_sep;
 123        struct stats            *walltime_nsecs_stats;
 124        struct rusage            ru_data;
 125        struct cpu_map          *aggr_map;
 126        aggr_get_id_t            aggr_get_id;
 127        struct cpu_map          *cpus_aggr_map;
 128        u64                     *walltime_run;
 129        struct rblist            metric_events;
 130};
 131
 132void update_stats(struct stats *stats, u64 val);
 133double avg_stats(struct stats *stats);
 134double stddev_stats(struct stats *stats);
 135double rel_stddev_stats(double stddev, double avg);
 136
 137static inline void init_stats(struct stats *stats)
 138{
 139        stats->n    = 0.0;
 140        stats->mean = 0.0;
 141        stats->M2   = 0.0;
 142        stats->min  = (u64) -1;
 143        stats->max  = 0;
 144}
 145
 146struct perf_evsel;
 147struct perf_evlist;
 148
 149struct perf_aggr_thread_value {
 150        struct perf_evsel *counter;
 151        int id;
 152        double uval;
 153        u64 val;
 154        u64 run;
 155        u64 ena;
 156};
 157
 158bool __perf_evsel_stat__is(struct perf_evsel *evsel,
 159                           enum perf_stat_evsel_id id);
 160
 161#define perf_stat_evsel__is(evsel, id) \
 162        __perf_evsel_stat__is(evsel, PERF_STAT_EVSEL_ID__ ## id)
 163
 164extern struct runtime_stat rt_stat;
 165extern struct stats walltime_nsecs_stats;
 166
 167typedef void (*print_metric_t)(struct perf_stat_config *config,
 168                               void *ctx, const char *color, const char *unit,
 169                               const char *fmt, double val);
 170typedef void (*new_line_t)(struct perf_stat_config *config, void *ctx);
 171
 172void runtime_stat__init(struct runtime_stat *st);
 173void runtime_stat__exit(struct runtime_stat *st);
 174void perf_stat__init_shadow_stats(void);
 175void perf_stat__reset_shadow_stats(void);
 176void perf_stat__reset_shadow_per_stat(struct runtime_stat *st);
 177void perf_stat__update_shadow_stats(struct perf_evsel *counter, u64 count,
 178                                    int cpu, struct runtime_stat *st);
 179struct perf_stat_output_ctx {
 180        void *ctx;
 181        print_metric_t print_metric;
 182        new_line_t new_line;
 183        bool force_header;
 184};
 185
 186void perf_stat__print_shadow_stats(struct perf_stat_config *config,
 187                                   struct perf_evsel *evsel,
 188                                   double avg, int cpu,
 189                                   struct perf_stat_output_ctx *out,
 190                                   struct rblist *metric_events,
 191                                   struct runtime_stat *st);
 192void perf_stat__collect_metric_expr(struct perf_evlist *);
 193
 194int perf_evlist__alloc_stats(struct perf_evlist *evlist, bool alloc_raw);
 195void perf_evlist__free_stats(struct perf_evlist *evlist);
 196void perf_evlist__reset_stats(struct perf_evlist *evlist);
 197
 198int perf_stat_process_counter(struct perf_stat_config *config,
 199                              struct perf_evsel *counter);
 200struct perf_tool;
 201union perf_event;
 202struct perf_session;
 203int perf_event__process_stat_event(struct perf_session *session,
 204                                   union perf_event *event);
 205
 206size_t perf_event__fprintf_stat(union perf_event *event, FILE *fp);
 207size_t perf_event__fprintf_stat_round(union perf_event *event, FILE *fp);
 208size_t perf_event__fprintf_stat_config(union perf_event *event, FILE *fp);
 209
 210int create_perf_stat_counter(struct perf_evsel *evsel,
 211                             struct perf_stat_config *config,
 212                             struct target *target);
 213int perf_stat_synthesize_config(struct perf_stat_config *config,
 214                                struct perf_tool *tool,
 215                                struct perf_evlist *evlist,
 216                                perf_event__handler_t process,
 217                                bool attrs);
 218void
 219perf_evlist__print_counters(struct perf_evlist *evlist,
 220                            struct perf_stat_config *config,
 221                            struct target *_target,
 222                            struct timespec *ts,
 223                            int argc, const char **argv);
 224#endif
 225