synthetic-events.h

  1/* SPDX-License-Identifier: GPL-2.0 */
  2#ifndef __PERF_SYNTHETIC_EVENTS_H
  3#define __PERF_SYNTHETIC_EVENTS_H
  4
  5#include <stdbool.h>
  6#include <sys/types.h> // pid_t
  7#include <linux/compiler.h>
  8#include <linux/types.h>
  9#include <perf/cpumap.h>
 10
 11struct auxtrace_record;
 12struct build_id;
 13struct dso;
 14struct evlist;
 15struct evsel;
 16struct machine;
 17struct perf_counts_values;
 18struct perf_cpu_map;
 19struct perf_data;
 20struct perf_event_attr;
 21struct perf_event_mmap_page;
 22struct perf_sample;
 23struct perf_session;
 24struct perf_stat_config;
 25struct perf_thread_map;
 26struct perf_tool;
 27struct record_opts;
 28struct target;
 29
 30union perf_event;
 31
 32enum perf_record_synth {
 33	PERF_SYNTH_TASK		= 1 << 0,
 34	PERF_SYNTH_MMAP		= 1 << 1,
 35	PERF_SYNTH_CGROUP	= 1 << 2,
 36
 37	/* last element */
 38	PERF_SYNTH_MAX		= 1 << 3,
 39};
 40#define PERF_SYNTH_ALL  (PERF_SYNTH_MAX - 1)
 41
 42int parse_synth_opt(char *str);
 43
 44typedef int (*perf_event__handler_t)(const struct perf_tool *tool, union perf_event *event,
 45				     struct perf_sample *sample, struct machine *machine);
 46
 47int perf_event__synthesize_attrs(const struct perf_tool *tool, struct evlist *evlist, perf_event__handler_t process);
 48int perf_event__synthesize_attr(const struct perf_tool *tool, struct perf_event_attr *attr, u32 ids, u64 *id, perf_event__handler_t process);
 49int perf_event__synthesize_build_id(const struct perf_tool *tool,
 50				    struct perf_sample *sample,
 51				    struct machine *machine,
 52				    perf_event__handler_t process,
 53				    const struct evsel *evsel,
 54				    __u16 misc,
 55				    const struct build_id *bid,
 56				    const char *filename);
 57int perf_event__synthesize_mmap2_build_id(const struct perf_tool *tool,
 58					  struct perf_sample *sample,
 59					  struct machine *machine,
 60					  perf_event__handler_t process,
 61					  const struct evsel *evsel,
 62					  __u16 misc,
 63					  __u32 pid, __u32 tid,
 64					  __u64 start, __u64 len, __u64 pgoff,
 65					  const struct build_id *bid,
 66					  __u32 prot, __u32 flags,
 67					  const char *filename);
 68int perf_event__synthesize_cpu_map(const struct perf_tool *tool, const struct perf_cpu_map *cpus, perf_event__handler_t process, struct machine *machine);
 69int perf_event__synthesize_event_update_cpus(const struct perf_tool *tool, struct evsel *evsel, perf_event__handler_t process);
 70int perf_event__synthesize_event_update_name(const struct perf_tool *tool, struct evsel *evsel, perf_event__handler_t process);
 71int perf_event__synthesize_event_update_scale(const struct perf_tool *tool, struct evsel *evsel, perf_event__handler_t process);
 72int perf_event__synthesize_event_update_unit(const struct perf_tool *tool, struct evsel *evsel, perf_event__handler_t process);
 73int perf_event__synthesize_extra_attr(const struct perf_tool *tool, struct evlist *evsel_list, perf_event__handler_t process, bool is_pipe);
 74int perf_event__synthesize_extra_kmaps(const struct perf_tool *tool, perf_event__handler_t process, struct machine *machine);
 75int perf_event__synthesize_features(const struct perf_tool *tool, struct perf_session *session, struct evlist *evlist, perf_event__handler_t process);
 76int perf_event__synthesize_id_index(const struct perf_tool *tool, perf_event__handler_t process, struct evlist *evlist, struct machine *machine);
 77int __perf_event__synthesize_id_index(const struct perf_tool *tool, perf_event__handler_t process, struct evlist *evlist, struct machine *machine, size_t from);
 78int perf_event__synthesize_id_sample(__u64 *array, u64 type, const struct perf_sample *sample);
 79int perf_event__synthesize_kernel_mmap(const struct perf_tool *tool, perf_event__handler_t process, struct machine *machine);
 80int perf_event__synthesize_mmap_events(const struct perf_tool *tool, union perf_event *event, pid_t pid, pid_t tgid, perf_event__handler_t process, struct machine *machine, bool mmap_data);
 81int perf_event__synthesize_modules(const struct perf_tool *tool, perf_event__handler_t process, struct machine *machine);
 82int perf_event__synthesize_namespaces(const struct perf_tool *tool, union perf_event *event, pid_t pid, pid_t tgid, perf_event__handler_t process, struct machine *machine);
 83int perf_event__synthesize_cgroups(const struct perf_tool *tool, perf_event__handler_t process, struct machine *machine);
 84int perf_event__synthesize_sample(union perf_event *event, u64 type, u64 read_format, const struct perf_sample *sample);
 85int perf_event__synthesize_stat_config(const struct perf_tool *tool, struct perf_stat_config *config, perf_event__handler_t process, struct machine *machine);
 86int perf_event__synthesize_stat_events(struct perf_stat_config *config, const struct perf_tool *tool, struct evlist *evlist, perf_event__handler_t process, bool attrs);
 87int perf_event__synthesize_stat_round(const struct perf_tool *tool, u64 time, u64 type, perf_event__handler_t process, struct machine *machine);
 88int perf_event__synthesize_stat(const struct perf_tool *tool, struct perf_cpu cpu, u32 thread, u64 id, struct perf_counts_values *count, perf_event__handler_t process, struct machine *machine);
 89int perf_event__synthesize_thread_map2(const struct perf_tool *tool, struct perf_thread_map *threads, perf_event__handler_t process, struct machine *machine);
 90int perf_event__synthesize_thread_map(const struct perf_tool *tool, struct perf_thread_map *threads, perf_event__handler_t process, struct machine *machine, bool needs_mmap, bool mmap_data);
 91int perf_event__synthesize_threads(const struct perf_tool *tool, perf_event__handler_t process, struct machine *machine, bool needs_mmap, bool mmap_data, unsigned int nr_threads_synthesize);
 92int perf_event__synthesize_tracing_data(const struct perf_tool *tool, int fd, struct evlist *evlist, perf_event__handler_t process);
 93int perf_event__synth_time_conv(const struct perf_event_mmap_page *pc, const struct perf_tool *tool, perf_event__handler_t process, struct machine *machine);
 94pid_t perf_event__synthesize_comm(const struct perf_tool *tool, union perf_event *event, pid_t pid, perf_event__handler_t process, struct machine *machine);
 95void perf_event__synthesize_final_bpf_metadata(struct perf_session *session,
 96					       perf_event__handler_t process);
 97
 98int perf_tool__process_synth_event(const struct perf_tool *tool, union perf_event *event, struct machine *machine, perf_event__handler_t process);
 99
