DH_INSTALLDEBCONF(1) Debhelper DH_INSTALLDEBCONF(1)
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
Ncht 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
#SIMPLE#
#FILEBASED#
EOF
echo -n "Complex value" > some-file
dh_installdeb --define SIMPLE=direct --define FILEBASED=@some-file
In diesem Beispiel wird #EINFACH# zu direkt und #DATEIBASIERT# zu
Komplexer Wert expandiert.
It is also possible to set package-specific values for a given
token. This is useful when dh_installdebconf is acting on multiple
packages that need different values for the same token. This is
done by prefixing the token name with pkg.package-name..
Es kann wie im folgenden Beispiel benutzt werden:
cat >> debian/foo.config <<EOF
# Script for #PACKAGE#
#TOKEN#
EOF
cat >> debian/bar.config <<EOF
# Script for #PACKAGE#
#TOKEN#
EOF
cat >> debian/baz.config <<EOF
# Script for #PACKAGE#
#TOKEN#
EOF
dh_installdebconf -pfoo -pbar -pbaz --define TOKEN=default --define pkg.bar.TOKEN=unique-bar-value \
--define pkg.baz.TOKEN=unique-baz-value
In this example, #TOKEN# will expand to default in
debian/foo.config, to unique-bar-value in debian/bar.config and to
unique-baz-value in debian/baz.config.
Note that the #pkg.*# tokens will be visible in all scripts acted
on. E.g. you can refer to #pkg.bar.TOKEN# inside debian/foo.config
and it will be replaced by unique-bar-value.
ERSETZUNG IN BETREUERSKRIPTEN
The dh_installdebconf will automatically replace the following tokens
inside a provided maintainer script (if not replaced via -D/--define):
#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.
Tokens that do not match that regex will be silently ignored if found
in the script template. Invalid token names passed to -D or --define
will cause dh_installdebconf to reject the command with an error in
most cases.
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.11.4 2023-01-02 DH_INSTALLDEBCONF(1)
Generated by dwww version 1.15 on Sat Jun 29 01:40:10 CEST 2024.