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

Written by:                  Jrg 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 fr Aufnahmen, Kanle, 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 Menpunkt 'Kindersicherung' im Hauptmen.
Der Code wird nach jedem Neustart zurckgesetzt. Die Sperre kann jederzeit mit dem entsprechenden 
Menpunktes oder auch automatisch nach einer einstellbaren Zeit aktiviert werden.

Es werden Aufnahmen in deren Ordner sich die Datei 'protection.fsk' befindet geschtzt. 
Hierzu 'Aufnahmen->Befehle' - 'FSK Schutz hinzufgen' oder 'FSK Schutz entfernen' whlen. 
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. Hierber kann aus einem Skript bzw. von der Kommandozeile abgefragt werden ob die
Kindersicherung gerade aktiviert ist. Auch OSD Meldungen knnen 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 untersttzt.

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 auflsen)
   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 hinzufgen: /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 ausfhren ;) !

 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.
