2 * (C) 2010,2011 Thomas Renninger <trenn@suse.de>, Novell Inc.
4 * Licensed under the terms of the GNU GPL License version 2.
6 * Output format inspired by Len Brown's <lenb@kernel.org> turbostat tool.
17 #include <sys/types.h>
21 #include "idle_monitor/cpupower-monitor.h"
22 #include "idle_monitor/idle_monitors.h"
23 #include "helpers/helpers.h"
25 /* Define pointers to all monitors. */
26 #define DEF(x) & x ## _monitor ,
27 struct cpuidle_monitor * all_monitors[] = {
28 #include "idle_monitors.def"
32 static struct cpuidle_monitor *monitors[MONITORS_MAX];
33 static unsigned int avail_monitors;
35 static char *progname;
37 enum operation_mode_e { list = 1, show, show_all };
39 static int interval = 1;
40 static char *show_monitors_param;
41 static struct cpupower_topology cpu_top;
43 /* ToDo: Document this in the manpage */
44 static char range_abbr[RANGE_MAX] = { 'T', 'C', 'P', 'M', };
46 long long timespec_diff_us(struct timespec start, struct timespec end)
49 if ((end.tv_nsec - start.tv_nsec) < 0) {
50 temp.tv_sec = end.tv_sec - start.tv_sec - 1;
51 temp.tv_nsec = 1000000000 + end.tv_nsec - start.tv_nsec;
53 temp.tv_sec = end.tv_sec - start.tv_sec;
54 temp.tv_nsec = end.tv_nsec - start.tv_nsec;
56 return (temp.tv_sec * 1000000) + (temp.tv_nsec / 1000);
59 void monitor_help(void)
61 printf(_("cpupower monitor: [-m <mon1>,[<mon2>],.. ] command\n"));
62 printf(_("cpupower monitor: [-m <mon1>,[<mon2>],.. ] [ -i interval_sec ]\n"));
63 printf(_("cpupower monitor: -l\n"));
64 printf(_("\t command: pass an arbitrary command to measure specific workload\n"));
65 printf(_("\t -i: time intervall to measure for in seconds (default 1)\n"));
66 printf(_("\t -l: list available CPU sleep monitors (for use with -m)\n"));
67 printf(_("\t -m: show specific CPU sleep monitors only (in same order)\n"));
68 printf(_("\t -h: print this help\n"));
70 printf(_("only one of: -l, -m are allowed\nIf none of them is passed,"));
71 printf(_(" all supported monitors are shown\n"));
74 void print_n_spaces(int n)
77 for (x = 0; x < n; x++)
81 /* size of s must be at least n + 1 */
82 int fill_string_with_spaces(char *s, int n)
87 for (; len < n; len++)
93 void print_header(int topology_depth)
96 int state, need_len, pr_mon_len;
99 int percent_width = 4;
101 fill_string_with_spaces(buf, topology_depth * 5 - 1);
104 for (mon = 0; mon < avail_monitors; mon++) {
106 need_len = monitors[mon]->hw_states_num * (percent_width + 3)
112 sprintf(buf, "%s", monitors[mon]->name);
113 fill_string_with_spaces(buf, need_len);
118 if (topology_depth > 2)
120 if (topology_depth > 1)
122 if (topology_depth > 0)
125 for (mon = 0; mon < avail_monitors; mon++) {
130 for (state = 0; state < monitors[mon]->hw_states_num; state++) {
133 s = monitors[mon]->hw_states[state];
134 sprintf(buf, "%s", s.name);
135 fill_string_with_spaces(buf, percent_width);
144 void print_results(int topology_depth, int cpu)
149 unsigned long long result;
152 if (topology_depth > 2)
153 printf("%4d|", cpu_top.core_info[cpu].pkg);
154 if (topology_depth > 1)
155 printf("%4d|", cpu_top.core_info[cpu].core);
156 if (topology_depth > 0)
157 printf("%4d|", cpu_top.core_info[cpu].cpu);
159 for (mon = 0; mon < avail_monitors; mon++) {
163 for (state = 0; state < monitors[mon]->hw_states_num; state++) {
167 s = monitors[mon]->hw_states[state];
169 if (s.get_count_percent) {
170 ret = s.get_count_percent(s.id, &percent,
171 cpu_top.core_info[cpu].cpu);
174 } else if (percent >= 100.0)
175 printf("%6.1f", percent);
177 printf("%6.2f", percent);
179 else if (s.get_count) {
180 ret = s.get_count(s.id, &result,
181 cpu_top.core_info[cpu].cpu);
185 printf("%6llu", result);
188 printf(_("Monitor %s, Counter %s has no count "
189 "function. Implementation error\n"),
190 monitors[mon]->name, s.name);
196 if (cpu_top.core_info[cpu].pkg == -1 ||
197 cpu_top.core_info[cpu].core == -1) {
198 printf(_(" *is offline\n"));
205 /* param: string passed by -m param (The list of monitors to show)
207 * Monitors must have been registered already, matching monitors
208 * are picked out and available monitors array is overridden
211 * Monitors get sorted in the same order the user passes them
214 static void parse_monitor_param(char* param)
218 char *tmp = param, *token;
219 struct cpuidle_monitor *tmp_mons[MONITORS_MAX];
222 for (mon = 0; mon < MONITORS_MAX;mon++, tmp = NULL) {
223 token = strtok(tmp, ",");
226 if (strlen(token) >= MONITOR_NAME_LEN) {
227 printf(_("%s: max monitor name length"
228 " (%d) exceeded\n"), token, MONITOR_NAME_LEN);
232 for (num = 0; num < avail_monitors; num++) {
233 if (!strcmp(monitors[num]->name, token)) {
234 dprint("Found requested monitor: %s\n", token);
235 tmp_mons[hits] = monitors[num];
241 printf(_("No matching monitor found in %s, "
242 "try -l option\n"), param);
246 /* Override detected/registerd monitors array with requested one */
247 memcpy(monitors, tmp_mons, sizeof(struct cpuidle_monitor*) * MONITORS_MAX);
248 avail_monitors = hits;
251 void list_monitors(void) {
256 for (mon = 0; mon < avail_monitors; mon++) {
257 printf(_("Monitor \"%s\" (%d states) - Might overflow after %u "
258 "s\n"), monitors[mon]->name, monitors[mon]->hw_states_num,
259 monitors[mon]->overflow_s);
261 for (state = 0; state < monitors[mon]->hw_states_num; state++) {
262 s = monitors[mon]->hw_states[state];
264 * ToDo show more state capabilities:
265 * percent, time (granlarity)
267 printf("%s\t[%c] -> %s\n", s.name, range_abbr[s.range],
273 int fork_it(char **argv)
277 unsigned long long timediff;
279 struct timespec start, end;
282 clock_gettime(CLOCK_REALTIME, &start);
284 for (num = 0; num < avail_monitors; num++)
285 monitors[num]->start();
289 execvp(argv[0], argv);
292 if (child_pid == -1) {
297 signal(SIGINT, SIG_IGN);
298 signal(SIGQUIT, SIG_IGN);
299 if (waitpid(child_pid, &status, 0) == -1) {
304 clock_gettime(CLOCK_REALTIME, &end);
305 for (num = 0; num < avail_monitors; num++)
306 monitors[num]->stop();
308 timediff = timespec_diff_us(start, end);
309 if (WIFEXITED(status))
310 printf(_("%s took %.5f seconds and exited with status %d\n"),
311 argv[0], timediff / (1000.0 * 1000), WEXITSTATUS(status));
315 int do_interval_measure(int i)
319 for (num = 0; num < avail_monitors; num++) {
320 dprint("HW C-state residency monitor: %s - States: %d\n",
321 monitors[num]->name, monitors[num]->hw_states_num);
322 monitors[num]->start();
325 for (num = 0; num < avail_monitors; num++) {
326 monitors[num]->stop();
331 static void cmdline(int argc, char *argv[])
334 progname = basename(argv[0]);
336 while ((opt = getopt(argc, argv, "+hli:m:")) != -1) {
349 /* only allow -i with -m or no option */
350 if (mode && mode != show) {
354 interval = atoi(optarg);
362 show_monitors_param = optarg;
373 int cmd_monitor(int argc, char **argv)
376 struct cpuidle_monitor *test_mon;
380 cpu_count = get_cpu_topology(&cpu_top);
382 printf(_("Cannot read number of available processors\n"));
386 dprint("System has up to %d CPU cores\n", cpu_count);
388 for (num = 0; all_monitors[num]; num++) {
389 dprint("Try to register: %s\n", all_monitors[num]->name);
390 test_mon = all_monitors[num]->do_register();
392 if (test_mon->needs_root && !run_as_root) {
393 fprintf(stderr, _("Available monitor %s needs "
394 "root access\n"), test_mon->name);
397 monitors[avail_monitors] = test_mon;
398 dprint("%s registered\n", all_monitors[num]->name);
403 if (avail_monitors == 0) {
404 printf(_("No HW Cstate monitors found\n"));
414 parse_monitor_param(show_monitors_param);
416 dprint("Packages: %d - Cores: %d - CPUs: %d\n",
417 cpu_top.pkgs, cpu_top.cores, cpu_count);
420 * if any params left, it must be a command to fork
423 fork_it(argv + optind);
425 do_interval_measure(interval);
427 /* ToDo: Topology parsing needs fixing first to do
428 this more generically */
429 if (cpu_top.pkgs > 1)
434 for (cpu = 0; cpu < cpu_count; cpu++) {
435 if (cpu_top.pkgs > 1)
436 print_results(3, cpu);
438 print_results(1, cpu);
441 for (num = 0; num < avail_monitors; num++) {
442 monitors[num]->unregister();
444 cpu_topology_release(cpu_top);