Provided by: debhelper_13.24.2ubuntu1_all 
NAME
dh_installdebconf - installiert Dateien, die von Debconf im Paketbauverzeichnis benutzt werden
ÜBERSICHT
dh_installdebconf [Debhelper-Optionen] [-n] [-- Parameter]
BESCHREIBUNG
dh_installdebconf ist ein Debhelper-Programm, das dafür zuständig ist, die Dateien, die von Debconf
verwendet werden, in die Paketbauverzeichnisse zu installieren.
Es erzeugt außerdem automatisch die für die Verbindung mit Debconf nötigen postrm-Befehle. dh_installdeb
trägt die Befehle in die Betreuerskripte ein. Eine Erklärung, wie das funktioniert, finden Sie in
dh_installdeb(1).
Beachten Sie, dass, falls Sie Debconf benutzen, Ihr Paket wahrscheinlich davon abhängen muss (es wird
durch dieses Programm zu ${misc:Depends} hinzugefügt).
Beachten Sie für Ihr durch dpkg aufgerufenes Konfigurationsskript, dass Ihr postinst das Confmodul von
Debconf einbinden muss. dh_installdebconf installiert die benötigten Befehle nicht automatisch in
postinst, da es zu schwierig ist, dies richtig zu machen.
DATEIEN
debian/Paket.config
Dies ist das Debconf-config-Skript. Es ist im Verzeichnis DEBIAN im Paketbauverzeichnis installiert.
Innerhalb des Skripts wird die Markierung #DEBHELPER# durch Shell-Skriptschnipsel ersetzt, die durch
andere Debhelper-Befehle erzeugt wurden.
debian/Paket.template
Dies ist die Debconf-templates-Datei. Sie ist im Verzeichnis DEBIAN im Paketbauverzeichnis
installiert.
debian/po/
Falls dieses Verzeichnis vorhanden ist, wird dieses Programm automatisch po2debconf(1) benutzen, um
zusammengefügte Schablonendateien zu erzeugen, die Übersetzungen aus dem Verzeichnis enthalten.
Für diese Aufgabe sollte Ihr Paket über eine Bauabhängigkeit auf po-debconf verfügen.
OPTIONEN
-n, --no-scripts
Nicht das postrm-Skript ändern.
-- Parameter
Übergeben der Parameter an po2debconf.
-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/config <<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.config <<EOF
# Skript für #PACKAGE#
#MARKIERUNG#
EOF
cat >> debian/bar.config <<EOF
# Skript für #PACKAGE#
#MARKIERUNG#
EOF
cat >> debian/baz.config <<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.config zu Vorgabe, in debian/bar.config zu
eindeutiger-bar-wert und in debian/baz.config 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.config 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):
#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_installdebconf 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_INSTALLDEBCONF(1)