Quelltext der Seite DEBIAN ETCH PAKETE ERSTELLEN

DEBIAN ETCH PAKETE ERSTELLEN (Stand 12.06.2009) [ © Oliver Schuetz aka OppTupacShakur | http://OPPServer.net | http://unix.oppserver.net ]

Als erstes benoetigte Pakete zum bauen installen:

 aptitude install build-essential dpkg-dev devscripts expect fakeroot wget libssl-dev gettext dpatch dh-make libc6-dev gcc


VDROLDSTABLE (1.4.7)


Als User (opp) ausfuehren:
 cd /etc/apt
 sudo rm -rf /etc/apt/sources.list
 sudo cp /etc/apt/sources.list.vdroldstable-build /etc/apt/sources.list
 sudo aptitude update
 cd /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdroldstable
 sudo apt-get source vdr
 sudo apt-get build-dep vdr
 sudo chown -R opp:users *
 rm -fv *.diff.gz && rm -fv *.dsc
 cd vdr-*
 mv channels.conf channels.conf.old
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19/opp/channels.conf .
 mv channels.conf channels.conf.opp.astra19
 cp /linux/pub/dvb/bouquets/vdr/sat/astra23/opp/channels.conf .
 mv channels.conf channels.conf.opp.astra23
 cp /linux/pub/dvb/bouquets/vdr/sat/hotbird13/opp/channels.conf .
 mv channels.conf channels.conf.opp.hotbird13
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19+hotbird13/opp/channels.conf .
 mv channels.conf channels.conf.opp.astra19+hotbird13
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19+hotbird13+astra23/opp/channels.conf .
 mv channels.conf channels.conf.opp.astra19+hotbird13+astra23
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19+astra23/opp/channels.conf .
 mv channels.conf channels.conf.opp.astra19+astra23
 cp /linux/pub/dvb/bouquets/vdr/sat/hotbird13+astra23/opp/channels.conf .
 mv channels.conf channels.conf.opp.hotbird13+astra23
 cp /linux/pub/dvb/bouquets/vdr/terrestrisch/nrw/opp/channels.conf .
 mv channels.conf channels.conf.opp.terr
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19/opp/channels.conf .
 mv diseqc.conf diseqc.conf.old
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19.2-hotbird13.0_diseqc.conf .
 mv astra19.2-hotbird13.0_diseqc.conf diseqc.conf.astra19.2-hotbird13.0
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19.2-hotbird13.0-astra23.5_diseqc.conf .
 mv astra19.2-hotbird13.0-astra23.5_diseqc.conf diseqc.conf.astra19.2-hotbird13.0-astra23.5
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19.2-hotbird13.0-astra23.5-astra28.0_diseqc.conf .
 mv astra19.2-hotbird13.0-astra23.5-astra28.0_diseqc.conf diseqc.conf.astra19.2-hotbird13.0-astra23.5-astra28.0
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19.2-astra23.5_diseqc.conf .
 mv astra19.2-astra23.5_diseqc.conf diseqc.conf.astra19.2-astra23.5
 cp /linux/pub/dvb/bouquets/vdr/sat/hotbird13.0-astra23.5_diseqc.conf .
 mv hotbird13.0-astra23.5_diseqc.conf diseqc.conf.hotbird13.0-astra23.5
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19.2-hotbird13.0_diseqc.conf .
 mv astra19.2-hotbird13.0_diseqc.conf diseqc.conf
 chmod 644 channels.conf*
 chmod 644 diseqc.conf*
 cd debian/
 mv vdr.postinst vdr.postinst.old
 grep -v 'exit 0' vdr.postinst.old > vdr.postinst
 echo 'if [ ! -d /video ] ; then' >> vdr.postinst
 echo '     mkdir /video' >> vdr.postinst
 echo 'fi' >> vdr.postinst
 echo >> vdr.postinst
 echo 'chown vdr:vdr /video' >> vdr.postinst
 echo >> vdr.postinst
 echo 'if [ -d /var/lib/video.00 ] ; then' >> vdr.postinst
 echo '     mv -f /var/lib/video.00/* /video > /dev/null 2>&1' >> vdr.postinst
 echo '     rm -rf /var/lib/video.00' >> vdr.postinst
 echo '     ln -s /video /var/lib/video.00' >> vdr.postinst
 echo 'fi' >> vdr.postinst
 echo >> vdr.postinst
 echo 'if [ ! -e /usr/lib/hotplug/firmware/dvb-ttpci-01.fw-2622 ] ; then' >> vdr.postinst
 echo 'wget http://www.linuxtv.org/downloads/firmware/dvb-ttpci-01.fw-2622 -O /usr/lib/hotplug/firmware/dvb-ttpci-01.fw-2622' >> vdr.postinst
 echo 'fi' >> vdr.postinst
 echo >> vdr.postinst
 echo 'if [ -e /usr/lib/hotplug/firmware/dvb-ttpci-01.fw ]; then' >> vdr.postinst
 echo 'rm /usr/lib/hotplug/firmware/dvb-ttpci-01.fw' >> vdr.postinst
 echo 'fi' >> vdr.postinst
 echo 'ln -s /usr/lib/hotplug/firmware/dvb-ttpci-01.fw-2622 /usr/lib/hotplug/firmware/dvb-ttpci-01.fw' >> vdr.postinst
 echo >> vdr.postinst
 echo 'exit 0' >> vdr.postinst
 rm vdr.postinst.old

Dann in vdr.postrm folgendes aendern:

    purge)

