xref: /linux/tools/perf/util/ordered-events.h (revision 6d99a79cb40da3eddafef844b7a679fe5162f224)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __ORDERED_EVENTS_H
3 #define __ORDERED_EVENTS_H
4 
5 #include <linux/types.h>
6 
7 struct perf_sample;
8 
9 struct ordered_event {
10 	u64			timestamp;
11 	u64			file_offset;
12 	union perf_event	*event;
13 	struct list_head	list;
14 };
15 
16 enum oe_flush {
17 	OE_FLUSH__NONE,
18 	OE_FLUSH__FINAL,
19 	OE_FLUSH__ROUND,
20 	OE_FLUSH__HALF,
21 	OE_FLUSH__TOP,
22 };
23 
24 struct ordered_events;
25 
26 typedef int (*ordered_events__deliver_t)(struct ordered_events *oe,
27 					 struct ordered_event *event);
28 
29 struct ordered_events_buffer {
30 	struct list_head	list;
31 	struct ordered_event	event[0];
32 };
33 
34 struct ordered_events {
35 	u64				 last_flush;
36 	u64				 next_flush;
37 	u64				 max_timestamp;
38 	u64				 max_alloc_size;
39 	u64				 cur_alloc_size;
40 	struct list_head		 events;
41 	struct list_head		 cache;
42 	struct list_head		 to_free;
43 	struct ordered_events_buffer	*buffer;
44 	struct ordered_event		*last;
45 	ordered_events__deliver_t	 deliver;
46 	int				 buffer_idx;
47 	unsigned int			 nr_events;
48 	enum oe_flush			 last_flush_type;
49 	u32				 nr_unordered_events;
50 	bool				 copy_on_queue;
51 	void				*data;
52 };
53 
54 int ordered_events__queue(struct ordered_events *oe, union perf_event *event,
55 			  u64 timestamp, u64 file_offset);
56 void ordered_events__delete(struct ordered_events *oe, struct ordered_event *event);
57 int ordered_events__flush(struct ordered_events *oe, enum oe_flush how);
58 void ordered_events__init(struct ordered_events *oe, ordered_events__deliver_t deliver,
59 			  void *data);
60 void ordered_events__free(struct ordered_events *oe);
61 void ordered_events__reinit(struct ordered_events *oe);
62 
63 static inline
64 void ordered_events__set_alloc_size(struct ordered_events *oe, u64 size)
65 {
66 	oe->max_alloc_size = size;
67 }
68 
69 static inline
70 void ordered_events__set_copy_on_queue(struct ordered_events *oe, bool copy)
71 {
72 	oe->copy_on_queue = copy;
73 }
74 #endif /* __ORDERED_EVENTS_H */
75