thinkfan - Online in the Cloud

PROGRAM:

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).

Use thinkfan online using onworks.net services