Man page - debuild(1)

Packages contains this manual

Package: devscripts
apt-get install devscripts

Manuals in package:

Documentations in package:

devscripts

Available languages:

en fr de

Manual

DEBUILD

NOM
SYNOPSIS
DESCRIPTION
Vérification du nom du répertoire
VARIABLES D’ENVIRONNEMENT
OBTENTION DES DROITS DU SUPERUTILISATEUR
POINTS D’ACCROCHE
OPTIONS
VARIABLES DE CONFIGURATION
EXEMPLES
VOIR AUSSI
AUTEUR
TRADUCTION

NOM

debuild - Construire un paquet Debian

SYNOPSIS

debuild [ options_debuild ] [ options_dpkg-buildpackage ] [ --lintian-opts options_lintian ]
debuild [ options_debuild ] -- binary | binary-arch | binary-indep | clean ...

DESCRIPTION

debuild crée tous les fichiers nécessaires pour envoyer un paquet à l’archive Debian. Il exécute dans un premier temps dpkg-buildpackage , puis lintian avec le fichier .changes créé (en supposant que lintian est installé), enfin il signe les fichiers appropriés (en utilisant debsign (1) plutôt que dpkg-buildpackage (1) ; toutes les options relatives à la signature lui sont passées). L’opération de signature sera ignorée si la distribution est UNRELEASED , à moins que l’option --force-sign de dpkg-buildpackage soit utilisée. Des paramètres peuvent être fournis à dpkg-buildpackage et lintian , en utilisant les paramètres de l’option --lintian-opts pour ce dernier. Les options --lintian et --no-lintian permettent de forcer ou d’empêcher l’exécution de lintian . Par défaut, lintian est exécuté. Il y a également d’autres options permettant de définir ou conserver des variables d’environnement, comme décrit dans la section VARIABLES D’ENVIRONNEMENT ci-dessous. Cette façon d’exécuter debuild permet également d’obtenir un journal de la construction du paquet dans ../<paquet>_<version>_<arch>.build .

Une autre façon d’utiliser debuild est d’utiliser un (ou plus) des paramètres binary , binary-arch , binary-indep et clean . Dans ce cas, debuild cherchera à obtenir les droits du superutilisateur et à exécuter debian/rules avec ce(s) paramètre(s). Les options --rootcmd = commande_pour_devenir_superutilisateur ou -r commande_pour_devenir_superutilisateur peuvent être utilisées. La commande_pour_devenir_superutilisateur est en règle générale une de celles-ci : fakeroot , sudo ou super . Lisez ci-dessous pour une discussion plus approfondie sur ce point. Encore une fois, les options permettant de préserver l’environnement peuvent être utilisées. Dans ce cas, debuild cherchera également à exécuter dans un premier temps dpkg-checkbuilddeps ; cela peut être explicitement demandé ou empêché avec les options -D et -d , respectivement. Remarquez également que si une de ces options ou si l’option -r est indiquée dans la variable DEBUILD_DPKG_BUILDPACKAGE_OPTS du fichier de configuration, elle sera reconnue, même avec cette façon d’exécuter debuild .

debuild lit aussi les fichiers de configuration de devscripts décrits ci-dessous. Cela permet de fournir des options à utiliser par défaut.

Vérification du nom du répertoire

Comme plusieurs autres scripts du paquet devscripts , debuild parcourt une arborescence de répertoires jusqu’à trouver un fichier debian/changelog avant de construire le paquet. Pour éviter les problèmes posés par les fichiers égarés, il examine le nom du répertoire parent une fois le fichier debian/changelog trouvé, et vérifie que le nom du répertoire correspond au nom du paquet. La façon précise utilisée est contrôlée par les deux variables du fichier de configuration DEVSCRIPTS_CHECK_DIRNAME_LEVEL et DEVSCRIPTS_CHECK_DIRNAME_REGEX , et les options en ligne de commande associées --check-dirname-level et --check-dirname-regex .

DEVSCRIPTS_CHECK_DIRNAME_LEVEL peut prendre les valeurs suivantes :

	0		Ne jamais vérifier le nom du répertoire.
	1		Ne vérifier le nom du répertoire que s’il a fallu changer de répertoire pour trouver le fichier debian/changelog . C’est le comportement par défaut.
	2		Toujours vérifier le nom du répertoire.

Le nom du répertoire est vérifié en testant si le nom du répertoire actuel (donné par pwd (1)) correspond à l’expression rationnelle donnée par la variable DEVSCRIPTS_CHECK_DIRNAME_REGEX du fichier de configuration ou par l’option --check-dirname-regex expression_rationnelle . Il s’agit d’une expression rationnelle Perl (voir perlre (1)), qui sera ancrée à son début et à sa fin. Si elle contient un "/", alors elle doit correspondre au chemin complet, sinon elle doit correspondre au nom de répertoire complet. Si elle contient la chaîne "PACKAGE", cette chaîne sera remplacée par le nom du paquet source déterminé par le fichier changelog . La valeur par défaut de cette expression rationnelle est "PACKAGE(-.+)?", ce qui correspond aux répertoires nommés PACKAGE ou PACKAGE-version.