in

    purge)
        if [ -L /var/lib/video.00 ] ; then
             rm /var/lib/video.00
        fi

 echo 'tmp/pmt.tmp    var/tmp/pmt.tmp' >> vdr.links
 echo 'tmp/pmt0.tmp    var/tmp/pmt0.tmp' >> vdr.links
 echo 'tmp/pmt1.tmp    var/tmp/pmt1.tmp' >> vdr.links
 echo 'tmp/pmt2.tmp    var/tmp/pmt2.tmp' >> vdr.links
 echo 'tmp/pmt3.tmp    var/tmp/pmt3.tmp' >> vdr.links
 echo 'tmp/pmt4.tmp    var/tmp/pmt4.tmp' >> vdr.links
 echo 'tmp/pmt5.tmp    var/tmp/pmt5.tmp' >> vdr.links

Nun die changelog kopieren:
 mv changelog changelog.bkp
 cp -v /linux/repository/dists/etch/$(uname -m)/opp-vdr/opp-vdr-patches/vdroldstable/multipatch/debian/changelog .
 chmod 644 changelog
Nun bearbeiten und dann das Backup loeschen:
 rm changelog.bkp

Backup kopieren:
 rm /linux/repository/dists/etch/$(uname -m)/opp-vdr/opp-vdr-patches/vdroldstable/multipatch/debian/changelog
 cp -v changelog /linux/repository/dists/etch/$(uname -m)/opp-vdr/opp-vdr-patches/vdroldstable/multipatch/debian/changelog

Nun die copyright kopieren:
 mv copyright copyright.bkp
 cp -v /linux/repository/dists/etch/$(uname -m)/opp-vdr/opp-vdr-patches/vdroldstable/multipatch/debian/copyright .
 chmod 644 copyright
Nun bearbeiten und dann das Backup loeschen:
 rm copyright.bkp

