Linux Audio

Check our new training course

Loading...
v3.5.6
  1#include "../../util/util.h"
  2#include "../browser.h"
  3#include "../helpline.h"
  4#include "../libslang.h"
  5#include "../ui.h"
  6#include "../util.h"
  7#include "../../util/annotate.h"
 
 
  8#include "../../util/hist.h"
  9#include "../../util/sort.h"
 
 10#include "../../util/symbol.h"
 
 
 
 11#include <pthread.h>
 12#include <newt.h>
 13
 14struct browser_disasm_line {
 15	struct rb_node	rb_node;
 16	double		percent;
 17	u32		idx;
 18	int		idx_asm;
 19	int		jump_sources;
 
 20};
 21
 22static struct annotate_browser_opt {
 23	bool hide_src_code,
 24	     use_offset,
 25	     jump_arrows,
 26	     show_nr_jumps;
 27} annotate_browser__opts = {
 28	.use_offset	= true,
 29	.jump_arrows	= true,
 30};
 31
 32struct annotate_browser {
 33	struct ui_browser b;
 34	struct rb_root	  entries;
 35	struct rb_node	  *curr_hot;
 36	struct disasm_line	  *selection;
 37	struct disasm_line  **offsets;
 38	u64		    start;
 39	int		    nr_asm_entries;
 40	int		    nr_entries;
 41	int		    max_jump_sources;
 42	int		    nr_jumps;
 43	bool		    searching_backwards;
 44	u8		    addr_width;
 45	u8		    jumps_width;
 46	u8		    target_width;
 47	u8		    min_addr_width;
 48	u8		    max_addr_width;
 49	char		    search_bf[128];
 50};
 51
 52static inline struct browser_disasm_line *disasm_line__browser(struct disasm_line *dl)
 53{
 54	return (struct browser_disasm_line *)(dl + 1);
 
 55}
 56
 57static bool disasm_line__filter(struct ui_browser *browser __used, void *entry)
 58{
 59	if (annotate_browser__opts.hide_src_code) {
 60		struct disasm_line *dl = list_entry(entry, struct disasm_line, node);
 61		return dl->offset == -1;
 62	}
 63
 64	return false;
 65}
 66
 67static int annotate_browser__jumps_percent_color(struct annotate_browser *browser,
 68						 int nr, bool current)
 69{
 70	if (current && (!browser->b.use_navkeypressed || browser->b.navkeypressed))
 
 
 71		return HE_COLORSET_SELECTED;
 72	if (nr == browser->max_jump_sources)
 73		return HE_COLORSET_TOP;
 74	if (nr > 1)
 75		return HE_COLORSET_MEDIUM;
 76	return HE_COLORSET_NORMAL;
 77}
 78
 79static int annotate_browser__set_jumps_percent_color(struct annotate_browser *browser,
 80						     int nr, bool current)
 81{
 82	 int color = annotate_browser__jumps_percent_color(browser, nr, current);
 83	 return ui_browser__set_color(&browser->b, color);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 84}
 85
 86static void annotate_browser__write(struct ui_browser *browser, void *entry, int row)
 87{
 88	struct annotate_browser *ab = container_of(browser, struct annotate_browser, b);
 89	struct disasm_line *dl = list_entry(entry, struct disasm_line, node);
 90	struct browser_disasm_line *bdl = disasm_line__browser(dl);
 91	bool current_entry = ui_browser__is_current_entry(browser, row);
 92	bool change_color = (!annotate_browser__opts.hide_src_code &&
 93			     (!current_entry || (browser->use_navkeypressed &&
 94					         !browser->navkeypressed)));
 95	int width = browser->width, printed;
 96	char bf[256];
 97
 98	if (dl->offset != -1 && bdl->percent != 0.0) {
 99		ui_browser__set_percent_color(browser, bdl->percent, current_entry);
100		slsmg_printf("%6.2f ", bdl->percent);
101	} else {
102		ui_browser__set_percent_color(browser, 0, current_entry);
103		slsmg_write_nstring(" ", 7);
104	}
105
106	SLsmg_write_char(' ');
107
108	/* The scroll bar isn't being used */
109	if (!browser->navkeypressed)
110		width += 1;
111
112	if (!*dl->line)
113		slsmg_write_nstring(" ", width - 7);
114	else if (dl->offset == -1) {
115		printed = scnprintf(bf, sizeof(bf), "%*s  ",
116				    ab->addr_width, " ");
117		slsmg_write_nstring(bf, printed);
118		slsmg_write_nstring(dl->line, width - printed - 6);
119	} else {
120		u64 addr = dl->offset;
121		int color = -1;
122
123		if (!annotate_browser__opts.use_offset)
124			addr += ab->start;
 
125
126		if (!annotate_browser__opts.use_offset) {
127			printed = scnprintf(bf, sizeof(bf), "%" PRIx64 ": ", addr);
128		} else {
129			if (bdl->jump_sources) {
130				if (annotate_browser__opts.show_nr_jumps) {
131					int prev;
132					printed = scnprintf(bf, sizeof(bf), "%*d ",
133							    ab->jumps_width,
134							    bdl->jump_sources);
135					prev = annotate_browser__set_jumps_percent_color(ab, bdl->jump_sources,
136											 current_entry);
137					slsmg_write_nstring(bf, printed);
138					ui_browser__set_color(browser, prev);
139				}
140
141				printed = scnprintf(bf, sizeof(bf), "%*" PRIx64 ": ",
142						    ab->target_width, addr);
143			} else {
144				printed = scnprintf(bf, sizeof(bf), "%*s  ",
145						    ab->addr_width, " ");
146			}
147		}
148
149		if (change_color)
150			color = ui_browser__set_color(browser, HE_COLORSET_ADDR);
151		slsmg_write_nstring(bf, printed);
152		if (change_color)
153			ui_browser__set_color(browser, color);
154		if (dl->ins && dl->ins->ops->scnprintf) {
155			if (ins__is_jump(dl->ins)) {
156				bool fwd = dl->ops.target.offset > (u64)dl->offset;
157
158				ui_browser__write_graph(browser, fwd ? SLSMG_DARROW_CHAR :
159								    SLSMG_UARROW_CHAR);
160				SLsmg_write_char(' ');
161			} else if (ins__is_call(dl->ins)) {
162				ui_browser__write_graph(browser, SLSMG_RARROW_CHAR);
163				SLsmg_write_char(' ');
164			} else {
165				slsmg_write_nstring(" ", 2);
166			}
167		} else {
168			if (strcmp(dl->name, "retq")) {
169				slsmg_write_nstring(" ", 2);
170			} else {
171				ui_browser__write_graph(browser, SLSMG_LARROW_CHAR);
172				SLsmg_write_char(' ');
173			}
174		}
175
176		disasm_line__scnprintf(dl, bf, sizeof(bf), !annotate_browser__opts.use_offset);
177		slsmg_write_nstring(bf, width - 10 - printed);
178	}
 
 
 
 
179
180	if (current_entry)
181		ab->selection = dl;
182}
183
184static void annotate_browser__draw_current_jump(struct ui_browser *browser)
185{
186	struct annotate_browser *ab = container_of(browser, struct annotate_browser, b);
187	struct disasm_line *cursor = ab->selection, *target;
188	struct browser_disasm_line *btarget, *bcursor;
189	unsigned int from, to;
 
 
 
 
 
190
191	if (!cursor || !cursor->ins || !ins__is_jump(cursor->ins) ||
192	    !disasm_line__has_offset(cursor))
193		return;
194
195	target = ab->offsets[cursor->ops.target.offset];
196	if (!target)
197		return;
198
199	bcursor = disasm_line__browser(cursor);
200	btarget = disasm_line__browser(target);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
201
202	if (annotate_browser__opts.hide_src_code) {
203		from = bcursor->idx_asm;
204		to = btarget->idx_asm;
205	} else {
206		from = (u64)bcursor->idx;
207		to = (u64)btarget->idx;
208	}
209
210	ui_browser__set_color(browser, HE_COLORSET_CODE);
211	__ui_browser__line_arrow(browser, 9 + ab->addr_width, from, to);
 
 
 
 
 
 
 
 
 
 
 
212}
213
214static unsigned int annotate_browser__refresh(struct ui_browser *browser)
215{
 
216	int ret = ui_browser__list_head_refresh(browser);
 
217
218	if (annotate_browser__opts.jump_arrows)
219		annotate_browser__draw_current_jump(browser);
220
221	ui_browser__set_color(browser, HE_COLORSET_NORMAL);
222	__ui_browser__vline(browser, 7, 0, browser->height - 1);
223	return ret;
224}
225
226static double disasm_line__calc_percent(struct disasm_line *dl, struct symbol *sym, int evidx)
 
