Grundvoraussetzungen

Zunächst benötigst du einige Tools rund ums Compilieren und Bauen von Debian-Paketen. Mit dem folgenden Kommando, werden diese "Essentials" installiert:

apt-get install dpkg-dev gcc g++ libc6-dev make patch fakeroot

Noch einfacher, geht das auch so:

apt-get install build-essential fakeroot

Es ist übrigens nicht erforderlich, die Pakete für VDR auch auf dem VDR-Rechner zu erzeugen. Dies kann genauso gut auch auf jedem anderen Rechner mit Debian-Woody geschehen.

Falls du ein vorbildlicher Linux-User sein willst, so möchtest du sicher nicht als root die Pakete erstellen. Der Benutzer unter dem du angemeldet bist, sollte in diesem Fall der Gruppe src angehören. Ausserdem ist es dann erforderlich, bestimmte Befehle wie z.B. dpkg-buildpackage oder debian/rules (mehr dazu später) mit fakeroot auszuführen:

fakeroot dpkg-buildpackage .....
fakeroot debian/rules ..... 

Um neue Pakete zu installieren, kannst du dich mittels su kurzfristig als root anmelden und dann mit exit wieder abmelden. Alternativ kannst du jeden Befehl, der root-Rechte erfordert, auch mittels sudo <Befehl> ausführen. Letzteres setzt natürlich voraus, dass du als Benutzer dazu berechtigt bist.

Installation der Quelltextpakete

Die Installation von Quelltextpaketen erfolgt, wie auch bei den Binärpaketen, am einfachsten mittels apt-get, jedoch mit dem Kommando source. Der einzige Unterschied ist, dass abhängige Entwicklerpakete (z.B. mit den Headerdateien der verwendeten Bibliotheken) nicht automatisch mit installiert werden. Hierfür ist noch ein zweiter Aufruf mit dem Kommando build-dep notwendig:

apt-get source <paketname>
apt-get build-dep <paketname>

Ach und noch einen Unterschied gibt es: Die Quelltextpakete werden automatisch in das momentane Arbeitsverzeichnis heruntergeladen und entpackt. Um nicht den überblick zu verlieren, legst du also am besten vorher ein paar Unterverzeichnisse an. üblicher Weise sollten diese Verzeichnisse unterhalb von /usr/src/ liegen. Aus dem angelegten Verzeichnis heraus, brauchst du dann lediglich noch die Installation des entsprechenden Quelltextpaketes starten. Um z.B. die Quelltexte der Pakete vdr und vdr-plugin-mp3 zu installieren, kannst du wie folgt vorgehen:

mkdir /usr/src/vdr 
mkdir /usr/src/vdr-plugin-mp3 

cd /usr/src/vdr 
apt-get source vdr 
apt-get build-dep vdr 

cd /usr/src/vdr-plugin-mp3
apt-get source vdr-plugin-mp3
apt-get build-dep vdr-plugin-mp3 

Danach liegen im Verzeichnis /usr/src/vdr drei Dateien. Die Datei vdr_1.2.6.orig.tar.gz enthält die Upstream- Version 1.2.6 von VDR. Als Upstream-Version wird die originale "nicht- Debian-Version" des Entwicklers bezeichnet. vdr_1.2.6-7.diff.tar.gz enthält alle Änderungen, die notwendig sind, um aus der Upstream-Version ein Debian-Paket zu machen. Die dritte Datei, vdr_1.2.6- 7.dsc, enthält Informationen über das Paket, wie z.B. die zum Compilieren benötigten abhängigen Pakete. Neben dem Download dieser drei Dateien, wurden von apt-get source auch gleich die Upstream-Version in das Verzeichnis vdr-1.2.6 entpackt und die notwendigen änderungen aus dem diff-File darauf angewendet. Letzteres kannst du mit dem folgenden Befehl auch jederzeit manuell tun:

dpkg-source -x vdr_1.2.6-7.dsc

Da die Entwicklung der Pakete schneller voranschreitet als ich diese Anleitung aktuell halten kann, sind alle angegebenen Paketversionen natürlich durch die aktuelle Version zu ersetzen (statt 1.2.6-7 also z.B. 1.2.6-9).

Compilieren von Paketen

