X-Git-Url: https://www.fleuret.org/cgi-bin/gitweb/gitweb.cgi?p=breezed.git;a=blobdiff_plain;f=breezed.1;h=750bc08179625f51b4caf57818bd40a1ab11fd64;hp=2f0152055b16067a9e6eaca322aa66ba4667912e;hb=HEAD;hpb=76179c07b5f1c0a19c4545bd51541e2cd64b07c7 diff --git a/breezed.1 b/breezed.1 index 2f01520..750bc08 100644 --- a/breezed.1 +++ b/breezed.1 @@ -1,4 +1,4 @@ -.TH "BREEZED" "1" +.TH "BREEZED" "1.4" "Mar 2010" "Francois Fleuret" "System Deamons" .SH "NAME" breezed - Fan control daemon .SH "SYNOPSIS" @@ -6,38 +6,42 @@ breezed - Fan control daemon \fBbreezed\fP [\fBoptions\fP] .SH "DESCRIPTION" .PP -\fBbreezed\fP Adjusts the fan speed according to the computer -temperature. It should be started through the adequate script in -/etc/rc?.d. +\fBbreezed\fP is a daemon to adjust the fan speed according to the +computer temperature. It should be started through the adequate +systemd configuration or script in /etc/rc?.d. -Every 5s, this daemon gathers all integer values from the thermal -files, and keep the max as the overall computer temperature T. It then -pick the highest temperature threshold lower than T and set the fan -speed to the corresponding level. To avoid oscillations, T has to be -two degrees below threshold to reduce the temperature. Also, the -daemon waits for at least 30s after any change of the fan speed before -reducing it. The fan speed is set by writing "level %d" into the -specified fan file. +Every 5s, \fBbreezed\fP gathers all integer values from the thermal +files, and takes the max as the overall temperature T. It then +computes the highest fan speed whose temperature threshold is lower +than T. If that speed is above the current speed, the daemon changes +the fan speed accordingly. Otherwise it computes the lowest fan speed +whose temperature threshold is two degrees above T, and sets the fan +speed one level below. This two degree gap avoids too many +oscillations. Also, the daemon waits for at least 30s after any change +of the fan speed before reducing it. The fan speed is set by writing +"level " into the specified fan file. The speed name is +the level itself if no alternative is provided with the temperature +threshold. -Options can not be specified twice, neither on the command line nor in +Options cannot be specified twice, neither on the command line nor in the configuration file. .SH "OPTIONS" -.IP "\fB-h | --help\fP " 10 +.IP "\fB-h | --help\fP" 10 display help and exits -.IP "\fB-v | --version\fP " 10 +.IP "\fB-v | --version\fP" 10 display the version number and exits -.IP "\fB-d | --debug\fP " 10 +.IP "\fB-d | --debug\fP" 10 run in verbose mode -.IP "\fB-cf | --configuration-file \fP " 10 +.IP "\fB-cf | --configuration-file \fP" 10 set the configuration file (default is /etc/breezed.conf) -.IP "\fB-ncf | --no-configuration-file\fP " 10 +.IP "\fB-ncf | --no-configuration-file\fP" 10 prevent the reading of a configuration file -.IP "\fB-tf | --thermal-file [,file2]...\fP " 10 +.IP "\fB-tf | --thermal-file [,file2]...\fP" 10 set the files to spool for temperatures. -.IP "\fB-ff | --fan-file \fP " 10 +.IP "\fB-ff | --fan-file \fP" 10 set the file to control the fan speed. -.IP "\fB-tt | --temperature-thresholds [,temp2]...\fP " 10 +.IP "\fB-tt | --temperature-thresholds [:][,temp2[:speed_name_2]]...\fP" 10 set the temperature thresholds. .SH "CONFIGURATION FILE" @@ -50,18 +54,29 @@ at /etc/breezed.conf .SH "EXAMPLES" -A typical way of starting breezed is +If a configuration file exists, the standard way to start breezed is +to run it without arguments. -breezed --thermal-files /proc/acpi/thermal_zone/THM0/temperature,/proc/acpi/thermal_zone/THM1/temperature \ - --fan-file /proc/acpi/ibm/fan \ - --temperature-thresholds -1,52,54,56,58,60,62,64 +Starting it with all the arguments on the commande line can be done +for instance with + +.P +.nf +.B breezed --no-configuration-file \e +.B \ \ \ \ \ \ \ \ --thermal-files /proc/acpi/thermal_zone/THM0/temperature,/proc/acpi/thermal_zone/THM1/temperature \e +.B \ \ \ \ \ \ \ \ --fan-file /proc/acpi/ibm/fan \e +.B \ \ \ \ \ \ \ \ --temperature-thresholds 52,54,56,58,60,62,64,68:full-speed which specifies that when the temperature raises above 52C, the fan level should be 1, when the temperature raises above 54C it should be -2, etc. The maximum speed level 7 should be chosen for temperature -above 64C. Due to the two degrees gap between the thresholds to -increase and thresholds to decrease the temperature, it will for -instance remains at speed 1 until the temperature goes down to 50C. +2, etc. The maximum speed level 8 should be chosen for temperatures +above 68C, and its name is "full-speed" (since no other speed name is +provided, the other ones are the default level names, hence their +numerical value). + +Due to the two degrees gap between the thresholds to increase and the +thresholds to decrease the temperature, it will for instance remains +at speed 1 until the temperature goes down to 50C. Because it takes into account all the values found in the thermal files, you can use as well /proc/acpi/thermal_zone/THM?/temperature or @@ -69,6 +84,6 @@ files, you can use as well /proc/acpi/thermal_zone/THM?/temperature or .SH "AUTHOR" .PP -Written by Francois Fleuret . Permission is +Written by Francois Fleuret . Permission is granted to copy, distribute and/or modify this document under the terms of the GNU GPL.