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;
|