
This is a "plugin" for the Video Disk Recorder (VDR).

Written by:                  Jörg Wendel (horchi@vdr-portal)
Project's homepage:          http://www.jwendel.de
Latest version available at: vdr-developer.org

This software is released under the GPL, version 2 (see COPYING).
Additionally, compiling, linking, and/or using the OpenSSL toolkit in
conjunction with this software is allowed.

PIN Plugin:
-----------
Das Plugin ist eine Kindersicherung für Aufnahmen, Kanäle, Sendungen, Plugins und Shell-Skripten.
Der bis zu 5-stellige numerische PIN kann im Plugin-Setup Menü eingestellt werden.
Das freischalten mittels des PIN Codes erfolgt über den Menüpunkt 'Kindersicherung' im Hauptmenü.
Der Code wird nach jedem Neustart zurückgesetzt. Die Sperre kann jederzeit mit dem entsprechenden 
Menüpunktes oder auch automatisch nach einer einstellbaren Zeit aktiviert werden.

Es werden Aufnahmen in deren Ordner sich die Datei 'protection.fsk' befindet geschützt. 
Hierzu 'Aufnahmen->Befehle' - 'FSK Schutz hinzufügen' oder 'FSK Schutz entfernen' wählen. 
Plugin, Kanal- und Sendungs-Sperren werden über das Plugin-Menü verwaltet.

Zum Schutz von Shell-Skripten dient das Tool fskcheck, dieses stellt ein Shell-Interface zum 
PIN Plugin dar. Hierüber kann aus einem Skript bzw. von der Kommandozeile abgefragt werden ob die
Kindersicherung gerade aktiviert ist. Auch OSD Meldungen können mittels fskcheck angezeigt werden. 
Ein Beispiel Skript hierzu ist im Ordner scripts enthalten.

Es werden VDR Versionen ab 1.3.47 bis 2.0.2 unterstützt.

Installation:
-------------

 Plugin in .../VDR/PLUGINS/src/ 
 auspacken und Link anlegen.

 Ggf. dir Zeile EXCLUDEPLUGINS im Makefile anpassen, die hier aufgelisteten Plugins werden nicht 
 in der Sperrliste aufgefÃ¼hrt und lassen sich somit auch nicht sperren.

 PIN-Patch auf den VDR anwenden. 

   cd /usr/src/VDR
   cat PLUGINS/src/pin/patches/vdr-<version>.diff | patch  (etwaige rejects auflösen)
   make plugins
  
   ALLE Plugins neu gegen den gepatchten VDR übersezten und installieren!

 Das Skript fskprotect.sh und das tool fskcheck in den Suchpfad (PATH) z.B.: '/usr/local/bin' oder '/usr/bin' 
 kopieren und in die Konfigurationsdatei reccmd.conf eintragen. 

    Beispiel:

    cp -p /usr/src/VDR/PLUGINS/src/pin/scripts/*.sh /usr/bin
    cp -p /usr/src/VDR/PLUGINS/src/pin/fskcheck /usr/bin
    echo 'FSK Schutz hinzufügen: /usr/bin/fskprotect.sh protect'   >> /etc/vdr/reccmds.conf
    echo 'FSK Schutz entfernen:  /usr/bin/fskprotect.sh unprotect' >> /etc/vdr/reccmds.conf

 Bitte die beiden unteren Zeilen nicht so in die reccmds.conf eintragen sondern auf der Kommandozeile ausführen ;) !

 Beim scheiden einer Aufnahme wird diese vom VDR umkopiert, diese Kopie ist nun nicht gesperrt!
 Um die Sperre automatisch zu übernehmen das beim Start des VDR mit der Option -r angegebene 
 Skript (noadcall.sh, vdr-recordingaction, ...) um den Code aus scripts/cut.sh erweitern.
