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 /** 63 * @repipe: When set causes certain reading (header and trace events) to 64 * also write events. The written file descriptor must be provided for 65 * the header but is implicitly stdout for trace events. 66 */ 67 bool repipe; 68 /** 69 * @one_mmap: The reader will use a single mmap by default. There may be 70 * multiple data files in particular for aux events. If this is true 71 * then the single big mmap for the data file can be assumed. 72 */ 73 bool one_mmap; 74 /** @one_mmap_addr: Address of initial perf data file reader mmap. */ 75 void *one_mmap_addr; 76 /** @one_mmap_offset: File offset in perf.data file when mapped. */ 77 u64 one_mmap_offset; 78 /** @ordered_events: Used to turn unordered events into ordered ones. */ 79 struct ordered_events ordered_events; 80 /** @data: Optional perf data file being read from. */ 81 struct perf_data *data; 82 /** @tool: callbacks for event handling. */ 83 const struct perf_tool *tool; 84 /** 85 * @bytes_transferred: Used by perf record to count written bytes before 86 * compression. 87 */ 88 u64 bytes_transferred; 89 /** 90 * @bytes_compressed: Used by perf record to count written bytes after 91 * compression. 92 */ 93 u64 bytes_compressed; 94 /** @zstd_data: Owner of global compression state, buffers, etc. */ 95 struct zstd_data zstd_data; 96 struct decomp_data decomp_data; 97 struct decomp_data *active_decomp; 98 }; 99 100 struct decomp { 101 struct decomp *next; 102 u64 file_pos; 103 const char *file_path; 104 size_t mmap_len; 105 u64 head; 106 size_t size; 107 char data[]; 108 }; 109 110 struct perf_tool; 111 112 struct perf_session *__perf_session__new(struct perf_data *data, 113 bool repipe, int repipe_fd, 114 struct perf_tool *tool); 115 116 static inline struct perf_session *perf_session__new(struct perf_data *data, 117 struct perf_tool *tool) 118 { 119 return __perf_session__new(data, false, -1, tool); 120 } 121 122 void perf_session__delete(struct perf_session *session); 123 124 void perf_event_header__bswap(struct perf_event_header *hdr); 125 126 int perf_session__peek_event(struct perf_session *session, off_t file_offset, 127 void *buf, size_t buf_sz, 128 union perf_event **event_ptr, 129 struct perf_sample *sample); 130 typedef int (*peek_events_cb_t)(struct perf_session *session, 131 union perf_event *event, u64 offset, 132 void *data); 133 int perf_session__peek_events(struct perf_session *session, u64 offset, 134 u64 size, peek_events_cb_t cb, void *data); 135 136 int perf_session__process_events(struct perf_session *session); 137 138 int perf_session__queue_event(struct perf_session *s, union perf_event *event, 139 u64 timestamp, u64 file_offset, const char *file_path); 140 141 int perf_session__resolve_callchain(struct perf_session *session, 142 struct evsel *evsel, 143 struct thread *thread, 144 struct ip_callchain *chain, 145 struct symbol **parent); 146 147 bool perf_session__has_traces(struct perf_session *session, const char *msg); 148 149 void perf_event__attr_swap(struct perf_event_attr *attr); 150 151 int perf_session__create_kernel_maps(struct perf_session *session); 152 153 void perf_session__set_id_hdr_size(struct perf_session *session); 154 155 static inline 156 struct machine *perf_session__find_machine(struct perf_session *session, pid_t pid) 157 { 158 return machines__find(&session->machines, pid); 159 } 160 161 static inline 162 struct machine *perf_session__findnew_machine(struct perf_session *session, pid_t pid) 163 { 164 return machines__findnew(&session->machines, pid); 165 } 166 167 struct thread *perf_session__findnew(struct perf_session *session, pid_t pid); 168 int perf_session__register_idle_thread(struct perf_session *session); 169 170 size_t perf_session__fprintf(struct perf_session *session, FILE *fp); 171 172 size_t perf_session__fprintf_dsos(struct perf_session *session, FILE *fp); 173 174 size_t perf_session__fprintf_dsos_buildid(struct perf_session *session, FILE *fp, 175 bool (fn)(struct dso *dso, int parm), int parm); 176 177 size_t perf_session__fprintf_nr_events(struct perf_session *session, FILE *fp); 178 179 void perf_session__dump_kmaps(struct perf_session *session); 180 181 struct evsel *perf_session__find_first_evtype(struct perf_session *session, 182 unsigned int type); 183 184 int perf_session__cpu_bitmap(struct perf_session *session, 185 const char *cpu_list, unsigned long *cpu_bitmap); 186 187 void perf_session__fprintf_info(struct perf_session *s, FILE *fp, bool full); 188 189 struct evsel_str_handler; 190 191 #define perf_session__set_tracepoints_handlers(session, array) \ 192 __evlist__set_tracepoints_handlers(session->evlist, array, ARRAY_SIZE(array)) 193 194 extern volatile int session_done; 195 196 #define session_done() READ_ONCE(session_done) 197 198 int perf_session__deliver_synth_event(struct perf_session *session, 199 union perf_event *event, 200 struct perf_sample *sample); 201 int perf_session__deliver_synth_attr_event(struct perf_session *session, 202 const struct perf_event_attr *attr, 203 u64 id); 204 205 int perf_session__dsos_hit_all(struct perf_session *session); 206 207 int perf_event__process_id_index(struct perf_session *session, 208 union perf_event *event); 209 210 int perf_event__process_finished_round(const struct perf_tool *tool, 211 union perf_event *event, 212 struct ordered_events *oe); 213 214 #endif /* __PERF_SESSION_H */ 215