NAME

       macfanctld - Fan control for MacBook

SYNOPSIS

       macfanctld [-f]

DESCRIPTION

       macfanctld  is  a  daemon  that  reads  temperature sensors and adjust the fan(s) speed on
       MacBook's. macfanctld is configurable and logs temp and fan data  to  a  file.  macfanctld
       uses  three  sources to determine the fan speeed: 1) average temperature from all sensors,
       2) sensor TC0P [CPU 0 Proximity Temp and 3] and sensor TG0P [GPU 0 Proximity  Temp].  Each
       source's impact on fan speed can be individually adjusted to fine tune working temperature
       on different MacBooks.

       Important: macfanctld depends on applesmc-dkms.

OPTIONS

       -f     runs macfanctld the in foreground, logging to stdout.

EXIT STATUS

       macfanctld returns non-zero exist status in case of failure to start.

FILES

       /etc/init.d/macfanctld

              Daemon init script.

       /etc/macfanctl.conf

              Configuration file that can be tuned to get desired working temperature. The format
              must be <key>:<number>.

              fan_min:  Minimum  fan  speed.  Typically,  this  is  set to 2000 (Apples default).
              Maximum speed is 6200.

              temp_avg_floor: Average temperature in Celsius at which the fan speed will  be  set
              to fan_min. Valid values are 0 to 90, and must be less than temp_avg_ceiling.

              temp_avg_ceiling: Average temperature in Celsius at which the fan speed will be set
              to max (6200). Valid values are 0 to 90, and must be larger than temp_avg_floor.

              temp_TC0P_floor: Temperature in Celsius at TC0P, at which the fan speed will be set
              to fan_min. Valid values are 0 to 90, and must be less than temp_TC0P_ceiling.

              temp_TC0P_ceiling:  Temperature  in Celsius at TC0P, at which the fan speed will be
              set  to  max  (6200).  Valid  values  are  0  to  90,  and  must  be  larger   than
              temp_TC0P_floor.

              temp_TG0P_floor  :  Temperature  in Celsius at TG0P, at which the fan speed will be
              set to fan_min. Valid values are 0 to 90, and must be less than temp_TG0P_ceiling.

              temp_TG0P_ceiling: Temperature in Celsius at TG0P, at which the fan speed  will  be
              set   to  max  (6200).  Valid  values  are  0  to  90,  and  must  be  larger  than
              temp_TG0P_floor.

              exclude: A list of natural numbers defining sensors that should  be  excluded  from
              reading. Example:

              exclude: 1 7

              will disable reading of sensors temp1_input and temp7_input.

              This  feature  was  added as a workaround for issues in applesmc-dkms that disables
              reading of some sensors, or in some cases, incorrectly defines sensors  that  don't
              exists.

              log_level values: Set the log level. Valid values are:
               0 - Startup / Exit logging only
               1 - Basic temp / fan logging
               2 - Log all sensors

       /var/log/macfanctl.log

              Log file. When log_level is 1, the following output is generated:

                Speed: 6200,  AVG: 52.5C, *TC0P: 62.0C,  TG0P: 62.0C
                Speed: 6200,  AVG: 52.4C, *TC0P: 62.0C,  TG0P: 61.8C
                Speed: 6200,  AVG: 52.4C,  TC0P: 61.8C, *TG0P: 62.0C
                Speed: 6168,  AVG: 52.3C,  TC0P: 61.8C, *TG0P: 61.8C
                Speed: 6168,  AVG: 52.2C,  TC0P: 61.5C, *TG0P: 61.8C

              Speed is the current fan speed.

              AVG, TC0P and TG0P shows the temperature in Celsius at the source.

              The '*' indicate which source that is currently driving the fan.

NOTES

       Hopefully  the  provided  configuration  file  will be suitable on most MacBooks. However,
       there has been very little testing at this point. Therefore, enable logging  and  keep  an
       eye on the temperatures in the log, as well as sensing the temp with your hand on the left
       part above the keyboard. If it feels too hot, tweak the config file!

       To follow the log as it's written do

       $ tail -F /var/log/macfanctl.log

BUGS

       There are most certainly bugs in this software.

       Please submit bug reports, comments and suggestions to mikael@sesamiq.com.

AUTHOR

       Mikael Strom (mikael@sesamiq.com)

SEE ALSO

       tail (1)