1 /* SPDX-License-Identifier: GPL-2.0 */ 2 #ifndef __PERF_SESSION_H 3 #define __PERF_SESSION_H 4 5 #include "trace-event.h" 6 #include "event.h" 7 #include "header.h" 8 #include "machine.h" 9 #include "data.h" 10 #include "ordered-events.h" 11 #include "util/compress.h" 12 #include <linux/kernel.h> 13 #include <linux/rbtree.h> 14 #include <linux/perf_event.h> 15 16 struct ip_callchain; 17 struct symbol; 18 struct thread; 19 20 struct auxtrace; 21 struct itrace_synth_opts; 22 23 struct decomp_data { 24 struct decomp *decomp; 25 struct decomp *decomp_last; 26 struct zstd_data *zstd_decomp; 27 }; 28 29 /** 30 * struct perf_session- A Perf session holds the main state when the program is 31 * working with live perf events or reading data from an input file. 32 * 33 * The rough organization of a perf_session is: 34 * ``` 35 * +--------------+ +-----------+ +------------+ 36 * | Session |1..* ----->| Machine |1..* ----->| Thread | 37 * +--------------+ +-----------+ +------------+ 38 * ``` 39 */ 40 struct perf_session { 41 /** 42 * @header: The read version of a perf_file_header, or captures global 43 * information from a live session. 44 */ 45 struct perf_header header; 46 /** @machines: Machines within the session a host and 0 or more guests. */ 47 struct machines machines; 48 /** @evlist: List of evsels/events of the session. */ 49 struct evlist *evlist; 50 /** @auxtrace: callbacks to allow AUX area data decoding. */ 51 const struct auxtrace *auxtrace; 52 /** @itrace_synth_opts: AUX area tracing synthesis options. */ 53 struct itrace_synth_opts *itrace_synth_opts; 54 /** @auxtrace_index: index of AUX area tracing events within a perf.data file. */ 55 struct list_head auxtrace_index; 56 #ifdef HAVE_LIBTRACEEVENT 57 /** @tevent: handles for libtraceevent and plugins. */ 58 struct trace_event tevent; 59 #endif 60 /** @time_conv: Holds contents of last PERF_RECORD_TIME_CONV event. */ 61 struct perf_record_time_conv time_conv; 62 /** @trace_event_repipe: When set causes read trace events to be written to stdout. */ 63 bool trace_event_repipe; 64 /** 65 * @one_mmap: The reader will use a single mmap by default. There may be 66 * multiple data files in particular for aux events. If this is true 67 * then the single big mmap for the data file can be assumed. 68 */ 69 bool one_mmap; 70 /** @one_mmap_addr: Address of initial perf data file reader mmap. */ 71 void *one_mmap_addr; 72 /** @one_mmap_offset: File offset in perf.data file when mapped. */ 73 u64 one_mmap_offset; 74 /** @ordered_events: Used to turn unordered events into ordered ones. */ 75 struct ordered_events ordered_events; 76 /** @data: Optional perf data file being read from. */ 77 struct perf_data *data; 78 /** @tool: callbacks for event handling. */ 79 const struct perf_tool *tool; 80 /** 81 * @bytes_transferred: Used by perf record to count written bytes before 82 * compression. 83 */ 84 u64 bytes_transferred; 85 /** 86 * @bytes_compressed: Used by perf record to count written bytes after 87 * compression. 88 */ 89 u64 bytes_compressed; 90 /** @zstd_data: Owner of global compression state, buffers, etc. */ 91 struct zstd_data zstd_data; 92 struct decomp_data decomp_data; 93 struct decomp_data *active_decomp; 94 }; 95 96 struct decomp { 97 struct decomp *next; 98 u64 file_pos; 99 const char *file_path; 100 size_t mmap_len; 101 u64 head; 102 size_t size; 103 char data[]; 104 }; 105 106 struct perf_tool; 107 108 struct perf_session *__perf_session__new(struct perf_data *data, 109 struct perf_tool *tool, 110 bool trace_event_repipe); 111 112 static inline struct perf_session *perf_session__new(struct perf_data *data, 113 struct perf_tool *tool) 114 { 115 return __perf_session__new(data, tool, /*trace_event_repipe=*/false); 116 } 117 118 void perf_session__delete(struct perf_session *session); 119 120 void perf_event_header__bswap(struct perf_event_header *hdr); 121 122 int perf_session__peek_event(struct perf_session *session, off_t file_offset, 123 void *buf, size_t buf_sz, 124 union perf_event **event_ptr, 125 struct perf_sample *sample); 126 typedef int (*peek_events_cb_t)(struct perf_session *session, 127 union perf_event *event, u64 offset, 128 void *data); 129 int perf_session__peek_events(struct perf_session *session, u64 offset, 130 u64 size, peek_events_cb_t cb, void *data); 131 132 int perf_session__process_events(struct perf_session *session); 133 134 int perf_session__queue_event(struct perf_session *s, union perf_event *event, 135 u64 timestamp, u64 file_offset, const char *file_path); 136 137 int perf_session__resolve_callchain(struct perf_session *session, 138 struct evsel *evsel, 139 struct thread *thread, 140 struct ip_callchain *chain, 141 struct symbol **parent); 142 143 bool perf_session__has_traces(struct perf_session *session, const char *msg); 144 bool perf_session__has_switch_events(struct perf_session *session); 145 146 void perf_event__attr_swap(struct perf_event_attr *attr); 147 148 int perf_session__create_kernel_maps(struct perf_session *session); 149 150 void perf_session__set_id_hdr_size(struct perf_session *session); 151 152 static inline 153 struct machine *perf_session__find_machine(struct perf_session *session, pid_t pid) 154 { 155 return machines__find(&session->machines, pid); 156 } 157 158 static inline 159 struct machine *perf_session__findnew_machine(struct perf_session *session, pid_t pid) 160 { 161 return machines__findnew(&session->machines, pid); 162 } 163 164 struct thread *perf_session__findnew(struct perf_session *session, pid_t pid); 165 int perf_session__register_idle_thread(struct perf_session *session); 166 167 size_t perf_session__fprintf(struct perf_session *session, FILE *fp); 168 169 size_t perf_session__fprintf_dsos(struct perf_session *session, FILE *fp); 170 171 size_t perf_session__fprintf_dsos_buildid(struct perf_session *session, FILE *fp, 172 bool (fn)(struct dso *dso, int parm), int parm); 173 174 size_t perf_session__fprintf_nr_events(struct perf_session *session, FILE *fp); 175 176 void perf_session__dump_kmaps(struct perf_session *session); 177 178 struct evsel *perf_session__find_first_evtype(struct perf_session *session, 179 unsigned int type); 180 181 int perf_session__cpu_bitmap(struct perf_session *session, 182 const char *cpu_list, unsigned long *cpu_bitmap); 183 184 void perf_session__fprintf_info(struct perf_session *s, FILE *fp, bool full); 185 186 struct evsel_str_handler; 187 188 #define perf_session__set_tracepoints_handlers(session, array) \ 189 __evlist__set_tracepoints_handlers(session->evlist, array, ARRAY_SIZE(array)) 190 191 extern volatile int session_done; 192 193 #define session_done() READ_ONCE(session_done) 194 195 int perf_session__deliver_synth_event(struct perf_session *session, 196 union perf_event *event, 197 struct perf_sample *sample); 198 int perf_session__deliver_synth_attr_event(struct perf_session *session, 199 const struct perf_event_attr *attr, 200 u64 id); 201 202 int perf_session__dsos_hit_all(struct perf_session *session); 203 204 int perf_event__process_id_index(struct perf_session *session, 205 union perf_event *event); 206 207 int perf_event__process_finished_round(const struct perf_tool *tool, 208 union perf_event *event, 209 struct ordered_events *oe); 210 211 #endif /* __PERF_SESSION_H */ 212