tools/perf/util/machine.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 #ifndef __PERF_MACHINE_H
   3 #define __PERF_MACHINE_H
   4
   5 #include <sys/types.h>
   6 #include <linux/rbtree.h>
   7 #include "map_groups.h"
   8 #include "dso.h"
   9 #include "event.h"
  10 #include "rwsem.h"
  11
  12 struct addr_location;
  13 struct branch_stack;
  14 struct perf_evsel;
  15 struct perf_sample;
  16 struct symbol;
  17 struct thread;
  18 union perf_event;
  19
  20 /* Native host kernel uses -1 as pid index in machine */
  21 #define HOST_KERNEL_ID                  (-1)
  22 #define DEFAULT_GUEST_KERNEL_ID         (0)
  23
  24 extern const char *ref_reloc_sym_names[];
  25
  26 struct vdso_info;
  27
  28 #define THREADS__TABLE_BITS     8
  29 #define THREADS__TABLE_SIZE     (1 << THREADS__TABLE_BITS)
  30
  31 struct threads {
  32         struct rb_root_cached  entries;
  33         struct rw_semaphore    lock;
  34         unsigned int           nr;
  35         struct list_head       dead;
  36         struct thread          *last_match;
  37 };
  38
  39 struct machine {
  40         struct rb_node    rb_node;
  41         pid_t             pid;
  42         u16               id_hdr_size;
  43         bool              comm_exec;
  44         bool              kptr_restrict_warned;
  45         bool              single_address_space;
  46         char              *root_dir;
  47         char              *mmap_name;
  48         struct threads    threads[THREADS__TABLE_SIZE];
  49         struct vdso_info  *vdso_info;
  50         struct perf_env   *env;
  51         struct dsos       dsos;
  52         struct map_groups kmaps;
  53         struct map        *vmlinux_map;
  54         u64               kernel_start;
  55         pid_t             *current_tid;
  56         union { /* Tool specific area */
  57                 void      *priv;
  58                 u64       db_id;
  59         };
  60         bool              trampolines_mapped;
  61 };
  62
  63 static inline struct threads *machine__threads(struct machine *machine, pid_t tid)
  64 {
  65         /* Cast it to handle tid == -1 */
  66         return &machine->threads[(unsigned int)tid % THREADS__TABLE_SIZE];
  67 }
  68
  69 /*
  70  * The main kernel (vmlinux) map
  71  */
  72 static inline
  73 struct map *machine__kernel_map(struct machine *machine)
  74 {
  75         return machine->vmlinux_map;
  76 }
  77
  78 /*
  79  * kernel (the one returned by machine__kernel_map()) plus kernel modules maps
  80  */
  81 static inline
  82 struct maps *machine__kernel_maps(struct machine *machine)
  83 {
  84         return &machine->kmaps.maps;
  85 }
  86
  87 int machine__get_kernel_start(struct machine *machine);
  88
  89 static inline u64 machine__kernel_start(struct machine *machine)
  90 {
  91         if (!machine->kernel_start)
  92                 machine__get_kernel_start(machine);
  93         return machine->kernel_start;
  94 }
  95
  96 static inline bool machine__kernel_ip(struct machine *machine, u64 ip)
  97 {
  98         u64 kernel_start = machine__kernel_start(machine);
  99
 100         return ip >= kernel_start;
 101 }
 102
 103 u8 machine__addr_cpumode(struct machine *machine, u8 cpumode, u64 addr);
 104
 105 struct thread *machine__find_thread(struct machine *machine, pid_t pid,
 106                                     pid_t tid);
 107 struct comm *machine__thread_exec_comm(struct machine *machine,
 108                                        struct thread *thread);
 109
 110 int machine__process_comm_event(struct machine *machine, union perf_event *event,
 111                                 struct perf_sample *sample);
 112 int machine__process_exit_event(struct machine *machine, union perf_event *event,
 113                                 struct perf_sample *sample);
 114 int machine__process_fork_event(struct machine *machine, union perf_event *event,
 115                                 struct perf_sample *sample);
 116 int machine__process_lost_event(struct machine *machine, union perf_event *event,
 117                                 struct perf_sample *sample);
 118 int machine__process_lost_samples_event(struct machine *machine, union perf_event *event,
 119                                         struct perf_sample *sample);
 120 int machine__process_aux_event(struct machine *machine,
 121                                union perf_event *event);
 122 int machine__process_itrace_start_event(struct machine *machine,
 123                                         union perf_event *event);
 124 int machine__process_switch_event(struct machine *machine,
 125                                   union perf_event *event);
 126 int machine__process_namespaces_event(struct machine *machine,
 127                                       union perf_event *event,
 128                                       struct perf_sample *sample);
 129 int machine__process_mmap_event(struct machine *machine, union perf_event *event,
 130                                 struct perf_sample *sample);
 131 int machine__process_mmap2_event(struct machine *machine, union perf_event *event,
 132                                  struct perf_sample *sample);
 133 int machine__process_ksymbol(struct machine *machine,
 134                              union perf_event *event,
 135                              struct perf_sample *sample);
 136 int machine__process_event(struct machine *machine, union perf_event *event,
 137                                 struct perf_sample *sample);
 138
 139 typedef void (*machine__process_t)(struct machine *machine, void *data);
 140
 141 struct machines {
 142         struct machine host;
 143         struct rb_root_cached guests;
 144 };
 145
 146 void machines__init(struct machines *machines);
 147 void machines__exit(struct machines *machines);
 148
 149 void machines__process_guests(struct machines *machines,
 150                               machine__process_t process, void *data);
 151
 152 struct machine *machines__add(struct machines *machines, pid_t pid,
 153                               const char *root_dir);
 154 struct machine *machines__find_host(struct machines *machines);
 155 struct machine *machines__find(struct machines *machines, pid_t pid);
 156 struct machine *machines__findnew(struct machines *machines, pid_t pid);
 157
 158 void machines__set_id_hdr_size(struct machines *machines, u16 id_hdr_size);
 159 void machines__set_comm_exec(struct machines *machines, bool comm_exec);
 160
 161 struct machine *machine__new_host(void);
 162 struct machine *machine__new_kallsyms(void);
 163 int machine__init(struct machine *machine, const char *root_dir, pid_t pid);
 164 void machine__exit(struct machine *machine);
 165 void machine__delete_threads(struct machine *machine);
 166 void machine__delete(struct machine *machine);
 167 void machine__remove_thread(struct machine *machine, struct thread *th);
 168
 169 struct branch_info *sample__resolve_bstack(struct perf_sample *sample,
 170                                            struct addr_location *al);
 171 struct mem_info *sample__resolve_mem(struct perf_sample *sample,
 172                                      struct addr_location *al);
 173
 174 struct callchain_cursor;
 175
 176 int thread__resolve_callchain(struct thread *thread,
 177                               struct callchain_cursor *cursor,
 178                               struct perf_evsel *evsel,
 179                               struct perf_sample *sample,
 180                               struct symbol **parent,
 181                               struct addr_location *root_al,
 182                               int max_stack);
 183
 184 /*
 185  * Default guest kernel is defined by parameter --guestkallsyms
 186  * and --guestmodules
 187  */
 188 static inline bool machine__is_default_guest(struct machine *machine)
 189 {
 190         return machine ? machine->pid == DEFAULT_GUEST_KERNEL_ID : false;
 191 }
 192
 193 static inline bool machine__is_host(struct machine *machine)
 194 {
 195         return machine ? machine->pid == HOST_KERNEL_ID : false;
 196 }
 197
 198 bool machine__is(struct machine *machine, const char *arch);
 199 int machine__nr_cpus_avail(struct machine *machine);
 200
 201 struct thread *__machine__findnew_thread(struct machine *machine, pid_t pid, pid_t tid);
 202 struct thread *machine__findnew_thread(struct machine *machine, pid_t pid, pid_t tid);
 203
 204 struct dso *machine__findnew_dso(struct machine *machine, const char *filename);
 205
 206 size_t machine__fprintf(struct machine *machine, FILE *fp);
 207
 208 static inline
 209 struct symbol *machine__find_kernel_symbol(struct machine *machine, u64 addr,
 210                                            struct map **mapp)
 211 {
 212         return map_groups__find_symbol(&machine->kmaps, addr, mapp);
 213 }
 214
 215 static inline
 216 struct symbol *machine__find_kernel_symbol_by_name(struct machine *machine,
 217                                                    const char *name,
 218                                                    struct map **mapp)
 219 {
 220         return map_groups__find_symbol_by_name(&machine->kmaps, name, mapp);
 221 }
 222
 223 struct map *machine__findnew_module_map(struct machine *machine, u64 start,
 224                                         const char *filename);
 225 int arch__fix_module_text_start(u64 *start, const char *name);
 226
 227 int machine__load_kallsyms(struct machine *machine, const char *filename);
 228
 229 int machine__load_vmlinux_path(struct machine *machine);
 230
 231 size_t machine__fprintf_dsos_buildid(struct machine *machine, FILE *fp,
 232                                      bool (skip)(struct dso *dso, int parm), int parm);
 233 size_t machines__fprintf_dsos(struct machines *machines, FILE *fp);
 234 size_t machines__fprintf_dsos_buildid(struct machines *machines, FILE *fp,
 235                                      bool (skip)(struct dso *dso, int parm), int parm);
 236
 237 void machine__destroy_kernel_maps(struct machine *machine);
 238 int machine__create_kernel_maps(struct machine *machine);
 239
 240 int machines__create_kernel_maps(struct machines *machines, pid_t pid);
 241 int machines__create_guest_kernel_maps(struct machines *machines);
 242 void machines__destroy_kernel_maps(struct machines *machines);
 243
 244 size_t machine__fprintf_vmlinux_path(struct machine *machine, FILE *fp);
 245
 246 int machine__for_each_thread(struct machine *machine,
 247                              int (*fn)(struct thread *thread, void *p),
 248                              void *priv);
 249 int machines__for_each_thread(struct machines *machines,
 250                               int (*fn)(struct thread *thread, void *p),
 251                               void *priv);
 252
 253 int __machine__synthesize_threads(struct machine *machine, struct perf_tool *tool,
 254                                   struct target *target, struct thread_map *threads,
 255                                   perf_event__handler_t process, bool data_mmap,
 256                                   unsigned int nr_threads_synthesize);
 257 static inline
 258 int machine__synthesize_threads(struct machine *machine, struct target *target,
 259                                 struct thread_map *threads, bool data_mmap,
 260                                 unsigned int nr_threads_synthesize)
 261 {
 262         return __machine__synthesize_threads(machine, NULL, target, threads,
 263                                              perf_event__process, data_mmap,
 264                                              nr_threads_synthesize);
 265 }
 266
 267 pid_t machine__get_current_tid(struct machine *machine, int cpu);
 268 int machine__set_current_tid(struct machine *machine, int cpu, pid_t pid,
 269                              pid_t tid);
 270 /*
 271  * For use with libtraceevent's tep_set_function_resolver()
 272  */
 273 char *machine__resolve_kernel_addr(void *vmachine, unsigned long long *addrp, char **modp);
 274
 275 void machine__get_kallsyms_filename(struct machine *machine, char *buf,
 276                                     size_t bufsz);
 277
 278 int machine__create_extra_kernel_maps(struct machine *machine,
 279                                       struct dso *kernel);
 280
 281 /* Kernel-space maps for symbols that are outside the main kernel map and module maps */
 282 struct extra_kernel_map {
 283         u64 start;
 284         u64 end;
 285         u64 pgoff;
 286         char name[KMAP_NAME_LEN];
 287 };
 288
 289 int machine__create_extra_kernel_map(struct machine *machine,
 290                                      struct dso *kernel,
 291                                      struct extra_kernel_map *xm);
 292
 293 int machine__map_x86_64_entry_trampolines(struct machine *machine,
 294                                           struct dso *kernel);
 295
 296 #endif /* __PERF_MACHINE_H */