diff options
author | Colin Ian King <colin.king@canonical.com> | 2012-06-01 14:45:18 +0100 |
---|---|---|
committer | Chris E Ferron <chris.e.ferron@linux.intel.com> | 2012-06-01 10:08:09 -0700 |
commit | cf72aca038274ec3cab55fecbb50edb741de9086 (patch) | |
tree | b83e8e4ed32f3f2c43e1be536e2d51daa740c0d5 /doc | |
parent | 4a41fcd2054807a046ec0e80d6eb03960fda14ec (diff) |
Add powertop manual page
Powertop should really have a manual page to explain the options
in a little more detail rather than the user having to get the
source and read the README file.
Signed-off-by: Colin Ian King <colin.king@canonical.com>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/Makefile.am | 1 | ||||
-rw-r--r-- | doc/powertop.8 | 59 |
2 files changed, 60 insertions, 0 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am new file mode 100644 index 0000000..c5f5d7e --- /dev/null +++ b/doc/Makefile.am @@ -0,0 +1 @@ +man_MANS = powertop.8 diff --git a/doc/powertop.8 b/doc/powertop.8 new file mode 100644 index 0000000..e8ec5fd --- /dev/null +++ b/doc/powertop.8 @@ -0,0 +1,59 @@ +.TH POWERTOP 8 "June 1, 2012" "Linux" "powertop manual" +.SH NAME +powertop \- a power consumption and power management diagnosis tool. +.SH SYNOPSIS +.B powertop +.RB [ +.IR options +.RB ] +.SH DESCRIPTION +.P +\fBpowertop\fP is a program that helps to diagnose various issues with power consumption +and power management. It also has an interactive mode allowing one to +experiment with various power management settings. When invoking powertop +without arguments powertop starts in interactive mode. +.SH OPTIONS +.TP +\fB\-\-csv[\fR=\fIFILENAME\fR] +generate a CSV report. If a filename is not specified then the +default name "powertop.csv" is used. The CSV report can be +used for reporting and data analysis. +.TP +\fB\-\-calibrate +runs powertop in calibration mode. When running on battery, powertop +can track power consumption as well as system activity. When there +are enough measurements, powertop can start to report power estimates. One +can get more accurate estimates by using this option to enable a +calibration cycle. This will cycle through various display levesl and USB +device activities and workloads. +.TP +\fB\-\-debug + run in "debug" mode. +.TP +\fB\-\-extech\fR=\fIdevnode\fR +use the Extech Power Analyzer for measurements. This allows one to +specify the serial device node of the serial to USB adaptor connecting to +the Extech Power Analyzer, for example /dev/ttyUSB0. +.TP +\fB\-\-help + show the help message. +.TP +\fB\-\-html[\fR=\fIFILENAME\fR] +generate an HTML report. If a filename is not specified then the +default name "powertop.html" is used. The HTML report can be +sent to others to help diagnose power issues. +.TP +\fB\-\-iteration[\fR=\fIiterations\fR] +number of times to run each test. +.TP +\fB\-\-time[\fR=\fIseconds\fR] +generate a report for a specified number of seconds. +.TP +\fB\-\-version +print version information and exit. +.SH BUGS +Send bug reports to <powertop@lists.01.org> +.SH SEE ALSO +The program is more fully described at https://01.org/powertop +.SH AUTHOR +powertop was written by Arjan van de Ven <arjan@linux.intel.com>, and is currently maintained by Chris E Ferron <chris.e.ferron@linux.intel.com>. |