[GitHub/mt8127/android_kernel_alcatel_ttab.git] / tools / perf / util / annotate.h

#ifndef __PERF_ANNOTATE_H
#define __PERF_ANNOTATE_H

#include <stdbool.h>
#include "types.h"
#include "symbol.h"
#include <linux/list.h>
#include <linux/rbtree.h>

struct objdump_line {
	struct list_head node;
	s64		 offset;
	char		 *line;
};

void objdump_line__free(struct objdump_line *self);
struct objdump_line *objdump__get_next_ip_line(struct list_head *head,
					       struct objdump_line *pos);

struct sym_hist {
	u64		sum;
	u64		addr[0];
};

struct source_line {
	struct rb_node	node;
	double		percent;
	char		*path;
};

/** struct annotation - symbols with hits have this attached as in sannotation
 *
 * @histogram: Array of addr hit histograms per event being monitored
 * @src_line: If 'print_lines' is specified, per source code line percentages
 *
 * src_line is allocated, percentages calculated and all sorted by percentage
 * when the annotation is about to be presented, so the percentages are for
 * one of the entries in the histogram array, i.e. for the event/counter being
 * presented. It is deallocated right after symbol__{tui,tty,etc}_annotate
 * returns.
 */
struct annotation {
	struct source_line *src_line;
	struct sym_hist	   *histograms;
	int    		   nr_histograms;
	int    		   sizeof_sym_hist;
};

struct sannotation {
	struct annotation annotation;
	struct symbol	  symbol;
};

static inline struct sym_hist *annotation__histogram(struct annotation *notes, int idx)
{
	return ((void *)notes->histograms) + (notes->sizeof_sym_hist * idx);
}

static inline struct annotation *symbol__annotation(struct symbol *sym)
{
	struct sannotation *a = container_of(sym, struct sannotation, symbol);
	return &a->annotation;
}

int symbol__inc_addr_samples(struct symbol *sym, struct map *map,
			     int evidx, u64 addr);
int symbol__alloc_hist(struct symbol *sym, int nevents);
void symbol__annotate_zero_histograms(struct symbol *sym);

int symbol__annotate(struct symbol *sym, struct map *map,
		     struct list_head *head, size_t privsize);
int symbol__annotate_printf(struct symbol *sym, struct map *map,
			    struct list_head *head, int evidx, bool full_paths,
			    int min_pcnt, int max_lines);
void symbol__annotate_zero_histogram(struct symbol *sym, int evidx);
void symbol__annotate_decay_histogram(struct symbol *sym,
				      struct list_head *head, int evidx);
void objdump_line_list__purge(struct list_head *head);

int symbol__tty_annotate(struct symbol *sym, struct map *map, int evidx,
			 bool print_lines, bool full_paths, int min_pcnt,
			 int max_lines);

#ifdef NO_NEWT_SUPPORT
static inline int symbol__tui_annotate(symbol *sym __used,
				       struct map *map __used, int evidx __used)
{
	return 0;
}
#else
int symbol__tui_annotate(struct symbol *sym, struct map *map, int evidx);
#endif

#endif	/* __PERF_ANNOTATE_H */
Commit	Line	Data
78f7defe ACM	1	#ifndef __PERF_ANNOTATE_H
	2	#define __PERF_ANNOTATE_H
	3
	4	#include <stdbool.h>
	5	#include "types.h"
	6	#include "symbol.h"
	7	#include <linux/list.h>
	8	#include <linux/rbtree.h>
	9
	10	struct objdump_line {
	11	struct list_head node;
	12	s64 offset;
	13	char *line;
	14	};
	15
	16	void objdump_line__free(struct objdump_line *self);
	17	struct objdump_line objdump__get_next_ip_line(struct list_head head,
	18	struct objdump_line *pos);
	19
	20	struct sym_hist {
	21	u64 sum;
	22	u64 addr[0];
	23	};
	24
	25	struct source_line {
	26	struct rb_node node;
	27	double percent;
	28	char *path;
	29	};
	30
2f525d01 ACM	31	/** struct annotation - symbols with hits have this attached as in sannotation
	32	*
	33	* @histogram: Array of addr hit histograms per event being monitored
	34	* @src_line: If 'print_lines' is specified, per source code line percentages
	35	*
	36	* src_line is allocated, percentages calculated and all sorted by percentage
	37	* when the annotation is about to be presented, so the percentages are for
	38	* one of the entries in the histogram array, i.e. for the event/counter being
	39	* presented. It is deallocated right after symbol__{tui,tty,etc}_annotate
	40	* returns.
	41	*/
78f7defe	42	struct annotation {
78f7defe	43	struct source_line *src_line;
2f525d01	44	struct sym_hist *histograms;
36532461	45	int nr_histograms;
2f525d01	46	int sizeof_sym_hist;
78f7defe ACM	47	};
	48
	49	struct sannotation {
	50	struct annotation annotation;
	51	struct symbol symbol;
	52	};
	53
2f525d01 ACM	54	static inline struct sym_hist annotation__histogram(struct annotation notes, int idx)
	55	{
	56	return ((void )notes->histograms) + (notes->sizeof_sym_hist idx);
	57	}
	58
78f7defe ACM	59	static inline struct annotation symbol__annotation(struct symbol sym)
	60	{
	61	struct sannotation *a = container_of(sym, struct sannotation, symbol);
	62	return &a->annotation;
	63	}
	64
2f525d01 ACM	65	int symbol__inc_addr_samples(struct symbol sym, struct map map,
	66	int evidx, u64 addr);
	67	int symbol__alloc_hist(struct symbol *sym, int nevents);
36532461	68	void symbol__annotate_zero_histograms(struct symbol *sym);
78f7defe ACM	69
	70	int symbol__annotate(struct symbol sym, struct map map,
	71	struct list_head *head, size_t privsize);
36532461 ACM	72	int symbol__annotate_printf(struct symbol sym, struct map map,
	73	struct list_head *head, int evidx, bool full_paths,
	74	int min_pcnt, int max_lines);
	75	void symbol__annotate_zero_histogram(struct symbol *sym, int evidx);
	76	void symbol__annotate_decay_histogram(struct symbol *sym,
	77	struct list_head *head, int evidx);
f1e2701d	78	void objdump_line_list__purge(struct list_head *head);
78f7defe	79
2f525d01	80	int symbol__tty_annotate(struct symbol sym, struct map map, int evidx,
d040bd36 ACM	81	bool print_lines, bool full_paths, int min_pcnt,
d040bd36 ACM	82	int max_lines);
78f7defe ACM	83
	84	#ifdef NO_NEWT_SUPPORT
	85	static inline int symbol__tui_annotate(symbol *sym __used,
2f525d01	86	struct map *map __used, int evidx __used)
78f7defe ACM	87	{
	88	return 0;
	89	}
	90	#else
2f525d01	91	int symbol__tui_annotate(struct symbol sym, struct map map, int evidx);
78f7defe ACM	92	#endif
	93
	94	#endif /* __PERF_ANNOTATE_H */