Quelle  annotate.c   Sprache: C

// SPDX-License-Identifier: GPL-2.0
#include "../browser.h"
#include "../helpline.h"
#include "../ui.h"
#include "../../util/annotate.h"
#include "../../util/debug.h"
#include "../../util/dso.h"
#include "../../util/hist.h"
#include "../../util/sort.h"
#include "../../util/map.h"
#include "../../util/mutex.h"
#include "../../util/symbol.h"
#include "../../util/evsel.h"
#include "../../util/evlist.h"
#include <inttypes.h>
#include <linux/kernel.h>
#include <linux/string.h>
#include <linux/zalloc.h>
#include <sys/ttydefaults.h>
#include <asm/bug.h>

struct arch;

struct annotate_browser {
 struct ui_browser     b;
 struct rb_root      entries;
 struct rb_node     *curr_hot;
 struct annotation_line    *selection;
 struct arch     *arch;
 bool       searching_backwards;
 char       search_bf[128];
};

static inline struct annotation *browser__annotation(struct ui_browser *browser)
{
 struct map_symbol *ms = browser->priv;
 return symbol__annotation(ms->sym);
}

static bool disasm_line__filter(struct ui_browser *browser __maybe_unused, void *entry)
{
 struct annotation_line *al = list_entry(entry, struct annotation_line, node);
 return annotation_line__filter(al);
}

static int ui_browser__jumps_percent_color(struct ui_browser *browser, int nr, bool current)
{
 struct annotation *notes = browser__annotation(browser);

 if (current && (!browser->use_navkeypressed || browser->navkeypressed))
  return HE_COLORSET_SELECTED;
 if (nr == notes->src->max_jump_sources)
  return HE_COLORSET_TOP;
 if (nr > 1)
  return HE_COLORSET_MEDIUM;
 return HE_COLORSET_NORMAL;
}

static int ui_browser__set_jumps_percent_color(void *browser, int nr, bool current)
{
  int color = ui_browser__jumps_percent_color(browser, nr, current);
  return ui_browser__set_color(browser, color);
}

static int annotate_browser__set_color(void *browser, int color)
{
 return ui_browser__set_color(browser, color);
}

static void annotate_browser__write_graph(void *browser, int graph)
{
 ui_browser__write_graph(browser, graph);
}

static void annotate_browser__set_percent_color(void *browser, double percent, bool current)
{
 ui_browser__set_percent_color(browser, percent, current);
}

static void annotate_browser__printf(void *browser, const char *fmt, ...)
{
 va_list args;

 va_start(args, fmt);
 ui_browser__vprintf(browser, fmt, args);
 va_end(args);
}

static void annotate_browser__write(struct ui_browser *browser, void *entry, int row)
{
 struct annotate_browser *ab = container_of(browser, struct annotate_browser, b);
 struct annotation *notes = browser__annotation(browser);
 struct annotation_line *al = list_entry(entry, struct annotation_line, node);
 const bool is_current_entry = ui_browser__is_current_entry(browser, row);
 struct annotation_write_ops ops = {
  .first_line   = row == 0,
  .current_entry   = is_current_entry,
  .change_color   = (!annotate_opts.hide_src_code &&
         (!is_current_entry ||
          (browser->use_navkeypressed &&
           !browser->navkeypressed))),
  .width    = browser->width,
  .obj    = browser,
  .set_color   = annotate_browser__set_color,
  .set_percent_color  = annotate_browser__set_percent_color,
  .set_jumps_percent_color = ui_browser__set_jumps_percent_color,
  .printf    = annotate_browser__printf,
  .write_graph   = annotate_browser__write_graph,
 };

 /* The scroll bar isn't being used */
 if (!browser->navkeypressed)
  ops.width += 1;

 annotation_line__write(al, notes, &ops);

 if (ops.current_entry)
  ab->selection = al;
}

static int is_fused(struct annotate_browser *ab, struct disasm_line *cursor)
{
 struct disasm_line *pos = list_prev_entry(cursor, al.node);
 const char *name;
 int diff = 1;

 while (pos && pos->al.offset == -1) {
  pos = list_prev_entry(pos, al.node);
  if (!annotate_opts.hide_src_code)
   diff++;
 }

 if (!pos)
  return 0;

 if (ins__is_lock(&pos->ins))
  name = pos->ops.locked.ins.name;
 else
  name = pos->ins.name;

 if (!name || !cursor->ins.name)
  return 0;

 if (ins__is_fused(ab->arch, name, cursor->ins.name))
  return diff;
 return 0;
}

