1 #ifndef _PERF_BRANCH_H
2 #define _PERF_BRANCH_H 1
3 /*
4  * The linux/stddef.h isn't need here, but is needed for __always_inline used
5  * in files included from uapi/linux/perf_event.h such as
6  * /usr/include/linux/swab.h and /usr/include/linux/byteorder/little_endian.h,
7  * detected in at least musl libc, used in Alpine Linux. -acme
8  */
9 #include <stdio.h>
10 #include <stdint.h>
11 #include <linux/compiler.h>
12 #include <linux/stddef.h>
13 #include <linux/perf_event.h>
14 #include <linux/types.h>
15 #include "event.h"
16 
17 struct branch_flags {
18 	union {
19 		u64 value;
20 		struct {
21 			u64 mispred:1;
22 			u64 predicted:1;
23 			u64 in_tx:1;
24 			u64 abort:1;
25 			u64 cycles:16;
26 			u64 type:4;
27 			u64 spec:2;
28 			u64 new_type:4;
29 			u64 priv:3;
30 			u64 reserved:31;
31 		};
32 	};
33 };
34 
35 struct branch_info {
36 	struct addr_map_symbol from;
37 	struct addr_map_symbol to;
38 	struct branch_flags    flags;
39 	char		       *srcline_from;
40 	char		       *srcline_to;
41 };
42 
43 struct branch_entry {
44 	u64			from;
45 	u64			to;
46 	struct branch_flags	flags;
47 };
48 
49 struct branch_stack {
50 	u64			nr;
51 	u64			hw_idx;
52 	struct branch_entry	entries[];
53 };
54 
55 /*
56  * The hw_idx is only available when PERF_SAMPLE_BRANCH_HW_INDEX is applied.
57  * Otherwise, the output format of a sample with branch stack is
58  * struct branch_stack {
59  *	u64			nr;
60  *	struct branch_entry	entries[0];
61  * }
62  * Check whether the hw_idx is available,
63  * and return the corresponding pointer of entries[0].
64  */
perf_sample__branch_entries(struct perf_sample * sample)65 static inline struct branch_entry *perf_sample__branch_entries(struct perf_sample *sample)
66 {
67 	u64 *entry = (u64 *)sample->branch_stack;
68 
69 	entry++;
70 	if (sample->no_hw_idx)
71 		return (struct branch_entry *)entry;
72 	return (struct branch_entry *)(++entry);
73 }
74 
75 struct branch_type_stat {
76 	bool	branch_to;
77 	u64	counts[PERF_BR_MAX];
78 	u64	new_counts[PERF_BR_NEW_MAX];
79 	u64	cond_fwd;
80 	u64	cond_bwd;
81 	u64	cross_4k;
82 	u64	cross_2m;
83 };
84 
85 void branch_type_count(struct branch_type_stat *st, struct branch_flags *flags,
86 		       u64 from, u64 to);
87 
88 const char *branch_type_name(int type);
89 const char *branch_new_type_name(int new_type);
90 const char *get_branch_type(struct branch_entry *e);
91 void branch_type_stat_display(FILE *fp, struct branch_type_stat *st);
92 int branch_type_str(struct branch_type_stat *st, char *bf, int bfsize);
93 
94 #endif /* _PERF_BRANCH_H */
95