dh - En ligne dans le Cloud

PROGRAMME:

Nom

dh - séquenceur de commandes debhelper

SYNOPSIS

dh séquence [--avec addon[,addon ...]] [--liste] [options debhelper]

DESCRIPTION

dh exécute une séquence de commandes debhelper. Le supporté séquences correspondent au
cibles d'un debian/règles fichier: construire-arche, construire-indépendamment, construire, espace extérieur plus propre,, install-indep,
arch d'installation, installer, arc-binaire, binaire-indepet une binaire.

OVERRIDE CIBLES

A debian/règles déposer à l'aide dh peut remplacer la commande exécutée à n'importe quelle étape d'un
séquence, en définissant une cible de remplacement.

Pour outrepasser dh_commande, ajoutez une cible nommée passer outre_dh_commande au fichier de règles. Quand cela
fonctionnerait normalement dh_commande, dh appellera à la place cette cible. La cible de remplacement peut
puis exécutez la commande avec des options supplémentaires, ou exécutez des commandes entièrement différentes à la place.
Voir les exemples ci-dessous.

Les cibles de remplacement peuvent également être définies pour s'exécuter uniquement lors de la construction d'une architecture dépendante ou
packages indépendants de l'architecture. Utilisez des cibles avec des noms comme passer outre_dh_commande-cambre
et de passer outre_dh_commande-indépendant. (Notez que pour utiliser cette fonctionnalité, vous devez Build-Depend sur
debhelper 8.9.7 ou supérieur.)

OPTIONS

--avec addon[,addon ...]
Ajoutez les commandes debhelper spécifiées par l'addon donné aux endroits appropriés dans le
séquence de commandes exécutée. Cette option peut être répétée plusieurs fois, ou
plusieurs addons peuvent être répertoriés, séparés par des virgules. Ceci est utilisé lorsqu'il y a un
package tiers qui fournit les commandes debhelper. Voir le LA PROGRAMMATION fichier pour
documentation sur l'interface du module complémentaire de séquence.

--sans pour autant addon
L'inverse de --avec, désactive l'utilisation de l'addon donné. Cette option peut être répétée
plusieurs fois, ou plusieurs modules complémentaires à désactiver peuvent être répertoriés, séparés par des virgules.

--liste, -l
Répertoriez tous les addons disponibles.

--pas d'action
Affiche les commandes qui s'exécuteraient pour une séquence donnée, mais ne les exécute pas.

Notez que dh ignore normalement les commandes en cours d'exécution dont il sait qu'elles ne feront rien. Avec
--no-act, la liste complète des commandes d'une séquence est affichée.

D'autres options sont passées à dh sont transmis à chaque commande qu'il exécute. Cela peut être utilisé pour définir
une option comme -v or -X or -N, ainsi que pour des options plus spécialisées.

EXEMPLES

Pour voir quelles commandes sont incluses dans une séquence, sans rien faire :

dh architecture-binaire --no-act

Il s'agit d'un fichier de règles très simple, pour les packages où les séquences de commandes par défaut
fonctionne sans options supplémentaires.

#!/usr/bin/faire -f
%:
dh $@

Souvent, vous voudrez passer une option à une commande debhelper spécifique. La manière facile de faire
with est en ajoutant une cible de remplacement pour cette commande.

#!/usr/bin/faire -f
%:
dh $@

override_dh_strip :
dh_strip -Xfoo

override_dh_auto_configure :
dh_auto_configure -- --with-foo --disable-bar

Parfois, l'automatisation dh_auto_configurede Géographie (1) et avec la dh_auto_build(1) je ne peux pas deviner quoi faire
pour un colis étrange. Voici comment éviter d'exécuter l'un ou l'autre et exécutez plutôt le vôtre
les commandes.

#!/usr/bin/faire -f
%:
dh $@

override_dh_auto_configure :
./mondoconfig

override_dh_auto_build :
faire exploser-de-délice l'univers

Un autre cas courant est de vouloir faire quelque chose manuellement avant ou après un certain
La commande debhelper est exécutée.

#!/usr/bin/faire -f
%:
dh $@

override_dh_fixperms :
dh_fixperms
chmod 4755 debian/foo/usr/bin/foo

Si votre package utilise des outils automatiques et que vous souhaitez actualiser config.sub et de config.deviner comprenant
des versions plus récentes du autotools-dev package au moment de la construction, vous pouvez utiliser certaines commandes
Fourni dans autotools-dev qui l'automatisent, comme ça.

#!/usr/bin/faire -f
%:
dh $@ --avec autotools_dev

