thermald

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

NAME
       thermald - start Linux thermal daemon

SYNOPSIS
       thermald  [ OPTIONS ]

DESCRIPTION
       thermald  is  a  Linux  daemon used to prevent the overheating of plat-
       forms. 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  sen-
       sors 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 tem-
       perature trip points, for each sensor and  associated  cooling  device.
       For  example a trip temperature X in a sensor can be associates a cool-
       ing 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 auto-
       matically  created and used, if the platform has ACPI thermal relation-
       ship table. If not this needs to be manually configured.

       When there is a sensor, which has no associate cooling device, via con-
       figuration  file  or  thermal  relationship  table, then this sensor is
       tested for relationship with CPU  load  dynamically  up  to  maximum  3
       times. If there is no relationship, then it is added to a black list of
       unbinded sensors and not tried again.

       Optionally thermal daemon can act as an exclusive thermal controller by
       using  thermal sysfs and acting as a user space governor.  In this case
       kernel thermal core is not active and decision is taken by thermal dae-
       mon only.

       Dbus  Interface:  When  started with dbus-enable option, dbus interface
       can be used to control thermal  temperature  at  which  cooling  action
       takes place. This change is persistent. For example, to start CPU cool-
       ing at 80C, dbus-send command can be used:

       #  dbus-send  --system  --dest=org.freedesktop.thermald  /org/freedesk-
       top/thermald         org.freedesktop.thermald.SetUserPassiveTemperature
       string:cpu uint32:80000

OPTIONS
       -h, --help
              Show help options.

       --version
              Print thermald version and exit.

       --no-daemon
              Don't become a daemon: Default is daemon mode.

       --loglevel=info
              log severity: info level and up.

       --loglevel=debug
              log severity: debug level and up: Max logging.

       --poll-interval
              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.

       --dbus-enable
              Enable Dbus.

       --exclusive-control
              Act  as  exclusive  thermal controller. This will use user-space
              governor for thermal sysfs and take over control.

       --ignore-cpuid-check
              Ignore cpuid check for supported CPU models.

       --config-file
              Specify  thermal-conf.xml  path  and  ignore  default   thermal-
              conf.xml.

SEE ALSO
       thermal-conf.xml(5)

                                  8 May 2013                       thermald(8)