186470930SIngo Molnar /* 286470930SIngo Molnar * builtin-annotate.c 386470930SIngo Molnar * 486470930SIngo Molnar * Builtin annotate command: Analyze the perf.data input file, 586470930SIngo Molnar * look up and read DSOs and symbol information and display 686470930SIngo Molnar * a histogram of results, along various sorting keys. 786470930SIngo Molnar */ 886470930SIngo Molnar #include "builtin.h" 986470930SIngo Molnar 1086470930SIngo Molnar #include "util/util.h" 1186470930SIngo Molnar #include "util/color.h" 125da50258SArnaldo Carvalho de Melo #include <linux/list.h> 1386470930SIngo Molnar #include "util/cache.h" 1443cbcd8aSArnaldo Carvalho de Melo #include <linux/rbtree.h> 1586470930SIngo Molnar #include "util/symbol.h" 1686470930SIngo Molnar 1786470930SIngo Molnar #include "perf.h" 188f28827aSFrederic Weisbecker #include "util/debug.h" 1986470930SIngo Molnar 20e248de33SArnaldo Carvalho de Melo #include "util/evlist.h" 21e248de33SArnaldo Carvalho de Melo #include "util/evsel.h" 2278f7defeSArnaldo Carvalho de Melo #include "util/annotate.h" 2362daacb5SArnaldo Carvalho de Melo #include "util/event.h" 244b6ab94eSJosh Poimboeuf #include <subcmd/parse-options.h> 2586470930SIngo Molnar #include "util/parse-events.h" 266baa0a5aSFrederic Weisbecker #include "util/thread.h" 27dd68ada2SJohn Kacur #include "util/sort.h" 283d1d07ecSJohn Kacur #include "util/hist.h" 2994c744b6SArnaldo Carvalho de Melo #include "util/session.h" 3045694aa7SArnaldo Carvalho de Melo #include "util/tool.h" 31f5fc1412SJiri Olsa #include "util/data.h" 3268e94f4eSIrina Tirdea #include "arch/common.h" 3370fbe057SPeter Zijlstra #include "util/block-range.h" 3486470930SIngo Molnar 35fc67297bSNamhyung Kim #include <dlfcn.h> 36a43783aeSArnaldo Carvalho de Melo #include <errno.h> 375d67be97SAnton Blanchard #include <linux/bitmap.h> 385d67be97SAnton Blanchard 39d20deb64SArnaldo Carvalho de Melo struct perf_annotate { 4045694aa7SArnaldo Carvalho de Melo struct perf_tool tool; 41fa10f316SNamhyung Kim struct perf_session *session; 42fa10f316SNamhyung Kim bool use_tui, use_stdio, use_gtk; 437009cc34SArnaldo Carvalho de Melo bool full_paths; 447009cc34SArnaldo Carvalho de Melo bool print_line; 4518c9e5c5SNamhyung Kim bool skip_missing; 467009cc34SArnaldo Carvalho de Melo const char *sym_hist_filter; 477009cc34SArnaldo Carvalho de Melo const char *cpu_list; 487009cc34SArnaldo Carvalho de Melo DECLARE_BITMAP(cpu_bitmap, MAX_NR_CPUS); 49d20deb64SArnaldo Carvalho de Melo }; 505d67be97SAnton Blanchard 5170fbe057SPeter Zijlstra /* 5270fbe057SPeter Zijlstra * Given one basic block: 5370fbe057SPeter Zijlstra * 5470fbe057SPeter Zijlstra * from to branch_i 5570fbe057SPeter Zijlstra * * ----> * 5670fbe057SPeter Zijlstra * | 5770fbe057SPeter Zijlstra * | block 5870fbe057SPeter Zijlstra * v 5970fbe057SPeter Zijlstra * * ----> * 6070fbe057SPeter Zijlstra * from to branch_i+1 6170fbe057SPeter Zijlstra * 6270fbe057SPeter Zijlstra * where the horizontal are the branches and the vertical is the executed 6370fbe057SPeter Zijlstra * block of instructions. 6470fbe057SPeter Zijlstra * 6570fbe057SPeter Zijlstra * We count, for each 'instruction', the number of blocks that covered it as 6670fbe057SPeter Zijlstra * well as count the ratio each branch is taken. 6770fbe057SPeter Zijlstra * 6870fbe057SPeter Zijlstra * We can do this without knowing the actual instruction stream by keeping 6970fbe057SPeter Zijlstra * track of the address ranges. We break down ranges such that there is no 7070fbe057SPeter Zijlstra * overlap and iterate from the start until the end. 7170fbe057SPeter Zijlstra * 7270fbe057SPeter Zijlstra * @acme: once we parse the objdump output _before_ processing the samples, 7370fbe057SPeter Zijlstra * we can easily fold the branch.cycles IPC bits in. 7470fbe057SPeter Zijlstra */ 7570fbe057SPeter Zijlstra static void process_basic_block(struct addr_map_symbol *start, 7670fbe057SPeter Zijlstra struct addr_map_symbol *end, 7770fbe057SPeter Zijlstra struct branch_flags *flags) 7870fbe057SPeter Zijlstra { 7970fbe057SPeter Zijlstra struct symbol *sym = start->sym; 8070fbe057SPeter Zijlstra struct annotation *notes = sym ? symbol__annotation(sym) : NULL; 8170fbe057SPeter Zijlstra struct block_range_iter iter; 8270fbe057SPeter Zijlstra struct block_range *entry; 8370fbe057SPeter Zijlstra 8470fbe057SPeter Zijlstra /* 8570fbe057SPeter Zijlstra * Sanity; NULL isn't executable and the CPU cannot execute backwards 8670fbe057SPeter Zijlstra */ 8770fbe057SPeter Zijlstra if (!start->addr || start->addr > end->addr) 8870fbe057SPeter Zijlstra return; 8970fbe057SPeter Zijlstra 9070fbe057SPeter Zijlstra iter = block_range__create(start->addr, end->addr); 9170fbe057SPeter Zijlstra if (!block_range_iter__valid(&iter)) 9270fbe057SPeter Zijlstra return; 9370fbe057SPeter Zijlstra 9470fbe057SPeter Zijlstra /* 9570fbe057SPeter Zijlstra * First block in range is a branch target. 9670fbe057SPeter Zijlstra */ 9770fbe057SPeter Zijlstra entry = block_range_iter(&iter); 9870fbe057SPeter Zijlstra assert(entry->is_target); 9970fbe057SPeter Zijlstra entry->entry++; 10070fbe057SPeter Zijlstra 10170fbe057SPeter Zijlstra do { 10270fbe057SPeter Zijlstra entry = block_range_iter(&iter); 10370fbe057SPeter Zijlstra 10470fbe057SPeter Zijlstra entry->coverage++; 10570fbe057SPeter Zijlstra entry->sym = sym; 10670fbe057SPeter Zijlstra 10770fbe057SPeter Zijlstra if (notes) 10870fbe057SPeter Zijlstra notes->max_coverage = max(notes->max_coverage, entry->coverage); 10970fbe057SPeter Zijlstra 11070fbe057SPeter Zijlstra } while (block_range_iter__next(&iter)); 11170fbe057SPeter Zijlstra 11270fbe057SPeter Zijlstra /* 11370fbe057SPeter Zijlstra * Last block in rage is a branch. 11470fbe057SPeter Zijlstra */ 11570fbe057SPeter Zijlstra entry = block_range_iter(&iter); 11670fbe057SPeter Zijlstra assert(entry->is_branch); 11770fbe057SPeter Zijlstra entry->taken++; 11870fbe057SPeter Zijlstra if (flags->predicted) 11970fbe057SPeter Zijlstra entry->pred++; 12070fbe057SPeter Zijlstra } 12170fbe057SPeter Zijlstra 12270fbe057SPeter Zijlstra static void process_branch_stack(struct branch_stack *bs, struct addr_location *al, 12370fbe057SPeter Zijlstra struct perf_sample *sample) 12470fbe057SPeter Zijlstra { 12570fbe057SPeter Zijlstra struct addr_map_symbol *prev = NULL; 12670fbe057SPeter Zijlstra struct branch_info *bi; 12770fbe057SPeter Zijlstra int i; 12870fbe057SPeter Zijlstra 12970fbe057SPeter Zijlstra if (!bs || !bs->nr) 13070fbe057SPeter Zijlstra return; 13170fbe057SPeter Zijlstra 13270fbe057SPeter Zijlstra bi = sample__resolve_bstack(sample, al); 13370fbe057SPeter Zijlstra if (!bi) 13470fbe057SPeter Zijlstra return; 13570fbe057SPeter Zijlstra 13670fbe057SPeter Zijlstra for (i = bs->nr - 1; i >= 0; i--) { 13770fbe057SPeter Zijlstra /* 13870fbe057SPeter Zijlstra * XXX filter against symbol 13970fbe057SPeter Zijlstra */ 14070fbe057SPeter Zijlstra if (prev) 14170fbe057SPeter Zijlstra process_basic_block(prev, &bi[i].from, &bi[i].flags); 14270fbe057SPeter Zijlstra prev = &bi[i].to; 14370fbe057SPeter Zijlstra } 14470fbe057SPeter Zijlstra 14570fbe057SPeter Zijlstra free(bi); 14670fbe057SPeter Zijlstra } 14770fbe057SPeter Zijlstra 148d04b35f8SArnaldo Carvalho de Melo static int perf_evsel__add_sample(struct perf_evsel *evsel, 149fd36f3ddSNamhyung Kim struct perf_sample *sample, 150d20deb64SArnaldo Carvalho de Melo struct addr_location *al, 151d20deb64SArnaldo Carvalho de Melo struct perf_annotate *ann) 15286470930SIngo Molnar { 1534ea062edSArnaldo Carvalho de Melo struct hists *hists = evsel__hists(evsel); 154628ada0cSArnaldo Carvalho de Melo struct hist_entry *he; 155e248de33SArnaldo Carvalho de Melo int ret; 156628ada0cSArnaldo Carvalho de Melo 1577009cc34SArnaldo Carvalho de Melo if (ann->sym_hist_filter != NULL && 1587009cc34SArnaldo Carvalho de Melo (al->sym == NULL || 1597009cc34SArnaldo Carvalho de Melo strcmp(ann->sym_hist_filter, al->sym->name) != 0)) { 160628ada0cSArnaldo Carvalho de Melo /* We're only interested in a symbol named sym_hist_filter */ 161facf3f06SArnaldo Carvalho de Melo /* 162facf3f06SArnaldo Carvalho de Melo * FIXME: why isn't this done in the symbol_filter when loading 163facf3f06SArnaldo Carvalho de Melo * the DSO? 164facf3f06SArnaldo Carvalho de Melo */ 165628ada0cSArnaldo Carvalho de Melo if (al->sym != NULL) { 166628ada0cSArnaldo Carvalho de Melo rb_erase(&al->sym->rb_node, 167628ada0cSArnaldo Carvalho de Melo &al->map->dso->symbols[al->map->type]); 168628ada0cSArnaldo Carvalho de Melo symbol__delete(al->sym); 169c0b4dffbSArnaldo Carvalho de Melo dso__reset_find_symbol_cache(al->map->dso); 170628ada0cSArnaldo Carvalho de Melo } 171628ada0cSArnaldo Carvalho de Melo return 0; 172628ada0cSArnaldo Carvalho de Melo } 173628ada0cSArnaldo Carvalho de Melo 17470fbe057SPeter Zijlstra /* 17570fbe057SPeter Zijlstra * XXX filtered samples can still have branch entires pointing into our 17670fbe057SPeter Zijlstra * symbol and are missed. 17770fbe057SPeter Zijlstra */ 17870fbe057SPeter Zijlstra process_branch_stack(sample->branch_stack, al, sample); 17970fbe057SPeter Zijlstra 1800102ef3eSJiri Olsa he = hists__add_entry(hists, al, NULL, NULL, NULL, sample, true); 1819735abf1SArnaldo Carvalho de Melo if (he == NULL) 18286470930SIngo Molnar return -ENOMEM; 183628ada0cSArnaldo Carvalho de Melo 184bab89f6aSTaeung Song ret = hist_entry__inc_addr_samples(he, sample, evsel->idx, al->addr); 1854ea062edSArnaldo Carvalho de Melo hists__inc_nr_samples(hists, true); 186e248de33SArnaldo Carvalho de Melo return ret; 18786470930SIngo Molnar } 18886470930SIngo Molnar 18945694aa7SArnaldo Carvalho de Melo static int process_sample_event(struct perf_tool *tool, 190d20deb64SArnaldo Carvalho de Melo union perf_event *event, 1918115d60cSArnaldo Carvalho de Melo struct perf_sample *sample, 1929e69c210SArnaldo Carvalho de Melo struct perf_evsel *evsel, 193743eb868SArnaldo Carvalho de Melo struct machine *machine) 19486470930SIngo Molnar { 19545694aa7SArnaldo Carvalho de Melo struct perf_annotate *ann = container_of(tool, struct perf_annotate, tool); 1961ed091c4SArnaldo Carvalho de Melo struct addr_location al; 197b91fc39fSArnaldo Carvalho de Melo int ret = 0; 1986baa0a5aSFrederic Weisbecker 199bb3eb566SArnaldo Carvalho de Melo if (machine__resolve(machine, &al, sample) < 0) { 20029a9f66dSArnaldo Carvalho de Melo pr_warning("problem processing %d event, skipping it.\n", 20186470930SIngo Molnar event->header.type); 20286470930SIngo Molnar return -1; 20386470930SIngo Molnar } 20486470930SIngo Molnar 2057009cc34SArnaldo Carvalho de Melo if (ann->cpu_list && !test_bit(sample->cpu, ann->cpu_bitmap)) 206b91fc39fSArnaldo Carvalho de Melo goto out_put; 2075d67be97SAnton Blanchard 208d20deb64SArnaldo Carvalho de Melo if (!al.filtered && perf_evsel__add_sample(evsel, sample, &al, ann)) { 20929a9f66dSArnaldo Carvalho de Melo pr_warning("problem incrementing symbol count, " 210ec218fc4SArnaldo Carvalho de Melo "skipping event\n"); 211b91fc39fSArnaldo Carvalho de Melo ret = -1; 21286470930SIngo Molnar } 213b91fc39fSArnaldo Carvalho de Melo out_put: 214b91fc39fSArnaldo Carvalho de Melo addr_location__put(&al); 215b91fc39fSArnaldo Carvalho de Melo return ret; 21686470930SIngo Molnar } 21786470930SIngo Molnar 218db8fd07aSNamhyung Kim static int hist_entry__tty_annotate(struct hist_entry *he, 219db8fd07aSNamhyung Kim struct perf_evsel *evsel, 220d20deb64SArnaldo Carvalho de Melo struct perf_annotate *ann) 22186470930SIngo Molnar { 222db8fd07aSNamhyung Kim return symbol__tty_annotate(he->ms.sym, he->ms.map, evsel, 2237009cc34SArnaldo Carvalho de Melo ann->print_line, ann->full_paths, 0, 0); 22486470930SIngo Molnar } 22586470930SIngo Molnar 226c824c433SArnaldo Carvalho de Melo static void hists__find_annotations(struct hists *hists, 227db8fd07aSNamhyung Kim struct perf_evsel *evsel, 228d20deb64SArnaldo Carvalho de Melo struct perf_annotate *ann) 22986470930SIngo Molnar { 230c824c433SArnaldo Carvalho de Melo struct rb_node *nd = rb_first(&hists->entries), *next; 231cf958003SArnaldo Carvalho de Melo int key = K_RIGHT; 23286470930SIngo Molnar 23346e3e055SArnaldo Carvalho de Melo while (nd) { 234ed52ce2eSArnaldo Carvalho de Melo struct hist_entry *he = rb_entry(nd, struct hist_entry, rb_node); 23578f7defeSArnaldo Carvalho de Melo struct annotation *notes; 23686470930SIngo Molnar 23746e3e055SArnaldo Carvalho de Melo if (he->ms.sym == NULL || he->ms.map->dso->annotate_warned) 23846e3e055SArnaldo Carvalho de Melo goto find_next; 239e4204992SArnaldo Carvalho de Melo 24078f7defeSArnaldo Carvalho de Melo notes = symbol__annotation(he->ms.sym); 241ce6f4fabSArnaldo Carvalho de Melo if (notes->src == NULL) { 24246e3e055SArnaldo Carvalho de Melo find_next: 243cf958003SArnaldo Carvalho de Melo if (key == K_LEFT) 24446e3e055SArnaldo Carvalho de Melo nd = rb_prev(nd); 24546e3e055SArnaldo Carvalho de Melo else 24646e3e055SArnaldo Carvalho de Melo nd = rb_next(nd); 247e4204992SArnaldo Carvalho de Melo continue; 24846e3e055SArnaldo Carvalho de Melo } 249e4204992SArnaldo Carvalho de Melo 2502b676bf0SNamhyung Kim if (use_browser == 2) { 25118c9e5c5SNamhyung Kim int ret; 252fc67297bSNamhyung Kim int (*annotate)(struct hist_entry *he, 253fc67297bSNamhyung Kim struct perf_evsel *evsel, 254fc67297bSNamhyung Kim struct hist_browser_timer *hbt); 25518c9e5c5SNamhyung Kim 256fc67297bSNamhyung Kim annotate = dlsym(perf_gtk_handle, 257fc67297bSNamhyung Kim "hist_entry__gtk_annotate"); 258fc67297bSNamhyung Kim if (annotate == NULL) { 259fc67297bSNamhyung Kim ui__error("GTK browser not found!\n"); 260fc67297bSNamhyung Kim return; 261fc67297bSNamhyung Kim } 262fc67297bSNamhyung Kim 263fc67297bSNamhyung Kim ret = annotate(he, evsel, NULL); 26418c9e5c5SNamhyung Kim if (!ret || !ann->skip_missing) 2652b676bf0SNamhyung Kim return; 26618c9e5c5SNamhyung Kim 26718c9e5c5SNamhyung Kim /* skip missing symbols */ 26818c9e5c5SNamhyung Kim nd = rb_next(nd); 2692b676bf0SNamhyung Kim } else if (use_browser == 1) { 270db8fd07aSNamhyung Kim key = hist_entry__tui_annotate(he, evsel, NULL); 27146e3e055SArnaldo Carvalho de Melo switch (key) { 27218c9e5c5SNamhyung Kim case -1: 27318c9e5c5SNamhyung Kim if (!ann->skip_missing) 27418c9e5c5SNamhyung Kim return; 27518c9e5c5SNamhyung Kim /* fall through */ 276cf958003SArnaldo Carvalho de Melo case K_RIGHT: 277b50e003dSArnaldo Carvalho de Melo next = rb_next(nd); 27846e3e055SArnaldo Carvalho de Melo break; 279cf958003SArnaldo Carvalho de Melo case K_LEFT: 280b50e003dSArnaldo Carvalho de Melo next = rb_prev(nd); 28146e3e055SArnaldo Carvalho de Melo break; 282b50e003dSArnaldo Carvalho de Melo default: 283b50e003dSArnaldo Carvalho de Melo return; 28446e3e055SArnaldo Carvalho de Melo } 285b50e003dSArnaldo Carvalho de Melo 286b50e003dSArnaldo Carvalho de Melo if (next != NULL) 287b50e003dSArnaldo Carvalho de Melo nd = next; 28846e3e055SArnaldo Carvalho de Melo } else { 289db8fd07aSNamhyung Kim hist_entry__tty_annotate(he, evsel, ann); 29046e3e055SArnaldo Carvalho de Melo nd = rb_next(nd); 291ed52ce2eSArnaldo Carvalho de Melo /* 29246e3e055SArnaldo Carvalho de Melo * Since we have a hist_entry per IP for the same 293ce6f4fabSArnaldo Carvalho de Melo * symbol, free he->ms.sym->src to signal we already 29446e3e055SArnaldo Carvalho de Melo * processed this symbol. 295ed52ce2eSArnaldo Carvalho de Melo */ 296d4957633SAndi Kleen zfree(¬es->src->cycles_hist); 29704662523SArnaldo Carvalho de Melo zfree(¬es->src); 29886470930SIngo Molnar } 29986470930SIngo Molnar } 30046e3e055SArnaldo Carvalho de Melo } 30186470930SIngo Molnar 302d20deb64SArnaldo Carvalho de Melo static int __cmd_annotate(struct perf_annotate *ann) 30386470930SIngo Molnar { 304bab81b62SLi Zefan int ret; 305fa10f316SNamhyung Kim struct perf_session *session = ann->session; 306e248de33SArnaldo Carvalho de Melo struct perf_evsel *pos; 307e248de33SArnaldo Carvalho de Melo u64 total_nr_samples; 30894c744b6SArnaldo Carvalho de Melo 3097009cc34SArnaldo Carvalho de Melo if (ann->cpu_list) { 3107009cc34SArnaldo Carvalho de Melo ret = perf_session__cpu_bitmap(session, ann->cpu_list, 3117009cc34SArnaldo Carvalho de Melo ann->cpu_bitmap); 3125d67be97SAnton Blanchard if (ret) 313fa10f316SNamhyung Kim goto out; 3145d67be97SAnton Blanchard } 3155d67be97SAnton Blanchard 31668e94f4eSIrina Tirdea if (!objdump_path) { 317eebd0bfcSArnaldo Carvalho de Melo ret = perf_env__lookup_objdump(&session->header.env); 31868e94f4eSIrina Tirdea if (ret) 319fa10f316SNamhyung Kim goto out; 32068e94f4eSIrina Tirdea } 32168e94f4eSIrina Tirdea 322b7b61cbeSArnaldo Carvalho de Melo ret = perf_session__process_events(session); 323bab81b62SLi Zefan if (ret) 324fa10f316SNamhyung Kim goto out; 32586470930SIngo Molnar 32662daacb5SArnaldo Carvalho de Melo if (dump_trace) { 327c8446b9bSArnaldo Carvalho de Melo perf_session__fprintf_nr_events(session, stdout); 3282a1731fbSArnaldo Carvalho de Melo perf_evlist__fprintf_nr_events(session->evlist, stdout); 329fa10f316SNamhyung Kim goto out; 33062daacb5SArnaldo Carvalho de Melo } 33186470930SIngo Molnar 332da21d1b5SArnaldo Carvalho de Melo if (verbose > 3) 333b3165f41SArnaldo Carvalho de Melo perf_session__fprintf(session, stdout); 33486470930SIngo Molnar 335da21d1b5SArnaldo Carvalho de Melo if (verbose > 2) 336cbf69680SArnaldo Carvalho de Melo perf_session__fprintf_dsos(session, stdout); 33786470930SIngo Molnar 338e248de33SArnaldo Carvalho de Melo total_nr_samples = 0; 339e5cadb93SArnaldo Carvalho de Melo evlist__for_each_entry(session->evlist, pos) { 3404ea062edSArnaldo Carvalho de Melo struct hists *hists = evsel__hists(pos); 341e248de33SArnaldo Carvalho de Melo u32 nr_samples = hists->stats.nr_events[PERF_RECORD_SAMPLE]; 34286470930SIngo Molnar 343e248de33SArnaldo Carvalho de Melo if (nr_samples > 0) { 344e248de33SArnaldo Carvalho de Melo total_nr_samples += nr_samples; 345c1fb5651SNamhyung Kim hists__collapse_resort(hists, NULL); 346f9db0d0fSKan Liang /* Don't sort callchain */ 347f9db0d0fSKan Liang perf_evsel__reset_sample_bit(pos, CALLCHAIN); 348452ce03bSJiri Olsa perf_evsel__output_resort(pos, NULL); 349b1dd4432SNamhyung Kim 350b1dd4432SNamhyung Kim if (symbol_conf.event_group && 351b1dd4432SNamhyung Kim !perf_evsel__is_group_leader(pos)) 352b1dd4432SNamhyung Kim continue; 353b1dd4432SNamhyung Kim 354db8fd07aSNamhyung Kim hists__find_annotations(hists, pos, ann); 355e248de33SArnaldo Carvalho de Melo } 356e248de33SArnaldo Carvalho de Melo } 357e248de33SArnaldo Carvalho de Melo 358e248de33SArnaldo Carvalho de Melo if (total_nr_samples == 0) { 359eae8ad80SJiri Olsa ui__error("The %s file has no samples!\n", session->data->file.path); 360fa10f316SNamhyung Kim goto out; 361e248de33SArnaldo Carvalho de Melo } 3627a60ba94SNamhyung Kim 363fc67297bSNamhyung Kim if (use_browser == 2) { 364fc67297bSNamhyung Kim void (*show_annotations)(void); 365fc67297bSNamhyung Kim 366fc67297bSNamhyung Kim show_annotations = dlsym(perf_gtk_handle, 367fc67297bSNamhyung Kim "perf_gtk__show_annotations"); 368fc67297bSNamhyung Kim if (show_annotations == NULL) { 369fc67297bSNamhyung Kim ui__error("GTK browser not found!\n"); 370fa10f316SNamhyung Kim goto out; 371fc67297bSNamhyung Kim } 372fc67297bSNamhyung Kim show_annotations(); 373fc67297bSNamhyung Kim } 3747a60ba94SNamhyung Kim 375fa10f316SNamhyung Kim out: 376bab81b62SLi Zefan return ret; 37786470930SIngo Molnar } 37886470930SIngo Molnar 37986470930SIngo Molnar static const char * const annotate_usage[] = { 38099345254SNamhyung Kim "perf annotate [<options>]", 38186470930SIngo Molnar NULL 38286470930SIngo Molnar }; 38386470930SIngo Molnar 384b0ad8ea6SArnaldo Carvalho de Melo int cmd_annotate(int argc, const char **argv) 385d20deb64SArnaldo Carvalho de Melo { 386d20deb64SArnaldo Carvalho de Melo struct perf_annotate annotate = { 38745694aa7SArnaldo Carvalho de Melo .tool = { 388d20deb64SArnaldo Carvalho de Melo .sample = process_sample_event, 389d20deb64SArnaldo Carvalho de Melo .mmap = perf_event__process_mmap, 3905c5e854bSStephane Eranian .mmap2 = perf_event__process_mmap2, 391d20deb64SArnaldo Carvalho de Melo .comm = perf_event__process_comm, 392ec4622f5SArnaldo Carvalho de Melo .exit = perf_event__process_exit, 393f62d3f0fSArnaldo Carvalho de Melo .fork = perf_event__process_fork, 394f3b3614aSHari Bathini .namespaces = perf_event__process_namespaces, 3956ab11f3aSDavid Carrillo-Cisneros .attr = perf_event__process_attr, 3966ab11f3aSDavid Carrillo-Cisneros .build_id = perf_event__process_build_id, 397f4849599SDavid Carrillo-Cisneros .tracing_data = perf_event__process_tracing_data, 398e9def1b2SDavid Carrillo-Cisneros .feature = perf_event__process_feature, 3990a8cb85cSJiri Olsa .ordered_events = true, 400d20deb64SArnaldo Carvalho de Melo .ordering_requires_timestamps = true, 401d20deb64SArnaldo Carvalho de Melo }, 402d20deb64SArnaldo Carvalho de Melo }; 4038ceb41d7SJiri Olsa struct perf_data data = { 404fa10f316SNamhyung Kim .mode = PERF_DATA_MODE_READ, 405fa10f316SNamhyung Kim }; 4061ac39372STaeung Song struct option options[] = { 40770cb4e96SFeng Tang OPT_STRING('i', "input", &input_name, "file", 40886470930SIngo Molnar "input file name"), 409ac73c5a9SArnaldo Carvalho de Melo OPT_STRING('d', "dsos", &symbol_conf.dso_list_str, "dso[,dso...]", 410ac73c5a9SArnaldo Carvalho de Melo "only consider symbols in these dsos"), 4117009cc34SArnaldo Carvalho de Melo OPT_STRING('s', "symbol", &annotate.sym_hist_filter, "symbol", 41286470930SIngo Molnar "symbol to annotate"), 4138ceb41d7SJiri Olsa OPT_BOOLEAN('f', "force", &data.force, "don't complain, do it"), 414c0555642SIan Munsie OPT_INCR('v', "verbose", &verbose, 41586470930SIngo Molnar "be more verbose (show symbol address, etc)"), 416eddaef88SNamhyung Kim OPT_BOOLEAN('q', "quiet", &quiet, "do now show any message"), 41786470930SIngo Molnar OPT_BOOLEAN('D', "dump-raw-trace", &dump_trace, 41886470930SIngo Molnar "dump raw trace in ASCII"), 4192b676bf0SNamhyung Kim OPT_BOOLEAN(0, "gtk", &annotate.use_gtk, "Use the GTK interface"), 4207009cc34SArnaldo Carvalho de Melo OPT_BOOLEAN(0, "tui", &annotate.use_tui, "Use the TUI interface"), 4217009cc34SArnaldo Carvalho de Melo OPT_BOOLEAN(0, "stdio", &annotate.use_stdio, "Use the stdio interface"), 422b32d133aSArnaldo Carvalho de Melo OPT_STRING('k', "vmlinux", &symbol_conf.vmlinux_name, 423b32d133aSArnaldo Carvalho de Melo "file", "vmlinux pathname"), 424b32d133aSArnaldo Carvalho de Melo OPT_BOOLEAN('m', "modules", &symbol_conf.use_modules, 42542976487SMike Galbraith "load module symbols - WARNING: use only with -k and LIVE kernel"), 4267009cc34SArnaldo Carvalho de Melo OPT_BOOLEAN('l', "print-line", &annotate.print_line, 427301406b9SFrederic Weisbecker "print matching source lines (may be slow)"), 4287009cc34SArnaldo Carvalho de Melo OPT_BOOLEAN('P', "full-paths", &annotate.full_paths, 42942976487SMike Galbraith "Don't shorten the displayed pathnames"), 43018c9e5c5SNamhyung Kim OPT_BOOLEAN(0, "skip-missing", &annotate.skip_missing, 43118c9e5c5SNamhyung Kim "Skip symbols that cannot be annotated"), 432c8e66720SDavid Ahern OPT_STRING('C', "cpu", &annotate.cpu_list, "cpu", "list of cpus to profile"), 433a7066709SHe Kuang OPT_CALLBACK(0, "symfs", NULL, "directory", 434a7066709SHe Kuang "Look for files with symbols relative to this directory", 435a7066709SHe Kuang symbol__config_symfs), 43664c6f0c7SArnaldo Carvalho de Melo OPT_BOOLEAN(0, "source", &symbol_conf.annotate_src, 4373e6a2a7fSStephane Eranian "Interleave source code with assembly code (default)"), 43864c6f0c7SArnaldo Carvalho de Melo OPT_BOOLEAN(0, "asm-raw", &symbol_conf.annotate_asm_raw, 4393e6a2a7fSStephane Eranian "Display raw encoding of assembly instructions (default)"), 440f69b64f7SAndi Kleen OPT_STRING('M', "disassembler-style", &disassembler_style, "disassembler style", 441f69b64f7SAndi Kleen "Specify disassembler style (e.g. -M intel for intel syntax)"), 4427a4ec938SMaciek Borzecki OPT_STRING(0, "objdump", &objdump_path, "path", 4437a4ec938SMaciek Borzecki "objdump binary to use for disassembly and annotations"), 444b1dd4432SNamhyung Kim OPT_BOOLEAN(0, "group", &symbol_conf.event_group, 445b1dd4432SNamhyung Kim "Show event group information together"), 4460c4a5bceSMartin Liška OPT_BOOLEAN(0, "show-total-period", &symbol_conf.show_total_period, 4470c4a5bceSMartin Liška "Show a column with the sum of periods"), 4481ac39372STaeung Song OPT_BOOLEAN('n', "show-nr-samples", &symbol_conf.show_nr_samples, 4491ac39372STaeung Song "Show a column with the number of samples"), 45053fe4ba1SArnaldo Carvalho de Melo OPT_CALLBACK_DEFAULT(0, "stdio-color", NULL, "mode", 45153fe4ba1SArnaldo Carvalho de Melo "'always' (default), 'never' or 'auto' only applicable to --stdio mode", 45253fe4ba1SArnaldo Carvalho de Melo stdio__config_color, "always"), 45386470930SIngo Molnar OPT_END() 45486470930SIngo Molnar }; 4551ac39372STaeung Song int ret; 456a635fc51SArnaldo Carvalho de Melo 4571ac39372STaeung Song set_option_flag(options, 0, "show-total-period", PARSE_OPT_EXCLUSIVE); 4581ac39372STaeung Song set_option_flag(options, 0, "show-nr-samples", PARSE_OPT_EXCLUSIVE); 4591ac39372STaeung Song 4601ac39372STaeung Song 4611ac39372STaeung Song ret = hists__init(); 462a635fc51SArnaldo Carvalho de Melo if (ret < 0) 463a635fc51SArnaldo Carvalho de Melo return ret; 46486470930SIngo Molnar 465655000e7SArnaldo Carvalho de Melo argc = parse_options(argc, argv, options, annotate_usage, 0); 46650e19ef9SNamhyung Kim if (argc) { 46750e19ef9SNamhyung Kim /* 46850e19ef9SNamhyung Kim * Special case: if there's an argument left then assume that 46950e19ef9SNamhyung Kim * it's a symbol filter: 47050e19ef9SNamhyung Kim */ 47150e19ef9SNamhyung Kim if (argc > 1) 47250e19ef9SNamhyung Kim usage_with_options(annotate_usage, options); 47350e19ef9SNamhyung Kim 47450e19ef9SNamhyung Kim annotate.sym_hist_filter = argv[0]; 47550e19ef9SNamhyung Kim } 476655000e7SArnaldo Carvalho de Melo 4779cef4b0bSTaeung Song if (symbol_conf.show_nr_samples && annotate.use_gtk) { 4789cef4b0bSTaeung Song pr_err("--show-nr-samples is not available in --gtk mode at this time\n"); 4791ac39372STaeung Song return ret; 4801ac39372STaeung Song } 4811ac39372STaeung Song 482eddaef88SNamhyung Kim if (quiet) 483eddaef88SNamhyung Kim perf_quiet_option(); 484eddaef88SNamhyung Kim 485eae8ad80SJiri Olsa data.file.path = input_name; 48644848cdbSMartin Liška 4878ceb41d7SJiri Olsa annotate.session = perf_session__new(&data, false, &annotate.tool); 488fa10f316SNamhyung Kim if (annotate.session == NULL) 48952e02834STaeung Song return -1; 490fa10f316SNamhyung Kim 491b01141f4SArnaldo Carvalho de Melo ret = symbol__annotation_init(); 492b01141f4SArnaldo Carvalho de Melo if (ret < 0) 493b01141f4SArnaldo Carvalho de Melo goto out_delete; 494b01141f4SArnaldo Carvalho de Melo 49575be6cf4SArnaldo Carvalho de Melo symbol_conf.try_vmlinux_path = true; 49675be6cf4SArnaldo Carvalho de Melo 4970a7e6d1bSNamhyung Kim ret = symbol__init(&annotate.session->header.env); 498fa10f316SNamhyung Kim if (ret < 0) 499fa10f316SNamhyung Kim goto out_delete; 50086470930SIngo Molnar 50140184c46SNamhyung Kim if (setup_sorting(NULL) < 0) 50255309985SNamhyung Kim usage_with_options(annotate_usage, options); 50386470930SIngo Molnar 5043df668e7SNamhyung Kim if (annotate.use_stdio) 5053df668e7SNamhyung Kim use_browser = 0; 5063df668e7SNamhyung Kim else if (annotate.use_tui) 5073df668e7SNamhyung Kim use_browser = 1; 5083df668e7SNamhyung Kim else if (annotate.use_gtk) 5093df668e7SNamhyung Kim use_browser = 2; 5103df668e7SNamhyung Kim 5113df668e7SNamhyung Kim setup_browser(true); 5123df668e7SNamhyung Kim 513fa10f316SNamhyung Kim ret = __cmd_annotate(&annotate); 514fa10f316SNamhyung Kim 515fa10f316SNamhyung Kim out_delete: 516fa10f316SNamhyung Kim /* 517fa10f316SNamhyung Kim * Speed up the exit process, for large files this can 518fa10f316SNamhyung Kim * take quite a while. 519fa10f316SNamhyung Kim * 520fa10f316SNamhyung Kim * XXX Enable this when using valgrind or if we ever 521fa10f316SNamhyung Kim * librarize this command. 522fa10f316SNamhyung Kim * 523fa10f316SNamhyung Kim * Also experiment with obstacks to see how much speed 524fa10f316SNamhyung Kim * up we'll get here. 525fa10f316SNamhyung Kim * 526fa10f316SNamhyung Kim * perf_session__delete(session); 527fa10f316SNamhyung Kim */ 528fa10f316SNamhyung Kim return ret; 52986470930SIngo Molnar } 530