static void annotate_browser__draw_current_jump(struct ui_browser *browser)
{
 struct annotate_browser *ab = container_of(browser, struct annotate_browser, b);
 struct disasm_line *cursor = disasm_line(ab->selection);
 struct annotation_line *target;
 unsigned int from, to;
 struct map_symbol *ms = ab->b.priv;
 struct symbol *sym = ms->sym;
 struct annotation *notes = symbol__annotation(sym);
 u8 pcnt_width = annotation__pcnt_width(notes);
 u8 cntr_width = annotation__br_cntr_width();
 int width;
 int diff = 0;

 /* PLT symbols contain external offsets */
 if (strstr(sym->name, "@plt"))
  return;

 if (!disasm_line__is_valid_local_jump(cursor, sym))
  return;

 /*
 * This first was seen with a gcc function, _cpp_lex_token, that
 * has the usual jumps:
 *
 *  │1159e6c: ↓ jne    115aa32 <_cpp_lex_token@@Base+0xf92>
 *
 * I.e. jumps to a label inside that function (_cpp_lex_token), and
 * those works, but also this kind:
 *
 *  │1159e8b: ↓ jne    c469be <cpp_named_operator2name@@Base+0xa72>
 *
 *  I.e. jumps to another function, outside _cpp_lex_token, which
 *  are not being correctly handled generating as a side effect references
 *  to ab->offset[] entries that are set to NULL, so to make this code
 *  more robust, check that here.
 *
 *  A proper fix for will be put in place, looking at the function
 *  name right after the '<' token and probably treating this like a
 *  'call' instruction.
 */
 target = annotated_source__get_line(notes->src, cursor->ops.target.offset);
 if (target == NULL) {
  ui_helpline__printf("WARN: jump target inconsistency, press 'o', notes->offsets[%#x] = NULL\n",
        cursor->ops.target.offset);
  return;
 }

 if (annotate_opts.hide_src_code) {
  from = cursor->al.idx_asm;
  to = target->idx_asm;
 } else {
  from = (u64)cursor->al.idx;
  to = (u64)target->idx;
 }

 width = annotation__cycles_width(notes);

 ui_browser__set_color(browser, HE_COLORSET_JUMP_ARROWS);
 __ui_browser__line_arrow(browser,
     pcnt_width + 2 + notes->src->widths.addr + width + cntr_width,
     from, to);

 diff = is_fused(ab, cursor);
 if (diff > 0) {
  ui_browser__mark_fused(browser,
           pcnt_width + 3 + notes->src->widths.addr + width + cntr_width,
           from - diff, diff, to > from);
 }
}

static unsigned int annotate_browser__refresh(struct ui_browser *browser)
{
 struct annotation *notes = browser__annotation(browser);
 int ret = ui_browser__list_head_refresh(browser);
 int pcnt_width = annotation__pcnt_width(notes);

 if (annotate_opts.jump_arrows)
  annotate_browser__draw_current_jump(browser);

 ui_browser__set_color(browser, HE_COLORSET_NORMAL);
 __ui_browser__vline(browser, pcnt_width, 0, browser->rows - 1);
 return ret;
}

static double disasm__cmp(struct annotation_line *a, struct annotation_line *b,
        int percent_type)
{
 int i;

 for (i = 0; i < a->data_nr; i++) {
  if (a->data[i].percent[percent_type] == b->data[i].percent[percent_type])
   continue;
  return a->data[i].percent[percent_type] -
      b->data[i].percent[percent_type];
 }
 return 0;
}

static void disasm_rb_tree__insert(struct annotate_browser *browser,
    struct annotation_line *al)
{
 struct rb_root *root = &browser->entries;
 struct rb_node **p = &root->rb_node;
 struct rb_node *parent = NULL;
 struct annotation_line *l;

 while (*p != NULL) {
  parent = *p;
  l = rb_entry(parent, struct annotation_line, rb_node);

  if (disasm__cmp(al, l, annotate_opts.percent_type) < 0)
   p = &(*p)->rb_left;
  else
   p = &(*p)->rb_right;
 }
 rb_link_node(&al->rb_node, parent, p);
 rb_insert_color(&al->rb_node, root);
}

static void annotate_browser__set_top(struct annotate_browser *browser,
          struct annotation_line *pos, u32 idx)
{
 unsigned back;