VARIABLES D’ENVIRONNEMENT

Comme les variables d’environnement peuvent affecter la construction d’un paquet, souvent de façon involontaire, debuild nettoie l’environnement en enlevant toutes les variables d’environnement, à l’exception de TERM , HOME , LOGNAME , GNUPGHOME , PGPPATH , GPG_AGENT_INFO , GPG_TTY , DBUS_SESSION_BUS_ADDRESS , FAKEROOTKEY , DEBEMAIL , DEB_ * , des variables ( C , CPP , CXX , LD et F ) FLAGS et les variables _APPEND associées, ainsi que les variables pour les paramètres régionaux LANG et LC_ * . La variable TERM vaut "dumb" si elle n’est pas définie, et PATH est définie à "/usr/sbin:/usr/bin:/sbin:/bin:/usr/bin/X11".

Si une variable d’environnement ne doit pas être modifiée pour la construction d’un paquet, il est possible d’utiliser --preserve-envvar var (ou -e var ). L’environnement peut aussi être préservé en utilisant l’option --preserve-env . Cependant, même dans ce cas le PATH est remis à la valeur précisée ci-dessus. Le seul moyen d’empêcher le PATH d’être remis à zéro est d’utiliser une option --preserve-envvar PATH . Mais soyez conscient qu’utiliser des programmes d’un emplacement non standard peut facilement résulter en un paquet cassé, puisqu’il ne sera pas possible de le construire sur des systèmes standards.

Remarquez que des répertoire peuvent être ajoutés au début de la variable d’environnement PATH en utilisant l’option --prepend-path . C’est utile quand on veut utiliser des outils comme ccache ou distcc pour la construction d’un paquet.

Il est également possible d’éviter d’avoir à écrire quelque chose comme TOTO = titi debuild -e TOTO en écrivant debuild -e TOTO = titi ou la forme longue debuild --set-envvar TOTO = titi .

OBTENTION DES DROITS DU SUPERUTILISATEUR

debuild doit être exécuté en tant que superutilisateur pour fonctionner correctement. Il y a trois façons fondamentalement différentes de faire cela. La première, et celle qui est conseillée, est d’utiliser une commande permettant de devenir superutilisateur. La meilleure d’entre elles est probablement fakeroot (1), puisqu’elle ne nécessite pas d’accorder véritablement de droits. super (1) et sudo (1) sont d’autres possibilités. Si aucune option -r (ou --rootcmd ) n’est donnée (rappelez-vous que dpkg-buildpackage accepte également une option -r ) et qu’aucune des méthodes suivantes n’est utilisée, alors -rfakeroot sera implicitement considérée.

La deuxième méthode est d’utiliser une commande comme su (1) pour devenir superutilisateur, et ensuite de réaliser toutes les opérations en tant que superutilisateur. Remarquez cependant que lintian s’arrêtera s’il est exécuté en tant que superutilisateur ou setuid root ; cela peut être contourné en utilisant l’option --allow-root de lintian si vous êtes sûr de vous.

La troisième méthode consiste à installer debuild setuid root. Ce n’est pas la méthode par défaut, et nécessitera l’installation en tant que tel par l’administrateur système. Il faut aussi être conscient que toute personne pouvant exécuter debuild en tant que superutilisateur ou setuid root a un accès complet au système . Cette méthode n’est pas recommandée, mais fonctionnera. debuild peut être installé avec les permissions 4754, de façon à ce que seuls les membres de son groupe puissent l’exécuter. L’inconvénient de cette méthode est que les autres utilisateurs ne pourront plus alors utiliser ce programme. D’autres variantes consistent à avoir plusieurs copies de debuild ou d’utiliser des programmes comme sudo ou super pour accorder sélectivement des droits du superutilisateur à certains utilisateurs. Si l’administrateur veut utiliser cette méthode, il devra utiliser le programme dpkg-statoverride pour modifier les permissions de /usr/bin/debuild . Cela permettra de conserver les permissions après les mises à jour.

POINTS D’ACCROCHE

debuild gère un certain nombre de points d’ancrage ("hook") quand il exécute dpkg-buildpackage . Remarquez que les points d’ancrage entre clean-hook et lintian (inclus) sont passées au travers de dpkg-buildpackage en utilisant leur option --hook- nom correspondante. Les points d’ancrage disponibles sont les suivants :
dpkg-buildpackage-hook

S’exécute avant le début de dpkg-buildpackage en appelant dpkg-checkbuilddeps .