Tizen 2.1 base
[external/powertop.git] / doc / powertop.8
1 .TH POWERTOP 8 "June 1, 2012" "Linux" "powertop manual"
2 .SH NAME
3 powertop \- a power consumption and power management diagnosis tool.
4 .SH SYNOPSIS
5 .B powertop
6 .RB [
7 .IR options
8 .RB ]
9 .SH DESCRIPTION
10 .P
11 \fBpowertop\fP is a program that helps to diagnose various issues with power consumption
12 and power management. It also has an interactive mode allowing one to
13 experiment with various power management settings. When invoking powertop
14 without arguments powertop starts in interactive mode.
15 .SH OPTIONS
16 .TP
17 \fB\-\-calibrate
18 runs powertop in calibration mode. When running on battery, powertop
19 can track power consumption as well as system activity. When there
20 are enough measurements, powertop can start to report power estimates. One
21 can get more accurate estimates by using this option to enable a
22 calibration cycle. This will cycle through various display levels and USB
23 device activities and workloads.
24 .TP
25 \fB\-\-csv[\fR=\fIFILENAME\fR]
26 generate a CSV report. If a filename is not specified then the
27 default name "powertop.csv" is used. The CSV report can be
28 used for reporting and data analysis.
29 .TP
30 \fB\-\-debug
31  run in "debug" mode.
32 .TP
33 \fB\-\-extech\fR=\fIdevnode\fR
34 use the Extech Power Analyzer for measurements. This allows one to
35 specify the serial device node of the serial to USB adaptor connecting to
36 the Extech Power Analyzer, for example /dev/ttyUSB0.
37 .TP
38 \fB\-\-help
39  show the help message.
40 .TP
41 \fB\-\-html[\fR=\fIFILENAME\fR]
42 generate an HTML report. If a filename is not specified then the
43 default name "powertop.html" is used. The HTML report can be
44 sent to others to help diagnose power issues.
45 .TP
46 \fB\-\-iteration[\fR=\fIiterations\fR]
47 number of times to run each test.
48 .TP
49 \fB\-\-quiet
50  supress stderr output.
51 .TP
52 \fB\-\-time[\fR=\fIseconds\fR]
53 generate a report for a specified number of seconds.
54 .TP
55 \fB\-\-version
56 print version information and exit.
57 .SH BUGS
58 Send bug reports to <powertop@lists.01.org>
59 .SH SEE ALSO
60 The program is more fully described at https://01.org/powertop
61 .SH AUTHOR
62 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>.