1 #ifndef __PERF_HIST_H
2 #define __PERF_HIST_H
3
4 #include <linux/types.h>
5 #include "callchain.h"
6
7 extern struct callchain_param callchain_param;
8
9 struct hist_entry;
10 struct addr_location;
11 struct symbol;
12
13 /*
14 * The kernel collects the number of events it couldn't send in a stretch and
15 * when possible sends this number in a PERF_RECORD_LOST event. The number of
16 * such "chunks" of lost events is stored in .nr_events[PERF_EVENT_LOST] while
17 * total_lost tells exactly how many events the kernel in fact lost, i.e. it is
18 * the sum of all struct lost_event.lost fields reported.
19 *
20 * The total_period is needed because by default auto-freq is used, so
21 * multipling nr_events[PERF_EVENT_SAMPLE] by a frequency isn't possible to get
22 * the total number of low level events, it is necessary to to sum all struct
23 * sample_event.period and stash the result in total_period.
24 */
25 struct events_stats {
26 u64 total_period;
27 u64 total_lost;
28 u64 total_invalid_chains;
29 u32 nr_events[PERF_RECORD_HEADER_MAX];
30 u32 nr_unknown_events;
31 u32 nr_invalid_chains;
32 u32 nr_unknown_id;
33 };
34
35 enum hist_column {
36 HISTC_SYMBOL,
37 HISTC_DSO,
38 HISTC_THREAD,
39 HISTC_COMM,
40 HISTC_PARENT,
41 HISTC_CPU,
42 HISTC_NR_COLS, /* Last entry */
43 };
44
45 struct hists {
46 struct rb_root entries;
47 u64 nr_entries;
48 struct events_stats stats;
49 u64 event_stream;
50 u16 col_len[HISTC_NR_COLS];
51 /* Best would be to reuse the session callchain cursor */
52 struct callchain_cursor callchain_cursor;
53 };
54
55 struct hist_entry *__hists__add_entry(struct hists *self,
56 struct addr_location *al,
57 struct symbol *parent, u64 period);
58 extern int64_t hist_entry__cmp(struct hist_entry *, struct hist_entry *);
59 extern int64_t hist_entry__collapse(struct hist_entry *, struct hist_entry *);
60 int hist_entry__fprintf(struct hist_entry *self, struct hists *hists,
61 struct hists *pair_hists, bool show_displacement,
62 long displacement, FILE *fp, u64 total);
63 int hist_entry__snprintf(struct hist_entry *self, char *bf, size_t size,
64 struct hists *hists, struct hists *pair_hists,
65 bool show_displacement, long displacement,
66 bool color, u64 total);
67 void hist_entry__free(struct hist_entry *);
68
69 void hists__output_resort(struct hists *self);
70 void hists__collapse_resort(struct hists *self);
71
72 void hists__inc_nr_events(struct hists *self, u32 type);
73 size_t hists__fprintf_nr_events(struct hists *self, FILE *fp);
74
75 size_t hists__fprintf(struct hists *self, struct hists *pair,
76 bool show_displacement, FILE *fp);
77
78 int hist_entry__inc_addr_samples(struct hist_entry *self, int evidx, u64 addr);
79 int hist_entry__annotate(struct hist_entry *self, size_t privsize);
80
81 void hists__filter_by_dso(struct hists *self, const struct dso *dso);
82 void hists__filter_by_thread(struct hists *self, const struct thread *thread);
83
84 u16 hists__col_len(struct hists *self, enum hist_column col);
85 void hists__set_col_len(struct hists *self, enum hist_column col, u16 len);
86 bool hists__new_col_len(struct hists *self, enum hist_column col, u16 len);
87
88 struct perf_evlist;
89
90 #ifdef NO_NEWT_SUPPORT
91 static inline
perf_evlist__tui_browse_hists(struct perf_evlist * evlist __used,const char * help __used)92 int perf_evlist__tui_browse_hists(struct perf_evlist *evlist __used,
93 const char *help __used)
94 {
95 return 0;
96 }
97
hist_entry__tui_annotate(struct hist_entry * self __used,int evidx __used)98 static inline int hist_entry__tui_annotate(struct hist_entry *self __used,
99 int evidx __used)
100 {
101 return 0;
102 }
103 #define KEY_LEFT -1
104 #define KEY_RIGHT -2
105 #else
106 #include <newt.h>
107 int hist_entry__tui_annotate(struct hist_entry *self, int evidx);
108
109 #define KEY_LEFT NEWT_KEY_LEFT
110 #define KEY_RIGHT NEWT_KEY_RIGHT
111
112 int perf_evlist__tui_browse_hists(struct perf_evlist *evlist, const char *help);
113 #endif
114
115 unsigned int hists__sort_list_width(struct hists *self);
116
117 #endif /* __PERF_HIST_H */
118