 ui_browser__refresh_dimensions(&browser->b);
 back = browser->b.height / 2;
 browser->b.top_idx = browser->b.index = idx;

 while (browser->b.top_idx != 0 && back != 0) {
  pos = list_entry(pos->node.prev, struct annotation_line, node);

  if (annotation_line__filter(pos))
   continue;

  --browser->b.top_idx;
  --back;
 }

 browser->b.top = pos;
 browser->b.navkeypressed = true;
}

static void annotate_browser__set_rb_top(struct annotate_browser *browser,
      struct rb_node *nd)
{
 struct annotation_line * pos = rb_entry(nd, struct annotation_line, rb_node);
 u32 idx = pos->idx;

 if (annotate_opts.hide_src_code)
  idx = pos->idx_asm;
 annotate_browser__set_top(browser, pos, idx);
 browser->curr_hot = nd;
}

static void annotate_browser__calc_percent(struct annotate_browser *browser,
        struct evsel *evsel)
{
 struct map_symbol *ms = browser->b.priv;
 struct symbol *sym = ms->sym;
 struct annotation *notes = symbol__annotation(sym);
 struct disasm_line *pos;

 browser->entries = RB_ROOT;

 annotation__lock(notes);

 symbol__calc_percent(sym, evsel);

 list_for_each_entry(pos, ¬es->src->source, al.node) {
  double max_percent = 0.0;
  int i;

  if (pos->al.offset == -1) {
   RB_CLEAR_NODE(&pos->al.rb_node);
   continue;
  }

  for (i = 0; i < pos->al.data_nr; i++) {
   double percent;

   percent = annotation_data__percent(&pos->al.data[i],
          annotate_opts.percent_type);

   if (max_percent < percent)
    max_percent = percent;
  }

  if (max_percent < 0.01 && (!pos->al.cycles || pos->al.cycles->ipc == 0)) {
   RB_CLEAR_NODE(&pos->al.rb_node);
   continue;
  }
  disasm_rb_tree__insert(browser, &pos->al);
 }
 annotation__unlock(notes);

 browser->curr_hot = rb_last(&browser->entries);
}

static struct annotation_line *annotate_browser__find_new_asm_line(
     struct annotate_browser *browser,
     int idx_asm)
{
 struct annotation_line *al;
 struct list_head *head = browser->b.entries;

 /* find an annotation line in the new list with the same idx_asm */
 list_for_each_entry(al, head, node) {
  if (al->idx_asm == idx_asm)
   return al;
 }

 /* There are no asm lines */
 return NULL;
}

static struct annotation_line *annotate_browser__find_next_asm_line(
     struct annotate_browser *browser,
     struct annotation_line *al)
{
 struct annotation_line *it = al;

 /* find next asm line */
 list_for_each_entry_continue(it, browser->b.entries, node) {
  if (it->idx_asm >= 0)
   return it;
 }

 /* no asm line found forwards, try backwards */
 it = al;
 list_for_each_entry_continue_reverse(it, browser->b.entries, node) {
  if (it->idx_asm >= 0)
   return it;
 }

 /* There are no asm lines */
 return NULL;
}

static bool annotation__has_source(struct annotation *notes)
{
 struct annotation_line *al;
 bool found_asm = false;

 /* Let's skip the first non-asm lines which present regardless of source. */
 list_for_each_entry(al, ¬es->src->source, node) {
  if (al->offset >= 0) {
   found_asm = true;
   break;
  }
 }

 if (found_asm) {
  /* After assembly lines, any line without offset means source. */
  list_for_each_entry_continue(al, ¬es->src->source, node) {
   if (al->offset == -1)
    return true;
  }
 }
 return false;
}

static bool annotate_browser__toggle_source(struct annotate_browser *browser,
         struct evsel *evsel)
{
 struct annotation *notes = browser__annotation(&browser->b);
 struct annotation_line *al;
 off_t offset = browser->b.index - browser->b.top_idx;

 browser->b.seek(&browser->b, offset, SEEK_CUR);
 al = list_entry(browser->b.top, struct annotation_line, node);

 if (!annotate_opts.annotate_src)
  annotate_opts.annotate_src = true;

