Provided by:
macfanctld_0.6+repack1-1_amd64 
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)