2 * perf stat: /usr/bin/time -alike performance counter statistics utility
4 It summarizes the counter events of all tasks (and child tasks),
5 covering all CPUs that the command (or workload) executes on.
6 It only counts the per-task events of the workload started,
7 independent of how many other tasks run on those CPUs.
11 $ perf stat -e 1 -e 3 -e 5 ls -lR /usr/include/ >/dev/null
13 Performance counter stats for 'ls':
15 163516953 instructions
19 * Copyright (C) 2008, Red Hat Inc, Ingo Molnar <mingo@redhat.com>
21 * Improvements and fixes by:
23 * Arjan van de Ven <arjan@linux.intel.com>
24 * Yanmin Zhang <yanmin.zhang@intel.com>
25 * Wu Fengguang <fengguang.wu@intel.com>
26 * Mike Galbraith <efault@gmx.de>
27 * Paul Mackerras <paulus@samba.org>
29 * Released under the GPL v2. (and only v2, not any later version)
34 #include "util/util.h"
35 #include "util/parse-options.h"
36 #include "util/parse-events.h"
38 #include <sys/prctl.h>
40 static int system_wide
= 0;
41 static int inherit
= 1;
43 static __u64 default_event_id
[MAX_COUNTERS
] = {
44 EID(PERF_TYPE_SOFTWARE
, PERF_COUNT_TASK_CLOCK
),
45 EID(PERF_TYPE_SOFTWARE
, PERF_COUNT_CONTEXT_SWITCHES
),
46 EID(PERF_TYPE_SOFTWARE
, PERF_COUNT_CPU_MIGRATIONS
),
47 EID(PERF_TYPE_SOFTWARE
, PERF_COUNT_PAGE_FAULTS
),
49 EID(PERF_TYPE_HARDWARE
, PERF_COUNT_CPU_CYCLES
),
50 EID(PERF_TYPE_HARDWARE
, PERF_COUNT_INSTRUCTIONS
),
51 EID(PERF_TYPE_HARDWARE
, PERF_COUNT_CACHE_REFERENCES
),
52 EID(PERF_TYPE_HARDWARE
, PERF_COUNT_CACHE_MISSES
),
55 static int default_interval
= 100000;
56 static int event_count
[MAX_COUNTERS
];
57 static int fd
[MAX_NR_CPUS
][MAX_COUNTERS
];
59 static int target_pid
= -1;
60 static int nr_cpus
= 0;
61 static unsigned int page_size
;
65 static const unsigned int default_count
[] = {
74 static void create_perfstat_counter(int counter
)
76 struct perf_counter_hw_event hw_event
;
78 memset(&hw_event
, 0, sizeof(hw_event
));
79 hw_event
.config
= event_id
[counter
];
80 hw_event
.record_type
= 0;
82 hw_event
.exclude_kernel
= event_mask
[counter
] & EVENT_MASK_KERNEL
;
83 hw_event
.exclude_user
= event_mask
[counter
] & EVENT_MASK_USER
;
86 hw_event
.read_format
= PERF_FORMAT_TOTAL_TIME_ENABLED
|
87 PERF_FORMAT_TOTAL_TIME_RUNNING
;
91 for (cpu
= 0; cpu
< nr_cpus
; cpu
++) {
92 fd
[cpu
][counter
] = sys_perf_counter_open(&hw_event
, -1, cpu
, -1, 0);
93 if (fd
[cpu
][counter
] < 0) {
94 printf("perfstat error: syscall returned with %d (%s)\n",
95 fd
[cpu
][counter
], strerror(errno
));
100 hw_event
.inherit
= inherit
;
101 hw_event
.disabled
= 1;
103 fd
[0][counter
] = sys_perf_counter_open(&hw_event
, 0, -1, -1, 0);
104 if (fd
[0][counter
] < 0) {
105 printf("perfstat error: syscall returned with %d (%s)\n",
106 fd
[0][counter
], strerror(errno
));
112 static int do_perfstat(int argc
, const char **argv
)
114 unsigned long long t0
, t1
;
123 for (counter
= 0; counter
< nr_counters
; counter
++)
124 create_perfstat_counter(counter
);
127 * Enable counters and exec the command:
130 prctl(PR_TASK_PERF_COUNTERS_ENABLE
);
132 if ((pid
= fork()) < 0)
133 perror("failed to fork");
135 if (execvp(argv
[0], (char **)argv
)) {
140 while (wait(&status
) >= 0)
142 prctl(PR_TASK_PERF_COUNTERS_DISABLE
);
147 fprintf(stderr
, "\n");
148 fprintf(stderr
, " Performance counter stats for \'%s\':\n",
150 fprintf(stderr
, "\n");
152 for (counter
= 0; counter
< nr_counters
; counter
++) {
154 __u64 count
[3], single_count
[3];
157 count
[0] = count
[1] = count
[2] = 0;
159 for (cpu
= 0; cpu
< nr_cpus
; cpu
++) {
160 res
= read(fd
[cpu
][counter
],
161 single_count
, nv
* sizeof(__u64
));
162 assert(res
== nv
* sizeof(__u64
));
164 count
[0] += single_count
[0];
166 count
[1] += single_count
[1];
167 count
[2] += single_count
[2];
174 fprintf(stderr
, " %14s %-20s\n",
175 "<not counted>", event_name(counter
));
178 if (count
[2] < count
[1]) {
180 count
[0] = (unsigned long long)
181 ((double)count
[0] * count
[1] / count
[2] + 0.5);
185 if (event_id
[counter
] == EID(PERF_TYPE_SOFTWARE
, PERF_COUNT_CPU_CLOCK
) ||
186 event_id
[counter
] == EID(PERF_TYPE_SOFTWARE
, PERF_COUNT_TASK_CLOCK
)) {
188 double msecs
= (double)count
[0] / 1000000;
190 fprintf(stderr
, " %14.6f %-20s (msecs)",
191 msecs
, event_name(counter
));
193 fprintf(stderr
, " %14Ld %-20s (events)",
194 count
[0], event_name(counter
));
197 fprintf(stderr
, " (scaled from %.2f%%)",
198 (double) count
[2] / count
[1] * 100);
199 fprintf(stderr
, "\n");
201 fprintf(stderr
, "\n");
202 fprintf(stderr
, " Wall-clock time elapsed: %12.6f msecs\n",
203 (double)(t1
-t0
)/1e6
);
204 fprintf(stderr
, "\n");
209 static void skip_signal(int signo
)
213 static const char * const stat_usage
[] = {
214 "perf stat [<options>] <command>",
215 "perf stat [<options>] -- <command> [<options>]",
219 static char events_help_msg
[EVENTS_HELP_MAX
];
221 static const struct option options
[] = {
222 OPT_CALLBACK('e', "event", NULL
, "event",
223 events_help_msg
, parse_events
),
224 OPT_INTEGER('c', "count", &default_interval
,
225 "event period to sample"),
226 OPT_BOOLEAN('i', "inherit", &inherit
,
227 "child tasks inherit counters"),
228 OPT_INTEGER('p', "pid", &target_pid
,
229 "stat events on existing pid"),
230 OPT_BOOLEAN('a', "all-cpus", &system_wide
,
231 "system-wide collection from all CPUs"),
232 OPT_BOOLEAN('l', "scale", &scale
,
233 "scale/normalize counters"),
237 int cmd_stat(int argc
, const char **argv
, const char *prefix
)
241 page_size
= sysconf(_SC_PAGE_SIZE
);
243 create_events_help(events_help_msg
);
244 memcpy(event_id
, default_event_id
, sizeof(default_event_id
));
246 argc
= parse_options(argc
, argv
, options
, stat_usage
, 0);
248 usage_with_options(stat_usage
, options
);
254 for (counter
= 0; counter
< nr_counters
; counter
++) {
255 if (event_count
[counter
])
258 event_count
[counter
] = default_interval
;
260 nr_cpus
= sysconf(_SC_NPROCESSORS_ONLN
);
261 assert(nr_cpus
<= MAX_NR_CPUS
);
262 assert(nr_cpus
>= 0);
265 * We dont want to block the signals - that would cause
266 * child tasks to inherit that and Ctrl-C would not work.
267 * What we want is for Ctrl-C to work in the exec()-ed
268 * task, but being ignored by perf stat itself:
270 signal(SIGINT
, skip_signal
);
271 signal(SIGALRM
, skip_signal
);
272 signal(SIGABRT
, skip_signal
);
274 return do_perfstat(argc
, argv
);