NOM
dpkg-buildpackage - Construire depuis les sources des paquets binaires
ou sources
SYNOPSIS
dpkg-buildpackage [options]
dpkg-buildpackage est un programme qui permet d'automatiser la
construction d'un paquet Debian. Il comporte les tapes suivantes :
1. It prepares the build environment by setting various environment
variables (see ENVIRONMENT) and calls dpkg-source --before-build
(unless -T or --target has been used).
2. Contrle des dpendances de constructions et des conflits de
construction (non effectu si -d est utilis).
3. Si une cible particuilre a t indique avec les options -T ou
--target, appel de cette cible et arrt. Dans le cas contraire, appel
de fakeroot debian/rules clean pour nettoyage de l'arborescence
source (sauf si -nc a t utilis).
4. It calls dpkg-source -b to generate the source package (unless a
binary-only build has been requested with -b, -B or -A).
5. Appel de debian/rules build suivi de fakeoot debian/rules
binary-target (sauf si une construction source seule a t demande
avec -S). Noter que binary-target est soit binary (cas par dfaut, ou
avec utilisation de -b) soit binary-arch (si -B est utilis).
6. Appel de gpg pour signature du fichier .dsc (sauf si -us est
utilis).
7. Appel de dpkg-genchanges pour crer un fichier .changes. De
nombreuses options de dpkg-buildpackage sont passes
dpkg-genchanges.
8. Appel de gpg pour signer le fichier .changes (sauf si -uc est
utilis).
9. If -tc is specified, it will call fakeroot debian/rules clean again.
Finally it calls dpkg-source --after-build.
OPTIONS
-b Indique que seul un paquet binaire est construire ; aucun
fichier source n'est construire et/ou distribuer. Pass
dpkg-genchanges.
-B Indique que seul un paquet binaire est construire ; aucun
fichier, appartenant un paquet binaire ne dpendant pas d'une
architecture, n'est distribuer. Pass dpkg-genchanges.
-A Indique que seul un paquet binaire est construire ; aucun
fichier, appartenant un paquet binaire ne dpendant pas d'une
architecture, n'est distribuer. Pass dpkg-genchanges.
-S Ne construit qu'un paquet source, aucun paquet binaire ne sera
construit. Pass dpkg-genchanges.
-F Specifies a normal full build, binary and source packages will
be built. This is the same as the default case when no build
option is specified.
--target=cible
--target cible
-Tcible
Appelle debian/rules cible aprs avoir mis en place
l'environnement de construction, puis interrompt le processus de
construction. Si --as-root est galement utilis, la commande sera
excute avec les privilges du superutilisateur (voir -r). Noter
que les cibles dont l'excution par root est impose par la Charte
Debian n'ont pas besoin de cette option.
--as-root
N'est utile qu'avec --target. Impose d'excuter la cible avec les
privilges du superutilisateur.
-si
-sa
-sd
-vversion
-Cdescription-des-changements
-madresse-du-responsable
-eadresse-du-responsable
Pass tel quel dpkg-genchanges. Voir sa page de manuel.
-aarchitecture
Prcise l'architecture Debian pour laquelle on construit.
L'architecture de la machine sur laquelle on construit est
automatiquement dtermine ; c'est aussi l'architecture par dfaut
de la machine hte.
-ttype-de-systme-gnu
Prcise le type de systme GNU pour lequel construire. Il peut tre
utilis
la place de -a ou en tant que complment afin de remplacer le
type de systme GNU par dfaut de l'architecture Debian cible.
-jjobs Nombre de processus simultans qui peuvent tre excuts, quivalent
l'option make(1) du mme nom. S'ajoutera tout seul la variable
d'environnement MAKEFLAGS, afin que les appels suivants de make
en hritent. Ajoute aussi parallel=jobs la variable
d'environnement DEB_BUILD_OPTIONS ce qui permet aux fichiers
debian/rules d'utiliser cette information pour leurs propres
besoins. La prsence de parallel=jobs dans la variable
d'environnement DEB_BUILD_OPTIONS remplace la valeur de l'option
-j si elle est prcise.
-D Vrifier les dpendances de constructions et les conflits ; se
termine en cas de problmes. Ceci est le comportement par dfaut.
-d Ne pas vrifier les dpendances de constructions et les conflits.
-nc Ne pas nettoyer l'arborescence des sources (implique -b si
aucune des options -B, -A ou -S n'est utilise).
-tc Nettoyage de l'arborescence (en utilisant
commande-pour-obtenir-privilges-de-root debian/rules clean)
aprs la construction du paquet.
-rcommande-pour-obtenir-privilges-de-root
Quand dpkg-buildpackage doit excuter une partie du processus de
construction en tant que root, il prfixe la commande excute par
commande-pour-obtenir-privilges-de-root, si une a t spcifi. Si
ce n'est pas le cas alors fakeroot est utilis par dfaut.
commande-pour-obtenir-privilges-de-root doit dbuter par le nom
d'un programme accessible depuis PATH et avoir comme arguments
le nom de la commande relle avec les arguments qu'elle doit
prendre. commande-pour-obtenir-privilges-de-root peut recevoir
des paramtres (ils doivent tre spars par des espaces) mais aucun
mtacaractre de l'interprteur de commandes. Classiquement
commande-pour-obtenir-privilges-de-root devrait tre fakeroot,
sudo, super ou really. su ne va pas, puisque ce programme peut
uniquement utiliser l'interprteur de commandes de l'utilisateur
avec l'option -c au lieu de passer directement les arguments la
commande qui doit tre excute.
-Rfichier-rules
Construire un paquet Debian implique gnralement l'invocation de
debian/rules comme une commande avec de nombreux paramtres
standards. Avec cette option, il est possible d'utiliser un
autre programme
utiliser pour la construction de paquet (ainsi que ses
paramtres spars par des espaces). Une autre utilisation possible
est d'excuter le fichier rules standard avec un autre programme
de construction (par exemple en utilisant /usr/local/bin/make -f
debian/rules comme fichier-rules).
-pcommande-de-signature
Quand dpkg-buildpackage doit excuter GPG ou PGP pour signer un
fichier source de contrle (.dsc) ou un fichier .changes, il
excute commande-de-signature (recherch via PATH si ncessaire) au
lieu de pgp. commande-de-signature reoit tous les paramtres
qu'aurait reupgp. Si commande-de-signature veut recevoir ses
paramtres la manire de GPG plutt qu' la manire de PGP, il faut
utiliser l'option -sgpg. commande-de-signature ne contiendra pas
d'espace ni aucun mtacaractre de l'interprteur de commandes.
-kkey-id
Prcise une cl pour la signature des paquets.
-us Ne pas signer le paquet source.
-uc Ne pas signer le fichier .changes.
-i[regexp]
-I[motif]
-s[nsAkurKUR]
-z, -Z
Chane passe telle quelle dpkg-source. Voir la page de manuel
correspondante.
--source-option=opt
Pass option opt to dpkg-source.
--changes-option=opt
Pass option opt to dpkg-genchanges.
--admindir=dir
--admindir rp
Change l'endroit o se trouve la base de donnes de dpkg. Par
dfaut, c'est /var/lib/dpkg.
-h, --help
Affiche un message d'aide puis quitte.
--version
Affiche le numro de version puis quitte.
ENVIRONNEMENT
Even if dpkg-buildpackage export some variables, debian/rules should
not rely on their presence and should instead use the respective
interface to retrieve the needed values.
Variables positionnes par dpkg-architecture
dpkg-architecture est lanc avec les paramtres de -a and -t. Toute
variable retourne par l'option -s est intgre dans l'environnement de
construction.
Drapeaux de compilation
The CFLAGS, CXXFLAGS, FFLAGS, CPPFLAGS and LDFLAGS environment
variables are set to the values that dpkg-buildflags returned. See its
manual page for more information.
BOGUES
On devrait pouvoir mettre des espaces et des mtacaractres du shell dans
les arguments initiaux de commande-pour-obtenir-privilges-de-root et
commande-de-signature.
VOIR AUSSI
dpkg-source(1), dpkg-architecture(1), dpkg-genchanges(1), fakeroot(1),
gpg(1).
AUTEURS
Copyright (C) 1995-1996 Ian Jackson
Copyright (C) 2000 Wichert Akkerman
Copyright (C) 2007 Frank Lichtenheld
Copyright (C) 2008-2010 Raphael Hertzog
Ce programme est un logiciel libre ; voyez la GNU General Public
Licence version 2 ou suprieure pour le copyright. Il n'y a PAS de
garantie.
TRADUCTION
Ariel VARDI <ariel.vardi@freesbee.fr>, 2002. Philippe Batailler, 2006.
Nicolas Franois, 2006. Veuillez signaler toute erreur
<debian-l10n-french@lists.debian.org>.