100size_t perf_event__sample_event_size(const struct perf_sample *sample, u64 type, u64 read_format);
101
102int __machine__synthesize_threads(struct machine *machine, const struct perf_tool *tool,
103				  struct target *target, struct perf_thread_map *threads,
104				  perf_event__handler_t process, bool needs_mmap, bool data_mmap,
105				  unsigned int nr_threads_synthesize);
106int machine__synthesize_threads(struct machine *machine, struct target *target,
107				struct perf_thread_map *threads, bool needs_mmap, bool data_mmap,
108				unsigned int nr_threads_synthesize);
109
110int perf_event__synthesize_auxtrace_info(struct auxtrace_record *itr, const struct perf_tool *tool,
111					 struct perf_session *session, perf_event__handler_t process);
112
113#ifdef HAVE_LIBBPF_SUPPORT
114int perf_event__synthesize_bpf_events(struct perf_session *session, perf_event__handler_t process,
115				      struct machine *machine, struct record_opts *opts);
116#else // HAVE_LIBBPF_SUPPORT
117static inline int perf_event__synthesize_bpf_events(struct perf_session *session __maybe_unused,
118						    perf_event__handler_t process __maybe_unused,
119						    struct machine *machine __maybe_unused,
120						    struct record_opts *opts __maybe_unused)
121{
122	return 0;
123}
124#endif // HAVE_LIBBPF_SUPPORT
125
126int perf_event__synthesize_for_pipe(const struct perf_tool *tool,
127				    struct perf_session *session,
128				    struct perf_data *data,
129				    perf_event__handler_t process);
130
131#endif // __PERF_SYNTHETIC_EVENTS_H