Backup kopieren:
 rm /linux/repository/dists/etch/$(uname -m)/opp-vdr/opp-vdr-patches/vdroldstable/multipatch/debian/copyright
 cp -v copyright /linux/repository/dists/etch/$(uname -m)/opp-vdr/opp-vdr-patches/vdroldstable/multipatch/debian/copyright

 cd patches
 rm 00list
 wget http://www.e-tobi.net/vdr-testing/pool-etch/patchlists/multipatch.00list
 mv multipatch.00list 00list
 echo >> 00list
 echo '# opp-sc-patch' >> 00list
 echo opt-999_opp-sc-patch >> 00list
 echo >> 00list
 echo '# api5 patch' >> 00list
 echo vdr-dvb-api-5-is-fine >> 00list
 cp -v /linux/repository/dists/etch/$(uname -m)/opp-vdr/opp-vdr-patches/vdroldstable/multipatch/debian/patches/* .
 chmod 644 *
 cd /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdroldstable
 sudo chown -R opp:users *
 cd vdr-*
 dpkg-buildpackage -rfakeroot -us -uc -sa -tc
 cd /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdroldstable
 cp -v *.deb *.changes vdr_1.* /mirror/debian.oppserver.net/incoming/vdroldstable/etch/

Nun die Revision fuer die Plugins anpassen:
 expr `cat /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdroldstable/revision` + 1 > /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdroldstable/revision

 cd /etc/apt
 sudo rm -r sources.list
 sudo cp /etc/apt/sources.list.orig.vdroldstable /etc/apt/sources.list
 sudo aptitude update



VDR (1.6.0)


Als user (opp) ausfuehren:
 cd /etc/apt
 sudo rm -rf /etc/apt/sources.list
 sudo cp /etc/apt/sources.list.vdr-build /etc/apt/sources.list
 sudo aptitude update
 cd /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdr
 sudo apt-get source vdr
 sudo apt-get build-dep vdr
 sudo chown -R opp:users *
 rm -fv *.diff.gz && rm -fv *.dsc
 cd vdr-*
 mv channels.conf channels.conf.old
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19/opp/channels.conf .
 mv channels.conf channels.conf.opp.astra19
 cp /linux/pub/dvb/bouquets/vdr/sat/astra23/opp/channels.conf .
 mv channels.conf channels.conf.opp.astra23
 cp /linux/pub/dvb/bouquets/vdr/sat/hotbird13/opp/channels.conf .
 mv channels.conf channels.conf.opp.hotbird13
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19+hotbird13/opp/channels.conf .
 mv channels.conf channels.conf.opp.astra19+hotbird13
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19+hotbird13+astra23/opp/channels.conf .
 mv channels.conf channels.conf.opp.astra19+hotbird13+astra23
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19+astra23/opp/channels.conf .
 mv channels.conf channels.conf.opp.astra19+astra23
 cp /linux/pub/dvb/bouquets/vdr/sat/hotbird13+astra23/opp/channels.conf .
 mv channels.conf channels.conf.opp.hotbird13+astra23
 cp /linux/pub/dvb/bouquets/vdr/terrestrisch/nrw/opp/channels.conf .
 mv channels.conf channels.conf.opp.terr
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19/opp/channels.conf .
 mv diseqc.conf diseqc.conf.old
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19.2-hotbird13.0_diseqc.conf .
 mv astra19.2-hotbird13.0_diseqc.conf diseqc.conf.astra19.2-hotbird13.0
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19.2-hotbird13.0-astra23.5_diseqc.conf .
 mv astra19.2-hotbird13.0-astra23.5_diseqc.conf diseqc.conf.astra19.2-hotbird13.0-astra23.5
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19.2-hotbird13.0-astra23.5-astra28.0_diseqc.conf .
 mv astra19.2-hotbird13.0-astra23.5-astra28.0_diseqc.conf diseqc.conf.astra19.2-hotbird13.0-astra23.5-astra28.0
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19.2-astra23.5_diseqc.conf .
 mv astra19.2-astra23.5_diseqc.conf diseqc.conf.astra19.2-astra23.5
 cp /linux/pub/dvb/bouquets/vdr/sat/hotbird13.0-astra23.5_diseqc.conf .
 mv hotbird13.0-astra23.5_diseqc.conf diseqc.conf.hotbird13.0-astra23.5
 cp /linux/pub/dvb/bouquets/vdr/sat/astra19.2-hotbird13.0_diseqc.conf .
 mv astra19.2-hotbird13.0_diseqc.conf diseqc.conf
 chmod 644 channels.conf*
 chmod 644 diseqc.conf*
 cd debian/
 mv vdr.postinst vdr.postinst.old
 grep -v 'exit 0' vdr.postinst.old > vdr.postinst
 echo 'if [ ! -d /video ] ; then' >> vdr.postinst
 echo '     mkdir /video' >> vdr.postinst
 echo 'fi' >> vdr.postinst
 echo >> vdr.postinst
 echo 'chown vdr:vdr /video' >> vdr.postinst
 echo >> vdr.postinst
 echo 'if [ -d /var/lib/video.00 ] ; then' >> vdr.postinst
 echo '     mv -f /var/lib/video.00/* /video > /dev/null 2>&1' >> vdr.postinst
 echo '     rm -rf /var/lib/video.00' >> vdr.postinst
 echo '     ln -s /video /var/lib/video.00' >> vdr.postinst
 echo 'fi' >> vdr.postinst
 echo >> vdr.postinst
 echo 'if [ ! -e /usr/lib/hotplug/firmware/dvb-ttpci-01.fw-2622 ] ; then' >> vdr.postinst
 echo 'wget http://www.linuxtv.org/downloads/firmware/dvb-ttpci-01.fw-2622 -O /usr/lib/hotplug/firmware/dvb-ttpci-01.fw-2622' >> vdr.postinst
 echo 'fi' >> vdr.postinst
 echo >> vdr.postinst
 echo 'if [ -e /usr/lib/hotplug/firmware/dvb-ttpci-01.fw ]; then' >> vdr.postinst
 echo 'rm /usr/lib/hotplug/firmware/dvb-ttpci-01.fw' >> vdr.postinst
 echo 'fi' >> vdr.postinst
 echo 'ln -s /usr/lib/hotplug/firmware/dvb-ttpci-01.fw-2622 /usr/lib/hotplug/firmware/dvb-ttpci-01.fw' >> vdr.postinst
 echo >> vdr.postinst
 echo 'exit 0' >> vdr.postinst
 rm vdr.postinst.old

Dann in vdr.postrm folgendes aendern:

    purge)

in

    purge)
        if [ -L /var/lib/video.00 ] ; then
             rm /var/lib/video.00
        fi

 echo 'tmp/pmt.tmp    var/tmp/pmt.tmp' >> vdr.links
 echo 'tmp/pmt0.tmp    var/tmp/pmt0.tmp' >> vdr.links
 echo 'tmp/pmt1.tmp    var/tmp/pmt1.tmp' >> vdr.links
 echo 'tmp/pmt2.tmp    var/tmp/pmt2.tmp' >> vdr.links
 echo 'tmp/pmt3.tmp    var/tmp/pmt3.tmp' >> vdr.links
 echo 'tmp/pmt4.tmp    var/tmp/pmt4.tmp' >> vdr.links
 echo 'tmp/pmt5.tmp    var/tmp/pmt5.tmp' >> vdr.links

Nun die changelog kopieren:
 mv changelog changelog.bkp
 cp -v /linux/repository/dists/etch/$(uname -m)/opp-vdr/opp-vdr-patches/vdr/multipatch/debian/changelog .
 chmod 644 changelog
Nun bearbeiten und dann das Backup loeschen:
 rm changelog.bkp

Backup kopieren:
 rm /linux/repository/dists/etch/$(uname -m)/opp-vdr/opp-vdr-patches/vdr/multipatch/debian/changelog
 cp -v changelog /linux/repository/dists/etch/$(uname -m)/opp-vdr/opp-vdr-patches/vdr/multipatch/debian/changelog

Nun die copyright kopieren:
 mv copyright copyright.bkp
 cp -v /linux/repository/dists/etch/$(uname -m)/opp-vdr/opp-vdr-patches/vdr/multipatch/debian/copyright .
 chmod 644 copyright
Nun bearbeiten und dann das Backup loeschen:
 rm copyright.bkp

Backup kopieren:
 rm /linux/repository/dists/etch/$(uname -m)/opp-vdr/opp-vdr-patches/vdr/multipatch/debian/copyright
 cp -v copyright /linux/repository/dists/etch/$(uname -m)/opp-vdr/opp-vdr-patches/vdr/multipatch/debian/copyright

 cd /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdr
 sudo chown -R opp:users *
 cd vdr-*
 PATCHVARIANT=multipatch dpkg-buildpackage -rfakeroot -us -uc -sa -tc
 cd /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdr
 cp -v *.deb *.changes vdr_1.* /mirror/debian.oppserver.net/incoming/vdr/etch/

Nun die Revision fuer die Plugins anpassen:
 expr `cat /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdr/revision` + 1 > /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdr/revision

 cd /etc/apt
 sudo rm -r sources.list
 sudo cp /etc/apt/sources.list.orig.vdr /etc/apt/sources.list
 sudo aptitude update



VDROLDSTABLE-PLUGINS (Beispiel vdr-plugin-xineliboutput)


Als User (opp) ausfuehren:

 cd /etc/apt
 sudo rm -r sources.list
 sudo cp /etc/apt/sources.list.orig.vdroldstable /etc/apt/sources.list
 sudo aptitude update

Als erstes das neu erstellte vdr-dev installieren:
 sudo aptitude remove vdr-dev
 sudo aptitude install vdr-dev

 cd /etc/apt
 sudo rm -rf /etc/apt/sources.list
 sudo cp /etc/apt/sources.list.vdroldstable-build /etc/apt/sources.list
 sudo aptitude update

 mkdir /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdroldstable-plugins/vdr-plugin-xineliboutput
 cd /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdroldstable-plugins/vdr-plugin-xineliboutput
 sudo apt-get source vdr-plugin-xineliboutput
 sudo apt-get build-dep vdr-plugin-xineliboutput
 sudo chown -R opp:users *
 mv -f *.diff.gz *.dsc /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdroldstable-plugins/originale/
 cp -rf * /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdroldstable-plugins/originale/
 cd vdr-*

Jetz die changelog in debian editieren.

 dpkg-buildpackage -rfakeroot -us -uc -sa -tc

 cd ..
 cp -v *.deb *.changes *.diff.gz *.orig.tar.gz *.dsc /mirror/debian.oppserver.net/incoming/vdroldstable/etch/
 cp -v *.deb *.changes *.diff.gz *.orig.tar.gz *.dsc /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdroldstable-plugins/opp/

 cd /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdroldstable-plugins/
 rm -r vdr-plugin-xineliboutput

 cd /etc/apt
 sudo rm -r sources.list
 sudo cp /etc/apt/sources.list.orig.vdroldstable /etc/apt/sources.list
 sudo aptitude update

Oder am besten per script ;)



VDR-PLUGINS (Beispiel vdr-plugin-xineliboutput)


Als User (opp) ausfuehren:

 cd /etc/apt
 sudo rm -r sources.list
 sudo cp /etc/apt/sources.list.orig.vdr /etc/apt/sources.list
 sudo aptitude update

Als erstes das neu erstellte vdr-dev installieren:
 sudo aptitude remove vdr-dev
 sudo aptitude install vdr-dev

 cd /etc/apt
 sudo rm -rf /etc/apt/sources.list
 sudo cp /etc/apt/sources.list.vdr-build /etc/apt/sources.list
 sudo aptitude update

 mkdir /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdr-plugins/vdr-plugin-xineliboutput
 cd /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdr-plugins/vdr-plugin-xineliboutput
 sudo apt-get source vdr-plugin-xineliboutput
 sudo apt-get build-dep vdr-plugin-xineliboutput
 sudo chown -R opp:users *
 mv -f *.diff.gz *.dsc /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdr-plugins/originale/
 cp -rf * /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdr-plugins/originale/
 cd vdr-*

Jetzt die changelog in debian editieren.

 dpkg-buildpackage -rfakeroot -us -uc -sa -tc

 cd ..
 cp -v *.deb *.changes *.diff.gz *.orig.tar.gz *.dsc /mirror/debian.oppserver.net/incoming/vdr/etch/
 cp -v *.deb *.changes *.diff.gz *.orig.tar.gz *.dsc /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdr-plugins/opp/

 cd /linux/repository/dists/etch/$(uname -m)/opp-vdr/vdr-plugins/
 rm -r vdr-plugin-xineliboutput

 cd /etc/ap
 sudo rm -r sources.list
 sudo cp /etc/apt/sources.list.orig.vdr /etc/apt/sources.list
 sudo aptitude update

Oder am besten per Script ;)


DEBIAN AUS DER SOURCE (VDR PAKETE)

Packet entpacken und ins Verzeichnis wechseln.
 debianize-vdrplugin
Dies erstellt den debian/ ordner mit folgenden Dateien die bearbeitet werden muessen:

1. README.Debian

Gibt es irgendwelche Hinweise, die speziell das Debian-Paket betreffen? Musstest du Aenderungen vornehmen, damit das Plug-in unter Debian funktioniert? Solche und aehnliche Informationen gehoeren, moeglichst in Englisch, in diese Datei. Hast du keine derartigen Anmerkungen, kannst du die README.Debian loeschen.

Im Fall des Beep-Plug-ins kann die Datei geloescht werden.

2. changelog (dh_installchangelog)

Evtl. musst du hier deinen Namen und die Email-Adresse als Maintainer eintragen. Neben "Initial Release" sind fuer die erste Version eines Paketes meist keine weiteren Informationen erforderlich.

3. control

Auch hier musst du Name und Email-Adresse ueberpruefen. Sollte das Paket spezielle Bibliotheken benoetigen, musst du die enstprechenden lib*-dev-Pakte bei den Build-Depends im Source-Abschnitt eintragen. Diese Bibliotheken muessen im Feld Depends NICHT wiederholt werden. Beim Erzeugen des Paketes wird ${shlibs:Depends} automatisch durch die Liste der verwendeten Bibliotheken ersetzt (dh_shlibdeps). Die Zeilen mit den Abhaengigkeiten duerfen nicht umbrochen werden!

Im Feld Description fehlt noch eine kurze und eine etwas ausfuehrlichere Beschreibung in Englisch. Oftmals kannst du diese aus der README uebernehmen.

Das beep-Plug-in besitzt keine speziellen Abhaengigkeiten. Das Description-Feld koennte so aussehen:

Description: VDR-plugin to give acoustic feedback for selected events
 This Plugin notifies the user with a beep from the internal mainboard speaker,
 when selected VDR events occur.

4. copyright

Ehre, wem Ehre gebuehrt! Hier musst du eintragen, von wo du das Plug-in heruntergeladen hast und wer der Autor ist. Auch solltest du pruefen, ob der Verweis auf die GPL2 auch wirklich zutrifft und das Plug-in nicht etwa einer ganz anderen Lizenz unterliegt.

Fuer das beep-Plug-in saehe das so aus:


It was downloaded from http://deltab.de/vdr/beep.html 

Upstream Author: Andreas Brachold <vdr04 at deltab de>


5. docs (dh_installdocs)

Hier werden alle Dateien aufgelistet, welche in die Rubrik Dokumentation fallen. Das ist fast immer zumindest die README-Datei. Die hier aufgefuehrten Dateien werden dann nach /usr/share/doc/ installiert.

Das Beep-Plug-in braucht nur die README.

6. install (dh_install)

Oftmals werden die zu installierenden Dateien in debian/rules kopiert. Eleganter ist die Verwendung von dh_install, welches die in debian/install aufgefuehrten Dateien in die ebenfalls dort angegebenen Zielverzeichnisse kopiert. Bei einem VDR-Plug-in ist dies auf jeden Fall die lib-Datei des Plug-ins. Aber auch eventuell benoetigte conf- Dateien, Grafiken usw. koennen so installiert werden. Der File System Hierarchie Standard FHS ist die Basis fuer die Wahl der Zielverzeichnisse. Oftmals reicht ein Blick in ein anderes Plug-in, wenn du dir nicht sicher bist. Hier ein paar wichtige Regel, die du beachten musst:

    *

      Plug-in-Konfigurationsdateien gehoeren nach /etc/vdr/plugins, jedoch nur statische conf-Files - also solche, die ausschliesslich manuell durch den Administrator geaendert werden. /etc ist read-only!
    *

      Statische Daten-Dateien, Grafiken usw. gehoeren nach /usr/share/<paketname>. Auch dieses Verzeichnis ist read-only!
    *

      Sich veraendernde, variable Dateien gehoeren nach /var/lib/vdr/plugins.

vdr-plugin-beep muss nur die Plug-in-Bibliothek selbst installieren.

7. links (dh_links)

Oftmals erwarten Plug-ins bestimmte Dateien in /var/lib/vdr/plugins, die (wie beispielsweise Grafiken) nach /usr/share/<paketname> installiert wurden. In solch einem Fall kannst du in /var/lib/vdr/plugins Symlinks anlegen, welche auf die entsprechenden Dateien oder Verzeichnisse verweisen.

In debian/links musst du diese Symlinks lediglich auflisten, dh_links uebernimmt dann den Rest. Werden keine Symlinks benoetigt, kannst du die Datei loeschen. (So auch beim Beep-Plug-in)

8. postinst|postrm|preinst|prerm.ex

Diese Dateien sind nur Beispiele (daher *.ex) und dienen dazu, bei der Installation bestimmte Aufgaben auszufuehren (z.B. bestehende Dateien zu verschieben). Meist werden sie nicht verwendet und du kannst sie, wie auch alle anderen nicht benoetigten Dateien, loeschen.

Fuer das Beep-Plug-in sind diese Dateien nicht notwendig

9. rules

debian/rules ist ein Makefile. In ihm ist definiert, was beim Erzeugen des Paketes zu tun ist. Das umfasst alles vom Compilieren bis zum Erzeugen des Patchlevel-Feldes. Das vorgefertigte rules-File ist eigens fuer VDR-Plug-ins so gestaltet, dass in der Regel keine Aenderungen daran noetig sind.

Unter Umstaenden muss lediglich die Zeile mit dh_installchangelogs angepasst werden, welche das changelog der Upstream-Version installiert:

...
# Build architecture-dependent files
binary-arch: build install
    dh_testdir

    dh_installchangelogs HISTORY


Meistens heisst diese Datei jedoch HISTORY und debian/rules muss nicht modifiziert werden.

Auch beim Beep-Plug-in kann rules unveraendert bleiben

9. watch.ex

Diese Datei beschreibt eine Art Filter, den das Tool uscan benutzt, um nach neuen Upstream-Versionen in Debian-Paketen zu suchen. Hilfe dazu bietet man uscan. Wenn du diese Datei verwendest, musst du natuerlich die Endung ex entfernen.

Fuer das Beep-Plug-in sieht debian/watch im einfachsten Fall so aus:

version=2
http://deltab.de/vdr/beep.html vdr-beep-(.*).tgz

danach ein dpkg-buildpackage -rfakeroot -us -uc -sa -tc und alles ist fertig


DEBIAN PACKETE AUS SOURCE

Notwendige Pakete

    * dpkg-deb
    * dh-make
    * gcc
    * libc6-dev


Vorbereitungen

Zunaechst sollte ein Arbeitsverzeichnis erstellt werden (am besten mit dem Namen des Paketes, ohne Versionsnummer).
Hier entpacken wir den Orginal-Source unseres Paketes:

      mkdir hallo; cd hallo
          tar xvfz ~/hallo-0.1.tar.gz
      cd hallo-0.1


Hinweis: Es ist wichtig, dass das Verzeichnis in dem der Source des Entpackten Paktes liegt, namentlich die Paket-Version (upstream-version) enthaelt (z.B. hallo-0.1).


"Debianisieren"

Nun koennen wir mit Hilfe des Pakets dh_make den Quellbaum fuer die Erstellung eines Debian-Pakets vorbereiten.

     dh_make -e marcus@antbear.org -f ~/hallo-0.1.tar.gz


Die Option -e gibt dabei die E-Mail-Adresse des Maintainers an. Die Option -f die Lage des Orginal-Source (upstream) im Filesystem an.
dh_make wird anschliessend erfragen, um welchen Typ es sich bei dem zu erstellenden Paket handelt. Die Moeglichen Antworten lauten:

    * single binary
    * multiple binary
    * library

Wir waehlen hier natuerlich single binary, da es sich bei hallo um ein einfaches Programm handelt.
Abschliessend wird uns eine Uebersicht, des erstellten Paket-Grundgeruests angezeigt.

Im uebergeordneten Verzeichnis befindet sich nun neben dem Orginal Source-Archiv des Pakets, ein neues Archiv, das dazu gedacht ist, in Kombination mit dem erzeugten Debian-Paket, auf die Debian-Server hochgeladen zu werden. Der Name des Archives lautet: hallo_0.1.orig.tar.gz
Das debian-Unterverzeichnis

Alle zur Erstellung des Debian-Pakets notwendigen Dateien befinden sich im debian-Unterverzeichnis unseres Quellbaums.

Hier ein Ueberblick der generierten Dateien:
README.Debian 	README-Datei die spaeter im /usr/share/doc/hallo Verzeichnis abgelegt wird. Hier sollten Debian-spezifische Anpassungen oder Kompilierungsoptionen oder Abweichungen von der upstream-Version dokumentiert werden.
changelog 	Enthaelt die Aenderungshistory des Debian-Pakets. Achtung die Datei muss in einem speziellen Format vorliegen.
conffiles.ex 	Enthaelt eine Liste von Konfigurationsdateien, die dpkg beachten sollten.
control 	Enthaelt die Informationen, die mit dpkg --info ausgegeben werden koennen. Hier muss auch die Beschreibung des Pakets angepasst werden.
copyright 	Hier sollte die Website oder ftp-URL angegeben werden, von wo das Orginal-Paket bezogen werden kann. Autoren und weitere upstream Copyright-Hinweise muessen hier eingetragen werden.
cron.d.ex 	Beispiel-crontab (optional)
dirs 	Enthaelt die Verzeichnisse, die bei Bedarf von dpkg waehrend der Installation erzeugt werden sollen. Im einfachsten Fall muss hier nichts geaendert werden, oder einfach nur das Installationsverzeichnis eingetragen werden (z.B. /usr/bin).
docs 	List von Dateien, die aus den Orginalquellen nach /usr/share/doc/paket uebernommen werden sollen.
emacsen-install.ex 	Emacs-spezifisch (optional)
emacsen-remove.ex 	Emacs-spezifisch (optional)
emacsen-startup.ex 	Emacs-spezifisch (optional)
ex.doc-base.package 	Fuer Pakete mit eigener HTML-Dokumentation. Wird benoetigt, um die Paket-Dokumentation bei doc-base zu registrieren (damit sie mittels dhelp(1) oder dwww(1) gefunden werden kann). (optional)
init.d.ex 	Fuer Pakete die einen Daemon enthalten und von init gestartet werden sollten (Initskript). (optional)
manpage.1.ex 	Skellet einer Manpage (troff(1)). (optional)
manpage.sgml.ex 	Skellet einer Manpage im SGML-Format (Docboc). (optional)
menu.ex 	Einstellungen fuer das Debian-Menu system. Ermoeglich es auf einfach Art einen Menueeintrag fuer das Paket zu erstellen, der dann in allen X11-Umgebungen sichtbar ist.
postinst.ex 	Skript, das nach der Installation ausgefuehrt werden soll
postrm.ex 	Skript, das nach dem Entfernen des Pakets ausgefuehrt werden soll.
preinst.ex 	Skript, das vor der Installation ausgefuehrt werden soll.
prerm.ex 	Sript, das vor dem Entfernen ausgefuehrt werden soll.
rules 	Enthaelt die Regeln die dpkg-buildpackage auswertet, um das Paket zu erstellen.
watch.ex 	Siehe uscan(1) und uupdate(1). (optional)

Da die Semantik, wann welche Paket-Skripte ausgefuehrt werden, recht komplex ist, verweise ich an dieser Stelle auf die "Debian Developers Reference"

Die Endung .ex steht fuer Example. Soll eine der Aufgefuehrten Dateien verwendet werden, so ist sie umzubennen (ohne .ex).
Anpassungen

Im Folgenden werden wir einige der oben aufgefuehrten Dateien anpassen, um aus dem hallo-Paket ein Debian-Paket zu erstellen.
Ein Wort zu Makefiles

Da die Debian-Policy genauch vorschreibt, wo die Vielzahl von Dateien aus denen sich ein Paket zusammensetzt, im Filesystem zu installieren sind, muessen bei manchen Paketen Anpassungen am Makefile vorgenommen werden. In der Regel sind das Pakete, die mit normalen Makefiles ausgeliefert werden.

Pakete die Automake/Autoconf einsetzen, muessen meist nicht angepasst werden, da hier ueber die Option --prefix=pfad des configure-Skripts, der Basispfad fuer die Installation vorgegeben werden kann. Entgegen dem GNU-"Standard", Programmpakete nach /usr/local zu installieren, muessen Debian-Pakete, die ausfuehrbare Programme enthalten, nach /usr/bin installiert werden.
Auf jeden Fall muss sichergestellt werden, dass das resultierende Paket, den Debian-Standards entspricht.
Das control-File

Das control-File enthaelt verschiedene Informationen, die dpkg und apt benoetigen, um das Paket zu verwalten:

     Source: hallo
     Section: unknown
     Priority: optional
     Maintainer: Marcus Geiger 
     Build-Depends: debhelper (>> 3.0.0)
     Standards-Version: 3.5.2

     Package: hallo
     Architecture: any
     Depends: ${shlibs:Depends}
     Description: 



Der obere Abschnitt enthaelt die Informationen fuer das Source-Paket, der Untere fuer das Binaerpaket. Die Semantik der einzelnen Felder ist wahrscheinlich jedem Debianer bekannt.
Die erste Zeile der Description enthaelt eine Kurzbeschreibung des Pakets. Eine Ausfuehrliche Beschreibung folgt unmittelbar in der naechsten Zeile. Jede Zeile muss dabei mit Leerzeichen eingerueckt werden. Paragraphen koennen mit einem Punkt erzeugt werden.

Die Zeile Section: ... dient der Kategorisierung des Pakets (z.B. fuer apt-Frontends).

Die Zeile Depends: ${shlibs:Depends} wird vom waehrend der Erstellung des Pakets automatisch substituiert (duch die Liste der Bibliotheken, die zum Paket (dynamisch) gelinkt wurden).

Weiter wichtige Felder die oft eingefuegt werden muessen, sind:

    * Recommends
    * Suggests
    * Pre-Depends
    * Conflicts
    * Provides
    * Replaces

Einzelheiten sind der "Debian Developers Reference" zu entnehmen.

Wir aendern nun unser control-File folgendermassen ab:

     Source: hallo
     Section: misc
     Priority: optional
     Maintainer: Marcus Geiger 
     Build-Depends: debhelper (>> 3.0.0)
     Standards-Version: 3.5.2

     Package: hallo
     Architecture: any
     Depends: ${shlibs:Depends}
     Suggests: hello
     Description: A package to learn howto create debian packages.
      A long description.

      A new paragraph. Also take a look at the hello package, because
      it's more full-featured.


Das copyright-File

Hier sollen alle upstream Copyright-Hinweise eingefuegt werden. Auch sollte hier die Quelle angegeben werden, von wo das Orginalpaket bezogen werden kann.

Hier die Anpassungen im Rahmen des hallo-Pakets:

     This package was debianized by Marcus Geiger  on
     Sun, 29 Jul 2001 18:48:42 +0200.

     It was downloaded from http://www.antbear.org

     Upstream Author(s): Marcus Geiger 

     Copyright:

     blah


Das changelog-File

Das changelog-File enthaelt die Aenderungshistorie des Debian-Pakets. Das genaue Format kann dem "Packaging Manual" (section 3.2.3) entnommen werden.

Wir aendern es folgendermassen ab:

     hallo (0.1-1) unstable; urgency=low

      * Initial Release.
      * This is my first Debian package.
      * No upstream changes.

     -- Marcus Geiger   Sun, 29 Jul 2001 18:48:42 +0200

     Local variables:
     mode: debian-changelog
     End:


Damit Emacs in den Debian-Changelog-Mode wechselt, wurden die unteren drei Zeilen eingefuegt (Erleichtert das Einhalten des Formats).
urgency=low besagt, dass die Aenderungen nicht wesentlich sind.

Jedesmal, wenn ein neues Paket-Release erstellt werden soll, muss die Version des Pakets erhoet werden. Am besten verwendet man dazu den Befehl dch -i, der die Versionsnummer des Pakets inkrementiert (siehe dch(1)). Anschliessend muss nur die changelog ergaenzt werden.

Hinweis: Das Datums- und Zeitformat muss muss RFC822-konform sein. Haendisch kann die aktuelle Zeit/Datum mit date -R abgefragt werden.
Das rules-File

Das rules-File enthaelt das Regelwerk fuer dpkg-buildpackage(1). Es handelt sich also um ein ausfuerbares Makefile fuer die Paketerstellung.

Wie ein "normales" Makefile, enthaelt das rules-File Ziele und die davon abhaengigen Regeln (siehe auch info make). Das von dh_make erstellt rules-File ist nur ein Vorschalg und sollte auf jeden Fall angepasst werden.
configure und configure-stamp

Die make-Ziele configure und configure-stamp sind fuer die Konfiguration des Software Pakets zustaendig. Diese make-Ziele werden von dh_make nur dann erzeugt, wenn das Quellpaket autoconf/automake verwendet. Hier wird configure mit den notwendigen Optionen gestartet, so dass das resultierende Paket Debiankonform ist.
build und build-stamp

Die make-Ziele build und build-stamp steuern den normalen Erstellungsprozess des Software-Pakets. Es wird also im wesentlichen ein make ausgefuehrt.
binary-arch

Dieses make-Ziel ist das interessanteste, da es die Erstellung des Debianpakets steuert. Hier werden viele kleine Hilfprogramme aus der debhelper-Sammlung verwendet. Hier sollten auf jeden Fall Anpassungen vorgenommen werden, die die Gegebenheiten des Pakets reflektieren.

    * dh_testdir prueft ob wir im richtigen Verzeichnis sind
    * dh_testroot prueft ob wir root-Rechte haben (fuer binary und clean)
    * dh_installdocs installiert die folgenden Debian Dateien: copyright, README.debian, TODO.debian, ...
    * dh_examples installiert mit dem Paket ausgelieferte Beispieldateien
    * dh_installmenu installiert einen Menueeintrag im Debian-Menue-System.
    * dh_installman installiert eine Manualpage
    * dh_installinfo installiert info-Seiten
    * dh_undocumented "installiert" eine Standard Manualpage mit dem Hinweis, dass das Paket keine Manualpage mitbringt.
    * dh_strip Entfernt Debugging-Informationen von uebersetzten Programmen.
    * dh_compress Komprimiert Manualpages und Dokumentation > 4KB
    * dh_fixperms Achtet auf korrekte Dateirechte
    * dh_installdeb Kopiert Maintainer-Files
    * dh_shlibdeps Berechnet die Abhaengigkeiten der verwendeten dynamischen Bibliotheken
    * dh_gencontrol Generiert und installiert das control-File
    * dh_md5sums Generiert MD5 Pruefsummen
    * dh_builddeb Generiert das Debian-Paket (mit dpkg)

Obige Auflistung ist nicht vollstaendig und sollte nur als Anhaltspunkt dienen. Jedes der dh_*-Programme kommt mit einer eigenen Manualpage in der Sektion (1). Jedes der dh_*-Programme fuegt ein besonderes Featuer zum zu erstellenden Debian-Paket hinzu.

Hier die rules-Date nach unseren Anpassungen:

     #!/usr/bin/make -f
     # Sample debian/rules that uses debhelper.
     # GNU copyright 1997 to 1999 by Joey Hess.

     # Uncomment this to turn on verbose mode.
     #export DH_VERBOSE=1

     # This is the debhelper compatability version to use.
     export DH_COMPAT=3

     configure: configure-stamp
     configure-stamp:
     	dh_testdir
     	# Add here commands to configure the package.
     	./configure --prefix=/usr --mandir=\$${prefix}/share/man \
                    --infodir=\$${prefix}/share/info

     	touch configure-stamp

     build: configure-stamp build-stamp
     build-stamp:
     	dh_testdir

     	# Add here commands to compile the package.
     	$(MAKE)
     	#/usr/bin/docbook-to-man debian/hallo.sgml > hallo.1

     	touch build-stamp

     clean:
     	dh_testdir
     	dh_testroot
     	rm -f build-stamp configure-stamp

     	# Add here commands to clean up after the build process.
     	-$(MAKE) distclean

     	dh_clean

     install: build
     	dh_testdir
     	dh_testroot
     	dh_clean -k
     	dh_installdirs

     	# Add here commands to install the package into debian/hallo.
     	$(MAKE) install prefix=$(CURDIR)/debian/hallo


     # Build architecture-independent files here.
     binary-indep: build install
     # We have nothing to do by default.

     # Build architecture-dependent files here.
     binary-arch: build install
     	dh_testdir
     	dh_testroot
     #	dh_installdebconf	
     	dh_installdocs
     #	dh_installexamples
     	dh_installmenu
     #	dh_installlogrotate
     #	dh_installemacsen
     #	dh_installpam
     #	dh_installmime
     #	dh_installinit
     #	dh_installcron
     #	dh_installman
     #	dh_installinfo
     	dh_undocumented
     	dh_installchangelogs ChangeLog
     	dh_link
     	dh_strip
     	dh_compress
     	dh_fixperms
     #	dh_makeshlibs
     	dh_installdeb
     #	dh_perl
     	dh_shlibdeps
     	dh_gencontrol
     	dh_md5sums
     	dh_builddeb
     
     binary: binary-indep binary-arch
     .PHONY: build clean binary-indep binary-arch binary install configure


Das README.debian-File

Hier sollten alle Aenderungen gegenueber der upstream-Version des Pakets ausfuehrlich dokumentiert werden.
conffiles

Jedem Debianer duerfte die Debian-Handhabe mit den Konfigurationsdateien bekannt sein. Damit das Paketsystem weiss, welche Konfigurationsdateien das Paket mitbringt, sind diese in dieser Datei mit absolutem Pfad anzugen.
dirs

Hier werden alle zu Installation benoetigten Verzeichnisse aufgefuehrt (z.B. /usr/bin).
menu

Hier kann angegeben werden, wie das Paket in das Debian-Menuesystem integriert werden soll (siehe auch dh_installmenu(1) im rules-File).

Da hallo ein Konsolenprogramm ist, aendern wir es wie folgt ab:

     ?package(hallo):needs=text section=Apps/Tools \
     title="hallo" command="/usr/bin/hallo"


Paketerstellung

Wenn wir uns sicher sind, alle Anpassungen vorgenommen zu haben, wechseln wir in das Paket-Hauptverzeichnis (hier hallo-0.1) und erstellen unser Debian-Paket:

     dpkg-buildpackage -rfakeroot -us -uc -sa -tc


Ging alles gut erhalten wir die folgenden Dateien (ein Verzeichnis hoeher):

    * hallo_0.1-1_i386.deb Das Debian-Paket fuer die Architektur fuer die wir uebersetzt haben
    * hallo_0.1.orig.tar.gz Der orginal Quellcode
    * hallo_0.1-1.dsc Auflistung der Bestandteile des Quellpakets.
    * hallo_0.1-1.diff.gz Alle Aenderungen am orginal Quellcode (siehe diff(1)).
    * hallo_0.1-1_i386.changes Enthaelt eine kleine Aenderungshistorie. Download-tools werden diese Datei aus, um zu entscheiden, was fuer das vollstaendige Quellpaket benoetigt wird. User koennen hier nachschauen, ob es sich lohnt, sich das Paket zu besorgen.