 /*
 * It's about to get source code annotation for the first time.
 * Drop the existing annotation_lines and get the new one with source.
 * And then move to the original line at the same asm index.
 */
 if (annotate_opts.hide_src_code && !notes->src->tried_source) {
  struct map_symbol *ms = browser->b.priv;
  int orig_idx_asm = al->idx_asm;

  /* annotate again with source code info */
  annotate_opts.hide_src_code = false;
  annotated_source__purge(notes->src);
  symbol__annotate2(ms, evsel, &browser->arch);
  annotate_opts.hide_src_code = true;

  /* should be after annotated_source__purge() */
  notes->src->tried_source = true;

  if (!annotation__has_source(notes))
   ui__warning("Annotation has no source code.");

  browser->b.entries = ¬es->src->source;
  al = annotate_browser__find_new_asm_line(browser, orig_idx_asm);
  if (unlikely(al == NULL)) {
   al = list_first_entry(¬es->src->source,
           struct annotation_line, node);
  }
  browser->b.seek(&browser->b, al->idx_asm, SEEK_SET);
 }

 if (annotate_opts.hide_src_code) {
  if (al->idx_asm < offset)
   offset = al->idx;

  browser->b.nr_entries = notes->src->nr_entries;
  annotate_opts.hide_src_code = false;
  browser->b.seek(&browser->b, -offset, SEEK_CUR);
  browser->b.top_idx = al->idx - offset;
  browser->b.index = al->idx;
 } else {
  if (al->idx_asm < 0) {
   /* move cursor to next asm line */
   al = annotate_browser__find_next_asm_line(browser, al);
   if (!al) {
    browser->b.seek(&browser->b, -offset, SEEK_CUR);
    return false;
   }
  }

  if (al->idx_asm < offset)
   offset = al->idx_asm;

  browser->b.nr_entries = notes->src->nr_asm_entries;
  annotate_opts.hide_src_code = true;
  browser->b.seek(&browser->b, -offset, SEEK_CUR);
  browser->b.top_idx = al->idx_asm - offset;
  browser->b.index = al->idx_asm;
 }

 if (annotate_opts.hide_src_code_on_title)
  annotate_opts.hide_src_code_on_title = false;

 return true;
}

#define SYM_TITLE_MAX_SIZE (PATH_MAX + 64)

static void annotate_browser__show_full_location(struct ui_browser *browser)
{
 struct annotate_browser *ab = container_of(browser, struct annotate_browser, b);
 struct disasm_line *cursor = disasm_line(ab->selection);
 struct annotation_line *al = &cursor->al;

 if (al->offset != -1)
  ui_helpline__puts("Only available for source code lines.");
 else if (al->fileloc == NULL)
  ui_helpline__puts("No source file location.");
 else {
  char help_line[SYM_TITLE_MAX_SIZE];
  sprintf (help_line, "Source file location: %s", al->fileloc);
  ui_helpline__puts(help_line);
 }
}

static void ui_browser__init_asm_mode(struct ui_browser *browser)
{
 struct annotation *notes = browser__annotation(browser);
 ui_browser__reset_index(browser);
 browser->nr_entries = notes->src->nr_asm_entries;
}

static int sym_title(struct symbol *sym, struct map *map, char *title,
       size_t sz, int percent_type)
{
 return snprintf(title, sz, "%s %s [Percent: %s]", sym->name,
   dso__long_name(map__dso(map)),
   percent_type_str(percent_type));
}

/*
 * This can be called from external jumps, i.e. jumps from one function
 * to another, like from the kernel's entry_SYSCALL_64 function to the
 * swapgs_restore_regs_and_return_to_usermode() function.
 *
 * So all we check here is that dl->ops.target.sym is set, if it is, just
 * go to that function and when exiting from its disassembly, come back
 * to the calling function.
 */
static bool annotate_browser__callq(struct annotate_browser *browser,
        struct evsel *evsel,
        struct hist_browser_timer *hbt)
{
 struct map_symbol *ms = browser->b.priv, target_ms;
 struct disasm_line *dl = disasm_line(browser->selection);
 struct annotation *notes;
 char title[SYM_TITLE_MAX_SIZE];

 if (!dl->ops.target.sym) {
  ui_helpline__puts("The called function was not found.");
  return true;
 }

 notes = symbol__annotation(dl->ops.target.sym);
 annotation__lock(notes);

 if (!symbol__hists(dl->ops.target.sym, evsel->evlist->core.nr_entries)) {
  annotation__unlock(notes);
  ui__warning("Not enough memory for annotating '%s' symbol!\n",
       dl->ops.target.sym->name);
  return true;
 }