Jetzt wo die Quelltextpakete und die dazugehörigen Entwicklerpakete installiert sind, ist es an der Zeit zu testen, ob sich alles erwartungsgemäß compilieren lässt. Hierzu wechselst du in das entsprechende Quelltextverzeichnis (In unserem Beispiel wäre das /usr/src/vdr/vdr-1.2.6/) und rufst den folgenden Befehl auf:

debian/rules binary

debian/rules ist ein Makefile, welches in einem ersten Schritt das Makefile der eigentlichen Software aufruft um das Compilieren zu starten. In einem zweiten Schritt sucht debian/rules alle notwendigen Dateien zusammen und erstellt ein Debian-Paket im übergeordneten Verzeichnis (also /usr/src/vdr/), welches sofort installiert werden kann. Um den beim Compilieren entstandenen Unrat aufzuräumen, kannst du dann noch folgenden Befehl ausführen:

debian/rules clean

Das ganze lässt sich sogar noch vereinfachen, indem du statt der obigen zwei Befehle einfach folgendes aufrufst:

dpkg-buildpackage -tc

Damit wird aber nicht einfach nur "blind" ein Debian-Paket erzeugt. Zuvor prüft dpkg-buildpackage noch, ob alle Abhängigkeiten erfüllt sind. Ist dies nicht der Fall, hast du wahrscheinlich das apt-get build-dep vergessen (siehe oben). Sind alle Abhängigkeiten erfüllt, compiliert dpkg-buildpackage das Paket. Die Option - tc weist dpkg-buildpackage zudem an, hinterher gleich wieder aufzuräumen. Das fertige Binärpaket (*.deb) findest du zusammen mit einem neu erzeugten Quelltextpaket wiederum im übergeordneten Verzeichnis (/usr/src/vdr/).

dpkg-buildpackage versucht ausserdem, die erzeugten Sources und die Changes-Datei zu signieren, falls z.B. GnuPG installiert ist. Wenn du jedoch keinen GnuPG-Key erzeugt hast, kannst du mit den Optionen -uc -us das Signieren verhindern. (Besten Dank an Thomas für diesen Hinweis.)

VDR-Patches

Im Vergleich zum manuellen Patchen, wo man spätestens bei zwei oder mehr Patches nicht umhin kommt, selber in die Quelltexte einzugreifen, hat sich das Patchen in der neuen VDR-Version sehr vereinfacht. Dennoch musst du ein paar Dinge beachten:

** Nicht alle Patches lassen sich in jeder beliebigen Kombination

und Reihenfolge anwenden. Entsprechende Hinweise dazu, welcher
Patch sich mit welchem kreuzen lässt, sind in den Patch-Dateien
selbst und in der Patchliste zu finden. 

** Die meisten Patches modifizieren VDR so stark, dass alle Plugins

für diese VDR-Version ebenfalls neu compiliert werden müssen. Wie
das gemacht wird, erkläre ich später noch im Detail.

Patches auswählen

Jeder einzelne Patch liegt im Verzeichnis debian/patches und trägt folgenden Namen:

<nn>_<patchname>.dpatch

<nn> ist dabei eine zweistellige Nummer, welche die Reihenfolge kennzeichnet, in der die Patches angewendet werden sollen. Welche Patches verwendet werden, kannst du in der Datei 00list festlegen. Hier sind alle Patches (ohne die .dpatch- Endung) aufgeführt. Zudem können Kommentare eingefügt werden, die durch ein vorangestelltes "#" gekennzeichnet sind. Um einen Patch zu aktivieren, oder zu deaktivieren, musst du also nur das vorangestellte "#" entfernen oder hinzufügen. Eine Patchliste, welche nur den Elchi und den ImprovedOSD-Patch aktiviert, würde z.B. so aussehen:

# to share one connection with several dvb cards
#10_sharelnb

# to allow channel editing with channels for analogtv-plugin
# (use this patch only, if you DON'T use the autopid-patch)
#12_analogtv

# to add submenus within the recording menu
#15_reccmdsubmenu125

# The Elchi AIO 3c patch for a nicer OSD:
20_elchiaio3c

# The Improved OSD patch, which extends the Elchi AIO patch:
21_improvedosd-3a

# The AC3overDVB patch for a outputting AC3 streams over the DVB card:
#25_ac3overdvb-0.2.4

