perf_counter tools: Make source code headers more coherent
Commit-ID: bf9e187637ca3d85cee7407e3af93995868cc87c Gitweb: http://git.kernel.org/tip/bf9e187637ca3d85cee7407e3af93995868cc87c Author: Ingo Molnar <[email protected]> AuthorDate: Tue, 2 Jun 2009 23:37:05 +0200 Committer: Ingo Molnar <[email protected]> CommitDate: Tue, 2 Jun 2009 23:37:05 +0200
perf_counter tools: Make source code headers more coherent
The perf commands had different ways of describing themselves, introduce a coherent command-file-header format taken from the Git project.
Cc: Peter Zijlstra <[email protected]>
Cc: Mike Galbraith <[email protected]>
Cc: Paul Mackerras <[email protected]>
Cc: Corey Ashford <[email protected]>
Cc: Marcelo Tosatti <[email protected]>
Cc: Arnaldo Carvalho de Melo <[email protected]>
Cc: Thomas Gleixner <[email protected]>
Cc: John Kacur <[email protected]>
LKML-Reference: <new-submission>
Signed-off-by Ingo Molnar <[email protected]>
--- Documentation/perf_counter/builtin-record.c | 11 ++++- Documentation/perf_counter/builtin-report.c | 10 ++++- Documentation/perf_counter/builtin-stat.c | 29 ++++++++----- Documentation/perf_counter/builtin-top.c | 60 ++++++++------------------- Documentation/perf_counter/perf.c | 9 ++++ 5 files changed, 62 insertions(+), 57 deletions(-)
Documentation/perf_counter/builtin-record.c +8 -3
@@ -1,9 +1,14 @@/* -* perf record: Record the profile of a workload (or a CPU, or a PID) into -* the perf.data output file - for later analysis via perf report. +* builtin-record.c +* +* Builtin record command: Record the profile of a workload +* (or a CPU, or a PID) into the perf.data output file - for +* later analysis via perf report. */ -#include "perf.h" #include "builtin.h" + +#include "perf.h" +#include "util/util.h" #include "util/parse-options.h" #include "util/parse-events.h"
Documentation/perf_counter/builtin-report.c +9 -1
@@ -1,6 +1,14 @@ -#include "util/util.h" +/* +* builtin-report.c +* +* Builtin report command: Analyze the perf.data input file, +* look up and read DSOs and symbol information and display +* a histogram of results, along various sorting keys. +*/ #include "builtin.h" +#include "util/util.h" +#include "util/list.h" #include "util/cache.h" #include "util/rbtree.h"
Documentation/perf_counter/builtin-stat.c +18 -11
@@ -1,20 +1,27 @@/* -* perf stat: /usr/bin/time -alike performance counter statistics utility +* builtin-stat.c +* +* Builtin stat command: Give a precise performance counters summary +* overview about any workload, CPU or specific PID. +* +* Sample output: -It summarizes the counter events of all tasks (and child tasks), -covering all CPUs that the command (or workload) executes on. -It only counts the per-task events of the workload started, -independent of how many other tasks run on those CPUs. +$ perf stat ~/hackbench 10 +Time: 0.104 -Sample output: +Performance counter stats for '/home/mingo/hackbench': -$ perf stat -e 1 -e 3 -e 5 ls -lR /usr/include/ >/dev/null +1255.538611 task clock ticks # 10.143 CPU utilization factor +54011 context switches # 0.043 M/sec +385 CPU migrations # 0.000 M/sec +17755 pagefaults # 0.014 M/sec +3808323185 CPU cycles # 3033.219 M/sec +1575111190 instructions # 1254.530 M/sec +17367895 cache references # 13.833 M/sec +7674421 cache misses # 6.112 M/sec -Performance counter stats for 'ls': +Wall-clock time elapsed: 123.786620 msecs -163516953 instructions -2295 cache-misses -2855182 branch-misses * * Copyright (C) 2008, Red Hat Inc, Ingo Molnar <[email protected]> *
Documentation/perf_counter/builtin-top.c +18 -42
67 lines not on this page · raw message
Documentation/perf_counter/perf.c +9 -0
@@ -1,4 +1,13 @@ +/* +* perf.c +* +* Performance analysis utility. +* +* This is the main hub from which the sub-commands (perf stat, +* perf top, perf record, perf report, etc.) are started. +*/ #include "builtin.h" +#include "util/exec_cmd.h" #include "util/cache.h" #include "util/quote.h"