 target_ms.maps = ms->maps;
 target_ms.map = ms->map;
 target_ms.sym = dl->ops.target.sym;
 annotation__unlock(notes);
 symbol__tui_annotate(&target_ms, evsel, hbt);
 sym_title(ms->sym, ms->map, title, sizeof(title), annotate_opts.percent_type);
 ui_browser__show_title(&browser->b, title);
 return true;
}

static
struct disasm_line *annotate_browser__find_offset(struct annotate_browser *browser,
       s64 offset, s64 *idx)
{
 struct annotation *notes = browser__annotation(&browser->b);
 struct disasm_line *pos;

 *idx = 0;
 list_for_each_entry(pos, ¬es->src->source, al.node) {
  if (pos->al.offset == offset)
   return pos;
  if (!annotation_line__filter(&pos->al))
   ++*idx;
 }

 return NULL;
}

static bool annotate_browser__jump(struct annotate_browser *browser,
       struct evsel *evsel,
       struct hist_browser_timer *hbt)
{
 struct disasm_line *dl = disasm_line(browser->selection);
 u64 offset;
 s64 idx;

 if (!ins__is_jump(&dl->ins))
  return false;

 if (dl->ops.target.outside) {
  annotate_browser__callq(browser, evsel, hbt);
  return true;
 }

 offset = dl->ops.target.offset;
 dl = annotate_browser__find_offset(browser, offset, &idx);
 if (dl == NULL) {
  ui_helpline__printf("Invalid jump offset: %" PRIx64, offset);
  return true;
 }

 annotate_browser__set_top(browser, &dl->al, idx);

 return true;
}

static
struct annotation_line *annotate_browser__find_string(struct annotate_browser *browser,
       char *s, s64 *idx)
{
 struct annotation *notes = browser__annotation(&browser->b);
 struct annotation_line *al = browser->selection;

 *idx = browser->b.index;
 list_for_each_entry_continue(al, ¬es->src->source, node) {
  if (annotation_line__filter(al))
   continue;

  ++*idx;

  if (al->line && strstr(al->line, s) != NULL)
   return al;
 }

 return NULL;
}

static bool __annotate_browser__search(struct annotate_browser *browser)
{
 struct annotation_line *al;
 s64 idx;

 al = annotate_browser__find_string(browser, browser->search_bf, &idx);
 if (al == NULL) {
  ui_helpline__puts("String not found!");
  return false;
 }

 annotate_browser__set_top(browser, al, idx);
 browser->searching_backwards = false;
 return true;
}

static
struct annotation_line *annotate_browser__find_string_reverse(struct annotate_browser *browser,
        char *s, s64 *idx)
{
 struct annotation *notes = browser__annotation(&browser->b);
 struct annotation_line *al = browser->selection;

 *idx = browser->b.index;
 list_for_each_entry_continue_reverse(al, ¬es->src->source, node) {
  if (annotation_line__filter(al))
   continue;

  --*idx;

  if (al->line && strstr(al->line, s) != NULL)
   return al;
 }

 return NULL;
}

static bool __annotate_browser__search_reverse(struct annotate_browser *browser)
{
 struct annotation_line *al;
 s64 idx;

 al = annotate_browser__find_string_reverse(browser, browser->search_bf, &idx);
 if (al == NULL) {
  ui_helpline__puts("String not found!");
  return false;
 }

 annotate_browser__set_top(browser, al, idx);
 browser->searching_backwards = true;
 return true;
}

static bool annotate_browser__search_window(struct annotate_browser *browser,
         int delay_secs)
{
 if (ui_browser__input_window("Search", "String: ", browser->search_bf,
         "ENTER: OK, ESC: Cancel",
         delay_secs * 2) != K_ENTER ||
     !*browser->search_bf)
  return false;

 return true;
}

static bool annotate_browser__search(struct annotate_browser *browser, int delay_secs)
{
 if (annotate_browser__search_window(browser, delay_secs))
  return __annotate_browser__search(browser);

 return false;
}

static bool annotate_browser__continue_search(struct annotate_browser *browser,
           int delay_secs)
{
 if (!*browser->search_bf)
  return annotate_browser__search(browser, delay_secs);

 return __annotate_browser__search(browser);
}

