1thermald(8)                 System Manager's Manual                thermald(8)
2
3
4

NAME

6       thermald - start Linux thermal daemon
7

SYNOPSIS

9       thermald  [ OPTIONS ]
10
11

DESCRIPTION

13       thermald  is  a  Linux  daemon used to prevent the overheating of plat‐
14       forms. This daemon monitors temperature and applies compensation  using
15       available cooling methods.
16
17       By  default,  it  monitors  CPU temperature using available CPU digital
18       temperature sensors and maintains CPU temperature under control, before
19       HW takes aggressive correction action.
20
21       Thermal daemon looks for thermal sensors and thermal cooling drivers in
22       the Linux thermal sysfs (/sys/class/thermal) and builds a list of  sen‐
23       sors and cooling drivers. Each of the thermal sensors can optionally be
24       binded to a cooling drivers by the in kernel drivers. In this case  the
25       Linux  kernel  thermal core can directly take actions based on the tem‐
26       perature trip points, for each sensor and  associated  cooling  device.
27       For  example a trip temperature X in a sensor can be associates a cool‐
28       ing driver Y. So when the sensor temperature = X,  the  cooling  driver
29       "Y" is activated.
30
31       Thermal  daemon  allows  one to change this relationship or add new one
32       via a thermal configuration file (thermal-conf.xml). This file is auto‐
33       matically created (thermal-conf.xml.auto) and used, if the platform has
34       ACPI thermal relationship table.  If not this needs to be manually con‐
35       figured.
36
37       For  manual  configuration  refer  to  the  manual page of the thermal-
38       conf.xml.
39
40       In some newer platforms the auto creation of the config file is done by
41       a  companion  tool  "dptfxtract".  This  tool  can  be  downloaded from
42       "https://github.com/intel/dptfxtract". It is suggested as parts of  the
43       install process, run dptfxtract.
44
45       There can be multiple configuration files. User can select a configura‐
46       tion file via -config-file option to overide the default selection. The
47       default selection picks one of the file in the following order:
48
49       - /etc/thermald/thermal-conf.xml.auto
50
51       - /var/run/thermald/thermal-conf.xml.auto
52
53       - /etc/thermald/thermal-conf.xml
54
55       (*Assuming configure prefix=/ is used during build.)
56
57       There  is  another  companion  tool  "ThermalMonitor", which presents a
58       graphical front end. This allows the monitoring of sensors and changing
59       of  thermal  trips  to  give  the user more control. The source code of
60       "ThermalMonitor" is a part of the thermald github source, in the  tools
61       folder.
62
63
64

OPTIONS

66       -h, --help
67              Show help options.
68
69       --version
70              Print thermald version and exit.
71
72       --no-daemon
73              Don't become a daemon: Default is daemon mode.
74
75       --loglevel=info
76              log severity: info level and up.
77
78       --loglevel=debug
79              log severity: debug level and up: Max logging.
80
81       --poll-interval
82              Poll interval in seconds: Poll for zone temperature changes.  To
83              disable polling, set to zero. Polling can only be  disabled,  if
84              available  temperature  sensors  can  notify  temperature change
85              asynchronously.
86
87       --dbus-enable
88              Enable Dbus.
89
90       --exclusive-control
91              Act as exclusive thermal controller. This  will  use  user-space
92              governor for thermal sysfs and take over control.
93
94       --ignore-cpuid-check
95              Ignore cpuid check for supported CPU models.
96
97       --config-file
98              Specify   thermal-conf.xml  path  and  ignore  default  thermal-
99              conf.xml.
100
101       --ignore-default-control
102              Ignore default CPU temperature control. Strictly follow thermal-
103              conf.xml  or thermal-conf.xml.auto.  --workaround-enabled Enable
104              special workarounds. This is currently used for  /dev/mem  based
105              power control.  --disable-active-power Disable active power man‐
106              agement. This will not set active power limits.  --adaptive  Use
107              DPTF  adaptive  tables  when  present. This will ignore thermald
108              config via xml files.
109
110

SEE ALSO

112       thermal-conf.xml(5)
113
114
115
116                                  8 May 2013                       thermald(8)
Impressum