Skip to contentSkip to conversation

perf_counter tools: Prepare for 'perf annotate'

tip:perfcounters/core tip-bot for Ingo Molnar 1 participant 1 message Jun 6, 2009 Documentation

lore
Share & tools
lore
#0 lore raw
Commit-ID:  8035e4288078cb806e7dd6bafe4d3e54d44cab3f
Gitweb:     http://git.kernel.org/tip/8035e4288078cb806e7dd6bafe4d3e54d44cab3f
Author:     Ingo Molnar <[email protected]>
AuthorDate: Sat, 6 Jun 2009 15:19:13 +0200
Committer:  Ingo Molnar <[email protected]>
CommitDate: Sat, 6 Jun 2009 18:58:30 +0200

perf_counter tools: Prepare for 'perf annotate'

Prepare for the 'perf annotate' implementation by splitting off builtin-annotate.c from builtin-report.c.

( We keep this commit separate to ease the later librarization
of the facilities that perf-report and perf-annotate shares. )

Cc: Peter Zijlstra <[email protected]>
Cc: Mike Galbraith <[email protected]>
Cc: Paul Mackerras <[email protected]>
Cc: Arnaldo Carvalho de Melo <[email protected]>
LKML-Reference: <new-submission>

---
 .../perf_counter/Documentation/perf-annotate.txt   |   26 +
 Documentation/perf_counter/Makefile                |    3 +-
 Documentation/perf_counter/builtin-annotate.c      | 1291 ++++++++++++++++++++
 Documentation/perf_counter/builtin.h               |    1 +
 Documentation/perf_counter/command-list.txt        |    3 +-
 Documentation/perf_counter/perf.c                  |    3 +
 6 files changed, 1325 insertions(+), 2 deletions(-)
Documentation/perf_counter/Documentation/perf-annotate.txt new file +26 -0
new file mode 100644
index 0000000..a9d6d5e
@@ -0,0 +1,26 @@
+perf-annotate(1)
+==============
+
+NAME
+----
+perf-annotate - Read perf.data (created by perf record) and annotate functions
+
+SYNOPSIS
+--------
+[verse]
+'perf annotate' [-i <file> | --input=file] symbol_name
+
+DESCRIPTION
+-----------
+This command displays the performance counter profile information recorded
+via perf record.
+
+OPTIONS
+-------
+-i::
+--input=::
+        Input file name. (default: perf.data)
+
+SEE ALSO
+--------
+linkperf:perf-record[1]
Documentation/perf_counter/Makefile +2 -1
index 32c0bb2..0cbd5d6 100644
@@ -323,12 +323,13 @@ LIB_OBJS += util/symbol.o
 LIB_OBJS += util/color.o
 LIB_OBJS += util/pager.o
 
+BUILTIN_OBJS += builtin-annotate.o
 BUILTIN_OBJS += builtin-help.o
+BUILTIN_OBJS += builtin-list.o
 BUILTIN_OBJS += builtin-record.o
 BUILTIN_OBJS += builtin-report.o
 BUILTIN_OBJS += builtin-stat.o
 BUILTIN_OBJS += builtin-top.o
-BUILTIN_OBJS += builtin-list.o
 
 PERFLIBS = $(LIB_FILE)
 EXTLIBS =
Documentation/perf_counter/builtin-annotate.c new file +1291 -0

1,291 lines not on this page · raw message

Documentation/perf_counter/builtin.h +1 -0
index e7de47d..51d1682 100644
@@ -14,6 +14,7 @@ extern void prune_packed_objects(int);
 extern int read_line_with_nul(char *buf, int size, FILE *file);
 extern int check_pager_config(const char *cmd);
 
+extern int cmd_annotate(int argc, const char **argv, const char *prefix);
 extern int cmd_help(int argc, const char **argv, const char *prefix);
 extern int cmd_record(int argc, const char **argv, const char *prefix);
 extern int cmd_report(int argc, const char **argv, const char *prefix);
Documentation/perf_counter/command-list.txt +2 -1
index f0b922c..eebce30 100644
@@ -2,8 +2,9 @@
 # List of known perf commands.
 # command name			category [deprecated] [common]
 #
+perf-annotate			mainporcelain common
+perf-list			mainporcelain common
 perf-record			mainporcelain common
 perf-report			mainporcelain common
 perf-stat			mainporcelain common
 perf-top			mainporcelain common
-perf-list			mainporcelain common
Documentation/perf_counter/perf.c +3 -0
index 161824f..4eb7259 100644
@@ -263,6 +263,7 @@ static void handle_internal_command(int argc, const char **argv)
 		{ "report", cmd_report, 0 },
 		{ "stat", cmd_stat, 0 },
 		{ "top", cmd_top, 0 },
+		{ "annotate", cmd_annotate, 0 },
 		{ "version", cmd_version, 0 },
 	};
 	int i;
@@ -402,9 +403,11 @@ int main(int argc, const char **argv)
 	while (1) {
 		static int done_help = 0;
 		static int was_alias = 0;
+
 		was_alias = run_argv(&argc, &argv);
 		if (errno != ENOENT)
 			break;
+
 		if (was_alias) {
 			fprintf(stderr, "Expansion of alias '%s' failed; "
 				"'%s' is not a perf-command\n",