DH_INSTALL(1) | Debhelper | DH_INSTALL(1) |
dh_install - Installer les fichiers dans le répertoire de construction du paquet
dh_install [-Xélément] [--autodest] [--sourcedir=répertoire] [options_de_debhelper] [fichier|répertoire ... répertoire_destination]
dh_install est un programme de la suite debhelper chargé de l'installation des fichiers dans les répertoires de construction des paquets. Il existe plein de commandes dh_install* qui gèrent l'installation de types de fichier particuliers tels que les documentations, les exemples, les pages de manuel, et ainsi de suite. Ces commandes spécifiques doivent être employées autant que possible car elles présentent souvent un savoir-faire supplémentaire pour ces tâches particulières. dh_install, en revanche, est utile pour installer tout le reste, c'est-à-dire tous les fichiers pour lesquels aucun savoir-faire particulier n'est nécessaire. Ce programme vient en remplacement de l'ancien programme dh_movefiles.
Ce programme peut être utilisé de deux façons différentes. S'il n'y a qu'un ou deux fichiers que Makefile n'installe pas lui même, il suffit d'exécuter dh_install en le configurant pour installer ces fichiers. Par contre, avec un paquet source qui construit plusieurs paquets binaires, il est préférable de demander à Makefile de mettre tout dans debian/tmp puis d'utiliser dh_install pour déplacer les répertoires et les fichiers depuis cet emplacement temporaire vers les répertoires de construction appropriés de chaque paquet.
Depuis la version 7 de debhelper, dh_install cherchera dans l'arborescence debian/tmp pour trouver les fichiers s'il ne les trouve pas dans le répertoire courant (ou dans celui indiqué par l'utilisation de --sourcedir).
Nota : Si le nom du fichier (ou le motif d'un ensemble de fichiers) est indiqué tout seul, sans que la destination ne soit précisée, alors dh_install déterminera automatiquement la destination à utiliser, comme si l'option --autodest avait été utilisée.
Les variables de substitution sont prises en charge dans les niveaux de compatibilité 13 et ultérieurs comme documenté dans debhelper(7).
Cette option est supprimée dans le niveau de compatibilité 12.
Cette option est supprimée dans le niveau de compatibilité 12.
Nota : Cette option ne fait pas la même chose que --sourcedirectory utilisée par dh_auto_*. Il est rare d'avoir besoin d'utiliser cette option puisque dh_install cherche automatiquement les fichiers dans debian/tmp depuis la version 7 de debhelper.
Il enlève debian/tmp (ou le nom du répertoire source, s'il a été indiqué) du début du chemin du fichier, s'il est présent, et copie le fichier dans le répertoire de construction du paquet, sous l'arborescence indiquée pour le fichier source. Par exemple, si l'objet à installer est le répertoire debian/tmp/usr/bin, alors il sera copié dans debian/paquet/usr/. Si le fichier à installer est debian/tmp/etc/passwd, il sera copié dans debian/paquet/etc/.
Voici quelques courts exemples de fichiers de configuration pour dh_install.
# Installation de mon-prog dans usr/bin (« usr/bin/mon-prog ») mon-prog usr/bin # Installation d'un répertoire de greffons dans usr/share/mon-prog # (sous « usr/share/mon-prog/plugins/ »") plugins usr/share/mon-prog # Installation d'un fichier avec des espaces dans usr/share/mon-prog/data # (sous « usr/share/my-prog/data/mon_fichier-de-données avec espaces.txt ») # SUPPOSE COMPAT 13 où les motifs de substitution sont disponibles my${Space}fichier${Space}with${Space}spaces.txt usr/share/mon-prog/data # Installe une bibliothèque dans le répertoire # de bibliothèques multi-arch # SUPPOSE COMPAT 13 où les motifs de substitution sont disponibles build/output/libfrop*.so.* usr/lib/${DEB_HOST_MULTIARCH}
dh_install ne peut pas renommer les fichiers ou les répertoires, il peut seulement les implanter n'importe où dans l'arbre de construction du paquet mais avec les noms qu'ils possèdent déjà.
En revanche, le renommage peut être effectué en utilisant dh_exec avec le niveau de compatibilité 9 ou supérieur. Un exemple de fichier debian/<paquet>.install utilisant dh_exec ressemblerait à :
#!/usr/bin/dh-exec debian/default.conf => /etc/mon-paquet/start.conf
Veuillez vous souvenir de ces trois remarques :
debhelper(7)
Ce programme fait partie de debhelper.
Joey Hess <joeyh@debian.org>
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> ».
2024-03-01 | 13.14.1ubuntu5 |