summarylogtreecommitdiffstats
path: root/01_add_cpufreq-aperf_manpage.patch
blob: 4764dbe1b91f09baad3b414bd381a82d50d41919 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
Add a manpage mostly taken from the source code comments and
the command help output.

Index: cpufrequtils/man/cpufreq-aperf.1
===================================================================
--- /dev/null	1970-01-01 00:00:00.000000000 +0000
+++ cpufrequtils/man/cpufreq-aperf.1	2012-05-06 13:29:37.943624564 +0900
@@ -0,0 +1,44 @@
+.TH "cpufreq-aperf" "1" "0.1" "Mattia Dongili" ""
+.SH "NAME"
+.LP
+cpufreq\-aperf \- Calculates the average frequency over a time period
+.SH "SYNTAX"
+.LP
+cpufreq\-aperf [\fIoptions\fP]
+.SH "DESCRIPTION"
+.LP
+On latest processors exist two MSR registers refered to as:
+  - MPERF increasing with maxium (P0) frequency in C0
+  - APERF increasing with current/actual frequency in C0
+
+From this information the average frequency over a time period can be
+calculated and this is what this tool does.
+
+A nice falloff feature beside the average frequency is the time
+a processor core remained in C0 (working state) or any CX (sleep state)
+processor sleep state during the measured time period. This information
+can be determined from the fact that MPERF only increases in C0 state.
+.SH "OPTIONS"
+.LP
+.TP
+\fB\-c\fR \fB\-\-cpu\fR <\fICPU\fP>
+ The <\fICPU\fP> core to measure - default all cores.
+.TP
+\fB\-i\fR \fB\-\-interval\fR <\fIseconds\fP>
+Refresh rate - default 1 second.
+.TP
+\fB\-o\fR \fB\-\-once\fR
+Exit after one interval.
+.TP
+\fB\-h\fR \fB\-\-help\fR
+Prints the available options.
+.SH "REMARKS"
+.LP
+The msr driver must be loaded for this command to work.
+.SH "AUTHORS"
+.nf
+Thomas Renninger <trenn@suse.de>
+.fi
+.SH "SEE ALSO"
+.LP
+cpufreq\-set(1), cpufreq\-info(1)
Index: cpufrequtils/man/cpufreq-info.1
===================================================================
--- cpufrequtils.orig/man/cpufreq-info.1	2012-05-06 11:56:21.215806103 +0900
+++ cpufrequtils/man/cpufreq-info.1	2012-05-06 13:29:37.943624564 +0900
@@ -73,4 +73,4 @@
 .fi
 .SH "SEE ALSO"
 .LP 
-cpufreq\-set(1)
+cpufreq\-set(1), cpufreq-aperf(1)
Index: cpufrequtils/man/cpufreq-set.1
===================================================================
--- cpufrequtils.orig/man/cpufreq-set.1	2012-05-06 11:56:21.215806103 +0900
+++ cpufrequtils/man/cpufreq-set.1	2012-05-06 13:29:37.943624564 +0900
@@ -53,4 +53,4 @@
 .fi
 .SH "SEE ALSO"
 .LP 
-cpufreq\-info(1)
+cpufreq\-info(1), cpufreq-aperf(1)
Index: cpufrequtils/Makefile
===================================================================
--- cpufrequtils.orig/Makefile	2012-05-06 11:56:21.215806103 +0900
+++ cpufrequtils/Makefile	2012-05-06 13:29:37.943624564 +0900
@@ -248,6 +248,7 @@
 install-man:
 	$(INSTALL_DATA) -D man/cpufreq-set.1 $(DESTDIR)${mandir}/man1/cpufreq-set.1
 	$(INSTALL_DATA) -D man/cpufreq-info.1 $(DESTDIR)${mandir}/man1/cpufreq-info.1
+	$(INSTALL_DATA) -D man/cpufreq-aperf.1 $(DESTDIR)${mandir}/man1/cpufreq-aperf.1
 
 install-gmo:
 	$(INSTALL) -d $(DESTDIR)${localedir}
@@ -270,6 +271,7 @@
 	- rm -f $(DESTDIR)${bindir}/cpufreq-aperf
 	- rm -f $(DESTDIR)${mandir}/man1/cpufreq-set.1
 	- rm -f $(DESTDIR)${mandir}/man1/cpufreq-info.1
+	- rm -f $(DESTDIR)${mandir}/man1/cpufreq-aperf.1
 	- for HLANG in $(LANGUAGES); do \
 		rm -f $(DESTDIR)${localedir}/$$HLANG/LC_MESSAGES/cpufrequtils.mo; \
 	  done;