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)