power/pm-graph/sleepgraph.8

3 sleepgraph \- Suspend/Resume timing analysis
21 Generates output files in subdirectory: suspend-yymmdd-HHMMSS
27 \fB-h\fR
30 \fB-v\fR
31 Print the current tool version.
33 \fB-verbose\fR
36 \fB-config \fIfile\fR
39 \fB-m \fImode\fR
42 \fB-o \fIname\fR
44 Use {date}, {time}, {hostname} for current values.
46 e.g. suspend-{hostname}-{date}-{time}
48 \fB-rtcwake \fIt\fR | off
50 disable rtcwake and require a user keypress to resume.
52 \fB-addlogs\fR
56 \fB-noturbostat\fR
61 \fB-result \fIfile\fR
64 \fB-sync\fR
68 \fB-rs \fIenable/disable\fR
69 During test, enable/disable runtime suspend for all devices. The test is delayed
73 \fB-display \fIon/off/standby/suspend\fR
77 \fB-wifi\fR
82 \fB-wifitrace\fR
87 \fB-gzip\fR
91 \fB-cmd \fIstr\fR
92 Run the timeline over a custom suspend command, e.g. pm-suspend. By default
93 the tool forces suspend via /sys/power/state so this allows testing over
97 \fB-filter \fI"d1,d2,..."\fR
101 \fB-mindev \fIt\fR
106 \fB-proc\fR
109 \fB-dev\fR
112 \fB-x2\fR
115 \fB-x2delay \fIt\fR
118 \fB-predelay \fIt\fR
121 \fB-postdelay \fIt\fR
124 \fB-multi \fIn d\fR
128 Execute tests continuously over \fIn\fR days, hours, or minutes at \fId\fR second intervals.
129 The outputs will be created in a new subdirectory, for count: suspend-{date}-{time}-xN,
130 for duration: suspend-{date}-{time}-Nm. When the multitest run is done, the \fI-summary\fR
132 use \fI-skiphtml\fR). \fI-skiphtml\fR will speed up the testing by not creating timelines
133 or summary html files. You can then run the tool again at a later time with \fI-summary\fR
134 and \fI-genhtml\fR to create the timelines.
136 \fB-maxfail \fIn\fR
137 Abort a -multi run after \fIn\fR consecutive fails. 0 means never abort (default = 0).
139 \fB-skiphtml\fR
141 You can generate the html timelines later with \fI-dmesg\fR & \fI-ftrace\fR, or
142 by running \fI-summary\fR and \fI-genhtml\fR.
146 \fB-f\fR
148 very large outputs, i.e. 10MB - 100MB.
150 \fB-ftop\fR
152 This option implies -f and creates a single callgraph covering all of suspend/resume.
154 \fB-maxdepth \fIlevel\fR
156 the best way to limit the output size when using callgraphs via -f.
158 \fB-expandcg\fR
159 pre-expand the callgraph data in the html output (default: disabled)
161 \fB-fadd \fIfile\fR
164 \fB-mincg \fIt\fR
170 \fB-cgfilter \fI"func1,func2,..."\fR
175 \fB-cgskip \fIfile\fR
176 Reduce callgraph timeline size by skipping over uninteresting functions
180 use "off" to disable completely (default: cgskip.txt)
182 \fB-cgphase \fIp\fR
185 \fB-cgtest \fIn\fR
188 \fB-timeprec \fIn\fR
191 \fB-bufsize \fIN\fR
192 Set trace buffer size to N kilo-bytes (default: all of free memory up to 3GB)
196 \fB-summary \fIindir\fR
198 Creates summary.html, summary-issues.html, and summary-devices.html in the current folder.
202 summary-issues.html is a list of kernel issues found in dmesg from all the tests.
203 summary-devices.html is a list of devices and times from all the tests.
205 Use \fI-genhtml\fR to regenerate any tests with missing html.
207 \fB-genhtml\fR
208 Used with \fI-summary\fR to regenerate any missing html timelines from their
212 \fB-modes\fR
215 \fB-status\fR
219 \fB-fpdt\fR
222 \fB-wificheck\fR
225 \fB-xon/-xoff/-xstandby/-xsuspend\fR
227 is the same command which will be issued by \fB-display \fImode\fR.
229 \fB-xstat\fR
230 Get the current DPMS display mode.
232 \fB-sysinfo\fR
235 \fB-devinfo\fR
238 \fB-cmdinfo\fR
241 \fB-flist\fR
243 that are not available as symbols in the current kernel are shown in red.
246 with -fadd they will also be checked.
248 \fB-flistall\fR
250 possible values you can add to trace via the -fadd argument.
253 \fB-ftrace \fIfile\fR
256 \fB-dmesg \fIfile\fR
263 \f(CW$ sleepgraph -modes\fR
267 \f(CW$ sudo sleepgraph -fpdt\fR
269 Print out the current USB power topology
271 \f(CW$ sleepgraph -usbtopo
275 \f(CW$ sudo sleepgraph -f -rtcwake 30 -status
279 \f(CW$ sleepgraph -summary ~/workspace/myresults/\fR
285 \f(CW$ sudo sleepgraph -rtcwake 15 -addlogs\fR
289 \f(CW$ sudo sleepgraph -m standby -rtcwake 15 -o "standby-{host}-{date}-{time}"\fR
293 \f(CW$ sudo sleepgraph -m freeze -rtcwake off -o "freeze-{hostname}-{date}-{time}"\fR
299 \f(CW$ sudo sleepgraph -m mem -rtcwake 15 -dev -mindev 5\fR
303 \f(CW$ sudo sleepgraph -m mem -rtcwake 15 -x2 -predelay 500 -x2delay 500 -postdelay 500\fR
307 \f(CW$ sudo sleepgraph -cmd "echo mem > /sys/power/state" -rtcwake 15\fR
310 .SS "endurance testing using -multi"
314 \f(CW$ sudo sleepgraph -m freeze -rtcwake 15 -multi 10 30\fR
318 \f(CW$ sudo sleepgraph -m freeze -rtcwake 15 -multi 24h 0\fR
323 \f(CW$ sudo sleepgraph -m mem -rtcwake 15 -f -maxdepth 5 -mincg 10\fR
327 \f(CW$ sudo sleepgraph -m mem -rtcwake 15 -f\fR
329 \f(CW$ sleepgraph -dmesg host_mem_dmesg.txt -ftrace host_mem_ftrace.txt -f -cgphase resume
336 \f(CW$ sleepgraph -dmesg dmesg.txt -ftrace ftrace.txt -callgraph\fR
340 \f(CW$ sleepgraph -dmesg dmesg.txt -ftrace ftrace.txt -addlogs -srgap\fR