Les outils Python ne sont pas exécutés par dh par défaut, en raison du changement continuel dans ce domaine.
(Avant le niveau de compatibilité v9, dh s'exécute dh_pysupport.) Voici comment utiliser dh_python2.

#!/usr/bin/faire -f
%:
dh $@ --avec python2

Voici comment forcer l'utilisation de Perl Module :: Construire système de construction, qui peut être nécessaire si
debhelper détecte à tort que le paquet utilise MakeMaker.

#!/usr/bin/faire -f
%:
dh $@ --buildsystem=perl_build

Voici un exemple de substitution où le dh_auto_* les commandes trouvent la source du paquet,
pour un package dont la source se trouve dans un sous-répertoire.

#!/usr/bin/faire -f
%:
dh $@ --sourcedirectory=src

Et voici un exemple de la façon de dire au dh_auto_* commandes à construire dans un sous-répertoire,
qui sera supprimé le espace extérieur plus propre,.

#!/usr/bin/faire -f
%:
dh $@ --builddirectory=construire

Si votre package peut être construit en parallèle, veuillez soit utiliser compat 10, soit passer --parallèle
à dh. Puis dpkg-buildpackage -j marchera.

#!/usr/bin/faire -f
%:
dh $@ --parallèle

Si votre package ne peut pas être construit de manière fiable en utilisant plusieurs threads, veuillez passer
--pas de parallèle à dh (ou le dh_auto_* commander):

#!/usr/bin/faire -f
%:
dh $@ --pas de parallèle

Voici un moyen d'éviter dh d'exécuter plusieurs commandes que vous ne voulez pas qu'il exécute,
en définissant des cibles de remplacement vides pour chaque commande.

#!/usr/bin/faire -f
%:
dh $@

# Commandes à ne pas exécuter :
override_dh_auto_test override_dh_compress override_dh_fixperms :

Un long processus de construction pour un package de documentation séparé peut être séparé en utilisant
dérogations indépendantes de l'architecture. Ceux-ci seront ignorés lors de l'exécution de build-arch et
séquences d'arcs binaires.

#!/usr/bin/faire -f
%:
dh $@

override_dh_auto_build-indep :
$(MAKE) -C documents

# Aucun test nécessaire pour les documents
override_dh_auto_test-indep :

override_dh_auto_install-indep :
$(MAKE) -C docs installer

En plus de l'exemple ci-dessus, supposons que vous ayez besoin de chmod un fichier, mais uniquement lors de la construction du
package dépendant de l'architecture, car il n'est pas présent lors de la création uniquement de la documentation.

override_dh_fixperms-arch :
dh_fixperms
chmod 4755 debian/foo/usr/bin/foo

INTERNES

Si vous êtes curieux de savoir dh's internes, voici comment cela fonctionne sous le capot.

Chaque commande debhelper enregistrera quand elle est exécutée avec succès dans
debian/paquet.debhelper.log. (Lequel dh_clean supprime.) Donc dh peut dire quelles commandes ont
déjà exécuté, pour quels packages, et ignorez l'exécution de ces commandes à nouveau.

Chaque fois dh est exécuté, il examine le journal et trouve la dernière commande enregistrée qui se trouve dans le
séquence spécifiée. Il continue ensuite avec la commande suivante de la séquence. Les --jusqu'à,
--avant, --aprèset une --restant les options peuvent remplacer ce comportement.

Une séquence peut également exécuter des cibles dépendantes dans debian/rules. Par exemple, le "binaire"
La séquence exécute la cible « install ».

dh utilise l' DH_INTERNAL_OPTIONS variable d'environnement pour transmettre des informations à
les commandes debhelper qui sont exécutées dans les cibles de remplacement. Le contenu (et en effet,
existence) de cette variable d'environnement, comme son nom l'indique, est susceptible de changer
à tout moment.

Les commandes dans le construire-indépendamment, install-indep et de binaire-indep les séquences sont passées le -i
option pour s'assurer qu'ils ne fonctionnent que sur des packages indépendants de l'architecture et des commandes dans le
construire-arche, arch d'installation et de arc-binaire les séquences sont passées le -a possibilité de s'assurer qu'ils
ne fonctionne que sur les packages dépendants de l'architecture.

Déprécié OPTIONS

Les options suivantes sont obsolètes. Il est préférable d'utiliser des cibles prioritaires à la place.
Ils ne sont ne sauraient disponible en version 10.

--jusqu'à cmd
Exécutez les commandes dans la séquence jusqu'à et y compris cmd, puis arrêtez.

--avant cmd
Exécuter les commandes dans l'ordre avant cmd, puis arrêtez.

--après cmd
Exécuter les commandes dans l'ordre qui suit cmd.

--restant
Exécutez toutes les commandes de la séquence qui n'ont pas encore été exécutées.

Dans les options ci-dessus, cmd peut être le nom complet d'une commande debhelper ou une sous-chaîne. ça va
rechercher d'abord une commande dans la séquence correspondant exactement au nom, pour éviter tout
ambiguïté. S'il y a plusieurs correspondances de sous-chaînes, la dernière de la séquence sera
utilisé.

Utilisez dh en ligne en utilisant les services onworks.net