227{
228	double percent = 0.0;
229
230	if (dl->offset != -1) {
231		int len = sym->end - sym->start;
232		unsigned int hits = 0;
233		struct annotation *notes = symbol__annotation(sym);
234		struct source_line *src_line = notes->src->lines;
235		struct sym_hist *h = annotation__histogram(notes, evidx);
236		s64 offset = dl->offset;
237		struct disasm_line *next;
238
239		next = disasm__get_next_ip_line(&notes->src->source, dl);
240		while (offset < (s64)len &&
241		       (next == NULL || offset < next->offset)) {
242			if (src_line) {
243				percent += src_line[offset].percent;
244			} else
245				hits += h->addr[offset];
246
247			++offset;
248		}
249		/*
250 		 * If the percentage wasn't already calculated in
251 		 * symbol__get_source_line, do it now:
252 		 */
253		if (src_line == NULL && h->sum)
254			percent = 100.0 * hits / h->sum;
255	}
256
257	return percent;
258}
259
260static void disasm_rb_tree__insert(struct rb_root *root, struct browser_disasm_line *bdl)
 
261{
 
262	struct rb_node **p = &root->rb_node;
263	struct rb_node *parent = NULL;
264	struct browser_disasm_line *l;
265
266	while (*p != NULL) {
267		parent = *p;
268		l = rb_entry(parent, struct browser_disasm_line, rb_node);
269		if (bdl->percent < l->percent)
 
270			p = &(*p)->rb_left;
271		else
272			p = &(*p)->rb_right;
273	}
274	rb_link_node(&bdl->rb_node, parent, p);
275	rb_insert_color(&bdl->rb_node, root);
276}
277
278static void annotate_browser__set_top(struct annotate_browser *browser,
279				      struct disasm_line *pos, u32 idx)
280{
 
281	unsigned back;
282
283	ui_browser__refresh_dimensions(&browser->b);
284	back = browser->b.height / 2;
285	browser->b.top_idx = browser->b.index = idx;
286
287	while (browser->b.top_idx != 0 && back != 0) {
288		pos = list_entry(pos->node.prev, struct disasm_line, node);
289
290		if (disasm_line__filter(&browser->b, &pos->node))
291			continue;
292
293		--browser->b.top_idx;
294		--back;
295	}
296
297	browser->b.top = pos;
298	browser->b.navkeypressed = true;
299}
300
301static void annotate_browser__set_rb_top(struct annotate_browser *browser,
302					 struct rb_node *nd)
303{
304	struct browser_disasm_line *bpos;
305	struct disasm_line *pos;
306	u32 idx;
307
308	bpos = rb_entry(nd, struct browser_disasm_line, rb_node);
309	pos = ((struct disasm_line *)bpos) - 1;
310	idx = bpos->idx;
311	if (annotate_browser__opts.hide_src_code)
312		idx = bpos->idx_asm;
313	annotate_browser__set_top(browser, pos, idx);
314	browser->curr_hot = nd;
315}
316
317static void annotate_browser__calc_percent(struct annotate_browser *browser,
318					   int evidx)
319{
320	struct map_symbol *ms = browser->b.priv;
321	struct symbol *sym = ms->sym;
322	struct annotation *notes = symbol__annotation(sym);
323	struct disasm_line *pos;
324
325	browser->entries = RB_ROOT;
326
327	pthread_mutex_lock(&notes->lock);
328
329	list_for_each_entry(pos, &notes->src->source, node) {
330		struct browser_disasm_line *bpos = disasm_line__browser(pos);
331		bpos->percent = disasm_line__calc_percent(pos, sym, evidx);
332		if (bpos->percent < 0.01) {
333			RB_CLEAR_NODE(&bpos->rb_node);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
334			continue;
335		}
336		disasm_rb_tree__insert(&browser->entries, bpos);
337	}
338	pthread_mutex_unlock(&notes->lock);
339
340	browser->curr_hot = rb_last(&browser->entries);
341}
342
343static bool annotate_browser__toggle_source(struct annotate_browser *browser)
344{
345	struct disasm_line *dl;
346	struct browser_disasm_line *bdl;
347	off_t offset = browser->b.index - browser->b.top_idx;
348
349	browser->b.seek(&browser->b, offset, SEEK_CUR);
350	dl = list_entry(browser->b.top, struct disasm_line, node);
351	bdl = disasm_line__browser(dl);
352
353	if (annotate_browser__opts.hide_src_code) {
354		if (bdl->idx_asm < offset)
355			offset = bdl->idx;
356
357		browser->b.nr_entries = browser->nr_entries;
358		annotate_browser__opts.hide_src_code = false;
359		browser->b.seek(&browser->b, -offset, SEEK_CUR);
360		browser->b.top_idx = bdl->idx - offset;
361		browser->b.index = bdl->idx;
362	} else {
363		if (bdl->idx_asm < 0) {
364			ui_helpline__puts("Only available for assembly lines.");
365			browser->b.seek(&browser->b, -offset, SEEK_CUR);
366			return false;
367		}
368
369		if (bdl->idx_asm < offset)
370			offset = bdl->idx_asm;
371
372		browser->b.nr_entries = browser->nr_asm_entries;
373		annotate_browser__opts.hide_src_code = true;
374		browser->b.seek(&browser->b, -offset, SEEK_CUR);
375		browser->b.top_idx = bdl->idx_asm - offset;
376		browser->b.index = bdl->idx_asm;
377	}
378
379	return true;
380}
381
382static void annotate_browser__init_asm_mode(struct annotate_browser *browser)
383{
384	ui_browser__reset_index(&browser->b);
385	browser->b.nr_entries = browser->nr_asm_entries;
 
386}
387
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
388static bool annotate_browser__callq(struct annotate_browser *browser,
389				    int evidx, void (*timer)(void *arg),
390				    void *arg, int delay_secs)
391{
392	struct map_symbol *ms = browser->b.priv;
393	struct disasm_line *dl = browser->selection;
394	struct symbol *sym = ms->sym;
395	struct annotation *notes;
396	struct symbol *target;
397	u64 ip;
398
399	if (!ins__is_call(dl->ins))
400		return false;
401
402	ip = ms->map->map_ip(ms->map, dl->ops.target.addr);
403	target = map__find_symbol(ms->map, ip, NULL);
404	if (target == NULL) {
405		ui_helpline__puts("The called function was not found.");
406		return true;
407	}
408
409	notes = symbol__annotation(target);
410	pthread_mutex_lock(&notes->lock);
411
412	if (notes->src == NULL && symbol__alloc_hist(target) < 0) {
413		pthread_mutex_unlock(&notes->lock);
414		ui__warning("Not enough memory for annotating '%s' symbol!\n",
415			    target->name);
416		return true;
417	}
418
 
 
 
419	pthread_mutex_unlock(&notes->lock);
420	symbol__tui_annotate(target, ms->map, evidx, timer, arg, delay_secs);
421	ui_browser__show_title(&browser->b, sym->name);
 
422	return true;
423}
424
425static
426struct disasm_line *annotate_browser__find_offset(struct annotate_browser *browser,
427					  s64 offset, s64 *idx)
428{
429	struct map_symbol *ms = browser->b.priv;
430	struct symbol *sym = ms->sym;
431	struct annotation *notes = symbol__annotation(sym);
432	struct disasm_line *pos;
433
434	*idx = 0;
435	list_for_each_entry(pos, &notes->src->source, node) {
436		if (pos->offset == offset)
437			return pos;
438		if (!disasm_line__filter(&browser->b, &pos->node))
439			++*idx;
440	}
441
442	return NULL;
443}
444
445static bool annotate_browser__jump(struct annotate_browser *browser)
 
 
446{
447	struct disasm_line *dl = browser->selection;
 
448	s64 idx;
449
450	if (!ins__is_jump(dl->ins))
451		return false;
452
453	dl = annotate_browser__find_offset(browser, dl->ops.target.offset, &idx);
 
 
 
 
 
 
454	if (dl == NULL) {
455		ui_helpline__puts("Invallid jump offset");
456		return true;
457	}
458
459	annotate_browser__set_top(browser, dl, idx);
460	
461	return true;
462}
463
464static
465struct disasm_line *annotate_browser__find_string(struct annotate_browser *browser,
466					  char *s, s64 *idx)
467{
468	struct map_symbol *ms = browser->b.priv;
469	struct symbol *sym = ms->sym;
470	struct annotation *notes = symbol__annotation(sym);
471	struct disasm_line *pos = browser->selection;
472
473	*idx = browser->b.index;
474	list_for_each_entry_continue(pos, &notes->src->source, node) {
475		if (disasm_line__filter(&browser->b, &pos->node))
476			continue;
477
478		++*idx;
479
480		if (pos->line && strstr(pos->line, s) != NULL)
481			return pos;
482	}
483
484	return NULL;
485}
486
487static bool __annotate_browser__search(struct annotate_browser *browser)
488{
489	struct disasm_line *dl;
490	s64 idx;
491
492	dl = annotate_browser__find_string(browser, browser->search_bf, &idx);
493	if (dl == NULL) {
494		ui_helpline__puts("String not found!");
495		return false;
496	}
497
498	annotate_browser__set_top(browser, dl, idx);
499	browser->searching_backwards = false;
500	return true;
501}
502
503static
504struct disasm_line *annotate_browser__find_string_reverse(struct annotate_browser *browser,
505						  char *s, s64 *idx)
506{
507	struct map_symbol *ms = browser->b.priv;
508	struct symbol *sym = ms->sym;
509	struct annotation *notes = symbol__annotation(sym);
510	struct disasm_line *pos = browser->selection;
511
512	*idx = browser->b.index;
513	list_for_each_entry_continue_reverse(pos, &notes->src->source, node) {
514		if (disasm_line__filter(&browser->b, &pos->node))
515			continue;
516
517		--*idx;
518
519		if (pos->line && strstr(pos->line, s) != NULL)
520			return pos;
521	}
522
523	return NULL;
524}
525
526static bool __annotate_browser__search_reverse(struct annotate_browser *browser)
527{
528	struct disasm_line *dl;
529	s64 idx;
530
531	dl = annotate_browser__find_string_reverse(browser, browser->search_bf, &idx);
532	if (dl == NULL) {
533		ui_helpline__puts("String not found!");
534		return false;
535	}
536
537	annotate_browser__set_top(browser, dl, idx);
538	browser->searching_backwards = true;
539	return true;
540}
541
542static bool annotate_browser__search_window(struct annotate_browser *browser,
543					    int delay_secs)
544{
545	if (ui_browser__input_window("Search", "String: ", browser->search_bf,
546				     "ENTER: OK, ESC: Cancel",
547				     delay_secs * 2) != K_ENTER ||
548	    !*browser->search_bf)
549		return false;
550
551	return true;
552}
553
554static bool annotate_browser__search(struct annotate_browser *browser, int delay_secs)
555{
556	if (annotate_browser__search_window(browser, delay_secs))
557		return __annotate_browser__search(browser);
558
559	return false;
560}
561
562static bool annotate_browser__continue_search(struct annotate_browser *browser,
563					      int delay_secs)
564{
565	if (!*browser->search_bf)
566		return annotate_browser__search(browser, delay_secs);
567
568	return __annotate_browser__search(browser);
569}
570
571static bool annotate_browser__search_reverse(struct annotate_browser *browser,
572					   int delay_secs)
573{
574	if (annotate_browser__search_window(browser, delay_secs))
575		return __annotate_browser__search_reverse(browser);
576
577	return false;
578}
579
580static
581bool annotate_browser__continue_search_reverse(struct annotate_browser *browser,
582					       int delay_secs)
583{
584	if (!*browser->search_bf)
585		return annotate_browser__search_reverse(browser, delay_secs);
586
587	return __annotate_browser__search_reverse(browser);
588}
589
590static void annotate_browser__update_addr_width(struct annotate_browser *browser)
591{
592	if (annotate_browser__opts.use_offset)
593		browser->target_width = browser->min_addr_width;
594	else
595		browser->target_width = browser->max_addr_width;
596
597	browser->addr_width = browser->target_width;
 
 
 
598
599	if (annotate_browser__opts.show_nr_jumps)
600		browser->addr_width += browser->jumps_width + 1;
 
 
601}
602
603static int annotate_browser__run(struct annotate_browser *browser, int evidx,
604				 void(*timer)(void *arg),
605				 void *arg, int delay_secs)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
606{
607	struct rb_node *nd = NULL;
 
608	struct map_symbol *ms = browser->b.priv;
609	struct symbol *sym = ms->sym;
 
610	const char *help = "Press 'h' for help on key bindings";
 
 
611	int key;
612
613	if (ui_browser__show(&browser->b, sym->name, help) < 0)
 
614		return -1;
615
616	annotate_browser__calc_percent(browser, evidx);
617
618	if (browser->curr_hot) {
619		annotate_browser__set_rb_top(browser, browser->curr_hot);
620		browser->b.navkeypressed = false;
621	}
622
623	nd = browser->curr_hot;
624
625	while (1) {
626		key = ui_browser__run(&browser->b, delay_secs);
627
628		if (delay_secs != 0) {
629			annotate_browser__calc_percent(browser, evidx);
630			/*
631			 * Current line focus got out of the list of most active
632			 * lines, NULL it so that if TAB|UNTAB is pressed, we
633			 * move to curr_hot (current hottest line).
634			 */
635			if (nd != NULL && RB_EMPTY_NODE(nd))
636				nd = NULL;
637		}
638
639		switch (key) {
640		case K_TIMER:
641			if (timer != NULL)
642				timer(arg);
643
644			if (delay_secs != 0)
645				symbol__annotate_decay_histogram(sym, evidx);
 
 
 
646			continue;
647		case K_TAB:
648			if (nd != NULL) {
649				nd = rb_prev(nd);
650				if (nd == NULL)
651					nd = rb_last(&browser->entries);
652			} else
653				nd = browser->curr_hot;
654			break;
655		case K_UNTAB:
656			if (nd != NULL)
657				nd = rb_next(nd);
658				if (nd == NULL)
659					nd = rb_first(&browser->entries);
660			else
661				nd = browser->curr_hot;
662			break;
663		case K_F1:
664		case 'h':
665			ui_browser__help_window(&browser->b,
666		"UP/DOWN/PGUP\n"
667		"PGDN/SPACE    Navigate\n"
668		"q/ESC/CTRL+C  Exit\n\n"
669		"->            Go to target\n"
670		"<-            Exit\n"
671		"H             Cycle thru hottest instructions\n"
 
672		"j             Toggle showing jump to target arrows\n"
673		"J             Toggle showing number of jump sources on targets\n"
674		"n             Search next string\n"
675		"o             Toggle disassembler output/simplified view\n"
 
676		"s             Toggle source code view\n"
 
 
677		"/             Search string\n"
678		"?             Search previous string\n");
 
 
 
 
 
 
 
 
 
679			continue;
 
 
 
680		case 'H':
681			nd = browser->curr_hot;
682			break;
683		case 's':
684			if (annotate_browser__toggle_source(browser))
685				ui_helpline__puts(help);
686			continue;
687		case 'o':
688			annotate_browser__opts.use_offset = !annotate_browser__opts.use_offset;
689			annotate_browser__update_addr_width(browser);
 
 
 
 
690			continue;
691		case 'j':
692			annotate_browser__opts.jump_arrows = !annotate_browser__opts.jump_arrows;
693			continue;
694		case 'J':
695			annotate_browser__opts.show_nr_jumps = !annotate_browser__opts.show_nr_jumps;
696			annotate_browser__update_addr_width(browser);
697			continue;
698		case '/':
699			if (annotate_browser__search(browser, delay_secs)) {
700show_help:
701				ui_helpline__puts(help);
702			}
703			continue;
704		case 'n':
705			if (browser->searching_backwards ?
706			    annotate_browser__continue_search_reverse(browser, delay_secs) :
707			    annotate_browser__continue_search(browser, delay_secs))
708				goto show_help;
709			continue;
710		case '?':
711			if (annotate_browser__search_reverse(browser, delay_secs))
712				goto show_help;
713			continue;
714		case 'D': {
715			static int seq;
716			ui_helpline__pop();
717			ui_helpline__fpush("%d: nr_ent=%d, height=%d, idx=%d, top_idx=%d, nr_asm_entries=%d",
718					   seq++, browser->b.nr_entries,
719					   browser->b.height,
720					   browser->b.index,
721					   browser->b.top_idx,
722					   browser->nr_asm_entries);
723		}
724			continue;
725		case K_ENTER:
726		case K_RIGHT:
 
 
 
727			if (browser->selection == NULL)
728				ui_helpline__puts("Huh? No selection. Report to linux-kernel@vger.kernel.org");
729			else if (browser->selection->offset == -1)
730				ui_helpline__puts("Actions are only available for assembly lines.");
731			else if (!browser->selection->ins) {
732				if (strcmp(browser->selection->name, "retq"))
733					goto show_sup_ins;
734				goto out;
735			} else if (!(annotate_browser__jump(browser) ||
736				     annotate_browser__callq(browser, evidx, timer, arg, delay_secs))) {
737show_sup_ins:
738				ui_helpline__puts("Actions are only available for 'callq', 'retq' & jump instructions.");
739			}
740			continue;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
741		case K_LEFT:
742		case K_ESC:
743		case 'q':
744		case CTRL('c'):
745			goto out;
746		default:
747			continue;
748		}
749
750		if (nd != NULL)
751			annotate_browser__set_rb_top(browser, nd);
752	}
753out:
754	ui_browser__hide(&browser->b);
755	return key;
756}
757
758int hist_entry__tui_annotate(struct hist_entry *he, int evidx,
759			     void(*timer)(void *arg), void *arg, int delay_secs)
 
