Provided by: debhelper_13.24.2ubuntu1_all bug

NAME

       dh_installdeb - installiert Dateien in das Verzeichnis DEBIAN.

ÜBERSICHT

       dh_installdeb [Debhelper-Optionen]

BESCHREIBUNG

       dh_installdeb ist ein Debhelper-Programm, das für die Installation von Dateien in die
       DEBIAN-Verzeichnisse in den Paketbauverzeichnissen mit den korrekten Berechtigungen zuständig ist.

DATEIEN

       Paket.postinst
       Paket.preinst
       Paket.postrm
       Paket.prerm
           Diese Betreuerskripte werden in das Verzeichnis DEBIAN installiert.

           dh_installdeb  wird  eine  Ersetzung  bekannter MARKIERUNGEN des Musters #MARKIERUNG# durchführen. Im
           Allgemeinen werden Skripte #DEBHELPER# einbinden wollen, um von den durch Debhelper-Befehle erzeugten
           Shell-Skripten   zu    profitieren    (einschließlich    derer    von    dh_installdeb,    wenn    es
           Paket.maintscript-Dateien verarbeitet).

           Die  Markierung  #DEBHELPER#  sollte  in  eine  eigene  Zeile  platziert werden, da sie oft durch ein
           mehrzeiliges Shellskript ersetzt wird.

       Paket.triggers
       Paket.shlibs
           Diese Steuerdateien sind im Verzeichnis DEBIAN installiert.

           Beachten Sie, dass Paket.shlibs nur auf Kompatibilitätsstufe 9 und älter installiert wird.  Verwenden
           Sie im Kompatibilitätsmodus 10 bitte dh_makeshlibs(1).

       Paket.conffiles
           Diese  Datei  wird  ins  DEBIAN-Verzeichnis installiert. Die bereitgestellte Datei wird von Debhelper
           ergänzt,  sodass  sie  alle  von  Debhelper  automatisch  festgestellten   conffiles   enthält   (der
           Paketbetreuer  sollte  diese  Liste  nicht  selbst schreiben, weil Debhelper davon ausgeht, dass dies
           seine Aufgabe ist).

           Diese Datei eignet sich hauptsächlich für den Einsatz »spezieller« Funktionalitäten wie Dpkgs remove-
           on-upgrade.

       Paket.maintscript
           Zeilen  in  dieser  Datei  entsprechen  dpkg-maintscript-helper(1)-Befehlen  und   -Parametern.   Die
           »maint-script-parameters«  sollten  jedoch  nicht  eingefügt  werden,  da  Debhelper  sie automatisch
           hinzufügen wird.

           Beispiel:

               # Richtig
               rm_conffile /etc/obsolete.conf 0.2~ foo
               # FALSCH
               rm_conffile /etc/obsolete.conf 0.2~ foo -- "$@"

           Im Kompatibilitätsmodus 10 oder höher werden alle Shell-Metazeichen maskiert, daher  kann  hier  kein
           beliebiger    Shell-Code   eingefügt   werden.   Eine   Zeile   wie   "mv_conffile   /etc/oldconffile
           /etc/newconffile" wird zum Beispiel Schnipsel von Betreuerskripten in alle Betreuerskripte  einfügen,
           die sich eignen, um diese Konfigdatei zu verschieben.

           Es  war  außerdem  beabsichtigt,  die  Shell-Metazeichen in allen vorherigen Kompatibilitätsstufen zu
           maskieren. Dies funktionierte jedoch nicht ordentlich und von daher war es möglich, beliebigen Shell-
           Code in vorhergehenden Kompatibilitätsstufen einzubetten.

           Das  Werkzeug  dh_installdeb  wird  einige  grundlegende  Prüfungen  einiger  der  in  dieser   Datei
           aufgeführten   Befehle   durchführen,  um  häufige  Fehler  abzufangen.  Die  Überprüfung  wird  seit
           Kompatibilitätsstufe 10 als Warnung aktiviert und in Kompatibilitätsstufe 12 als harter Fehler.

           Wo möglich, kann sich dh_installdeb eigenständig dafür entscheiden,  einige  oder  alle  Einträge  so
           umzugestalten,  dass  anstelle  von  Betreuer-Skripten  die  entsprechenden Dpkg-Funktionen verwendet
           werden (bspw. kann es rm_conffile in remove-on-upgrade umschreiben). Die  Mindestvoraussetzung,  dass
           diese Funktionalität aktiv wird, ist dass Debhelper in Kompatibilitätsstufe 10 oder höher läuft.

           unterstützt   Ersetzungsvariablen   in  Kompatibilitätsstufe  13  oder  neuer,  wie  in  debhelper(7)
           beschrieben.

