Linux Audio

Check our new training course

Yocto / OpenEmbedded training

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