1 .TH THERMOMETER 8
2 # SPDX-License-Identifier: GPL-2.0
3 .SH NAME
4 \fBthermometer\fP - A thermal profiling tool
5
6 .SH SYNOPSIS
7 .ft B
8 .B thermometer
9 .RB [ options ]
10 .RB [ command ]
11 .br
12 .SH DESCRIPTION
13 \fBthermometer \fP captures the thermal zones
14 specified sampling period. It is optimized to
15 possible the overhead while doing the temperat
16 to prevent disrupting the running application
17
18 This low overhead also allows a high rate samp
19 which could be necessary to spot overshots and
20
21 If no configuration file is specified, then al
22 be monitored at 4Hz, so every 250ms. A configu
23 the thermal zone names and the desired samplin
24 name can be a regular expression to specify a
25
26 The sampling of the different thermal zones wi
27 separate files with the thermal zone name. It
28 postfix to identify them for example for a spe
29 output directory can be specified in addition.
30
31 Without any parameters, \fBthermometer \fP cap
32 zone temperatures every 250ms and write to the
33 captured files postfixed with the current date
34
35 If a running \fBduration\fP is specified or a
36 capture ends at the end of the duration if the
37 finished before. The \fBduration\fP can be spe
38 the \fBcommand\fP. If none is specified, the c
39 indefinitively until interrupted by \fBSIGINT\
40 .PP
41
42 .SS Options
43 .PP
44 The \fB-h, --help\fP option shows a short usag
45 .PP
46 The \fB-o <dir>, --output <dir>\fP option defi
47 sampling files
48 .PP
49 The \fB-c <config>, --config <config>\fP optio
50 .PP
51 The \fB-d <seconds>, --duration <seconds>\fP o
52 .PP
53 The \fB-l <loglevel>, --loglevel <loglevel>\fP
54 .PP
55 The \fB-p <string>, --postfix <string>\fP opti
56 .PP
57 The \fB-s, --syslog\fP option sets the output
58 .PP
59 The \fB-w, --overwrite\fP overwrites the outpu
60 .PP
61
62 .PP
63
64 .SS "Exit status:"
65 .TP
66 0
67 if OK,
68 .TP
69 1
70 Error with the options specified as parameters
71 .TP
72 2
73 Error when configuring the logging facility
74 .TP
75 3
76 Error when configuring the time
77 .TP
78 4
79 Error in the initialization routine
80 .TP
81 5
82 Error during the runtime
83
84 .SH Capture file format
85
86 Every file contains two columns. The first one
87 in order to find a point in time since the sys
88 is any thermal event. The second one is the te
89 degree. The first line contains the label of e
90
91 .SH AUTHOR
92 Daniel Lezcano <daniel.lezcano@kernel.org>
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.