# The AutoPID patch for automatic PID adjustment of channels:
# ( use this patch only, if you use the ac3overdvb-0.2.3 patch too !!! )
#30_autopid_ac3overdvb

# The AutoPID patch for automatic PID adjustment of channels:
# ( use this patch only, if you DON'T use the ac3overdvb-0.2.3 patch !!! )
#30_autopid

# to allow channel editing with channels for analogtv-plugin
# ( use this patch only, if you use one of the autopid-patches too !!!)
#32_analogtvautopid

# The Jump patch allows automatic jumping over cutting marks.
# It requires the following patches: elchiaio3c, ac3overdvb, autopid
#35_jumpplay-0.0

# to share one connection with several dvb cards
# ( use this patch only, if you use one of the autopid-patches too !!!)
#40_sharelnbautopid

Die Patches werden von debian/rules binary vor dem Compilieren automatisch angewendet und mit einem debian/rules clean wieder rückgängig gemacht. Die Patchliste sollte immer nur nach einem debian/rules clean geändert werden, damit sich die Quelltexte wieder in einem ungepatchten Zustand befinden, bevor man etwas ändert. Alternativ kannst du auch, wie oben bereits beschrieben, dpkg-buildpackage -tc verwenden.

Läuft beim Patchen etwas schief, weil du z.B. zwei Patches ausgewählt hast, die sich gegenseitig behindern, so befindet sich der Quelltext in einem undefinierten Patch-Zustand. Der zweite Patch konnte nur zum Teil angewendet werden und kann daher auch nicht so ohne weiteres rückgängig gemacht werden. In solch einem Fall solltest du das Quelltextpaket neu installieren, indem du folgendes ausführst:

dpkg-source -x vdr_1.2.6-7.dsc

Plugins neu compilieren

Die Patches nehmen auch änderungen an den Schnittstellen vor, welche von den VDR-Plugins verwendet werden. Daher ist es i.d.R. unerlässlich, nach änderung des Patchlevels auch die Plugins neu zu compilieren. Beim Starten von VDR lädt das init-Skript zudem nur die Plugins, die mit dem selben VDR-Patchlevel compiliert wurden, wie das installierte VDR. Zwar lässt sich dies umgehen, aber ich kann nur dazu raten, lieber alle Plugins neu zu compilieren. Fehler durch inkompatible Schnittstellen können so von vornherein ausgeschlossen werden.

Damit die Plugins mit dem richtigen VDR-Entwickler-Paket aus der neu erstellten Patchvariante compiliert werden, musst du dieses zunächst installieren. Das entsprechende Entwicklerpaket wurde beim Compilieren automatisch in /usr/src/vdr/ erzeugt. Mit folgendem Aufruf, kannst du es installieren:

dpkg -i vdr-dev_1.2.6-7.deb

Hierfür kann es wieder erforderlich sein, dass du dich zuerst als root anmeldest (z.B. mit su) oder den Befehl mittels sudo ausführst. Danach können alle Plugins mit debian/rules binary oder dpkg-buildpackage neu compiliert werden. In unserem Beispiel, wäre dies nur vdr-plugin-mp3:

cd /usr/src/vdr-plugin-mp3/vdr-plugin-mp3-0.8.2
dpkg-buildpackage -tc

Ein lokales Repository anlegen

Um die Installation der neu erzeugten Pakete zu vereinfachen, bietet es sich an, ein eigenes kleines Repository zu erzeugen. Dieses kann dann in die sources.list eingetragen und von apt-get verwendet werden. Hierzu solltest du dir zunächst ein geeignetes Verzeichnis (z.B. /var/local/vdr-repository/) anlegen und dorthinein alle erzeugten .deb-Dateien legen. Zudem musst du in diesem Verzeichnis noch eine Datei Release** mit folgendem Inhalt anlegen:

Archive: stable
Component: main
Origin: Meins!
Label: Mein persönliches Debian repository
Architecture: i386

Um die Datei Packages.gz zu erzeugen rufst du dann noch den folgenden Befehl in deinem Repository-Verzeichnis auf:

dpkg-scanpackages ./ /dev/null | gzip -9c >Packages.gz

Das Repository-Verzeichnis kannst du dann über einen http- bzw. ftp-Server oder mittels des folgenden Eintrages in die sources.list direkt verfügbar machen:

deb file:/var/local/vdr-repository ./