tools/perf/util/probe-event.h

   1 #ifndef _PROBE_EVENT_H
   2 #define _PROBE_EVENT_H
   3
   4 #include <stdbool.h>
   5 #include "intlist.h"
   6
   7 /* Probe related configurations */
   8 struct probe_conf {
   9         bool    show_ext_vars;
  10         bool    show_location_range;
  11         bool    force_add;
  12         bool    no_inlines;
  13         bool    cache;
  14         int     max_probes;
  15 };
  16 extern struct probe_conf probe_conf;
  17 extern bool probe_event_dry_run;
  18
  19 struct symbol;
  20
  21 /* kprobe-tracer and uprobe-tracer tracing point */
  22 struct probe_trace_point {
  23         char            *realname;      /* function real name (if needed) */
  24         char            *symbol;        /* Base symbol */
  25         char            *module;        /* Module name */
  26         unsigned long   offset;         /* Offset from symbol */
  27         unsigned long   address;        /* Actual address of the trace point */
  28         bool            retprobe;       /* Return probe flag */
  29 };
  30
  31 /* probe-tracer tracing argument referencing offset */
  32 struct probe_trace_arg_ref {
  33         struct probe_trace_arg_ref      *next;  /* Next reference */
  34         long                            offset; /* Offset value */
  35 };
  36
  37 /* kprobe-tracer and uprobe-tracer tracing argument */
  38 struct probe_trace_arg {
  39         char                            *name;  /* Argument name */
  40         char                            *value; /* Base value */
  41         char                            *type;  /* Type name */
  42         struct probe_trace_arg_ref      *ref;   /* Referencing offset */
  43 };
  44
  45 /* kprobe-tracer and uprobe-tracer tracing event (point + arg) */
  46 struct probe_trace_event {
  47         char                            *event; /* Event name */
  48         char                            *group; /* Group name */
  49         struct probe_trace_point        point;  /* Trace point */
  50         int                             nargs;  /* Number of args */
  51         bool                            uprobes;        /* uprobes only */
  52         struct probe_trace_arg          *args;  /* Arguments */
  53 };
  54
  55 /* Perf probe probing point */
  56 struct perf_probe_point {
  57         char            *file;          /* File path */
  58         char            *function;      /* Function name */
  59         int             line;           /* Line number */
  60         bool            retprobe;       /* Return probe flag */
  61         char            *lazy_line;     /* Lazy matching pattern */
  62         unsigned long   offset;         /* Offset from function entry */
  63         unsigned long   abs_address;    /* Absolute address of the point */
  64 };
  65
  66 /* Perf probe probing argument field chain */
  67 struct perf_probe_arg_field {
  68         struct perf_probe_arg_field     *next;  /* Next field */
  69         char                            *name;  /* Name of the field */
  70         long                            index;  /* Array index number */
  71         bool                            ref;    /* Referencing flag */
  72 };
  73
  74 /* Perf probe probing argument */
  75 struct perf_probe_arg {
  76         char                            *name;  /* Argument name */
  77         char                            *var;   /* Variable name */
  78         char                            *type;  /* Type name */
  79         struct perf_probe_arg_field     *field; /* Structure fields */
  80 };
  81
  82 /* Perf probe probing event (point + arg) */
  83 struct perf_probe_event {
  84         char                    *event; /* Event name */
  85         char                    *group; /* Group name */
  86         struct perf_probe_point point;  /* Probe point */
  87         int                     nargs;  /* Number of arguments */
  88         bool                    sdt;    /* SDT/cached event flag */
  89         bool                    uprobes;        /* Uprobe event flag */
  90         char                    *target;        /* Target binary */
  91         struct perf_probe_arg   *args;  /* Arguments */
  92         struct probe_trace_event *tevs;
  93         int                     ntevs;
  94 };
  95
  96 /* Line range */
  97 struct line_range {
  98         char                    *file;          /* File name */
  99         char                    *function;      /* Function name */
 100         int                     start;          /* Start line number */
 101         int                     end;            /* End line number */
 102         int                     offset;         /* Start line offset */
 103         char                    *path;          /* Real path name */
 104         char                    *comp_dir;      /* Compile directory */
 105         struct intlist          *line_list;     /* Visible lines */
 106 };
 107
 108 struct strlist;
 109
 110 /* List of variables */
 111 struct variable_list {
 112         struct probe_trace_point        point;  /* Actual probepoint */
 113         struct strlist                  *vars;  /* Available variables */
 114 };
 115
 116 struct map;
 117 int init_probe_symbol_maps(bool user_only);
 118 void exit_probe_symbol_maps(void);
 119
 120 /* Command string to events */
 121 int parse_perf_probe_command(const char *cmd, struct perf_probe_event *pev);
 122 int parse_probe_trace_command(const char *cmd, struct probe_trace_event *tev);
 123
 124 /* Events to command string */
 125 char *synthesize_perf_probe_command(struct perf_probe_event *pev);
 126 char *synthesize_probe_trace_command(struct probe_trace_event *tev);
 127 char *synthesize_perf_probe_arg(struct perf_probe_arg *pa);
 128 char *synthesize_perf_probe_point(struct perf_probe_point *pp);
 129
 130 int perf_probe_event__copy(struct perf_probe_event *dst,
 131                            struct perf_probe_event *src);
 132
 133 bool perf_probe_with_var(struct perf_probe_event *pev);
 134
 135 /* Check the perf_probe_event needs debuginfo */
 136 bool perf_probe_event_need_dwarf(struct perf_probe_event *pev);
 137
 138 /* Release event contents */
 139 void clear_perf_probe_event(struct perf_probe_event *pev);
 140 void clear_probe_trace_event(struct probe_trace_event *tev);
 141
 142 /* Command string to line-range */
 143 int parse_line_range_desc(const char *cmd, struct line_range *lr);
 144
 145 /* Release line range members */
 146 void line_range__clear(struct line_range *lr);
 147
 148 /* Initialize line range */
 149 int line_range__init(struct line_range *lr);
 150
 151 int add_perf_probe_events(struct perf_probe_event *pevs, int npevs);
 152 int convert_perf_probe_events(struct perf_probe_event *pevs, int npevs);
 153 int apply_perf_probe_events(struct perf_probe_event *pevs, int npevs);
 154 int show_probe_trace_events(struct perf_probe_event *pevs, int npevs);
 155 void cleanup_perf_probe_events(struct perf_probe_event *pevs, int npevs);
 156
 157 struct strfilter;
 158
 159 int del_perf_probe_events(struct strfilter *filter);
 160
 161 int show_perf_probe_event(const char *group, const char *event,
 162                           struct perf_probe_event *pev,
 163                           const char *module, bool use_stdout);
 164 int show_perf_probe_events(struct strfilter *filter);
 165 int show_line_range(struct line_range *lr, const char *module, bool user);
 166 int show_available_vars(struct perf_probe_event *pevs, int npevs,
 167                         struct strfilter *filter);
 168 int show_available_funcs(const char *module, struct strfilter *filter, bool user);
 169 void arch__fix_tev_from_maps(struct perf_probe_event *pev,
 170                              struct probe_trace_event *tev, struct map *map,
 171                              struct symbol *sym);
 172
 173 /* If there is no space to write, returns -E2BIG. */
 174 int e_snprintf(char *str, size_t size, const char *format, ...)
 175         __attribute__((format(printf, 3, 4)));
 176
 177 /* Maximum index number of event-name postfix */
 178 #define MAX_EVENT_INDEX 1024
 179
 180 int copy_to_probe_trace_arg(struct probe_trace_arg *tvar,
 181                             struct perf_probe_arg *pvar);
 182
 183 struct map *get_target_map(const char *target, bool user);
 184
 185 void arch__post_process_probe_trace_events(struct perf_probe_event *pev,
 186                                            int ntevs);
 187
 188 #endif /*_PROBE_EVENT_H */