xref: /linux/tools/lib/perf/include/internal/mmap.h (revision 5e0266f0e5f57617472d5aac4013f58a3ef264ac)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __LIBPERF_INTERNAL_MMAP_H
3 #define __LIBPERF_INTERNAL_MMAP_H
4 
5 #include <linux/compiler.h>
6 #include <linux/refcount.h>
7 #include <linux/types.h>
8 #include <stdbool.h>
9 #include <internal/cpumap.h>
10 
11 /* perf sample has 16 bits size limit */
12 #define PERF_SAMPLE_MAX_SIZE (1 << 16)
13 
14 struct perf_mmap;
15 struct perf_counts_values;
16 
17 typedef void (*libperf_unmap_cb_t)(struct perf_mmap *map);
18 
19 /**
20  * struct perf_mmap - perf's ring buffer mmap details
21  *
22  * @refcnt - e.g. code using PERF_EVENT_IOC_SET_OUTPUT to share this
23  */
24 struct perf_mmap {
25 	void			*base;
26 	int			 mask;
27 	int			 fd;
28 	struct perf_cpu		 cpu;
29 	refcount_t		 refcnt;
30 	u64			 prev;
31 	u64			 start;
32 	u64			 end;
33 	bool			 overwrite;
34 	u64			 flush;
35 	libperf_unmap_cb_t	 unmap_cb;
36 	char			 event_copy[PERF_SAMPLE_MAX_SIZE] __aligned(8);
37 	struct perf_mmap	*next;
38 };
39 
40 struct perf_mmap_param {
41 	int	prot;
42 	int	mask;
43 };
44 
45 size_t perf_mmap__mmap_len(struct perf_mmap *map);
46 
47 void perf_mmap__init(struct perf_mmap *map, struct perf_mmap *prev,
48 		     bool overwrite, libperf_unmap_cb_t unmap_cb);
49 int perf_mmap__mmap(struct perf_mmap *map, struct perf_mmap_param *mp,
50 		    int fd, struct perf_cpu cpu);
51 void perf_mmap__munmap(struct perf_mmap *map);
52 void perf_mmap__get(struct perf_mmap *map);
53 void perf_mmap__put(struct perf_mmap *map);
54 
55 u64 perf_mmap__read_head(struct perf_mmap *map);
56 
57 int perf_mmap__read_self(struct perf_mmap *map, struct perf_counts_values *count);
58 
59 #endif /* __LIBPERF_INTERNAL_MMAP_H */
60