Linux Audio

Check our new training course

Yocto / OpenEmbedded training

Mar 24-27, 2025, special US time zones
Register
Loading...
Note: File does not exist in v3.5.6.
  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;
 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
 26extern const char *ref_reloc_sym_names[];
 27
 28struct vdso_info;
 29
 30#define THREADS__TABLE_BITS	8
 31#define THREADS__TABLE_SIZE	(1 << THREADS__TABLE_BITS)
 32
 33struct 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
 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	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
 65static 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 */
 74static inline
 75struct 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 */
 83static inline
 84struct maps *machine__kernel_maps(struct machine *machine)
 85{
 86	return &machine->kmaps;
 87}
 88
 89int machine__get_kernel_start(struct machine *machine);
 90
 91static 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
 98static 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
105u8 machine__addr_cpumode(struct machine *machine, u8 cpumode, u64 addr);
106
107struct thread *machine__find_thread(struct machine *machine, pid_t pid,
108				    pid_t tid);
109struct thread *machine__idle_thread(struct machine *machine);
110struct comm *machine__thread_exec_comm(struct machine *machine,
111				       struct thread *thread);
112
113int machine__process_comm_event(struct machine *machine, union perf_event *event,
114				struct perf_sample *sample);
115int machine__process_exit_event(struct machine *machine, union perf_event *event,
116				struct perf_sample *sample);
117int machine__process_fork_event(struct machine *machine, union perf_event *event,
118				struct perf_sample *sample);
119int machine__process_lost_event(struct machine *machine, union perf_event *event,
120				struct perf_sample *sample);
121int machine__process_lost_samples_event(struct machine *machine, union perf_event *event,
122					struct perf_sample *sample);
123int machine__process_aux_event(struct machine *machine,
124			       union perf_event *event);
125int machine__process_itrace_start_event(struct machine *machine,
126					union perf_event *event);
127int machine__process_switch_event(struct machine *machine,
128				  union perf_event *event);
129int machine__process_namespaces_event(struct machine *machine,
130				      union perf_event *event,
131				      struct perf_sample *sample);
132int machine__process_cgroup_event(struct machine *machine,
133				  union perf_event *event,
134				  struct perf_sample *sample);
135int machine__process_mmap_event(struct machine *machine, union perf_event *event,
136				struct perf_sample *sample);
137int machine__process_mmap2_event(struct machine *machine, union perf_event *event,
138				 struct perf_sample *sample);
139int machine__process_ksymbol(struct machine *machine,
140			     union perf_event *event,
141			     struct perf_sample *sample);
142int machine__process_text_poke(struct machine *machine,
143			       union perf_event *event,
144			       struct perf_sample *sample);
145int machine__process_event(struct machine *machine, union perf_event *event,
146				struct perf_sample *sample);
147
148typedef void (*machine__process_t)(struct machine *machine, void *data);
149
150struct machines {
151	struct machine host;
152	struct rb_root_cached guests;
153};
154
155void machines__init(struct machines *machines);
156void machines__exit(struct machines *machines);
157
158void machines__process_guests(struct machines *machines,
159			      machine__process_t process, void *data);
160
161struct machine *machines__add(struct machines *machines, pid_t pid,
162			      const char *root_dir);
163struct machine *machines__find_host(struct machines *machines);
164struct machine *machines__find(struct machines *machines, pid_t pid);
165struct machine *machines__findnew(struct machines *machines, pid_t pid);
166struct machine *machines__find_guest(struct machines *machines, pid_t pid);
167
168void machines__set_id_hdr_size(struct machines *machines, u16 id_hdr_size);
169void machines__set_comm_exec(struct machines *machines, bool comm_exec);
170
171struct machine *machine__new_host(void);
172struct machine *machine__new_kallsyms(void);
173int machine__init(struct machine *machine, const char *root_dir, pid_t pid);
174void machine__exit(struct machine *machine);
175void machine__delete_threads(struct machine *machine);
176void machine__delete(struct machine *machine);
177void machine__remove_thread(struct machine *machine, struct thread *th);
178
179struct branch_info *sample__resolve_bstack(struct perf_sample *sample,
180					   struct addr_location *al);
181struct mem_info *sample__resolve_mem(struct perf_sample *sample,
182				     struct addr_location *al);
183
184struct callchain_cursor;
185
186int thread__resolve_callchain(struct thread *thread,
187			      struct callchain_cursor *cursor,
188			      struct evsel *evsel,
189			      struct perf_sample *sample,
190			      struct symbol **parent,
191			      struct addr_location *root_al,
192			      int max_stack);
193
194/*
195 * Default guest kernel is defined by parameter --guestkallsyms
196 * and --guestmodules
197 */
198static inline bool machine__is_default_guest(struct machine *machine)
199{
200	return machine ? machine->pid == DEFAULT_GUEST_KERNEL_ID : false;
201}
202
203static inline bool machine__is_host(struct machine *machine)
204{
205	return machine ? machine->pid == HOST_KERNEL_ID : false;
206}
207
208bool machine__is(struct machine *machine, const char *arch);
209int machine__nr_cpus_avail(struct machine *machine);
210
211struct thread *__machine__findnew_thread(struct machine *machine, pid_t pid, pid_t tid);
212struct thread *machine__findnew_thread(struct machine *machine, pid_t pid, pid_t tid);
213
214struct dso *machine__findnew_dso_id(struct machine *machine, const char *filename, struct dso_id *id);
215struct dso *machine__findnew_dso(struct machine *machine, const char *filename);
216
217size_t machine__fprintf(struct machine *machine, FILE *fp);
218
219static inline
220struct symbol *machine__find_kernel_symbol(struct machine *machine, u64 addr,
221					   struct map **mapp)
222{
223	return maps__find_symbol(&machine->kmaps, addr, mapp);
224}
225
226static inline
227struct symbol *machine__find_kernel_symbol_by_name(struct machine *machine,
228						   const char *name,
229						   struct map **mapp)
230{
231	return maps__find_symbol_by_name(&machine->kmaps, name, mapp);
232}
233
234int arch__fix_module_text_start(u64 *start, u64 *size, const char *name);
235
236int machine__load_kallsyms(struct machine *machine, const char *filename);
237
238int machine__load_vmlinux_path(struct machine *machine);
239
240size_t machine__fprintf_dsos_buildid(struct machine *machine, FILE *fp,
241				     bool (skip)(struct dso *dso, int parm), int parm);
242size_t machines__fprintf_dsos(struct machines *machines, FILE *fp);
243size_t machines__fprintf_dsos_buildid(struct machines *machines, FILE *fp,
244				     bool (skip)(struct dso *dso, int parm), int parm);
245
246void machine__destroy_kernel_maps(struct machine *machine);
247int machine__create_kernel_maps(struct machine *machine);
248
249int machines__create_kernel_maps(struct machines *machines, pid_t pid);
250int machines__create_guest_kernel_maps(struct machines *machines);
251void machines__destroy_kernel_maps(struct machines *machines);
252
253size_t machine__fprintf_vmlinux_path(struct machine *machine, FILE *fp);
254
255typedef int (*machine__dso_t)(struct dso *dso, struct machine *machine, void *priv);
256
257int machine__for_each_dso(struct machine *machine, machine__dso_t fn,
258			  void *priv);
259int machine__for_each_thread(struct machine *machine,
260			     int (*fn)(struct thread *thread, void *p),
261			     void *priv);
262int machines__for_each_thread(struct machines *machines,
263			      int (*fn)(struct thread *thread, void *p),
264			      void *priv);
265
266pid_t machine__get_current_tid(struct machine *machine, int cpu);
267int machine__set_current_tid(struct machine *machine, int cpu, pid_t pid,
268			     pid_t tid);
269/*
270 * For use with libtraceevent's tep_set_function_resolver()
271 */
272char *machine__resolve_kernel_addr(void *vmachine, unsigned long long *addrp, char **modp);
273
274void machine__get_kallsyms_filename(struct machine *machine, char *buf,
275				    size_t bufsz);
276
277int machine__create_extra_kernel_maps(struct machine *machine,
278				      struct dso *kernel);
279
280/* Kernel-space maps for symbols that are outside the main kernel map and module maps */
281struct extra_kernel_map {
282	u64 start;
283	u64 end;
284	u64 pgoff;
285	char name[KMAP_NAME_LEN];
286};
287
288int machine__create_extra_kernel_map(struct machine *machine,
289				     struct dso *kernel,
290				     struct extra_kernel_map *xm);
291
292int machine__map_x86_64_entry_trampolines(struct machine *machine,
293					  struct dso *kernel);
294
295#endif /* __PERF_MACHINE_H */