thermald(8) System Manager's Manual thermald(8)

thermald - start Linux thermal daemon

thermald [ OPTIONS ]

thermald is a Linux daemon used to prevent the overheating of platforms. This daemon monitors temperature and applies compensation using available cooling methods.

By default, it monitors CPU temperature using available CPU digital temperature sensors and maintains CPU temperature under control, before HW takes aggressive correction action.

Thermal daemon looks for thermal sensors and thermal cooling drivers in the Linux thermal sysfs (/sys/class/thermal) and builds a list of sensors and cooling drivers. Each of the thermal sensors can optionally be binded to a cooling drivers by the in kernel drivers. In this case the Linux kernel thermal core can directly take actions based on the temperature trip points, for each sensor and associated cooling device. For example a trip temperature X in a sensor can be associates a cooling driver Y. So when the sensor temperature = X, the cooling driver "Y" is activated.

Thermal daemon allows one to change this relationship or add new one via a thermal configuration file (thermal-conf.xml). This file is automatically created ( and used, if the platform has ACPI thermal relationship table. If not this needs to be manually configured.

For manual configuration refer to the manual page of the thermal-conf.xml.

In some newer platforms the auto creation of the config file is done by a companion tool "dptfxtract". This tool can be downloaded from "". It is suggested as parts of the install process, run dptfxtract.

There can be multiple configuration files. User can select a configuration file via -config-file option to override the default selection. The default selection picks one of the file in the following order:

- /etc/thermald/

- /var/run/thermald/

- /etc/thermald/thermal-conf.xml

(*Assuming configure prefix=/ is used during build.)

There is another companion tool "ThermalMonitor", which presents a graphical front end. This allows the monitoring of sensors and changing of thermal trips to give the user more control. The source code of "ThermalMonitor" is a part of the thermald github source, in the tools folder.

-h, --help
Show help options.
Print thermald version and exit.
Don't become a daemon: Default is daemon mode.
log severity: info level and up.
log severity: debug level and up: Max logging.
Poll interval in seconds: Poll for zone temperature changes. To disable polling, set to zero. Polling can only be disabled, if available temperature sensors can notify temperature change asynchronously.
Enable Dbus.
Act as exclusive thermal controller. This will use user-space governor for thermal sysfs and take over control.
Ignore cpuid check for supported CPU models.
Specify thermal-conf.xml path and ignore default thermal-conf.xml.
Ignore default CPU temperature control. Strictly follow thermal-conf.xml or --workaround-enabled Enable special workarounds. This is currently used for /dev/mem based power control. --disable-active-power Disable active power management. This will not set active power limits. --adaptive Use DPTF adaptive tables when present. This will ignore thermald config via xml files.

8 May 2013