760{
761	return symbol__tui_annotate(he->ms.sym, he->ms.map, evidx,
762				    timer, arg, delay_secs);
763}
764
765static void annotate_browser__mark_jump_targets(struct annotate_browser *browser,
766						size_t size)
 
767{
768	u64 offset;
769
770	for (offset = 0; offset < size; ++offset) {
771		struct disasm_line *dl = browser->offsets[offset], *dlt;
772		struct browser_disasm_line *bdlt;
773
774		if (!dl || !dl->ins || !ins__is_jump(dl->ins) ||
775		    !disasm_line__has_offset(dl))
776			continue;
777
778		if (dl->ops.target.offset >= size) {
779			ui__error("jump to after symbol!\n"
780				  "size: %zx, jump target: %" PRIx64,
781				  size, dl->ops.target.offset);
782			continue;
783		}
784
785		dlt = browser->offsets[dl->ops.target.offset];
786		/*
787 		 * FIXME: Oops, no jump target? Buggy disassembler? Or do we
788 		 * have to adjust to the previous offset?
789 		 */
790		if (dlt == NULL)
791			continue;
792
793		bdlt = disasm_line__browser(dlt);
794		if (++bdlt->jump_sources > browser->max_jump_sources)
795			browser->max_jump_sources = bdlt->jump_sources;
796
797		++browser->nr_jumps;
798	}
799		
800}
801
802static inline int width_jumps(int n)
 
 
803{
804	if (n >= 100)
805		return 5;
806	if (n / 10)
807		return 2;
808	return 1;
809}
810
811int symbol__tui_annotate(struct symbol *sym, struct map *map, int evidx,
812			 void(*timer)(void *arg), void *arg,
813			 int delay_secs)
814{
815	struct disasm_line *pos, *n;
816	struct annotation *notes;
817	const size_t size = symbol__size(sym);
818	struct map_symbol ms = {
819		.map = map,
820		.sym = sym,
821	};
822	struct annotate_browser browser = {
823		.b = {
824			.refresh = annotate_browser__refresh,
825			.seek	 = ui_browser__list_head_seek,
826			.write	 = annotate_browser__write,
827			.filter  = disasm_line__filter,
828			.priv	 = &ms,
 
829			.use_navkeypressed = true,
830		},
 
831	};
832	int ret = -1;
833
834	if (sym == NULL)
835		return -1;
836
837	if (map->dso->annotate_warned)
838		return -1;
839
840	browser.offsets = zalloc(size * sizeof(struct disasm_line *));
841	if (browser.offsets == NULL) {
842		ui__error("Not enough memory!");
843		return -1;
844	}
845
846	if (symbol__annotate(sym, map, sizeof(struct browser_disasm_line)) < 0) {
847		ui__error("%s", ui_helpline__last_msg);
848		goto out_free_offsets;
849	}
850
851	ui_helpline__push("Press <- or ESC to exit");
852
853	notes = symbol__annotation(sym);
854	browser.start = map__rip_2objdump(map, sym->start);
855
856	list_for_each_entry(pos, &notes->src->source, node) {
857		struct browser_disasm_line *bpos;
858		size_t line_len = strlen(pos->line);
859
860		if (browser.b.width < line_len)
861			browser.b.width = line_len;
862		bpos = disasm_line__browser(pos);
863		bpos->idx = browser.nr_entries++;
864		if (pos->offset != -1) {
865			bpos->idx_asm = browser.nr_asm_entries++;
866			/*
867			 * FIXME: short term bandaid to cope with assembly
868			 * routines that comes with labels in the same column
869			 * as the address in objdump, sigh.
870			 *
871			 * E.g. copy_user_generic_unrolled
872 			 */
873			if (pos->offset < (s64)size)
874				browser.offsets[pos->offset] = pos;
875		} else
876			bpos->idx_asm = -1;
877	}
878
879	annotate_browser__mark_jump_targets(&browser, size);
880
881	browser.addr_width = browser.target_width = browser.min_addr_width = hex_width(size);
882	browser.max_addr_width = hex_width(sym->end);
883	browser.jumps_width = width_jumps(browser.max_jump_sources);
884	browser.b.nr_entries = browser.nr_entries;
885	browser.b.entries = &notes->src->source,
886	browser.b.width += 18; /* Percentage */
887
888	if (annotate_browser__opts.hide_src_code)
889		annotate_browser__init_asm_mode(&browser);
890
891	annotate_browser__update_addr_width(&browser);
892
893	ret = annotate_browser__run(&browser, evidx, timer, arg, delay_secs);
894	list_for_each_entry_safe(pos, n, &notes->src->source, node) {
895		list_del(&pos->node);
896		disasm_line__free(pos);
897	}
898
899out_free_offsets:
900	free(browser.offsets);
901	return ret;
902}
903
904#define ANNOTATE_CFG(n) \
905	{ .name = #n, .value = &annotate_browser__opts.n, }
906	
907/*
908 * Keep the entries sorted, they are bsearch'ed
909 */
910static struct annotate__config {
911	const char *name;
912	bool *value;
913} annotate__configs[] = {
914	ANNOTATE_CFG(hide_src_code),
915	ANNOTATE_CFG(jump_arrows),
916	ANNOTATE_CFG(show_nr_jumps),
917	ANNOTATE_CFG(use_offset),
918};
919
920#undef ANNOTATE_CFG
921
922static int annotate_config__cmp(const void *name, const void *cfgp)
923{
924	const struct annotate__config *cfg = cfgp;
925
926	return strcmp(name, cfg->name);
927}
928
929static int annotate__config(const char *var, const char *value, void *data __used)
930{
931	struct annotate__config *cfg;
932	const char *name;
933
934	if (prefixcmp(var, "annotate.") != 0)
935		return 0;
936
937	name = var + 9;
938	cfg = bsearch(name, annotate__configs, ARRAY_SIZE(annotate__configs),
939		      sizeof(struct annotate__config), annotate_config__cmp);
940
941	if (cfg == NULL)
942		return -1;
943
944	*cfg->value = perf_config_bool(name, value);
945	return 0;
946}
947
948void annotate_browser__init(void)
949{
950	perf_config(annotate__config, NULL);
951}
v5.9
  1// SPDX-License-Identifier: GPL-2.0
  2#include "../browser.h"
  3#include "../helpline.h"
 
  4#include "../ui.h"
 
  5#include "../../util/annotate.h"
  6#include "../../util/debug.h"
  7#include "../../util/dso.h"
  8#include "../../util/hist.h"
  9#include "../../util/sort.h"
 10#include "../../util/map.h"
 11#include "../../util/symbol.h"
 12#include "../../util/evsel.h"
 13#include "../../util/evlist.h"
 14#include <inttypes.h>
 15#include <pthread.h>
 16#include <linux/kernel.h>
 17#include <linux/string.h>
 18#include <linux/zalloc.h>
 19#include <sys/ttydefaults.h>
 20#include <asm/bug.h>
 21
 22struct disasm_line_samples {
 23	double		      percent;
 24	struct sym_hist_entry he;
 25};
 26
 27struct arch;
 
 
 
 
 
 
 
 
 28
 29struct annotate_browser {
 30	struct ui_browser	    b;
 31	struct rb_root		    entries;
 32	struct rb_node		   *curr_hot;
 33	struct annotation_line	   *selection;
 34	struct arch		   *arch;
 35	struct annotation_options  *opts;
 36	bool			    searching_backwards;
 37	char			    search_bf[128];
 
 
 
 
 
 
 
 
 
 38};
 39
 40static inline struct annotation *browser__annotation(struct ui_browser *browser)
 41{
 42	struct map_symbol *ms = browser->priv;
 43	return symbol__annotation(ms->sym);
 44}
 45
 46static bool disasm_line__filter(struct ui_browser *browser, void *entry)
 47{
 48	struct annotation *notes = browser__annotation(browser);
 49	struct annotation_line *al = list_entry(entry, struct annotation_line, node);
 50	return annotation_line__filter(al, notes);
 
 
 
 51}
 52
 53static int ui_browser__jumps_percent_color(struct ui_browser *browser, int nr, bool current)
 
 54{
 55	struct annotation *notes = browser__annotation(browser);
 56
 57	if (current && (!browser->use_navkeypressed || browser->navkeypressed))
 58		return HE_COLORSET_SELECTED;
 59	if (nr == notes->max_jump_sources)
 60		return HE_COLORSET_TOP;
 61	if (nr > 1)
 62		return HE_COLORSET_MEDIUM;
 63	return HE_COLORSET_NORMAL;
 64}
 65
 66static int ui_browser__set_jumps_percent_color(void *browser, int nr, bool current)
 
 67{
 68	 int color = ui_browser__jumps_percent_color(browser, nr, current);
 69	 return ui_browser__set_color(browser, color);
 70}
 71
 72static int annotate_browser__set_color(void *browser, int color)
 73{
 74	return ui_browser__set_color(browser, color);
 75}
 76
 77static void annotate_browser__write_graph(void *browser, int graph)
 78{
 79	ui_browser__write_graph(browser, graph);
 80}
 81
 82static void annotate_browser__set_percent_color(void *browser, double percent, bool current)
 83{
 84	ui_browser__set_percent_color(browser, percent, current);
 85}
 86
 87static void annotate_browser__printf(void *browser, const char *fmt, ...)
 88{
 89	va_list args;
 90
 91	va_start(args, fmt);
 92	ui_browser__vprintf(browser, fmt, args);
 93	va_end(args);
 94}
 95
 96static void annotate_browser__write(struct ui_browser *browser, void *entry, int row)
 97{
 98	struct annotate_browser *ab = container_of(browser, struct annotate_browser, b);
 99	struct annotation *notes = browser__annotation(browser);
100	struct annotation_line *al = list_entry(entry, struct annotation_line, node);
101	const bool is_current_entry = ui_browser__is_current_entry(browser, row);
102	struct annotation_write_ops ops = {
103		.first_line		 = row == 0,
104		.current_entry		 = is_current_entry,
105		.change_color		 = (!notes->options->hide_src_code &&
106					    (!is_current_entry ||
107					     (browser->use_navkeypressed &&
108					      !browser->navkeypressed))),
109		.width			 = browser->width,
110		.obj			 = browser,
111		.set_color		 = annotate_browser__set_color,
112		.set_percent_color	 = annotate_browser__set_percent_color,
113		.set_jumps_percent_color = ui_browser__set_jumps_percent_color,
114		.printf			 = annotate_browser__printf,
115		.write_graph		 = annotate_browser__write_graph,
116	};
117
118	/* The scroll bar isn't being used */
119	if (!browser->navkeypressed)
120		ops.width += 1;
121
122	annotation_line__write(al, notes, &ops, ab->opts);
 
 
 
 
 
 
 
 
 
123
124	if (ops.current_entry)
125		ab->selection = al;
126}
127
128static bool is_fused(struct annotate_browser *ab, struct disasm_line *cursor)
129{
130	struct disasm_line *pos = list_prev_entry(cursor, al.node);
131	const char *name;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
132
133	if (!pos)
134		return false;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
135
136	if (ins__is_lock(&pos->ins))
137		name = pos->ops.locked.ins.name;
138	else
139		name = pos->ins.name;
140
141	if (!name || !cursor->ins.name)
142		return false;
143
144	return ins__is_fused(ab->arch, name, cursor->ins.name);
 
145}
146
147static void annotate_browser__draw_current_jump(struct ui_browser *browser)
148{
149	struct annotate_browser *ab = container_of(browser, struct annotate_browser, b);
150	struct disasm_line *cursor = disasm_line(ab->selection);
151	struct annotation_line *target;
152	unsigned int from, to;
153	struct map_symbol *ms = ab->b.priv;
154	struct symbol *sym = ms->sym;
155	struct annotation *notes = symbol__annotation(sym);
156	u8 pcnt_width = annotation__pcnt_width(notes);
157	int width;
158
159	/* PLT symbols contain external offsets */
160	if (strstr(sym->name, "@plt"))
161		return;
162
163	if (!disasm_line__is_valid_local_jump(cursor, sym))
 
164		return;
165
166	/*
167	 * This first was seen with a gcc function, _cpp_lex_token, that
168	 * has the usual jumps:
169	 *
170	 *  │1159e6c: ↓ jne    115aa32 <_cpp_lex_token@@Base+0xf92>
171	 *
172	 * I.e. jumps to a label inside that function (_cpp_lex_token), and
173	 * those works, but also this kind:
174	 *
175	 *  │1159e8b: ↓ jne    c469be <cpp_named_operator2name@@Base+0xa72>
176	 *
177	 *  I.e. jumps to another function, outside _cpp_lex_token, which
178	 *  are not being correctly handled generating as a side effect references
179	 *  to ab->offset[] entries that are set to NULL, so to make this code
180	 *  more robust, check that here.
181	 *
182	 *  A proper fix for will be put in place, looking at the function
183	 *  name right after the '<' token and probably treating this like a
184	 *  'call' instruction.
185	 */
186	target = notes->offsets[cursor->ops.target.offset];
187	if (target == NULL) {
188		ui_helpline__printf("WARN: jump target inconsistency, press 'o', notes->offsets[%#x] = NULL\n",
189				    cursor->ops.target.offset);
190		return;
191	}
192
193	if (notes->options->hide_src_code) {
194		from = cursor->al.idx_asm;
195		to = target->idx_asm;
196	} else {
197		from = (u64)cursor->al.idx;
198		to = (u64)target->idx;
199	}
200
201	width = annotation__cycles_width(notes);
202
203	ui_browser__set_color(browser, HE_COLORSET_JUMP_ARROWS);
204	__ui_browser__line_arrow(browser,
205				 pcnt_width + 2 + notes->widths.addr + width,
206				 from, to);
207
208	if (is_fused(ab, cursor)) {
209		ui_browser__mark_fused(browser,
210				       pcnt_width + 3 + notes->widths.addr + width,
211				       from - 1,
212				       to > from);
213	}
214}
215
216static unsigned int annotate_browser__refresh(struct ui_browser *browser)
217{
218	struct annotation *notes = browser__annotation(browser);
219	int ret = ui_browser__list_head_refresh(browser);
220	int pcnt_width = annotation__pcnt_width(notes);
221
222	if (notes->options->jump_arrows)
223		annotate_browser__draw_current_jump(browser);
224
225	ui_browser__set_color(browser, HE_COLORSET_NORMAL);
226	__ui_browser__vline(browser, pcnt_width, 0, browser->rows - 1);
227	return ret;
228}
229
230static double disasm__cmp(struct annotation_line *a, struct annotation_line *b,
231						  int percent_type)
232{
233	int i;
234
235	for (i = 0; i < a->data_nr; i++) {
236		if (a->data[i].percent[percent_type] == b->data[i].percent[percent_type])
237			continue;
238		return a->data[i].percent[percent_type] -
239			   b->data[i].percent[percent_type];
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
240	}
241	return 0;
 
242}
243
244static void disasm_rb_tree__insert(struct annotate_browser *browser,
245				struct annotation_line *al)
246{
247	struct rb_root *root = &browser->entries;
248	struct rb_node **p = &root->rb_node;
249	struct rb_node *parent = NULL;
250	struct annotation_line *l;
251
252	while (*p != NULL) {
253		parent = *p;
254		l = rb_entry(parent, struct annotation_line, rb_node);
255
256		if (disasm__cmp(al, l, browser->opts->percent_type) < 0)
257			p = &(*p)->rb_left;
258		else
259			p = &(*p)->rb_right;
260	}
261	rb_link_node(&al->rb_node, parent, p);
262	rb_insert_color(&al->rb_node, root);
263}
264
265static void annotate_browser__set_top(struct annotate_browser *browser,
266				      struct annotation_line *pos, u32 idx)
267{
268	struct annotation *notes = browser__annotation(&browser->b);
269	unsigned back;
270
271	ui_browser__refresh_dimensions(&browser->b);
272	back = browser->b.height / 2;
273	browser->b.top_idx = browser->b.index = idx;
274
275	while (browser->b.top_idx != 0 && back != 0) {
276		pos = list_entry(pos->node.prev, struct annotation_line, node);
277
278		if (annotation_line__filter(pos, notes))
279			continue;
280
281		--browser->b.top_idx;
282		--back;
283	}
284
285	browser->b.top = pos;
286	browser->b.navkeypressed = true;
287}
288
289static void annotate_browser__set_rb_top(struct annotate_browser *browser,
290					 struct rb_node *nd)
291{
292	struct annotation *notes = browser__annotation(&browser->b);
293	struct annotation_line * pos = rb_entry(nd, struct annotation_line, rb_node);
294	u32 idx = pos->idx;
295
296	if (notes->options->hide_src_code)
297		idx = pos->idx_asm;
 
 
 
298	annotate_browser__set_top(browser, pos, idx);
299	browser->curr_hot = nd;
300}
301
302static void annotate_browser__calc_percent(struct annotate_browser *browser,
303					   struct evsel *evsel)
304{
305	struct map_symbol *ms = browser->b.priv;
306	struct symbol *sym = ms->sym;
307	struct annotation *notes = symbol__annotation(sym);
308	struct disasm_line *pos;
309
310	browser->entries = RB_ROOT;
311
312	pthread_mutex_lock(&notes->lock);
313
314	symbol__calc_percent(sym, evsel);
315
316	list_for_each_entry(pos, &notes->src->source, al.node) {
317		double max_percent = 0.0;
318		int i;
319
320		if (pos->al.offset == -1) {
321			RB_CLEAR_NODE(&pos->al.rb_node);
322			continue;
323		}
324
325		for (i = 0; i < pos->al.data_nr; i++) {
326			double percent;
327
328			percent = annotation_data__percent(&pos->al.data[i],
329							   browser->opts->percent_type);
330
331			if (max_percent < percent)
332				max_percent = percent;
333		}
334
335		if (max_percent < 0.01 && pos->al.ipc == 0) {
336			RB_CLEAR_NODE(&pos->al.rb_node);
337			continue;
338		}
339		disasm_rb_tree__insert(browser, &pos->al);
340	}
341	pthread_mutex_unlock(&notes->lock);
342
343	browser->curr_hot = rb_last(&browser->entries);
344}
345
346static bool annotate_browser__toggle_source(struct annotate_browser *browser)
347{
348	struct annotation *notes = browser__annotation(&browser->b);
349	struct annotation_line *al;
350	off_t offset = browser->b.index - browser->b.top_idx;
351
352	browser->b.seek(&browser->b, offset, SEEK_CUR);
353	al = list_entry(browser->b.top, struct annotation_line, node);
 
354
355	if (notes->options->hide_src_code) {
356		if (al->idx_asm < offset)
357			offset = al->idx;
358
359		browser->b.nr_entries = notes->nr_entries;
360		notes->options->hide_src_code = false;
361		browser->b.seek(&browser->b, -offset, SEEK_CUR);
362		browser->b.top_idx = al->idx - offset;
363		browser->b.index = al->idx;
364	} else {
365		if (al->idx_asm < 0) {
366			ui_helpline__puts("Only available for assembly lines.");
367			browser->b.seek(&browser->b, -offset, SEEK_CUR);
368			return false;
369		}
370
371		if (al->idx_asm < offset)
372			offset = al->idx_asm;
373
374		browser->b.nr_entries = notes->nr_asm_entries;
375		notes->options->hide_src_code = true;
376		browser->b.seek(&browser->b, -offset, SEEK_CUR);
377		browser->b.top_idx = al->idx_asm - offset;
378		browser->b.index = al->idx_asm;
379	}
380
381	return true;
382}
383
384static void ui_browser__init_asm_mode(struct ui_browser *browser)
385{
386	struct annotation *notes = browser__annotation(browser);
387	ui_browser__reset_index(browser);
388	browser->nr_entries = notes->nr_asm_entries;
389}
390
391#define SYM_TITLE_MAX_SIZE (PATH_MAX + 64)
392
393static int sym_title(struct symbol *sym, struct map *map, char *title,
394		     size_t sz, int percent_type)
395{
396	return snprintf(title, sz, "%s  %s [Percent: %s]", sym->name, map->dso->long_name,
397			percent_type_str(percent_type));
398}
399
400/*
401 * This can be called from external jumps, i.e. jumps from one functon
402 * to another, like from the kernel's entry_SYSCALL_64 function to the
403 * swapgs_restore_regs_and_return_to_usermode() function.
404 *
405 * So all we check here is that dl->ops.target.sym is set, if it is, just
406 * go to that function and when exiting from its disassembly, come back
407 * to the calling function.
408 */
409static bool annotate_browser__callq(struct annotate_browser *browser,
410				    struct evsel *evsel,
411				    struct hist_browser_timer *hbt)
412{
413	struct map_symbol *ms = browser->b.priv, target_ms;
414	struct disasm_line *dl = disasm_line(browser->selection);
 
415	struct annotation *notes;
416	char title[SYM_TITLE_MAX_SIZE];
 
417
418	if (!dl->ops.target.sym) {
 
 
 
 
 
419		ui_helpline__puts("The called function was not found.");
420		return true;
421	}
422
423	notes = symbol__annotation(dl->ops.target.sym);
424	pthread_mutex_lock(&notes->lock);
425
426	if (!symbol__hists(dl->ops.target.sym, evsel->evlist->core.nr_entries)) {
427		pthread_mutex_unlock(&notes->lock);
428		ui__warning("Not enough memory for annotating '%s' symbol!\n",
429			    dl->ops.target.sym->name);
430		return true;
431	}
432
433	target_ms.maps = ms->maps;
434	target_ms.map = ms->map;
435	target_ms.sym = dl->ops.target.sym;
436	pthread_mutex_unlock(&notes->lock);
437	symbol__tui_annotate(&target_ms, evsel, hbt, browser->opts);
438	sym_title(ms->sym, ms->map, title, sizeof(title), browser->opts->percent_type);
439	ui_browser__show_title(&browser->b, title);
440	return true;
441}
442
443static
444struct disasm_line *annotate_browser__find_offset(struct annotate_browser *browser,
445					  s64 offset, s64 *idx)
446{
447	struct annotation *notes = browser__annotation(&browser->b);
 
 
448	struct disasm_line *pos;
449
450	*idx = 0;
451	list_for_each_entry(pos, &notes->src->source, al.node) {
452		if (pos->al.offset == offset)
453			return pos;
454		if (!annotation_line__filter(&pos->al, notes))
455			++*idx;
456	}
457
458	return NULL;
459}
460
461static bool annotate_browser__jump(struct annotate_browser *browser,
462				   struct evsel *evsel,
463				   struct hist_browser_timer *hbt)
464{
465	struct disasm_line *dl = disasm_line(browser->selection);
466	u64 offset;
467	s64 idx;
468
469	if (!ins__is_jump(&dl->ins))
470		return false;
471
472	if (dl->ops.target.outside) {
473		annotate_browser__callq(browser, evsel, hbt);
474		return true;
475	}
476
477	offset = dl->ops.target.offset;
478	dl = annotate_browser__find_offset(browser, offset, &idx);
479	if (dl == NULL) {
480		ui_helpline__printf("Invalid jump offset: %" PRIx64, offset);
481		return true;
482	}
483
484	annotate_browser__set_top(browser, &dl->al, idx);
485
486	return true;
487}
488
489static
490struct annotation_line *annotate_browser__find_string(struct annotate_browser *browser,
491					  char *s, s64 *idx)
492{
493	struct annotation *notes = browser__annotation(&browser->b);
494	struct annotation_line *al = browser->selection;
 
 
495
496	*idx = browser->b.index;
497	list_for_each_entry_continue(al, &notes->src->source, node) {
498		if (annotation_line__filter(al, notes))
499			continue;
500
501		++*idx;
502
503		if (al->line && strstr(al->line, s) != NULL)
504			return al;
505	}
506
507	return NULL;
508}
509
510static bool __annotate_browser__search(struct annotate_browser *browser)
511{
512	struct annotation_line *al;
513	s64 idx;
514
515	al = annotate_browser__find_string(browser, browser->search_bf, &idx);
516	if (al == NULL) {
517		ui_helpline__puts("String not found!");
518		return false;
519	}
520
521	annotate_browser__set_top(browser, al, idx);
522	browser->searching_backwards = false;
523	return true;
524}
525
526static
527struct annotation_line *annotate_browser__find_string_reverse(struct annotate_browser *browser,
528						  char *s, s64 *idx)
529{
530	struct annotation *notes = browser__annotation(&browser->b);
531	struct annotation_line *al = browser->selection;
 
 
532
533	*idx = browser->b.index;
534	list_for_each_entry_continue_reverse(al, &notes->src->source, node) {
535		if (annotation_line__filter(al, notes))
536			continue;
537
538		--*idx;
539
540		if (al->line && strstr(al->line, s) != NULL)
541			return al;
542	}
543
544	return NULL;
545}
546
547static bool __annotate_browser__search_reverse(struct annotate_browser *browser)
548{
549	struct annotation_line *al;
550	s64 idx;
551
552	al = annotate_browser__find_string_reverse(browser, browser->search_bf, &idx);
553	if (al == NULL) {
554		ui_helpline__puts("String not found!");
555		return false;
556	}
557
558	annotate_browser__set_top(browser, al, idx);
559	browser->searching_backwards = true;
560	return true;
561}
562
563static bool annotate_browser__search_window(struct annotate_browser *browser,
564					    int delay_secs)
565{
566	if (ui_browser__input_window("Search", "String: ", browser->search_bf,
567				     "ENTER: OK, ESC: Cancel",
568				     delay_secs * 2) != K_ENTER ||
569	    !*browser->search_bf)
570		return false;
571
572	return true;
573}
574
575static bool annotate_browser__search(struct annotate_browser *browser, int delay_secs)
576{
577	if (annotate_browser__search_window(browser, delay_secs))
578		return __annotate_browser__search(browser);
579
580	return false;
581}
582
583static bool annotate_browser__continue_search(struct annotate_browser *browser,
584					      int delay_secs)
585{
586	if (!*browser->search_bf)
587		return annotate_browser__search(browser, delay_secs);
588
589	return __annotate_browser__search(browser);
590}
591
592static bool annotate_browser__search_reverse(struct annotate_browser *browser,
593					   int delay_secs)
594{
595	if (annotate_browser__search_window(browser, delay_secs))
596		return __annotate_browser__search_reverse(browser);
597
598	return false;
599}
600
601static
602bool annotate_browser__continue_search_reverse(struct annotate_browser *browser,
603					       int delay_secs)
604{
605	if (!*browser->search_bf)
606		return annotate_browser__search_reverse(browser, delay_secs);
607
608	return __annotate_browser__search_reverse(browser);
609}
610
611static int annotate_browser__show(struct ui_browser *browser, char *title, const char *help)
612{
613	struct annotate_browser *ab = container_of(browser, struct annotate_browser, b);
614	struct map_symbol *ms = browser->priv;
615	struct symbol *sym = ms->sym;
616	char symbol_dso[SYM_TITLE_MAX_SIZE];
617
618	if (ui_browser__show(browser, title, help) < 0)
619		return -1;
620
621	sym_title(sym, ms->map, symbol_dso, sizeof(symbol_dso), ab->opts->percent_type);
622
623	ui_browser__gotorc_title(browser, 0, 0);
624	ui_browser__set_color(browser, HE_COLORSET_ROOT);
625	ui_browser__write_nstring(browser, symbol_dso, browser->width + 1);
626	return 0;
627}
628
629static void
630switch_percent_type(struct annotation_options *opts, bool base)
631{
632	switch (opts->percent_type) {
633	case PERCENT_HITS_LOCAL:
634		if (base)
635			opts->percent_type = PERCENT_PERIOD_LOCAL;
636		else
637			opts->percent_type = PERCENT_HITS_GLOBAL;
638		break;
639	case PERCENT_HITS_GLOBAL:
640		if (base)
641			opts->percent_type = PERCENT_PERIOD_GLOBAL;
642		else
643			opts->percent_type = PERCENT_HITS_LOCAL;
644		break;
645	case PERCENT_PERIOD_LOCAL:
646		if (base)
647			opts->percent_type = PERCENT_HITS_LOCAL;
648		else
649			opts->percent_type = PERCENT_PERIOD_GLOBAL;
650		break;
651	case PERCENT_PERIOD_GLOBAL:
652		if (base)
653			opts->percent_type = PERCENT_HITS_GLOBAL;
654		else
655			opts->percent_type = PERCENT_PERIOD_LOCAL;
656		break;
657	default:
658		WARN_ON(1);
659	}
660}
661
662static int annotate_browser__run(struct annotate_browser *browser,
663				 struct evsel *evsel,
664				 struct hist_browser_timer *hbt)
665{
666	struct rb_node *nd = NULL;
667	struct hists *hists = evsel__hists(evsel);
668	struct map_symbol *ms = browser->b.priv;
669	struct symbol *sym = ms->sym;
670	struct annotation *notes = symbol__annotation(ms->sym);
671	const char *help = "Press 'h' for help on key bindings";
672	int delay_secs = hbt ? hbt->refresh : 0;
673	char title[256];
674	int key;
675
676	hists__scnprintf_title(hists, title, sizeof(title));
677	if (annotate_browser__show(&browser->b, title, help) < 0)
678		return -1;
679
680	annotate_browser__calc_percent(browser, evsel);
681
682	if (browser->curr_hot) {
683		annotate_browser__set_rb_top(browser, browser->curr_hot);
684		browser->b.navkeypressed = false;
685	}
686
687	nd = browser->curr_hot;
688
689	while (1) {
690		key = ui_browser__run(&browser->b, delay_secs);
691
692		if (delay_secs != 0) {
693			annotate_browser__calc_percent(browser, evsel);
694			/*
695			 * Current line focus got out of the list of most active
696			 * lines, NULL it so that if TAB|UNTAB is pressed, we
697			 * move to curr_hot (current hottest line).
698			 */
699			if (nd != NULL && RB_EMPTY_NODE(nd))
700				nd = NULL;
701		}
702
703		switch (key) {
704		case K_TIMER:
705			if (hbt)
706				hbt->timer(hbt->arg);
707
708			if (delay_secs != 0) {
709				symbol__annotate_decay_histogram(sym, evsel->idx);
710				hists__scnprintf_title(hists, title, sizeof(title));
711				annotate_browser__show(&browser->b, title, help);
712			}
713			continue;
714		case K_TAB:
715			if (nd != NULL) {
716				nd = rb_prev(nd);
717				if (nd == NULL)
718					nd = rb_last(&browser->entries);
719			} else
720				nd = browser->curr_hot;
721			break;
722		case K_UNTAB:
723			if (nd != NULL) {
724				nd = rb_next(nd);
725				if (nd == NULL)
726					nd = rb_first(&browser->entries);
727			} else
728				nd = browser->curr_hot;
729			break;
730		case K_F1:
731		case 'h':
732			ui_browser__help_window(&browser->b,
733		"UP/DOWN/PGUP\n"
734		"PGDN/SPACE    Navigate\n"
735		"q/ESC/CTRL+C  Exit\n\n"
736		"ENTER         Go to target\n"
737		"ESC           Exit\n"
738		"H             Go to hottest instruction\n"
739		"TAB/shift+TAB Cycle thru hottest instructions\n"
740		"j             Toggle showing jump to target arrows\n"
741		"J             Toggle showing number of jump sources on targets\n"
742		"n             Search next string\n"
743		"o             Toggle disassembler output/simplified view\n"
744		"O             Bump offset level (jump targets -> +call -> all -> cycle thru)\n"
745		"s             Toggle source code view\n"
746		"t             Circulate percent, total period, samples view\n"
747		"c             Show min/max cycle\n"
748		"/             Search string\n"
749		"k             Toggle line numbers\n"
750		"P             Print to [symbol_name].annotation file.\n"
751		"r             Run available scripts\n"
752		"p             Toggle percent type [local/global]\n"
753		"b             Toggle percent base [period/hits]\n"
754		"?             Search string backwards\n");
755			continue;
756		case 'r':
757			script_browse(NULL, NULL);
758			annotate_browser__show(&browser->b, title, help);
759			continue;
760		case 'k':
761			notes->options->show_linenr = !notes->options->show_linenr;
762			break;
763		case 'H':
764			nd = browser->curr_hot;
765			break;
766		case 's':
767			if (annotate_browser__toggle_source(browser))
768				ui_helpline__puts(help);
769			continue;
770		case 'o':
771			notes->options->use_offset = !notes->options->use_offset;
772			annotation__update_column_widths(notes);
773			continue;
774		case 'O':
775			if (++notes->options->offset_level > ANNOTATION__MAX_OFFSET_LEVEL)
776				notes->options->offset_level = ANNOTATION__MIN_OFFSET_LEVEL;
777			continue;
778		case 'j':
779			notes->options->jump_arrows = !notes->options->jump_arrows;
780			continue;
781		case 'J':
782			notes->options->show_nr_jumps = !notes->options->show_nr_jumps;
783			annotation__update_column_widths(notes);
784			continue;
785		case '/':
786			if (annotate_browser__search(browser, delay_secs)) {
787show_help:
788				ui_helpline__puts(help);
789			}
790			continue;
791		case 'n':
792			if (browser->searching_backwards ?
793			    annotate_browser__continue_search_reverse(browser, delay_secs) :
794			    annotate_browser__continue_search(browser, delay_secs))
795				goto show_help;
796			continue;
797		case '?':
798			if (annotate_browser__search_reverse(browser, delay_secs))
799				goto show_help;
800			continue;
801		case 'D': {
802			static int seq;
803			ui_helpline__pop();
804			ui_helpline__fpush("%d: nr_ent=%d, height=%d, idx=%d, top_idx=%d, nr_asm_entries=%d",
805					   seq++, browser->b.nr_entries,
806					   browser->b.height,
807					   browser->b.index,
808					   browser->b.top_idx,
809					   notes->nr_asm_entries);
810		}
811			continue;
812		case K_ENTER:
813		case K_RIGHT:
814		{
815			struct disasm_line *dl = disasm_line(browser->selection);
816
817			if (browser->selection == NULL)
818				ui_helpline__puts("Huh? No selection. Report to linux-kernel@vger.kernel.org");
819			else if (browser->selection->offset == -1)
820				ui_helpline__puts("Actions are only available for assembly lines.");
821			else if (!dl->ins.ops)
822				goto show_sup_ins;
823			else if (ins__is_ret(&dl->ins))
824				goto out;
825			else if (!(annotate_browser__jump(browser, evsel, hbt) ||
826				     annotate_browser__callq(browser, evsel, hbt))) {
827show_sup_ins:
828				ui_helpline__puts("Actions are only available for function call/return & jump/branch instructions.");
829			}
830			continue;
831		}
832		case 'P':
833			map_symbol__annotation_dump(ms, evsel, browser->opts);
834			continue;
835		case 't':
836			if (symbol_conf.show_total_period) {
837				symbol_conf.show_total_period = false;
838				symbol_conf.show_nr_samples = true;
839			} else if (symbol_conf.show_nr_samples)
840				symbol_conf.show_nr_samples = false;
841			else
842				symbol_conf.show_total_period = true;
843			annotation__update_column_widths(notes);
844			continue;
845		case 'c':
846			if (notes->options->show_minmax_cycle)
847				notes->options->show_minmax_cycle = false;
848			else
849				notes->options->show_minmax_cycle = true;
850			annotation__update_column_widths(notes);
851			continue;
852		case 'p':
853		case 'b':
854			switch_percent_type(browser->opts, key == 'b');
855			hists__scnprintf_title(hists, title, sizeof(title));
856			annotate_browser__show(&browser->b, title, help);
857			continue;
858		case K_LEFT:
859		case K_ESC:
860		case 'q':
861		case CTRL('c'):
862			goto out;
863		default:
864			continue;
865		}
866
867		if (nd != NULL)
868			annotate_browser__set_rb_top(browser, nd);
869	}
870out:
871	ui_browser__hide(&browser->b);
872	return key;
873}
874
875int map_symbol__tui_annotate(struct map_symbol *ms, struct evsel *evsel,
876			     struct hist_browser_timer *hbt,
877			     struct annotation_options *opts)
878{
879	return symbol__tui_annotate(ms, evsel, hbt, opts);
 
880}
881
882int hist_entry__tui_annotate(struct hist_entry *he, struct evsel *evsel,
883			     struct hist_browser_timer *hbt,
884			     struct annotation_options *opts)
885{
886	/* reset abort key so that it can get Ctrl-C as a key */
887	SLang_reset_tty();
888	SLang_init_tty(0, 0, 0);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
889
890	return map_symbol__tui_annotate(&he->ms, evsel, hbt, opts);
 
 
 
 
 
 
891}
892
893int symbol__tui_annotate(struct map_symbol *ms, struct evsel *evsel,
894			 struct hist_browser_timer *hbt,
895			 struct annotation_options *opts)
896{
897	struct symbol *sym = ms->sym;
898	struct annotation *notes = symbol__annotation(sym);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
899	struct annotate_browser browser = {
900		.b = {
901			.refresh = annotate_browser__refresh,
902			.seek	 = ui_browser__list_head_seek,
903			.write	 = annotate_browser__write,
904			.filter  = disasm_line__filter,
905			.extra_title_lines = 1, /* for hists__scnprintf_title() */
906			.priv	 = ms,
907			.use_navkeypressed = true,
908		},
909		.opts = opts,
910	};
911	int ret = -1, err;
912
913	if (sym == NULL)
914		return -1;
915
916	if (ms->map->dso->annotate_warned)
917		return -1;
918
919	err = symbol__annotate2(ms, evsel, opts, &browser.arch);
920	if (err) {
921		char msg[BUFSIZ];
922		symbol__strerror_disassemble(ms, err, msg, sizeof(msg));
923		ui__error("Couldn't annotate %s:\n%s", sym->name, msg);
 
 
 
924		goto out_free_offsets;
925	}
926
927	ui_helpline__push("Press ESC to exit");
 
 
 
928
929	browser.b.width = notes->max_line_len;
930	browser.b.nr_entries = notes->nr_entries;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
931	browser.b.entries = &notes->src->source,
932	browser.b.width += 18; /* Percentage */
933
934	if (notes->options->hide_src_code)
935		ui_browser__init_asm_mode(&browser.b);
936
937	ret = annotate_browser__run(&browser, evsel, hbt);
938
939	annotated_source__purge(notes->src);
 
 
 
 
940
941out_free_offsets:
942	zfree(&notes->offsets);
943	return ret;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
944}