path: root/README.de

                       runvdr extreme


Geschrieben von:       Udo Richter <udo_richter(a)gmx.de>
Projekt Homepage:      http://projects.vdr-developer.org/projects/runvdr-extreme
Siehe Datei COPYING für Lizenz-Informationen



Über
--------------------------------------------------------------------------
runvdr extreme ist ein runvdr-Skript, genau wie das runvdr-Skript aus
der VDR-Distribution. Es ist nur rund 17 mal größer.

Einige der Features von runvdr extreme:

- Lädt die Grundkonfiguration aus runvdr.conf
- Die gesamte Konfiguration kann per Kommandozeile gesetzt werden
- Alle VDR-Optionen werden unterstützt
- Verwaltet runvdr.pid Datei, reagiert auf Signale
- Kann einen X-Server für Ausgabe-Plugins starten
- Startet VDR im Falle von Fehlern neu
- Kommandos, um VDR neu zu starten und DVB-Treiber neu zu laden
- Beim VDR-Neustart wird die Konfiguration erneut gelesen
- Vermeidet endlose Schleifen, wenn VDR sofort stirbt
- Setzt Terminal zurück nachdem VDR beendet wurde
- Starten von Wrapper-Programmen zum Debuggen
- Wartet bis der VDR-Prozess beendet wurde,
  hartes Beenden nach Timeout
- Kommandozeilenhilfe
- Kann Konsole umschalten
- Kann Landessprache für VDR setzen
- Unterstützt Pluginsetup-Plugin optional
- Unterstützt Setup-Plugin optional

Dazu kommt runvdr-conf.d:

- Lädt Konfigurationsdateien alphabetisch aus einem Verzeichnis,
  vergleichbar mit init.d-Verzeichnissen.
- Kommandozeilentool zum Aktivieren/Deaktivieren von Plugins
- Festlegen der Ladereihenfolge
- Optional: Menüsteuerung per osdserver-Plugin



Schnellstart
--------------------------------------------------------------------------
- Kopiere runvdr nach /usr/local/bin/ oder wo-auch-immer-du-magst
- Kopiere runvdr.conf.example nach /etc/runvdr.conf, wenn runvdr als
  Server laufen soll, oder nach ~/.runvdr.conf, wenn runvdr durch
  einen Benutzer gestartet werden soll.
- Bearbeite /etc/runvdr.conf nach deinem Bedarf

Die runvdr.conf ist größtenteils selbsterklärend. Alle Optionen sind auch
per Kommandozeile verfügbar, siehe runvdr --help.

Für das init-Skript (Debian):
- Kopiere init.d.runvdr.Debian nach /etc/init.d/runvdr
- Benutze sysv-rc-conf oder update-rc.d um die Start-Runlevel zu konfigurieren.

Für runvdr-conf.d:
- Kopiere runvdr-conf.d nach /usr/local/bin/
- /etc/runvdr/ anlegen und mit Dateien nach Vorbild der skeleton.example
  füllen
