cpupower/man/cpupower-monitor.1

1 .TH CPUPOWER\-MONITOR "1" "22/02/2011" "" "cpupower Manual"
3 cpupower\-monitor \- Report processor frequency and idle statistics
7 .RB "\-l"
10 .RB [ -c ] [ "\-m <mon1>," [ "<mon2>,..." ] ]
11 .RB [ "\-i seconds" ]
14 .RB [ -c ][ "\-m <mon1>," [ "<mon2>,..." ] ]
18 \fBcpupower-monitor \fP reports processor topology, frequency and idle power
19 state statistics. Either \fBcommand\fP is forked and
22 \fBcpupower-monitor \fP implements independent processor sleep state and
24 directly reading out hardware registers. Use \-l to get an overview which are
29 \-l
35 The name in quotation marks which can be passed to the \-m parameter.
46 [T] \-> Thread
48 [C] \-> Core
50 [P] \-> Processor Package (Socket)
52 [M] \-> Machine/Platform wide counter
57 \-m <mon1>,<mon2>,...
59 Only display specific monitors. Use the monitor string(s) provided by \-l option.
62 \-i seconds
67 \-c
74 -account its cpuidle (C-state) information before reading the
80 Measure idle and frequency characteristics of an arbitrary command/workload.
85 \-v
93 /sys/devices/system/cpu/cpu*/cpuidle/state*/.
94 The kernel updates these values every time an idle state is entered or
95 left. Therefore there can be some inaccuracy when cores are in an idle
96 state for some time when the measure starts or ends. In worst case it can happen
97 that one core stayed in an idle state for the whole measure time and the idle
98 state usage time as exported by the kernel did not get updated. In this case
99 a state residency of 0 percent is shown while it was 100.
105 The fact that on all recent hardware the mperf timer stops ticking in any idle
106 state it is also used to show C0 (processor is active) and Cx (processor is in
107 any sleep state) times. These counters do not have the inaccuracy restrictions
109 May work poorly on Linux-2.6.20 through 2.6.29, as the \fBacpi-cpufreq \fP
114 Intel Core and Package sleep state counters.
118 sleep states and can only be entered if all cores are idle. Look up Intel
120 The monitors are named after the CPU family where the sleep state capabilities
122 For example an IvyBridge processor has sleep state capabilities which got
125 state monitors.
126 HaswellExtended extra package sleep state capabilities are available only in a
130 AMD laptop and desktop processor (family 12h and 14h) sleep state counters.
136 power state got entered at least once during measure time.
137 Being able to enter NBP1 state also depends on graphics power management.
143 cpupower monitor -l" may show:
145 Monitor "Mperf" (3 states) \- Might overflow after 922000000 s
149 Monitor "Idle_Stats" (3 states) \- Might overflow after 4294967295 s
154 cpupower monitor \-m "Idle_Stats,Mperf" scp /tmp/test /nfs/tmp
168 shell script. Hit CTRL\-c to terminate the command and get the measure output
179 "Intel® 64 and IA-32 Architectures Software Developer's Manual
187 /sys/devices/system/cpu/cpu*/cpuidle/state*/.