1thermald(8) System Manager's Manual thermald(8)
2
6 thermald - start Linux thermal daemon
7
9 thermald [ OPTIONS ]
10
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 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 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 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 For manual configuration refer to the manual page of the thermal-
38 conf.xml.
39 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 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 - /etc/thermald/thermal-conf.xml.auto
50 - /var/run/thermald/thermal-conf.xml.auto
52 - /etc/thermald/thermal-conf.xml
54 (*Assuming configure prefix=/ is used during build.)
56 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
66 -h, --help
67 Show help options.
68 --version
70 Print thermald version and exit.
71 --no-daemon
73 Don't become a daemon: Default is daemon mode.
74 --loglevel=info
76 log severity: info level and up.
77 --loglevel=debug
79 log severity: debug level and up: Max logging.
80 --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 --dbus-enable
88 Enable Dbus.
89 --exclusive-control
91 Act as exclusive thermal controller. This will use user-space
92 governor for thermal sysfs and take over control.
93 --ignore-cpuid-check
95 Ignore cpuid check for supported CPU models.
96 --config-file
98 Specify thermal-conf.xml path and ignore default thermal-
99 conf.xml.
100 --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
118 thermal-conf.xml(5)
119 8 May 2013 thermald(8)