- INCLUDE /etc/runvdr/conf.d/* in runvdr.conf aufnehmen
- runvdr-conf.d show|enable|disable zum Konfigurieren der Plugins verwenden
- (Optional) "runvdr-conf.d osdserver" in commands.conf hinzufügen.



Details
--------------------------------------------------------------------------

Die Optionen werden in dieser Reihenfolge ausgewertet:

1. Kommandozeilenoptionen haben höchste Priorität.
2. runvdr.conf auf Kommandozeile mit -C oder --runvdr-conf angegeben
3. Wenn kein -C und kein --runvdr-conf angegeben, benutze ~/.runvdr.conf
4. Wenn kein -C und kein --runvdr-conf und kein ~/.runvdr.conf, benutze
   /etc/runvdr.conf
5. Wenn keine der obigen Dateien existiert, benutze runvdr-Defaults

Der Standard-Name der Konfigurationsdatei wird gebildet aus dem Namen der
Applikation und dem Anhang ".conf". So kann man auf einfache Weise, ohne ständig
den -C Parameter angeben zu müssen, mehrere Konfigurationsdateien nutzen,
indem Symlinks auf runvdr erzeugt werden.

Nur eine runvdr.conf wird normalerweise geladen, und nur eine -C Option
wird ausgewertet. Man kann aber den Inhalt einer runvdr.conf in einer anderen
runvdr.conf laden, wenn man die INCLUDE-Direktive verwendet. Man kann zum
Beispiel /etc/runvdr.conf aus der Datei ~/.runvdr.conf heraus laden, um
für den aktuellen Benutzer einige Einstellungen zu überschreiben.

Die INCLUDE-Direktive kann auch mehrere Konfigurationsdateien laden. So kann
man z.B. mit INCLUDE /etc/runvdr/conf.d/* ein ganzes Verzeichnis von
Konfigurationsdateien laden. Beispielsweise könnten in so einem Verzeichnis
für jedes zu ladende Plugin eine Datei (oder Symlink) mit dem Einzeiler
"AddPlugin xxx" liegen.

Plugins, die durch die AddPlugin-Direktive in der conf-Datei oder die
--plugin oder -P Option geladen werden, können von der Plugin-Liste wieder
entfernt werden, wenn man "AddPlugin -name", --plugin="-name" oder -P-name
verwendet. Der name-Teil wird dabei als Muster für den Anfangsteil des Plugin-
Namens verwendet, alle Plugins, die auf "name*" passen, werden entfernt.
Insbesondere hebt "AddPlugin -" und -P- die gesamte bisherige Plugin-Liste
auf. Der selbe Mechanismus funktioniert auch beim -D Device-Parameter.

Um Parameter an VDR direkt weiter zu geben, ohne dass runvdr sie
interpretiert, kann -- als Parameter angegeben werden. Alle Parameter nach
-- werden unverändert an VDR weiter gegeben. So gibt "runvdr -- --help"
die Hilfestellung von VDR aus, und nicht die Hilfestellung von runvdr.



runvdr-conf.d
--------------------------------------------------------------------------

Mit runvdr-conf.d steht ein (optionales) Tool zur Verfügung, das das
Verwalten der Plugins erleichtern soll. Es funktioniert nach dem init.d
Prinzip, bei dem in einem Verzeichnis mehrere symbolische Links auf Dateien
abgelegt werden, die in alphabetischer Reihenfolge abgearbeitet werden.

Im Falle von runvdr-conf.d legt man pro zu ladendem Plugin eine eigene
Konfigurationsdatei nach Vorbild der skeleton.example in /etc/runvdr/ ab.
Geladen werden Plugins, deren symbolischer Link unter /etc/runvdr/conf.d
liegt. Dazu muss in der runvdr.conf die passende INCLUDE-Zeile aktiviert
werden.

Folgende Befehle stehen zur Verfügung, um die aktiven Plugins zu verwalten:

runvdr-conf.d show [name]
  Zeigt alle Plugins bzw. ein Plugin an, inklusive Name und Ladepriorität.
  'name' ist der Dateiname im Verzeichnis /etc/runvdr/.

runvdr-conf.d enable name [--prio XX]
  Aktiviere Plugin für nächsten Neustart. Verwendet Default-Priorität oder
  die angegebene Priorität. Dazu wird ein symbolischer Link auf die Datei
  /etc/runvdr/name unter /etc/runvdr/conf.d/XXname abgelegt.

runvdr-conf.d disable name
  Deaktiviert ein Plugin ab dem nächsten Neustart, d.h. löscht den Link
  unter /etc/runvdr/conf.d/XXname.

runvdr-conf.d osdserver [--debug]
  Verbindet mit OSD-Server Plugin und erlaubt das Konfigurieren der Plugins
  per VDR OSD. Von dort können Plugins aktiviert und deaktivert werden, und
  die Ladepriorität gesetzt werden.
  Ohne --debug kehrt runvdr-conf.d sofort zurück und trennt sich von der
  Standard-Ein/Ausgabe, kann also von der commands.conf direkt aufgerufen
  werden. Mit --debug wird die OSD-Server Kommunikation ausgegeben.



Voraussetzungen
--------------------------------------------------------------------------
Unix-Kommandos, die runvdr benutzt:

Kommando      Debian-Paket
 pgrep         procps
 ps            procps
 sleep         coreutils
 date          coreutils
 chvt          console-tools
 getopt        util-linux



Beispiele
--------------------------------------------------------------------------
Wenn die Standardeinstellungen in /etc/runvdr.conf vorgenommen sind, hier
ein paar coole Dinge, die man tun kann:


Starte VDR im Hintergrund (zum Beispiel mit TERMINAL=/dev/tty8 in conf-Datei):

  runvdr &

Stoppe VDR und das runvdr-Skript:

  runvdr --terminate

Dito, aber warte bis VDR beendet ist:

  runvdr --terminate --wait

Starte den bereits laufenden VDR-Prozess neu, weil er hängt, oder
weil die runvdr.conf geändert wurde:

  runvdr --restart

Dito, aber lade auch die DVB-Treiber neu:

  runvdr --dvb-restart

Benutze den frich neu übersetzten VDR zum ersten mal:

  runvdr --vdr=/usr/src/vdr-1.5.0/vdr --lib=/usr/src/vdr-1.5.0/PLUGINS/lib

Zum Debuggen, starte VDR ohne Terminalumlenkung:

  runvdr --terminal="" --switchterminal=""

Lade alle Plugins, und zusätzlich das hello-Plugin:

  runvdr -P hello

Lade nur das hello-Plugin:

  runvdr -P- -P hello

Lade alle Plugins, aber nicht das hello-Plugin:

  runvdr -P-hello

Starte einen Testlauf von runvdr, um zu sehen was passiert:

  runvdr --wrapper=echo

Starte eine Debugging-Session:

  runvdr --wrapper="gdb --args"

Starte mit einer komplett abweichenden Konfiguration:

  runvdr --runvdr-conf="/etc/runvdr-debugging.conf"