Linux Audio

Check our new training course

Loading...
v5.4
  1/* SPDX-License-Identifier: GPL-2.0 */
  2#ifndef __PERF_SORT_H
  3#define __PERF_SORT_H
  4#include <regex.h>
  5#include <stdbool.h>
  6#include <linux/list.h>
  7#include <linux/rbtree.h>
  8#include "map_symbol.h"
  9#include "symbol_conf.h"
 10#include "callchain.h"
 11#include "values.h"
 12#include "hist.h"
 
 
 13
 14struct option;
 15struct thread;
 16
 17extern regex_t parent_regex;
 18extern const char *sort_order;
 19extern const char *field_order;
 20extern const char default_parent_pattern[];
 21extern const char *parent_pattern;
 22extern const char *default_sort_order;
 23extern regex_t ignore_callees_regex;
 24extern int have_ignore_callees;
 25extern enum sort_mode sort__mode;
 26extern struct sort_entry sort_comm;
 27extern struct sort_entry sort_dso;
 28extern struct sort_entry sort_sym;
 29extern struct sort_entry sort_parent;
 30extern struct sort_entry sort_dso_from;
 31extern struct sort_entry sort_dso_to;
 32extern struct sort_entry sort_sym_from;
 33extern struct sort_entry sort_sym_to;
 34extern struct sort_entry sort_srcline;
 35extern enum sort_type sort__first_dimension;
 36extern const char default_mem_sort_order[];
 37
 38struct res_sample {
 39	u64 time;
 40	int cpu;
 41	int tid;
 42};
 43
 44struct he_stat {
 45	u64			period;
 46	u64			period_sys;
 47	u64			period_us;
 48	u64			period_guest_sys;
 49	u64			period_guest_us;
 50	u64			weight;
 51	u32			nr_events;
 52};
 53
 54struct namespace_id {
 55	u64			dev;
 56	u64			ino;
 57};
 58
 59struct hist_entry_diff {
 60	bool	computed;
 61	union {
 62		/* PERF_HPP__DELTA */
 63		double	period_ratio_delta;
 64
 65		/* PERF_HPP__RATIO */
 66		double	period_ratio;
 67
 68		/* HISTC_WEIGHTED_DIFF */
 69		s64	wdiff;
 70
 71		/* PERF_HPP_DIFF__CYCLES */
 72		s64	cycles;
 73	};
 
 
 74};
 75
 76struct hist_entry_ops {
 77	void	*(*new)(size_t size);
 78	void	(*free)(void *ptr);
 79};
 80
 81/**
 82 * struct hist_entry - histogram entry
 83 *
 84 * @row_offset - offset from the first callchain expanded to appear on screen
 85 * @nr_rows - rows expanded in callchain, recalculated on folding/unfolding
 86 */
 87struct hist_entry {
 88	struct rb_node		rb_node_in;
 89	struct rb_node		rb_node;
 90	union {
 91		struct list_head node;
 92		struct list_head head;
 93	} pairs;
 94	struct he_stat		stat;
 95	struct he_stat		*stat_acc;
 96	struct map_symbol	ms;
 97	struct thread		*thread;
 98	struct comm		*comm;
 99	struct namespace_id	cgroup_id;
 
100	u64			ip;
101	u64			transaction;
102	s32			socket;
103	s32			cpu;
 
 
 
 
104	u8			cpumode;
105	u8			depth;
106
107	/* We are added by hists__add_dummy_entry. */
108	bool			dummy;
109	bool			leaf;
110
111	char			level;
112	u8			filtered;
113
114	u16			callchain_size;
115	union {
116		/*
117		 * Since perf diff only supports the stdio output, TUI
118		 * fields are only accessed from perf report (or perf
119		 * top).  So make it a union to reduce memory usage.
120		 */
121		struct hist_entry_diff	diff;
122		struct /* for TUI */ {
123			u16	row_offset;
124			u16	nr_rows;
125			bool	init_have_children;
126			bool	unfolded;
127			bool	has_children;
128			bool	has_no_entry;
129		};
130	};
131	char			*srcline;
132	char			*srcfile;
133	struct symbol		*parent;
134	struct branch_info	*branch_info;
135	long			time;
136	struct hists		*hists;
137	struct mem_info		*mem_info;
138	struct block_info	*block_info;
139	void			*raw_data;
140	u32			raw_size;
141	int			num_res;
142	struct res_sample	*res_samples;
143	void			*trace_output;
144	struct perf_hpp_list	*hpp_list;
145	struct hist_entry	*parent_he;
146	struct hist_entry_ops	*ops;
147	union {
148		/* this is for hierarchical entry structure */
149		struct {
150			struct rb_root_cached	hroot_in;
151			struct rb_root_cached   hroot_out;
152		};				/* non-leaf entries */
153		struct rb_root	sorted_chain;	/* leaf entry has callchains */
154	};
155	struct callchain_root	callchain[0]; /* must be last member */
156};
157
158static __pure inline bool hist_entry__has_callchains(struct hist_entry *he)
159{
160	return he->callchain_size != 0;
161}
162
 
 
163static inline bool hist_entry__has_pairs(struct hist_entry *he)
164{
165	return !list_empty(&he->pairs.node);
166}
167
168static inline struct hist_entry *hist_entry__next_pair(struct hist_entry *he)
169{
170	if (hist_entry__has_pairs(he))
171		return list_entry(he->pairs.node.next, struct hist_entry, pairs.node);
172	return NULL;
173}
174
175static inline void hist_entry__add_pair(struct hist_entry *pair,
176					struct hist_entry *he)
177{
178	list_add_tail(&pair->pairs.node, &he->pairs.head);
179}
180
181static inline float hist_entry__get_percent_limit(struct hist_entry *he)
182{
183	u64 period = he->stat.period;
184	u64 total_period = hists__total_period(he->hists);
185
186	if (unlikely(total_period == 0))
187		return 0;
188
189	if (symbol_conf.cumulate_callchain)
190		period = he->stat_acc->period;
191
192	return period * 100.0 / total_period;
193}
194
195enum sort_mode {
196	SORT_MODE__NORMAL,
197	SORT_MODE__BRANCH,
198	SORT_MODE__MEMORY,
199	SORT_MODE__TOP,
200	SORT_MODE__DIFF,
201	SORT_MODE__TRACEPOINT,
202};
203
204enum sort_type {
205	/* common sort keys */
206	SORT_PID,
207	SORT_COMM,
208	SORT_DSO,
209	SORT_SYM,
210	SORT_PARENT,
211	SORT_CPU,
212	SORT_SOCKET,
213	SORT_SRCLINE,
214	SORT_SRCFILE,
215	SORT_LOCAL_WEIGHT,
216	SORT_GLOBAL_WEIGHT,
217	SORT_TRANSACTION,
218	SORT_TRACE,
219	SORT_SYM_SIZE,
220	SORT_DSO_SIZE,
 
221	SORT_CGROUP_ID,
222	SORT_SYM_IPC_NULL,
223	SORT_TIME,
 
 
 
 
 
 
224
225	/* branch stack specific sort keys */
226	__SORT_BRANCH_STACK,
227	SORT_DSO_FROM = __SORT_BRANCH_STACK,
228	SORT_DSO_TO,
229	SORT_SYM_FROM,
230	SORT_SYM_TO,
231	SORT_MISPREDICT,
232	SORT_ABORT,
233	SORT_IN_TX,
234	SORT_CYCLES,
235	SORT_SRCLINE_FROM,
236	SORT_SRCLINE_TO,
237	SORT_SYM_IPC,
 
 
238
239	/* memory mode specific sort keys */
240	__SORT_MEMORY_MODE,
241	SORT_MEM_DADDR_SYMBOL = __SORT_MEMORY_MODE,
242	SORT_MEM_DADDR_DSO,
243	SORT_MEM_LOCKED,
244	SORT_MEM_TLB,
245	SORT_MEM_LVL,
246	SORT_MEM_SNOOP,
247	SORT_MEM_DCACHELINE,
248	SORT_MEM_IADDR_SYMBOL,
249	SORT_MEM_PHYS_DADDR,
 
 
250};
251
252/*
253 * configurable sorting bits
254 */
255
256struct sort_entry {
257	const char *se_header;
258
259	int64_t (*se_cmp)(struct hist_entry *, struct hist_entry *);
260	int64_t (*se_collapse)(struct hist_entry *, struct hist_entry *);
261	int64_t	(*se_sort)(struct hist_entry *, struct hist_entry *);
262	int	(*se_snprintf)(struct hist_entry *he, char *bf, size_t size,
263			       unsigned int width);
264	int	(*se_filter)(struct hist_entry *he, int type, const void *arg);
 
265	u8	se_width_idx;
266};
267
268struct block_hist {
269	struct hists		block_hists;
270	struct perf_hpp_list	block_list;
271	struct perf_hpp_fmt	block_fmt;
272	int			block_idx;
273	bool			valid;
274	struct hist_entry	he;
275};
276
277extern struct sort_entry sort_thread;
278extern struct list_head hist_entry__sort_list;
279
280struct evlist;
281struct tep_handle;
282int setup_sorting(struct evlist *evlist);
283int setup_output_field(void);
284void reset_output_field(void);
285void sort__setup_elide(FILE *fp);
286void perf_hpp__set_elide(int idx, bool elide);
287
288const char *sort_help(const char *prefix);
289
290int report_parse_ignore_callees_opt(const struct option *opt, const char *arg, int unset);
291
292bool is_strict_order(const char *order);
293
294int hpp_dimension__add_output(unsigned col);
295void reset_dimensions(void);
296int sort_dimension__add(struct perf_hpp_list *list, const char *tok,
297			struct evlist *evlist,
298			int level);
299int output_field_add(struct perf_hpp_list *list, char *tok);
300int64_t
301sort__iaddr_cmp(struct hist_entry *left, struct hist_entry *right);
302int64_t
303sort__daddr_cmp(struct hist_entry *left, struct hist_entry *right);
304int64_t
305sort__dcacheline_cmp(struct hist_entry *left, struct hist_entry *right);
 
 
306char *hist_entry__srcline(struct hist_entry *he);
307#endif	/* __PERF_SORT_H */
v6.2
  1/* SPDX-License-Identifier: GPL-2.0 */
  2#ifndef __PERF_SORT_H
  3#define __PERF_SORT_H
  4#include <regex.h>
  5#include <stdbool.h>
  6#include <linux/list.h>
  7#include <linux/rbtree.h>
  8#include "map_symbol.h"
  9#include "symbol_conf.h"
 10#include "callchain.h"
 11#include "values.h"
 12#include "hist.h"
 13#include "stat.h"
 14#include "spark.h"
 15
 16struct option;
 17struct thread;
 18
 19extern regex_t parent_regex;
 20extern const char *sort_order;
 21extern const char *field_order;
 22extern const char default_parent_pattern[];
 23extern const char *parent_pattern;
 24extern const char *default_sort_order;
 25extern regex_t ignore_callees_regex;
 26extern int have_ignore_callees;
 27extern enum sort_mode sort__mode;
 28extern struct sort_entry sort_comm;
 29extern struct sort_entry sort_dso;
 30extern struct sort_entry sort_sym;
 31extern struct sort_entry sort_parent;
 32extern struct sort_entry sort_dso_from;
 33extern struct sort_entry sort_dso_to;
 34extern struct sort_entry sort_sym_from;
 35extern struct sort_entry sort_sym_to;
 36extern struct sort_entry sort_srcline;
 
 37extern const char default_mem_sort_order[];
 38
 39struct res_sample {
 40	u64 time;
 41	int cpu;
 42	int tid;
 43};
 44
 45struct he_stat {
 46	u64			period;
 47	u64			period_sys;
 48	u64			period_us;
 49	u64			period_guest_sys;
 50	u64			period_guest_us;
 
 51	u32			nr_events;
 52};
 53
 54struct namespace_id {
 55	u64			dev;
 56	u64			ino;
 57};
 58
 59struct hist_entry_diff {
 60	bool	computed;
 61	union {
 62		/* PERF_HPP__DELTA */
 63		double	period_ratio_delta;
 64
 65		/* PERF_HPP__RATIO */
 66		double	period_ratio;
 67
 68		/* HISTC_WEIGHTED_DIFF */
 69		s64	wdiff;
 70
 71		/* PERF_HPP_DIFF__CYCLES */
 72		s64	cycles;
 73	};
 74	struct stats	stats;
 75	unsigned long	svals[NUM_SPARKS];
 76};
 77
 78struct hist_entry_ops {
 79	void	*(*new)(size_t size);
 80	void	(*free)(void *ptr);
 81};
 82
 83/**
 84 * struct hist_entry - histogram entry
 85 *
 86 * @row_offset - offset from the first callchain expanded to appear on screen
 87 * @nr_rows - rows expanded in callchain, recalculated on folding/unfolding
 88 */
 89struct hist_entry {
 90	struct rb_node		rb_node_in;
 91	struct rb_node		rb_node;
 92	union {
 93		struct list_head node;
 94		struct list_head head;
 95	} pairs;
 96	struct he_stat		stat;
 97	struct he_stat		*stat_acc;
 98	struct map_symbol	ms;
 99	struct thread		*thread;
100	struct comm		*comm;
101	struct namespace_id	cgroup_id;
102	u64			cgroup;
103	u64			ip;
104	u64			transaction;
105	s32			socket;
106	s32			cpu;
107	u64			code_page_size;
108	u64			weight;
109	u64			ins_lat;
110	u64			p_stage_cyc;
111	u8			cpumode;
112	u8			depth;
113
114	/* We are added by hists__add_dummy_entry. */
115	bool			dummy;
116	bool			leaf;
117
118	char			level;
119	u8			filtered;
120
121	u16			callchain_size;
122	union {
123		/*
124		 * Since perf diff only supports the stdio output, TUI
125		 * fields are only accessed from perf report (or perf
126		 * top).  So make it a union to reduce memory usage.
127		 */
128		struct hist_entry_diff	diff;
129		struct /* for TUI */ {
130			u16	row_offset;
131			u16	nr_rows;
132			bool	init_have_children;
133			bool	unfolded;
134			bool	has_children;
135			bool	has_no_entry;
136		};
137	};
138	char			*srcline;
139	char			*srcfile;
140	struct symbol		*parent;
141	struct branch_info	*branch_info;
142	long			time;
143	struct hists		*hists;
144	struct mem_info		*mem_info;
145	struct block_info	*block_info;
146	void			*raw_data;
147	u32			raw_size;
148	int			num_res;
149	struct res_sample	*res_samples;
150	void			*trace_output;
151	struct perf_hpp_list	*hpp_list;
152	struct hist_entry	*parent_he;
153	struct hist_entry_ops	*ops;
154	union {
155		/* this is for hierarchical entry structure */
156		struct {
157			struct rb_root_cached	hroot_in;
158			struct rb_root_cached   hroot_out;
159		};				/* non-leaf entries */
160		struct rb_root	sorted_chain;	/* leaf entry has callchains */
161	};
162	struct callchain_root	callchain[0]; /* must be last member */
163};
164
165static __pure inline bool hist_entry__has_callchains(struct hist_entry *he)
166{
167	return he->callchain_size != 0;
168}
169
170int hist_entry__sym_snprintf(struct hist_entry *he, char *bf, size_t size, unsigned int width);
171
172static inline bool hist_entry__has_pairs(struct hist_entry *he)
173{
174	return !list_empty(&he->pairs.node);
175}
176
177static inline struct hist_entry *hist_entry__next_pair(struct hist_entry *he)
178{
179	if (hist_entry__has_pairs(he))
180		return list_entry(he->pairs.node.next, struct hist_entry, pairs.node);
181	return NULL;
182}
183
184static inline void hist_entry__add_pair(struct hist_entry *pair,
185					struct hist_entry *he)
186{
187	list_add_tail(&pair->pairs.node, &he->pairs.head);
188}
189
190static inline float hist_entry__get_percent_limit(struct hist_entry *he)
191{
192	u64 period = he->stat.period;
193	u64 total_period = hists__total_period(he->hists);
194
195	if (unlikely(total_period == 0))
196		return 0;
197
198	if (symbol_conf.cumulate_callchain)
199		period = he->stat_acc->period;
200
201	return period * 100.0 / total_period;
202}
203
204enum sort_mode {
205	SORT_MODE__NORMAL,
206	SORT_MODE__BRANCH,
207	SORT_MODE__MEMORY,
208	SORT_MODE__TOP,
209	SORT_MODE__DIFF,
210	SORT_MODE__TRACEPOINT,
211};
212
213enum sort_type {
214	/* common sort keys */
215	SORT_PID,
216	SORT_COMM,
217	SORT_DSO,
218	SORT_SYM,
219	SORT_PARENT,
220	SORT_CPU,
221	SORT_SOCKET,
222	SORT_SRCLINE,
223	SORT_SRCFILE,
224	SORT_LOCAL_WEIGHT,
225	SORT_GLOBAL_WEIGHT,
226	SORT_TRANSACTION,
227	SORT_TRACE,
228	SORT_SYM_SIZE,
229	SORT_DSO_SIZE,
230	SORT_CGROUP,
231	SORT_CGROUP_ID,
232	SORT_SYM_IPC_NULL,
233	SORT_TIME,
234	SORT_CODE_PAGE_SIZE,
235	SORT_LOCAL_INS_LAT,
236	SORT_GLOBAL_INS_LAT,
237	SORT_LOCAL_PIPELINE_STAGE_CYC,
238	SORT_GLOBAL_PIPELINE_STAGE_CYC,
239	SORT_ADDR,
240
241	/* branch stack specific sort keys */
242	__SORT_BRANCH_STACK,
243	SORT_DSO_FROM = __SORT_BRANCH_STACK,
244	SORT_DSO_TO,
245	SORT_SYM_FROM,
246	SORT_SYM_TO,
247	SORT_MISPREDICT,
248	SORT_ABORT,
249	SORT_IN_TX,
250	SORT_CYCLES,
251	SORT_SRCLINE_FROM,
252	SORT_SRCLINE_TO,
253	SORT_SYM_IPC,
254	SORT_ADDR_FROM,
255	SORT_ADDR_TO,
256
257	/* memory mode specific sort keys */
258	__SORT_MEMORY_MODE,
259	SORT_MEM_DADDR_SYMBOL = __SORT_MEMORY_MODE,
260	SORT_MEM_DADDR_DSO,
261	SORT_MEM_LOCKED,
262	SORT_MEM_TLB,
263	SORT_MEM_LVL,
264	SORT_MEM_SNOOP,
265	SORT_MEM_DCACHELINE,
266	SORT_MEM_IADDR_SYMBOL,
267	SORT_MEM_PHYS_DADDR,
268	SORT_MEM_DATA_PAGE_SIZE,
269	SORT_MEM_BLOCKED,
270};
271
272/*
273 * configurable sorting bits
274 */
275
276struct sort_entry {
277	const char *se_header;
278
279	int64_t (*se_cmp)(struct hist_entry *, struct hist_entry *);
280	int64_t (*se_collapse)(struct hist_entry *, struct hist_entry *);
281	int64_t	(*se_sort)(struct hist_entry *, struct hist_entry *);
282	int	(*se_snprintf)(struct hist_entry *he, char *bf, size_t size,
283			       unsigned int width);
284	int	(*se_filter)(struct hist_entry *he, int type, const void *arg);
285	void	(*se_init)(struct hist_entry *he);
286	u8	se_width_idx;
287};
288
289struct block_hist {
290	struct hists		block_hists;
291	struct perf_hpp_list	block_list;
292	struct perf_hpp_fmt	block_fmt;
293	int			block_idx;
294	bool			valid;
295	struct hist_entry	he;
296};
297
298extern struct sort_entry sort_thread;
 
299
300struct evlist;
301struct tep_handle;
302int setup_sorting(struct evlist *evlist);
303int setup_output_field(void);
304void reset_output_field(void);
305void sort__setup_elide(FILE *fp);
306void perf_hpp__set_elide(int idx, bool elide);
307
308char *sort_help(const char *prefix);
309
310int report_parse_ignore_callees_opt(const struct option *opt, const char *arg, int unset);
311
312bool is_strict_order(const char *order);
313
314int hpp_dimension__add_output(unsigned col);
315void reset_dimensions(void);
316int sort_dimension__add(struct perf_hpp_list *list, const char *tok,
317			struct evlist *evlist,
318			int level);
319int output_field_add(struct perf_hpp_list *list, char *tok);
320int64_t
321sort__iaddr_cmp(struct hist_entry *left, struct hist_entry *right);
322int64_t
323sort__daddr_cmp(struct hist_entry *left, struct hist_entry *right);
324int64_t
325sort__dcacheline_cmp(struct hist_entry *left, struct hist_entry *right);
326int64_t
327_sort__sym_cmp(struct symbol *sym_l, struct symbol *sym_r);
328char *hist_entry__srcline(struct hist_entry *he);
329#endif	/* __PERF_SORT_H */