OPTIONEN

       -DMARKIERUNG=WERT, --define MARKIERUNG=WERT
           definiert Markierungen, die innerhalb von Betreuerskripten bei ihrer Erzeugung ersetzt werden.  Bitte
           beachten  Sie, dass die in "Beschränkungen in Markierungsnamen" beschriebenen Beschränkungen auch für
           Markierungen gelten, die auf der Befehlszeile definiert  werden.  Ungültige  Markierungsnamen  werden
           einen Fehler auslösen.

           In einfachen Fall wird dieser Parameter veranlassen, dass #MARKIERUNG# durch WERT ersetzt wird. Falls
           WERT  mit  einem  @-Zeichen  beginnt,  wird  von WERT erwartet, dass er auf eine Datei zeigt, die den
           tatsächlich einzufügenden Wert enthält.

           Eine explizit mit diesem Parameter deklarierte Markierung wird die eingebauten Markierungen ersetzen.

           Testbeispiele zum besseren Verständnis:

                   cat >> debian/postinst <<EOF
                   #EINFACH#
                   #DATEIBASIERT#
                   EOF
                   echo -n "Komplexer Wert" > irgendeine-Datei
               dh_installdeb --define EINFACH=direkt --define DATEIBASIERT=@irgendeine-Datei

           In diesem Beispiel wird #EINFACH# zu direkt und #DATEIBASIERT# zu Komplexer Wert expandiert.

           Es ist auch möglich, paketspezifische Werte für eine angegebene Markierung zu setzen,  was  hilfreich
           ist,  wenn  dh_installdeb  mit  mehreren  Paketen  agiert,  die  unterschiedliche  Werte für dieselbe
           Markierung benötigen. Dazu wird pkg.Paketname. vor die Markierung gestellt.

           Es kann wie im folgenden Beispiel benutzt werden:

                   cat >> debian/foo.postinst <<EOF
                   # Skript für #PACKAGE#
                   #MARKIERUNG#
                   EOF
                   cat >> debian/bar.postinst <<EOF
                   # Skript für #PACKAGE#
                   #MARKIERUNG#
                   EOF
                   cat >> debian/baz.postinst <<EOF
                   # Skript für #PACKAGE#
                   #MARKIERUNG#
                   EOF
               dh_installdeb -pfoo -pbar -pbaz  --define MARKIERUNG=Vorgabe --define pkg.bar.MARKIERUNG=eindeutiger-bar-wert \
                 --define pkg.baz.MARKIERUNG=eindeutiger-baz-wert

           In diesem Beispiel wird #MARKIERUNG# in debian/foo.postinst zu  Vorgabe,  in  debian/bar.postinst  zu
           eindeutiger-bar-wert und in debian/baz.postinst zu eindeutiger-baz-wert expandiert.

           Beachten  Sie,  dass  die #pkg.*#-Markierungen in allen Skripten, mit denen gearbeitet wird, sichtbar
           sind. Sie können sich z. B. auf #pkg.bar.MARKIERUNG# innerhalb von debian/foo.postinst  beziehen  und
           es wird durch eindeutiger-bar-wert ersetzt.

ERSETZUNG IN BETREUERSKRIPTEN

       dh_installdeb   wird   automatisch   die   folgenden   Markierungen   innerhalb   eines  bereitgestellten
       Betreuerskripts ersetzen (falls sie nicht über -D/--define ersetzt werden):

       #DEBHELPER#
           Diese Markierung wird standardmäßig durch in Shell-Schnipseln erzeugten  Debhelper-Befehlen  ersetzt.
           Dies  umfasst  die  durch  dh_installdeb  aus  der Datei Paket.maintscript erzeugten Schnipsel (falls
           vorhanden).

       #DEB_HOST_NAME#, #DEB_BUILD_NAME#, #DEB_TARGET_NAME#
           Diese Markierungen werden durch die entsprechende Variable aus dpkg-architecture(1) ersetzt. In  fast
           allen   Fällen   werden  Sie  die  Variante  #DEB_HOST_NAME  in  einem  Skript  benutzen  wollen,  um
           sicherzustellen, dass Sie beim Cross-Bauen den richtigen Wert haben.

           Wenn Markierungen dieses Musters  auch  unter  größten  Anstrengungen  nicht  zu  einer  Variable  in
           dpkg-architecture(1) passen, werden sie so belassen, wie sie sind.

       #ENV.NAME#
           Markierungen  dieser  Form  werden durch den Wert der entsprechenden Umgebungsvariable ersetzt. Falls
           eine Umgebungsvariable nicht gesetzt ist, wird die Markierung durch die leere Zeichenkette ersetzt.

           Beachten  Sie,  dass  es  Einschränkungen  gibt,  welche  Namen  verwendet   werden   können   (siehe
           "Einschränkungen in Markierungsnamen").

       #PACKAGE#
           Diese Markierung wird standardmäßig durch den Namen des Paketes ersetzt, welches das wirkliche Skript
           enthält.

   Einschränkungen in Markierungsnamen
       Alle  Markierungen,  die  zur  Ersetzung vorgesehen sind, müssen zum regulären Ausdruck #[A-Za-z0-9_.+]+#
       passen.

       Markierungen, die nicht auf diesen Ausdruck passen, werden stillschweigend ignoriert, falls  sie  in  der
       Skriptschablone  gefunden  werden. Ungültige Markierungsnamen, die per -D oder --define übergeben wurden,
       führen in den meisten Fällen dazu, dass dh_installdeb den Befehl mit einem Fehler zurückweist.

SIEHE AUCH

       debhelper(7)

       Dieses Programm ist Teil von Debhelper.

ÜBERSETZUNG

       Diese Übersetzung  wurde  mit  dem  Werkzeug  po4a  <http://po4a.alioth.debian.org/>  durch  Chris  Leick
       c.leick@vollbio.de und das deutsche Debian-Übersetzer-Team im Dezember 2011 erstellt.

       Bitte  melden  Sie  alle  Fehler  in  der  Übersetzung  an  debian-l10n-german@lists.debian.org  oder als
       Fehlerbericht an das Paket debhelper.

       Sie können mit dem folgenden Befehl das englische Original anzeigen man -L en Abschnitt Handbuchseite

AUTOR

       Joey Hess <joeyh@debian.org>

13.24.2ubuntu1                                     2025-05-22                                   DH_INSTALLDEB(1)