static bool annotate_browser__search_reverse(struct annotate_browser *browser,
        int delay_secs)
{
 if (annotate_browser__search_window(browser, delay_secs))
  return __annotate_browser__search_reverse(browser);

 return false;
}

static
bool annotate_browser__continue_search_reverse(struct annotate_browser *browser,
            int delay_secs)
{
 if (!*browser->search_bf)
  return annotate_browser__search_reverse(browser, delay_secs);

 return __annotate_browser__search_reverse(browser);
}

static int annotate_browser__show(struct ui_browser *browser, char *title, const char *help)
{
 struct map_symbol *ms = browser->priv;
 struct symbol *sym = ms->sym;
 char symbol_dso[SYM_TITLE_MAX_SIZE];

 if (ui_browser__show(browser, title, help) < 0)
  return -1;

 sym_title(sym, ms->map, symbol_dso, sizeof(symbol_dso), annotate_opts.percent_type);

 ui_browser__gotorc_title(browser, 0, 0);
 ui_browser__set_color(browser, HE_COLORSET_ROOT);
 ui_browser__write_nstring(browser, symbol_dso, browser->width + 1);
 return 0;
}

static void
switch_percent_type(struct annotation_options *opts, bool base)
{
 switch (opts->percent_type) {
 case PERCENT_HITS_LOCAL:
  if (base)
   opts->percent_type = PERCENT_PERIOD_LOCAL;
  else
   opts->percent_type = PERCENT_HITS_GLOBAL;
  break;
 case PERCENT_HITS_GLOBAL:
  if (base)
   opts->percent_type = PERCENT_PERIOD_GLOBAL;
  else
   opts->percent_type = PERCENT_HITS_LOCAL;
  break;
 case PERCENT_PERIOD_LOCAL:
  if (base)
   opts->percent_type = PERCENT_HITS_LOCAL;
  else
   opts->percent_type = PERCENT_PERIOD_GLOBAL;
  break;
 case PERCENT_PERIOD_GLOBAL:
  if (base)
   opts->percent_type = PERCENT_HITS_GLOBAL;
  else
   opts->percent_type = PERCENT_PERIOD_LOCAL;
  break;
 default:
  WARN_ON(1);
 }
}

static int annotate__scnprintf_title(struct hists *hists, char *bf, size_t size)
{
 int printed = hists__scnprintf_title(hists, bf, size);

 if (!annotate_opts.hide_src_code_on_title) {
  printed += scnprintf(bf + printed, size - printed, " [source: %s]",
         annotate_opts.hide_src_code ? "OFF" : "On");
 }

 return printed;
}

static int annotate_browser__run(struct annotate_browser *browser,
     struct evsel *evsel,
     struct hist_browser_timer *hbt)
{
 struct rb_node *nd = NULL;
 struct hists *hists = evsel__hists(evsel);
 struct map_symbol *ms = browser->b.priv;
 struct symbol *sym = ms->sym;
 struct annotation *notes = symbol__annotation(ms->sym);
 const char *help = "Press 'h' for help on key bindings";
 int delay_secs = hbt ? hbt->refresh : 0;
 char *br_cntr_text = NULL;
 char title[256];
 int key;

 annotate__scnprintf_title(hists, title, sizeof(title));
 if (annotate_browser__show(&browser->b, title, help) < 0)
  return -1;

 annotate_browser__calc_percent(browser, evsel);

 if (browser->curr_hot) {
  annotate_browser__set_rb_top(browser, browser->curr_hot);
  browser->b.navkeypressed = false;
 }

 nd = browser->curr_hot;

 annotation_br_cntr_abbr_list(&br_cntr_text, evsel, false);

