Provided by: debhelper_13.24.2ubuntu1_all 
NOM
dh_installdebconf – Installer les fichiers utilisés par debconf dans les répertoires de construction du
paquet
SYNOPSIS
dh_installdebconf [options_de_debhelper] [-n] [-- paramètres]
DESCRIPTION
dh_installdebconf est le programme de la suite debhelper chargé d'installer les fichiers utilisés par
debconf dans les répertoires de construction du paquet.
Il génère également automatiquement les lignes de code du script de maintenance postrm nécessaires à
l'interfaçage avec debconf. Les commandes sont ajoutées aux scripts de maintenance par dh_installdeb.
Consulter dh_installdeb(1) pour obtenir une explication sur le mécanisme d'insertion de lignes de code.
Nota : Comme un paquet qui utilise debconf a probablement besoin d'en dépendre, ce programme ajoute cette
dépendance à ${misc:Depends}.
Nota : Étant donné que le script de configuration est invoqué par dpkg, postinst doit comporter le module
de configuration (confmodule) de debconf. dh_installdebconf n'implémente pas automatiquement ce
traitement dans le script de maintenance postinst car ce serait trop difficile à faire correctement.
FICHIERS
debian/paquet.config
C'est le script config de debconf. Il est installé dans le répertoire DEBIAN du répertoire de
construction du paquet.
Dans le script, l'item #DEBHELPER# est remplacé par les lignes de code générées par les autres
commandes debhelper.
debian/paquet.templates
C'est le fichier templates de debconf. Il est installé dans le répertoire DEBIAN du répertoire de
construction du paquet.
debian/po/
Si ce répertoire existe, ce programme utilisera po2debconf(1) pour produire un fichier multilingue de
modèles.
Pour que cela fonctionne, le paquet doit dépendre, pour sa construction (build-depend), de po-
debconf.
OPTIONS
-n, --no-scripts
Empêche la modification du script de maintenance postrm.
-- paramètres
Passe les paramètres à po2debconf.
-DITEM=VALEUR, --define ITEM=VALEUR
Définit les items qui doivent être remplacés dans les scripts du responsable quand ils sont créés.
Veuillez noter que les contraintes décrites dans "Restrictions dans les noms d'item" s'appliquent
aussi aux items définis en ligne de commande. Les noms d'item non valables déclencheront une erreur.
Dans un cas simple, ce paramètre fera que #ITEM# sera remplacé par VALEUR. Si VALEUR commence par un
signe @ littéral, alors VALEUR est censé pointer vers un fichier contenant la valeur réelle à
insérer.
Un item déclaré de façon explicite avec ce paramètre remplacera les items internes.
Exemples de tests pour aider à mieux comprendre :
cat >> debian/config <<EOF
#SIMPLE#
#FILEBASED#
EOF
echo -n "valeur_complexe" > un_fichier
dh_installdeb --define SIMPLE=direct --define FILEBASED=@un_fichier
Dans cet exemple, #SIMPLE# sera développé en direct et #FILEBASED# sera développé en valeur_complexe.
Il est aussi possible de fixer des valeurs spécifiques à un paquet pour un item donné. Cela est
utilisé quand dh_installdebconf agit sur plusieurs paquets qui ont besoin de valeurs distinctes pour
le même item. Cela est obtenu en préfixant le nom de l'item par pkg.nom-paquet..
Cela peut être utilisé comme dans l'exemple suivant :
cat >> debian/toto.config <<EOF
# Script pour #PACKAGE#
#TOKEN#
EOF
cat >> debian/titi.config <<EOF
# Script pour #PACKAGE#
#TOKEN#
EOF
cat >> debian/truc.config <<EOF
# Script pour #PACKAGE#
#TOKEN#
EOF
dh_installdebconf -ptoto -ptiti -ptruc --define TOKEN=default --define pkg.titi.TOKEN=valeur-unique-titi \
--define pkg.truc.TOKEN=valeur-unique-truc
Dans cet exemple, #TOKEN# sera développé en default dans debian/toto.config, en valeur-unique-titi
dans debian/titi.config et en valeur-unique-truc dans debian/truc.config.
Notez que les items de #pkg.*# seront visibles dans tous les scripts en cause. Par exemple, il est
possible de faire référence à #pkg.titi.TOKEN# dans debian/toto.config et il sera remplacé par
valeur-unique-titi.
SUBSTITUTION DANS LES SCRIPTS DU RESPONSABLE
dh_installdebconf remplacera automatiquement les items suivants dans un script fourni par le responsable
(s'il n'est pas remplacé au moyen de -D ou --define) :
#DEB_HOST_NOM#, #DEB_BUILD_NOM#, #DEB_TARGET_NOM#
Ces items sont remplacés par leur variable respective venant de dpkg-architecture(1). Dans presque
tous les cas, vous voudrez utiliser la variante #DEB_HOST_NOM dans un script pour vous assurer
d'obtenir la valeur correcte lors d'une construction croisée.
Dans un souci de qualité, les items avec ce motif qui ne correspondent pas à une variable de
dpkg-architecture(1) seront laissés tels quels.
#ENV.NOM#
Les items de cette forme seront remplacés par la valeur de la variable d'environnement
correspondante. Si la variable d'environnement n'est pas définie, l'item est remplacé par une chaîne
vide.
Notez qu'il y a des restrictions sur les noms pouvant être utilisés voir "Restrictions dans les noms
d'item").
#PACKAGE#
Cet item est remplacé par défaut par le nom du paquet qui contiendra le script réel.
Restrictions dans les noms d'item
Tous les items destinés à être remplacés doivent correspondre à l'expression rationnelle :
#[A-Za-z0-9_.+]+#
Les items qui ne correspondent pas à cette expression rationnelle seront ignorés silencieusement s'ils
sont présents dans un modèle de script. Les noms d'item non valables passés à -D ou --define feront que
dh_installdebconf rejettera la commande avec une erreur dans la plupart des cas.
VOIR AUSSI
debhelper(7)
Ce programme fait partie de debhelper.
AUTEUR
Joey Hess <joeyh@debian.org>
TRADUCTION
Cette traduction est maintenue à l'aide de l'outil po4a <URL:http://po4a.alioth.debian.org/> par l'équipe
francophone de traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par
un rapport de bogue sur le paquet debhelper.
Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
<section> <page_de_man> ».
13.24.2ubuntu1 2025-05-22 DH_INSTALLDEBCONF(1)