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 override  the  default  selection.
47       The 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 for RAPL MMIO power limit and TCC offset ev‐
105              ery  30  seconds.  This helps to disable RAPL MMIO when not used
106              and adjust TCC offset in certain Lenovo laptops.   --disable-ac‐
107              tive-power  Disable  active  power management. This will not set
108              active power limits using RAPL MMIO. This  may  result  in  con‐
109              strained  performance,  if  the system boots up with lower power
110              limits.  --adaptive Use DPTF adaptive tables when present.  This
111              will  ignore  thermald config via xml files.  --ignore-critical-
112              trip If the configuration defined a critical temperature  point,
113              which  is too low, this option will avoid shutting down the sys‐
114              tem on reaching this temperature limit.
115
116

SEE ALSO

118       thermal-conf.xml(5)
119
120
121
122                                  8 May 2013                       thermald(8)
Impressum