 while (1) {
  key = ui_browser__run(&browser->b, delay_secs);

  if (delay_secs != 0) {
   annotate_browser__calc_percent(browser, evsel);
   /*
 * Current line focus got out of the list of most active
 * lines, NULL it so that if TAB|UNTAB is pressed, we
 * move to curr_hot (current hottest line).
 */
   if (nd != NULL && RB_EMPTY_NODE(nd))
    nd = NULL;
  }

  switch (key) {
  case K_TIMER:
   if (hbt)
    hbt->timer(hbt->arg);

   if (delay_secs != 0) {
    symbol__annotate_decay_histogram(sym, evsel);
    annotate__scnprintf_title(hists, title, sizeof(title));
    annotate_browser__show(&browser->b, title, help);
   }
   continue;
  case K_TAB:
   if (nd != NULL) {
    nd = rb_prev(nd);
    if (nd == NULL)
     nd = rb_last(&browser->entries);
   } else
    nd = browser->curr_hot;
   break;
  case K_UNTAB:
   if (nd != NULL) {
    nd = rb_next(nd);
    if (nd == NULL)
     nd = rb_first(&browser->entries);
   } else
    nd = browser->curr_hot;
   break;
  case K_F1:
  case 'h':
   ui_browser__help_window(&browser->b,
  "UP/DOWN/PGUP\n"
  "PGDN/SPACE Navigate\n"
  " Move to prev/next symbol\n"
  "q/ESC/CTRL+C Exit\n\n"
  "ENTER Go to target\n"
  "H Go to hottest instruction\n"
  "TAB/shift+TAB Cycle thru hottest instructions\n"
  "j Toggle showing jump to target arrows\n"
  "J Toggle showing number of jump sources on targets\n"
  "n Search next string\n"
  "o Toggle disassembler output/simplified view\n"
  "O Bump offset level (jump targets -> +call -> all -> cycle thru)\n"
  "s Toggle source code view\n"
  "t Circulate percent, total period, samples view\n"
  "c Show min/max cycle\n"
  "/ Search string\n"
  "k Toggle line numbers\n"
  "l Show full source file location\n"
  "P Print to [symbol_name].annotation file.\n"
  "r Run available scripts\n"
  "p Toggle percent type [local/global]\n"
  "b Toggle percent base [period/hits]\n"
  "B Branch counter abbr list (Optional)\n"
  "? Search string backwards\n"
  "f Toggle showing offsets to full address\n");
   continue;
  case 'r':
   script_browse(NULL, NULL);
   annotate_browser__show(&browser->b, title, help);
   continue;
  case 'k':
   annotate_opts.show_linenr = !annotate_opts.show_linenr;
   continue;
  case 'l':
   annotate_browser__show_full_location (&browser->b);
   continue;
  case 'H':
   nd = browser->curr_hot;
   break;
  case 's':
   if (annotate_browser__toggle_source(browser, evsel))
    ui_helpline__puts(help);
   annotate__scnprintf_title(hists, title, sizeof(title));
   annotate_browser__show(&browser->b, title, help);
   continue;
  case 'o':
   annotate_opts.use_offset = !annotate_opts.use_offset;
   annotation__update_column_widths(notes);
   continue;
  case 'O':
   if (++annotate_opts.offset_level > ANNOTATION__MAX_OFFSET_LEVEL)
    annotate_opts.offset_level = ANNOTATION__MIN_OFFSET_LEVEL;
   continue;
  case 'j':
   annotate_opts.jump_arrows = !annotate_opts.jump_arrows;
   continue;
  case 'J':
   annotate_opts.show_nr_jumps = !annotate_opts.show_nr_jumps;
   annotation__update_column_widths(notes);
   continue;
  case '/':
   if (annotate_browser__search(browser, delay_secs)) {
show_help:
    ui_helpline__puts(help);
   }
   continue;
  case 'n':
   if (browser->searching_backwards ?
       annotate_browser__continue_search_reverse(browser, delay_secs) :
       annotate_browser__continue_search(browser, delay_secs))
    goto show_help;
   continue;
  case '?':
   if (annotate_browser__search_reverse(browser, delay_secs))
    goto show_help;
   continue;
  case 'D': {
   static int seq;
   ui_helpline__pop();
   ui_helpline__fpush("%d: nr_ent=%d, height=%d, idx=%d, top_idx=%d, nr_asm_entries=%d",
        seq++, browser->b.nr_entries,
        browser->b.height,
        browser->b.index,
        browser->b.top_idx,
        notes->src->nr_asm_entries);
  }
   continue;
  case K_ENTER:
  case K_RIGHT:
  {
   struct disasm_line *dl = disasm_line(browser->selection);

   if (browser->selection == NULL)
    ui_helpline__puts("Huh? No selection. Report to linux-kernel@vger.kernel.org");
   else if (browser->selection->offset == -1)
    ui_helpline__puts("Actions are only available for assembly lines.");
   else if (!dl->ins.ops)
    goto show_sup_ins;
   else if (ins__is_ret(&dl->ins))
    goto out;
   else if (!(annotate_browser__jump(browser, evsel, hbt) ||
         annotate_browser__callq(browser, evsel, hbt))) {
show_sup_ins:
    ui_helpline__puts("Actions are only available for function call/return & jump/branch instructions.");
   }
   continue;
  }
  case 'P':
   map_symbol__annotation_dump(ms, evsel);
   continue;
  case 't':
   if (symbol_conf.show_total_period) {
    symbol_conf.show_total_period = false;
    symbol_conf.show_nr_samples = true;
   } else if (symbol_conf.show_nr_samples)
    symbol_conf.show_nr_samples = false;
   else
    symbol_conf.show_total_period = true;
   annotation__update_column_widths(notes);
   continue;
  case 'c':
   if (annotate_opts.show_minmax_cycle)
    annotate_opts.show_minmax_cycle = false;
   else
    annotate_opts.show_minmax_cycle = true;
   annotation__update_column_widths(notes);
   continue;
  case 'p':
  case 'b':
   switch_percent_type(&annotate_opts, key == 'b');
   annotate__scnprintf_title(hists, title, sizeof(title));
   annotate_browser__show(&browser->b, title, help);
   continue;
  case 'B':
   if (br_cntr_text)
    ui_browser__help_window(&browser->b, br_cntr_text);
   else {
    ui_browser__help_window(&browser->b,
       "\n The branch counter is not available.\n");
   }
   continue;
  case 'f':
   annotation__toggle_full_addr(notes, ms);
   continue;
  case K_LEFT:
  case '<':
  case '>':
  case K_ESC:
  case 'q':
  case CTRL('c'):
   goto out;
  default:
   ui_browser__warn_unhandled_hotkey(&browser->b, key, delay_secs, ", use 'h'/F1 to see actions");
   continue;
  }

  if (nd != NULL)
   annotate_browser__set_rb_top(browser, nd);
 }
out:
 ui_browser__hide(&browser->b);
 free(br_cntr_text);
 return key;
}

