zcfan(1)

zcfan1

Zero-configuration fan control daemon for thinkpads

Overview

zcfan is a minimal, zero-configuration fan control daemon for ThinkPads.

Options

zcfan does not take any options. If any are provided, a help message will be printed and zcfan will exit.

Configuration

Usage

zcfan has the following default fan states:

Config namethinkpad_acpi fan levelDefault trip temperature (C)
max_temp790
med_temp480
low_temp170

You can optionally override this configuration at /etc/zcfan.conf with your desired threshold values in the following format:

max_temp 85
med_temp 70
low_temp 55

If no trip temperature is reached, the fan will be turned off.

Hysteresis

We will only reduce the fan level again once:

1.

The temperature is now at least temp_hysteresis Celsius below the trip point (default 10C), and

2.

At least 3 seconds have elapsed since the initial trip.

This avoids unnecessary fluctuations in fan speed.

Watchdog

The kernel watchdog is reset every 120 seconds by default, but a smaller value can be selected in the /etc/zcfan.conf config file with the syntax

watchdog_secs 10

Dependencies

thinkpad-acpi must be loaded with fan_control=1.

Releases

2 releases since Debian 12 (Bookworm); the text changed 1 time.

  1. 12
  2. 13

Author

Chris Down ⟨[email protected]⟩

Reporting bugs

Please send bug reports to ⟨https://github.com/cdown/zcfan/issues⟩.

From zcfan 1.4.0-2 in Debian 13 (Trixie). Parsed by carta from the page's man source.