.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_INSTALLDEB 1"
.TH DH_INSTALLDEB 1 2024-03-27 13.15.3 Debhelper
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
dh_installdeb \- installiert Dateien in das Verzeichnis DEBIAN.
.SH ÜBERSICHT
.IX Header "ÜBERSICHT"
\&\fBdh_installdeb\fR [\fIDebhelper-Optionen\fR]
.SH BESCHREIBUNG
.IX Header "BESCHREIBUNG"
\&\fBdh_installdeb\fR ist ein Debhelper-Programm, das für die Installation von Dateien in die \fIDEBIAN\fR\-Verzeichnisse in den Paketbauverzeichnissen mit den korrekten Berechtigungen zuständig ist.
.SH DATEIEN
.IX Header "DATEIEN"
.IP \fIPaket\fR.postinst 4
.IX Item "Paket.postinst"
.PD 0
.IP \fIPaket\fR.preinst 4
.IX Item "Paket.preinst"
.IP \fIPaket\fR.postrm 4
.IX Item "Paket.postrm"
.IP \fIPaket\fR.prerm 4
.IX Item "Paket.prerm"
.PD
Diese Betreuerskripte werden in das Verzeichnis \fIDEBIAN\fR installiert.
.Sp
\&\fBdh_installdeb\fR wird eine Ersetzung bekannter MARKIERUNGEN des Musters \fB#MARKIERUNG#\fR durchführen. Im Allgemeinen werden Skripte \fB#DEBHELPER#\fR einbinden wollen, um von den durch Debhelper-Befehle erzeugten Shell-Skripten zu profitieren (einschließlich derer von \fBdh_installdeb\fR, wenn es \fIPaket\fR.maintscript\-Dateien verarbeitet).
.Sp
Die Markierung \fB#DEBHELPER#\fR sollte in eine eigene Zeile platziert werden, da sie oft durch ein mehrzeiliges Shellskript ersetzt wird.
.IP \fIPaket\fR.triggers 4
.IX Item "Paket.triggers"
.PD 0
.IP \fIPaket\fR.shlibs 4
.IX Item "Paket.shlibs"
.PD
Diese Steuerdateien sind im Verzeichnis \fIDEBIAN\fR installiert.
.Sp
Beachten Sie, dass \fIPaket\fR.shlibs nur auf Kompatibilitätsstufe 9 und älter installiert wird. Verwenden Sie im Kompatibilitätsmodus 10 bitte \fBdh_makeshlibs\fR\|(1).
.IP \fIPaket\fR.conffiles 4
.IX Item "Paket.conffiles"
Diese Datei wird ins \fIDEBIAN\fR\-Verzeichnis installiert. Die bereitgestellte Datei wird von Debhelper ergänzt, sodass sie alle von Debhelper automatisch festgestellten \fBconffiles\fR enthält (der Paketbetreuer sollte diese Liste nicht selbst schreiben, weil Debhelper davon ausgeht, dass dies seine Aufgabe ist).
.Sp
Diese Datei eignet sich hauptsächlich für den Einsatz »spezieller« Funktionalitäten wie Dpkgs \fBremove-on-upgrade\fR.
.IP \fIPaket\fR.maintscript 4
.IX Item "Paket.maintscript"
Zeilen in dieser Datei entsprechen \fBdpkg\-maintscript\-helper\fR\|(1)\-Befehlen und \-Parametern. Die »maint\-script\-parameters« sollten jedoch \fInicht\fR eingefügt werden, da Debhelper sie automatisch hinzufügen wird.
.Sp
Beispiel:
.Sp
.Vb 4
\&    # Richtig
\&    rm_conffile /etc/obsolete.conf 0.2~ foo
\&    # FALSCH
\&    rm_conffile /etc/obsolete.conf 0.2~ foo \-\- "$@"
.Ve
.Sp
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 \f(CW\*(C`mv_conffile /etc/oldconffile /etc/newconffile\*(C'\fR wird zum Beispiel Schnipsel von Betreuerskripten in alle Betreuerskripte einfügen, die sich eignen, um diese Konfigdatei zu verschieben.
.Sp
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.
.Sp
Das Werkzeug \fBdh_installdeb\fR 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.
.Sp
Wo möglich, kann sich \fBdh_installdeb\fR 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 \fBrm_conffile\fR in \fBremove-on-upgrade\fR umschreiben). Die Mindestvoraussetzung, dass diese Funktionalität aktiv wird, ist dass Debhelper in Kompatibilitätsstufe 10 oder höher läuft.
.Sp
unterstützt Ersetzungsvariablen in Kompatibilitätsstufe 13 oder neuer, wie in \fBdebhelper\fR\|(7) beschrieben.
.SH OPTIONEN
.IX Header "OPTIONEN"
.IP "\fB\-D\fR\fIMARKIERUNG=WERT\fR, \fB\-\-define\fR \fIMARKIERUNG=WERT\fR" 4
.IX Item "-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.
.Sp
In einfachen Fall wird dieser Parameter veranlassen, dass \fB#\fR\f(BIMARKIERUNG\fR\fB#\fR durch \fIWERT\fR ersetzt wird. Falls \fIWERT\fR mit einem \fI@\fR\-Zeichen beginnt, wird von \fIWERT\fR erwartet, dass er auf eine Datei zeigt, die den tatsächlich einzufügenden Wert enthält.
.Sp
Eine explizit mit diesem Parameter deklarierte Markierung wird die eingebauten Markierungen ersetzen.
.Sp
Testbeispiele zum besseren Verständnis:
.Sp
.Vb 6
\&        cat >> debian/postinst <<EOF
\&        #EINFACH#
\&        #DATEIBASIERT#
\&        EOF
\&        echo \-n "Komplexer Wert" > irgendeine\-Datei
\&    dh_installdeb \-\-define EINFACH=direkt \-\-define DATEIBASIERT=@irgendeine\-Datei
.Ve
.Sp
In diesem Beispiel wird \fB#EINFACH#\fR zu \fBdirekt\fR und \fB#DATEIBASIERT#\fR zu \fBKomplexer Wert\fR expandiert.
.Sp
Es ist auch möglich, paketspezifische Werte für eine angegebene Markierung zu setzen, was hilfreich ist, wenn \fBdh_installdeb\fR mit mehreren Paketen agiert, die unterschiedliche Werte für dieselbe Markierung benötigen. Dazu wird \fBpkg.\fR\f(BIPaketname\fR\fB.\fR vor die Markierung gestellt.
.Sp
Es kann wie im folgenden Beispiel benutzt werden:
.Sp
.Vb 10
\&        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 \e
\&      \-\-define pkg.baz.MARKIERUNG=eindeutiger\-baz\-wert
.Ve
.Sp
In diesem Beispiel wird \fB#MARKIERUNG#\fR in \fIdebian/foo.postinst\fR zu \fBVorgabe\fR, in \fIdebian/bar.postinst\fR zu \fBeindeutiger-bar-wert\fR und in \fIdebian/baz.postinst\fR zu \fBeindeutiger-baz-wert\fR expandiert.
.Sp
Beachten Sie, dass die \fB#pkg.*#\fR\-Markierungen in allen Skripten, mit denen gearbeitet wird, sichtbar sind. Sie können sich z. B. auf \fB#pkg.bar.MARKIERUNG#\fR innerhalb von \fIdebian/foo.postinst\fR beziehen und es wird durch \fBeindeutiger-bar-wert\fR ersetzt.
.SH "ERSETZUNG IN BETREUERSKRIPTEN"
.IX Header "ERSETZUNG IN BETREUERSKRIPTEN"
\&\fBdh_installdeb\fR wird automatisch die folgenden Markierungen innerhalb eines bereitgestellten Betreuerskripts ersetzen (falls sie nicht über \fB\-D\fR/\fB\-\-define\fR ersetzt werden):
.IP #DEBHELPER# 4
.IX Item "#DEBHELPER#"
Diese Markierung wird standardmäßig durch in Shell-Schnipseln erzeugten Debhelper-Befehlen ersetzt. Dies umfasst die durch \fBdh_installdeb\fR aus der Datei \fIPaket\fR.maintscript erzeugten Schnipsel (falls vorhanden).
.IP "#DEB_HOST_\fINAME\fR#, #DEB_BUILD_\fINAME\fR#, #DEB_TARGET_\fINAME\fR#" 4
.IX Item "#DEB_HOST_NAME#, #DEB_BUILD_NAME#, #DEB_TARGET_NAME#"
Diese Markierungen werden durch die entsprechende Variable aus \fBdpkg\-architecture\fR\|(1) ersetzt. In fast allen Fällen werden Sie die Variante \fB#DEB_HOST_\fR\f(BINAME\fR in einem Skript benutzen wollen, um sicherzustellen, dass Sie beim Cross-Bauen den richtigen Wert haben.
.Sp
Wenn Markierungen dieses Musters auch unter größten Anstrengungen nicht zu einer Variable in \fBdpkg\-architecture\fR\|(1) passen, werden sie so belassen, wie sie sind.
.IP #ENV.\fINAME\fR# 4
.IX Item "#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.
.Sp
Beachten Sie, dass es Einschränkungen gibt, welche Namen verwendet werden können (siehe "Einschränkungen in Markierungsnamen").
.IP #PACKAGE# 4
.IX Item "#PACKAGE#"
Diese Markierung wird standardmäßig durch den Namen des Paketes ersetzt, welches das wirkliche Skript enthält.
.SS "Einschränkungen in Markierungsnamen"
.IX Subsection "Einschränkungen in Markierungsnamen"
Alle Markierungen, die zur Ersetzung vorgesehen sind, müssen zum regulären Ausdruck #[A\-Za\-z0\-9_.+]+# passen.
.PP
Markierungen, die nicht auf diesen Ausdruck passen, werden stillschweigend ignoriert, falls sie in der Skriptschablone gefunden werden. Ungültige Markierungsnamen, die per \fB\-D\fR oder \fB\-\-define\fR übergeben wurden, führen in den meisten Fällen dazu, dass \fBdh_installdeb\fR den Befehl mit einem Fehler zurückweist.
.SH "SIEHE AUCH"
.IX Header "SIEHE AUCH"
\&\fBdebhelper\fR\|(7)
.PP
Dieses Programm ist Teil von Debhelper.
.SH ÜBERSETZUNG
.IX Header "ÜBERSETZUNG"
Diese Übersetzung wurde mit dem Werkzeug
\&\fBpo4a\fR
<http://po4a.alioth.debian.org/>
durch Chris Leick
\&\fIc.leick@vollbio.de\fR
und das deutsche Debian\-Übersetzer\-Team im 
Dezember 2011 erstellt.
.PP
Bitte melden Sie alle Fehler in der Übersetzung an
\&\fIdebian\-l10n\-german@lists.debian.org\fR
oder als Fehlerbericht an das Paket
\&\fIdebhelper\fR.
.PP
Sie können mit dem folgenden Befehl das englische 
Original anzeigen
man\ \-L\ en\ Abschnitt\ Handbuchseite
.SH AUTOR
.IX Header "AUTOR"
Joey Hess <joeyh@debian.org>