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