.\" -*- coding: UTF-8 -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH THINKFAN.CONF 5 "Dezember 2021" "thinkfan 1.3.1" .SH BEZEICHNUNG thinkfan.conf \- YAML\-formatierte Konfigurationsdatei für \fBthinkfan\fP(1) .SH BESCHREIBUNG YAML ist eine sehr mächtige und prägnante Notierung für strukturierte Daten. Dessen vollständige Spezifikation finden Sie auf https://yaml.org/spec/1.2/spec.html. \fBthinkfan\fP verwendet nur eine kleine Teilmenge der YAML\-Syntax, daher ist es für Benutzer zwar hilfreich, aber nicht zwingend notwendig, einen Blick auf die Spezifikation zu werfen. Am erwähnenswertesten ist, dass Einrückungen syntaktisch bedeutsam sind. Insbesondere sollten Tabulatoren und Leerzeichen nicht gemischt verwendet werden. Wir empfehlen eine Einrückung von zwei Leerzeichen, wie nachfolgend gezeigt. Die Konfiguration von \fBthinkfan\fP besteht aus drei Hauptabschnitten: .TP 11m \fBsensors:\fP Gibt an, woraus Temperaturen gelesen werden sollen. Alle Treiber im \fBhwmon\fP\-Stil und auch \fB/proc/acpi/ibm/thermal\fP werden unterstützt. Außerdem werden \fBlibatasmart\fP (zum direkten Auslesen der Temperaturen von Festplatten) und \fBNVML\fP (über den proprietären Nvidia\-Treiber) unterstützt, wobei beides von den Optionen beim Kompilieren von \fBthinkfan\fP abhängig ist. .TP \fBfans:\fP Gibt an, welche Lüfter verwendet werden sollen (gegenwärtig ist nur einer erlaubt). Die Unterstützung für mehrere Lüfter befindet sich bereits in der Entwicklung und ist für eine zukünftige Veröffentlichung geplant. Sowohl PWM\-Steuerungen im \fBhwmon\fP\-Stil als auch \fB/proc/acpi/ibm/fan\fP können verwendet werden. .TP \fBlevels:\fP Weist die Temperaturen den Lüftergeschwindigkeiten zu. Eine »einfache Zuweisung« ordnet einer angegebenen Lüftergeschwindigkeit nur eine Temperatur als Unter\- bzw. Obergrenze zu. In der »detaillierten Zuweisung« werden die Ober\- und Untergrenzen für jeden unter \fBsensors:\fP konfigurierten Treiber/Sensor zugeordnet. Dieser Modus sollte verwendet werden, wenn \fBthinkfan\fP mehrere Geräte überwacht, die unterschiedliche Temperaturwerte tolerieren können. .PP In jedem dieser Abschnitte muss eine Liste aus Schlüssel\-Wert\-Zuordnungen stehen, wobei jede einen Sensortreiber, einen Lüftertreiber oder eine Zuordnung der Lüftergeschwindigkeit konfiguriert. .SH "SENSOREN UND LÜFTERTREIBER" Damit \fBthinkfan\fP arbeiten kann, muss es darüber informiert sein, welche Tenperatorsensortreiber und Lüftertreiber es verwenden soll. Die Zuordnung der auszulesenden Temperaturen zu den Lüftergeschwindigkeiten ist in einem separaten Konfigurationsabschnitt angegeben (siehe den nachfolgenden Abschnitt \fBLÜFTERGESCHWINDIGKEITEN\fP). .SS Sensor\-Syntax Die Einträge im Abschnitt \fBsensors:\fP können \fBhwmon\fP\-, \fBthinkpad_acpi\fP\-, \fBNVML\fP\- oder \fBatasmart\fP\-Treiber angeben, wobei die beiden Letztgenannten bereits beim Kompilieren von \fBthinkfan\fP aktiviert werden müssen. Jede beliebige Zahl (größer als 0) und eine Kombination aus \fBhwmon\fP\-, \fBtpacpi\fP\-, \fBnvml\fP\- und \fBatasmart\fP\-Einträgen ist erlaubt. Jedoch darf höchstens ein \fBtpacpi\fP\-Eintrag vorhanden sein. .nf \fBsensors:\fP \fB \- hwmon: \fP\fIhwmon\-Pfad\fP \fB name: \fP\fIhwmon\-Name\fP \fB indices: \fP\fIIndexliste\fP \fB correction: \fP\fIKorrekturliste\fP \fB optional: \fP\fIboolesche\-erlaubte\-Fehler\fP \fB\- tpacpi: /proc/acpi/ibm/thermal\fP \fB indices: \fP\fIIndexliste\fP \fB correction: \fP\fIKorrekturliste\fP \fB optional: \fP\fIboolesche\-erlaubte\-Fehler\fP \fB \- nvml: \fP\fInvml\-Buskennung\fP \fB correction: \fP\fIKorrekturliste\fP \fB optional: \fP\fIboolesche\-erlaubte\-Fehler\fP \fB \- atasmart: \fP\fIPlatten\-Gerätedatei\fP \fB correction: \fP\fIKorrekturliste\fP \fB optional: \fP\fIboolesche\-erlaubte\-Fehler\fP \fB \- \fP … .fi .SS Lüfter\-Syntax Gegenwärtig unterstützt \fBthinkfan\fP nur einen einzigen Lüfter, daher kann es nur einen Eintrag in der Liste geben. Die Unterstützung für mehrere Lüfter ist derzeit in der Entwicklung und für eine zukünftige Veröffentlichung geplant. Der Lüfter ist entweder ein \fBhwmon\fP\-Lüfter: .nf \fBfans:\fP \fB \- hwmon: \fP\fIhwmon\-Pfad\fP \fB name: \fP\fIhwmon\-Name\fP \fB indices: \fP\fIIndexliste\fP .fi oder ein \fBtpacpi\fP\-Lüfter: .nf \fBfans:\fP \fB\- tpacpi: /proc/acpi/ibm/fan\fP .fi .SS Werte .TP 12m \fIhwmon\-Pfad\fP Es gibt drei Möglichkeiten, Hwmon\-Lüfter oder Sensoren anzugeben: .TP \h'8m'1) Ein vollständiger Pfad zu einer »temp*_input«\- oder »pwm*«\-Datei wie »/sys/class/hwmon/hwmon0/pwm1« oder »/sys/class/hwmon/hwmon0/temp1_input«. In diesem Fall sind die Einträge »\fBindices:\fP\fI Indexliste\fP« und »\fBname:\fP\fI hwmon\-Name\fP« überflüssig, da der Pfad einen bestimmten Lüfter oder Sensor eindeutig angibt. Beachten Sie, dass diese Methode Probleme verursachen kann, wenn sich die Ladereihenfolge der Treiber nach Neustarts ändert, da sich das \fIX\fP im Ordnernamen »hwmon\fIX\fP« auf die Ladereihenfolge bezieht. Verwenden Sie Methode 2) oder 3), um dieses Problem zu vermeiden. .TP \h'8m'2) Ein Verzeichnis, das einen spezifischen Hwmon\-Treiber enthält, zum Beispiel »/sys/devices/platform/nct6775.2592«. Beachten Sie, dass dieser Pfad nicht das von der Ladereihenfolge abhängige Verzeichnis »hwmon\fIX\fP« enthält. Solange hier nur ein(e) einzelne(r) Hwmon\-Treiber/\-Schnittstelle enthalten ist, reicht es aus, den Eintrag »\fBindices:\fP\fI Indexliste\fP« anzugeben, woraus \fBthinkfan\fP die aus dieser Schnittstelle zu verwendenden Sensoren entnehmen kann. Der Eintrag »\fBname:\fP\fI hwmon\-Name\fP« ist nicht erforderlich. .TP \h'8m'3) Ein Verzeichnis, das mehrere oder alle Hwmon\-Treiber\-Einträge enthält, zum Beispiel »/sys/class/hwmon«. Hier sind sowohl »\fBname:\fP\fI hwmon\-Name\fP« als auch »\fBindices:\fP\fI Indexliste\fP« erforderlich, um \fBthinkfan\fP über die aus diesem Pfad zu verwendende Schnittstelle und die aus dieser Schnittstelle zu verwendenden Sensoren oder Lüfter zu informieren. .TP \fIhwmon\-Name\fP Der Name der Hwmon\-Schnittstelle, der üblicherweise in einer Datei »name« zu finden ist. Dies muss immer dann angegeben werden, wenn \fIhwmon\-Pfad\fP ein Basispfad ist, in dem mehrere Hwmons enthalten sind. Diese Methode zur Angabe von Sensoren ist insbesondere dann nützlich, wenn sich der vollständige Pfad zu einem bestimmten Hwmon nach einem Neustart des Systems ändern kann, beispielsweise aufgrund einer anderen Ladereihenfolge der Treibermodule. .TP \fIIndexliste\fP Eine YAML\-Liste \fB[ \fP\fIX1\fP\fB, \fP\fIX2\fP\fB, \fP …\fB ]\fP, die angibt, welche Sensoren beziehungsweise welcher Lüfter aus einer angegebenen Schnittstelle verwendet werden soll. Sowohl \fB/proc/acpi/ibm/thermal\fP als auch viele Hwmon\-Schnittstellen enthalten mehrere Sensoren und nicht alle davon sind für die Lüftersteuerung von Bedeutung. .TP \h'9m'\(bu Dies ist für \fBhwmon\fP\-Einträge erforderlich, falls der \fIhwmon\-Pfad\fP nicht auf eine einzelne »temp\fIXi\fP_input«\-Eingabedatei zeigt, sondern auf ein Verzeichnis, welches eine oder mehrere Dateien enthält. In diesem Fall gibt die \fIIndexliste\fP das \fIXi\fP an, dass in den Eingabedateien »temp\fIXi\fP_input« verwendet werden sollte. Eine Hwmon\-Schnittstelle darf auch mehrere PWM\-Steuerungen für Lüfter enthalten, so dass die \fIIndexliste\fP in diesem Fall genau einen Eintrag enthalten muss. .TP \h'9m'\(bu Für \fBtpacpi\fP\-Sensoren ist dieser Eintrag optional. Falls er weggelassen wird, werden alle in \fB/proc/acpi/ibm/thermal\fP enthaltenen Temperaturen verwendet. .TP \fInvml\-Buskennung\fP HINWEIS: Dies ist nur verfügbar, wenn bei der Kompilierung von \fBthinkfan\fP USE_NVML aktiviert wurde. Die PCI\-Buskennung einer nVidia\-Grafikkarte, die mit dem proprietären nVidia\-Treiber läuft. Diese kann mit dem Befehl »lspci | grep \-i vga« ermittelt werden. Üblicherweise verwenden nVidia\-Karten den quelloffenen \fBnoveau\fP\-Treiber, der stattdessen Hwmon\-Sensoren unterstützen sollte. .TP \fIPlatten\-Gerätedatei\fP HINWEIS: Dies ist nur verfügbar, wenn bei der Kompilierung von \fBthinkfan\fP USE_ATASMART aktiviert wurde. Vollständiger Pfad zu einer Gerätedatei einer Festplatte, die S.M.A.R.T. unterstützt. Siehe auch die Option \fB\-d\fP in \fBthinkfan\fP(1), welche verhindert, dass \fBthinkfan\fP schlafende (mechanische) Festplatten aufweckt, um deren Temperatur auszulesen. .TP \fIKorrekturliste\fP (immer optional) Eine YAML\-Liste, die für jeden der vom angegebenen Treiber verwendeten Sensoren Temperaturkorrekturwerte angibt. Verwenden Sie dies, wenn Sie die Syntax der »einfachen« Stufe verwenden wollen, aber in Kauf nehmen, dass Sie dies für Geräte mit geringerer Temperaturbeständigkeit kompensieren müssen. Beachten Sie jedoch, dass die detailliertere Syntax für gewöhnlich die bessere Wahl mit feineren Einstellmöglichkeiten ist. .TP \fIboolesche\-erlaubte\-Fehler\fP (immer optional, standardmäßig \fBfalse\fP) Ein Wahrheitswert (\fByes\fP/\fBno\fP/\fBtrue\fP/\fBfalse\fP), der angibt, ob \fBthinkfan\fP Fehlermeldungen beim Lesen aus diesem Sensor akzeptieren soll. Normalerweise wird \fBthinkfan\fP beendet und gibt eine Fehlermeldung aus, falls das Auslesen der Temperatur aus einem der konfigurierten Sensoren fehlschlägt. Einen Sensor als optional zu kennzeichnen kann für entfernbare Hardware oder Geräte nützlich sein, die zwecks Energieeinsparung vollständig abgeschaltet werden könnten. .SH LÜFTERGESCHWINDIGKEITEN Der Abschnitt \fBlevels:\fP gibt Lüftergeschwindigkeiten mit deren zugehörigen Temperaturunter\- und \-obergrenzen in Form einer Liste an. Wenn die Temperatur unter die Untergrenze fällt, wechselt \fBthinkfan\fP in die vorherige Stufe und wenn die Obergrenze erreicht ist, in die nächste Stufe. .SS "Einfache Syntax" In der einfachen Form wird für eine bestimmte Lüftergeschwindigkeit nur eine einzige Temperatur als Unter\- bzw. Obergrenze angegeben. In diesem Fall werden \fIUntergrenze\fP und \fIObergrenze\fP nur mit der höchsten in allen konfigurierten Sensoren gefundenen Temperaturen verglichen. Alle anderen Temperaturen werden ignoriert. Dieser Modus ist für kleine Systeme (wie Laptops) geeignet, wo es nur ein Gerät gibt (zum Beispiel die CPU), dessen Temperatur gesteuert werden muss oder wo das nötige Lüfterverhalten für alle wärmeerzeugenden Geräte ähnlich genug ist. .nf \fBlevels:\fP \fB \- [ \fP\fILüftergeschwindigkeit\fP\fB, \fP\fIUntergrenze\fP\fB, \fP\fIObergrenze\fP\fB ]\fP \fB \- \fP … .fi .SS "Detaillierte Syntax" Dieser Modus ist für komplexere Systeme mit Geräten geeignet, die verschiedene Temperaturbereiche haben. Zum Beispiel können viele moderne CPUs und GPUs dauerhaft mit Temperaturen über 80\[char176]C umgehen, während eine Festplatte nicht überleben würde, wenn sie solche Temperaturen erreicht. Im detaillierten Modus werden die Unter\- und Obergrenzen der Temperaturen individuell für jeden Sensor angegeben: .nf \fBlevels:\fP \fB \- speed: \fP\fILüftergeschwindigkeit\fP \fB lower_limit: [ \fP\fIl1\fP\fB, \fP\fIl2\fP\fB, \fP … \fB ]\fP \fB upper\-limit: [ \fP\fIu1\fP\fB, \fP\fIu2\fP\fB, \fP … \fB ]\fP \fB \- \fP … .fi .SS Werte .TP 12m \fILüftergeschwindigkeit\fP Die möglichen Geschwindigkeitswerte sind unterschiedlich, je nachdem, welcher Lüftertreiber verwendet wird. Für einen \fBhwmon\fP\-Lüfter ist die \fILüftergeschwindigkeit\fP ein numerischer Wert von \fB0\fP bis \fB255\fP entsprechend der PWM\-Werte, die von den verschiedenen Kerneltreibern akzeptiert werden. Für einen \fBtpacpi\fP\-Lüfter in Lenovo\-/IBM\-ThinkPads und einigen anderen Lenovo\-Laptops (siehe \fBSENSOREN UND LÜFTERTREIBER\fP oben) können numerische Werte und Zeichenketten verwendet werden. Numerische Werte von 0 bis 7 sind zulässig. Die Zeichenkettenwerte folgen der Form \fB"level \fP\fIStufen\-Kennung\fP\fB"\fP, wobei \fIStufen\-Kennung\fP ein Wert von \fB0\fP bis \fB7\fP, \fBauto\fP, \fBfull\-speed\fP oder \fBdisengaged\fP sein darf. Die numerischen Werte \fB0\fP bis \fB7\fP entsprechen den von der Firmware verwendeten Lüftergeschwindigkeiten, wobei die meisten Firmwares die Stufe \fB7\fP nicht verwenden. Der Wert \fB"level auto"\fP überlässt die Steuerung der Firmware, was nützlich sein kann, wenn das Lüfterverhalten nur für bestimmte Temperaturbereiche angepasst werden muss (üblicherweise am unteren und oberen Ende des Bereichs). Die Werte \fB"level full\-speed"\fP und \fB"level disengaged"\fP sorgen dafür, dass der Lüfter nicht mehr durch die Firmware gesteuert wird. Das führt dazu, dass der Lüfter langsam auf ein absolutes Maximum hochfährt, das innerhalb der elektrischen Grenzen erreicht werden kann. Beachten Sie, dass dies nicht den Spezifikationen des Lüfters entspricht und erhöhten Verschleiß zur Folge haben kann. Es kann dennoch hilfreich sein, um thermischer Drosselung entgegenzuwirken. .TP \fIl1\fP\fB, \fP\fIl2\fP\fB, \fP … .TP \fIu1\fP\fB, \fP\fIu2\fP\fB, \fP … Die Unter\- und Obergrenzen beziehen sich auf die Sensoren in der gleichen Reihenfolge, wie sie beim Auswerten des \fBsensors:\fP\-Abschnitts gefunden werden (siehe \fBSENSOREN UND LÜFTERTREIBER\fP oben). Für den ersten Eintrag kann die Untergrenze \fBlower_limit\fP und für den letzten Eintrag die Obergrenze \fBupper_limit\fP weggelassen werden. Für alle dazwischen liegenden Stufen muss sich die Untergrenze mit der Obergrenze der vorherigen Stufe überschneiden, um sicherzustellen, dass der gesamte Temperaturbereich abgedeckt wird und zwischen den Lüfterstufen eine gewisse Nachlaufsteuerung möglich ist. .SH "SIEHE AUCH" .nf Die \fBthinkfan\fP\-Handbuchseite: \fBthinkfan\fP(1) Beispielkonfigurationen, die mit der Quelldistribution mitgeliefert werden, sind auch hier verfügbar: .hy 0 https://github.com/vmatare/thinkfan/tree/master/examples Die Dokumentation der Hwmon\-Benutzerschnittstelle von Linux: https://www.kernel.org/doc/html/latest/hwmon/sysfs\-interface.html Dokumentation zur \fIthinkpad_acpi\fP\-Schnittstelle: https://www.kernel.org/doc/html/latest/admin\-guide/laptops/thinkpad\-acpi.html .SH FEHLER .hy 0 .nf Melden Sie Fehler auf Github: https://github.com/vmatare/thinkfan/issues .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Mario Blättermann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .