NAME

       thinkfan - A simple fan control program

SYNOPSIS

       thinkfan [-hnqzDd] [-b BIAS] [-c CONFIG] [-s SECONDS] [-p [DELAY]]

DESCRIPTION

       Thinkfan  sets  the fan speed according to temperature limits preconfigured in /etc/thinkfan.conf. It can
       read temperatures from three possible sources:

       /proc/acpi/ibm/thermal
              Which is provided by the thinkpad_acpi kernel module,

       /sys/class/hwmon/*/temp*_input
              Which may be provided by any hwmon drivers, and

       S.M.A.R.T. (since 0.9)
              Which reads the temperature directly from the hard disk using libatasmart.

       Note that since 0.9 you can use any sensors of these three types at the same time.  To  allow  that,  the
       configuration  keywords  have  been  changed.  The sensor keyword has been deprecated in favor of the new
       keywords tp_thermal, hwmon and atasmart which mark the following path as a legacy  thinkpad_acpi  thermal
       file, sysfs hwmon file, or a hard disk device file, respectively.

       The  fan can be /proc/acpi/ibm/fan or some PWM file in /sys/class/hwmon. Note that the fan config keyword
       is deprecated as well. Instead, you should use tp_fan for a legacy thinkpad_acpi fan file or pwm_fan  for
       a sysfs PWM file.

       See the README file and the example configurations for details on these changes.

       WARNING:  This program does only very basic sanity checking on the configuration. That means that you can
              set your temperature limits as insane as you like.

       There are two general modes of operation:

   COMPLEX MODE
       In complex mode, temperature limits are defined for each sensor thinkfan knows  about.  Setting  suitable
       limits  for  each sensor in your system will probably require a bit of experimentation and good knowledge
       about your hardware, but it's the safest way of keeping each component within its  specified  temperature
       range.  See  http://www.thinkwiki.org/wiki/Thermal_Sensors  for  details  on  which  sensor measures what
       temperature in a Thinkpad. On other systems you'll have to find out on your own. See the example  configs
       to learn about the syntax.

   SIMPLE MODE
       In  simple  mode,  Thinkfan uses only the highest temperature found in the system. That may be dangerous,
       e.g. for hard disks.  That's why you should provide a correction value (i.e. add 10-15 \[u00B0]C) for the
       sensor  that  has  the  temperature  of  your hard disk (or battery...). See the example config files for
       details about that.

CONFIGURATION

       Some example configurations are provided with the source package. For detailed explanations  please  read
       the  README  file.  If  you  installed  thinkfan  from  a  distribution  package, you may find them under
       /usr/share/doc or wherever your package manager puts documentation.

OPTIONS

       -h     Show a short help message

       -s SECONDS
              Maximum seconds between temperature updates (default: 5)

       -b BIAS
              Floating point number (-10 to 30) to control rising temperature exaggeration.  If the  temperature
              increases  by  more  than 2 °C during one cycle, this number is used to calculate a bias, which is
              added to the current highest temperature seen in the system:

               current_tmax = current_tmax + delta_t * BIAS / 10

              This means that negative numbers can be used to even out short and sudden temperature spikes  like
              those  seen  on  some on-DIE sensors. Use DANGEROUS mode to remove the -10 to +30 limit. Note that
              you can't have a space between -b and a negative argument, because otherwise getopt will interpret
              things like -10 as an option and fail (i.e. write "-b-10" instead of "-b -10").

              Default is 15.0

       -c FILE
              Load a different configuration file (default: /etc/thinkfan.conf)

       -n     Do not become a daemon and log to terminal instead of syslog

       -q     Be quiet (no status info on terminal)

       -z     Assume  we  don't  have  to  worry about resuming from standby when using the sysfs interface (see
              README!)

       -p [SECONDS]
              Use the pulsing-fan workaround (for older Thinkpads). Takes an  optional  floating-point  argument
              (0-10s) as depulsing duration. Default 0.5s.

       -d     Do  not  read  temperature  from sleeping disks. Instead, 0 °C is used as that disk's temperature.
              This is needed if reading the temperature causes your disk to wake up unnecessarily.   Note:  This
              option is only available if thinkfan was built with -D USE_ATASMART.

       -D     DANGEROUS mode: Disable all sanity checks. May damage your hardware!!

SIGNALS

       SIGINT and SIGTERM simply interrupt operation and should cause thinkfan to terminate cleanly.

       SIGHUP makes thinkfan reload its config. If there's any problem with the new config, we keep the old one.

       SIGUSR1  causes thinkfan to dump all currently known temperatures either to syslog, or to the console (if
       running with the -n option).

SEE ALSO

       git://git.code.sf.net/p/thinkfan/code

BUGS

       If you have any problems with thinkfan, please go to the help forum at sf.net:
       http://sourceforge.net/projects/thinkfan/forums/forum/905019.

       There's a bugtracker at
       http://sourceforge.net/tracker/?group_id=249873&atid=2416828.