int map_symbol__tui_annotate(struct map_symbol *ms, struct evsel *evsel,
        struct hist_browser_timer *hbt)
{
 return symbol__tui_annotate(ms, evsel, hbt);
}

int hist_entry__tui_annotate(struct hist_entry *he, struct evsel *evsel,
        struct hist_browser_timer *hbt)
{
 /* reset abort key so that it can get Ctrl-C as a key */
 SLang_reset_tty();
 SLang_init_tty(0, 0, 0);
 SLtty_set_suspend_state(true);

 return map_symbol__tui_annotate(&he->ms, evsel, hbt);
}

int symbol__tui_annotate(struct map_symbol *ms, struct evsel *evsel,
    struct hist_browser_timer *hbt)
{
 struct symbol *sym = ms->sym;
 struct annotation *notes = symbol__annotation(sym);
 struct annotate_browser browser = {
  .b = {
   .refresh = annotate_browser__refresh,
   .seek  = ui_browser__list_head_seek,
   .write  = annotate_browser__write,
   .filter  = disasm_line__filter,
   .extra_title_lines = 1, /* for hists__scnprintf_title() */
   .priv  = ms,
   .use_navkeypressed = true,
  },
 };
 struct dso *dso;
 int ret = -1, err;
 int not_annotated = list_empty(¬es->src->source);

 if (sym == NULL)
  return -1;

 dso = map__dso(ms->map);
 if (dso__annotate_warned(dso))
  return -1;

 if (not_annotated || !sym->annotate2) {
  err = symbol__annotate2(ms, evsel, &browser.arch);
  if (err) {
   char msg[BUFSIZ];
   dso__set_annotate_warned(dso);
   symbol__strerror_disassemble(ms, err, msg, sizeof(msg));
   ui__error("Couldn't annotate %s:\n%s", sym->name, msg);
   return -1;
  }

  if (!annotate_opts.hide_src_code) {
   notes->src->tried_source = true;
   if (!annotation__has_source(notes))
    ui__warning("Annotation has no source code.");
  }
 }

 ui_helpline__push("Press ESC to exit");

 browser.b.width = notes->src->widths.max_line_len;
 browser.b.nr_entries = notes->src->nr_entries;
 browser.b.entries = ¬es->src->source;
 browser.b.width += 18; /* Percentage */

 if (annotate_opts.hide_src_code)
  ui_browser__init_asm_mode(&browser.b);

 ret = annotate_browser__run(&browser, evsel, hbt);

 if (not_annotated && !notes->src->tried_source)
  annotated_source__purge(notes->src);

 return ret;
}