TLP Programmdokumentation

*** IN ARBEIT ***

Zielgruppe

Diese Anleitung wendet sich an Programmierer bzw. Paketierer, die TLP anpassen und für weitere Linux-Distributionen verfügbar machen wollen.

Wer TLP nur benutzen möchte, liest bitte hier weiter.

Einleitung

TLP besteht - abgesehen von Manpages und Dokumentation - ausschließlich aus POSIX-kompatiblen (d.h. ohne Bash-Erweiterungen) Shell-Skripten.

Programmbestandteile

Tabelle 1 listet die Inhalte des Source-Tarballs tlp_VERSION.orig.tar.gz, den jeweiligen Installationsort (lt. Makefile) und den Verwendungszweck auf.

Datei	Installationsort	Verwendung
49bay	/usr/lib/pm-utils/sleep.d/	Skript zum Sichern und Wiederherstellen des Wechselschacht- bzw. Ultrabay-Schaltzustands. Wird von pm-utils vor einem Suspend bzw. Hibernate und nach dem darauffolgenden Resume aufgerufen.
49wwan	/usr/lib/pm-utils/sleep.d/	Skript zum Sichern und Wiederherstellen des WWAN-Schaltzustands. Wird von pm-utils vor einem Suspend bzw. Hibernate und nach dem darauffolgenden Resume aufgerufen.
default	/etc/default/	Zentrale Konfigurationsdatei.
tlp	/usr/sbin/	TLP-Hauptprogramm.
tlp.desktop	/etc/xdg/autostart/	Autostart nach der Benutzeranmeldung (derzeit ohne Funktion).
tlp-functions	/usr/lib/tlp-pm/	Funktionsbibliothek allgemein.
tlp-ifup	/etc/networking/if-up.d/	Skript zum Setzen des WLAN-Power-Save-Modus: wird vom System stets nach dem Start eines IP-Interfaces aufgerufen wir nur aktiv, wenn es sich um ein WLAN-Interface handelt Installationsort und das Skript selbst müssen ggf. distributionsspezifisch angepaßt werden.
tlp.init	/etc/init.d/tlp	Systemstartskript (SysV) - schaltet Funkgeräte aus und setzt die Akkuladeschwellen.
tlp-nop	/usr/lib/tlp-pm/	Dummyskript - liefert rc=0.
tlp-rf	/usr/bin/bluetooth wifi wwan	Hauptprogramm zum Schalten der Funkgeräte (3 Hardlinks auf dasselbe Skript).
tlp-rf-func	/usr/lib/tlp-pm/	Funktionsbibliothek zum Schalten der Funkgeräte.
tlp-run-on	/usr/bin/run-on-bat run-on-ac	Bedingtes Starten von Befehlen in Abhängigkeit von der aktiven Stromquelle (2 Hardlinks auf dasselbe Skript).
tlp-stat	/usr/bin/	Statusbericht aller aktiven Einstellungen.
tlp.upstart	n/a	Systemstartskript für Upstart (derzeit nicht verwendet).
zztlp	/usr/lib/pm-utils/power.d/	Skript zum Setzen aller Einstellungen in Abhängigkeit von der aktiven Stromquelle: ruft tlp auf wird von pm-utils bei jedem Wechsel der Stromquelle sowie beim Systemstart aufgerufen (via pm-powersave)
man/bluetooth.1 run-on-ac.1 run-on-bat.1 tlp.8 tlp-stat.8 wifi.1 wwan.1	n/a	Manpages für die gleichnamigen Kommandos. Installation ist distributionsspezifisch und daher nicht im Makefile enthalten.
Makefile	n/a	Installation aller Skripte und der Konfigurationsdatei an die angegebenen Installationsorte.
README	n/a	README zu TLP. Installationsort ist distributionsspezifisch und daher nicht im Makefile enthalten.
COPYING	n/a	Angaben zum Copyright - Lizenzierung nach GPL v2. Installationsort ist distributionsspezifisch und daher nicht im Makefile enthalten. Die Installation dieser Datei auf dem Zielsystem (oder die Aufnahme in ein distributionsspezifisches Template) ist dient zur Einhaltung der Lizenz.
LICENSE	n/a	Angaben zum Programmautor.

Tabelle 1

Abhängigkeiten

Auf den folgenden Tools baut TLP auf.

pm-utils (zwingend erforderlich)

Stellt das Framework bereit, um TLP beim jedem Wechsel der Stromquelle aufzurufen. pm-utils bietet durch Skripte im Verzeichnis /usr/li/pm-utils/power.d/ einige der Funktionen an