557 lines
30 KiB
HTML
557 lines
30 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of dpkg-buildpackage</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>dpkg-buildpackage</H1>
|
|
Section: suite dpkg (1)<BR>Updated: 2020-03-23<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NOM</H2>
|
|
|
|
dpkg-buildpackage - Construire depuis les sources des paquets binaires ou
|
|
sources
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>dpkg-buildpackage</B> [<I>option</I>...]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>dpkg-buildpackage</B> est un programme qui permet d'automatiser la
|
|
construction d'un paquet Debian. Il comporte les étapes suivantes :
|
|
<DL COMPACT>
|
|
<DT id="1"><B>1.</B><DD>
|
|
Préparation de l'environnement de compilation par positionnement de diverses
|
|
variables d'environnement (voir <B>VARIABLES D'ENVIRONNEMENT</B>), exécution du
|
|
point d'entrée <B>init</B> et appel de <B>dpkg-source --before-build</B> (sauf si
|
|
<B>-T</B> ou <B>--target</B> ont été utilisés).
|
|
<DT id="2"><B>2.</B><DD>
|
|
Contrôle des dépendances de construction et des conflits de construction
|
|
(non effectué si <B>-d</B> ou <B>--no-check-builddeps</B> sont utilisés).
|
|
<DT id="3"><B>3.</B><DD>
|
|
Si une ou plusieurs cibles particulières ont été indiquées avec les options
|
|
<B>-T</B> ou <B>--target</B>, appel de ces cibles et arrêt. Dans le cas contraire,
|
|
exécution du point d'entrée <B>preclean</B> et appel de <B>fakeroot debian/rules
|
|
clean</B> pour nettoyage de l'arborescence source (sauf si <B>-nc</B> ou
|
|
<B>--no-pre-clean</B> ont été utilisés).
|
|
<DT id="4"><B>4.</B><DD>
|
|
Exécution du point d'entrée <B>source</B> et appel de <B>dpkg-source -b</B> pour
|
|
créer le paquet source (si une construction <B>source</B> a été demandée avec
|
|
<B>--build</B> ou des options équivalentes).
|
|
<DT id="5"><B>5.</B><DD>
|
|
Exécution du point d'entrée <B>build</B> et appel de <B>debian/rules</B>
|
|
<I>build-target</I>, puis exécution du point d'entrée <B>binary</B> suivie de
|
|
<B>fakeroot debian/rules</B> <I>binary-target</I> (sauf si une construction source
|
|
seule a été demandée avec <B>--build=source</B> ou des options
|
|
équivalentes). Noter que <I>build-target</I> et <I>binary-target</I> sont soit
|
|
<B>build</B> et <B>binary</B> (cas par défaut, ou si une construction <B>any</B> et
|
|
<B>all</B> a été demandée avec <B>--build</B> ou des options équivalentes), soit
|
|
<B>build-arch</B> et <B>binary-arch</B> (si une construction <B>any</B> et pas <B>all</B> a
|
|
été demandée avec <B>--build</B> ou des options équivalentes), soit
|
|
<B>build-indep</B> et <B>binary-indep</B> (si une construction <B>all</B> et pas <B>any</B>
|
|
a été demandée avec <B>--build</B> ou des options équivalentes).
|
|
<DT id="6"><B>6.</B><DD>
|
|
Exécution du point d'entrée <B>buildinfo</B> et appel de <B>dpkg-genbuildinfo</B>
|
|
pour créer un fichier <B>.buildinfo</B>. De nombreuses options de
|
|
<B>dpkg-buildpackage</B> sont passées à <B>dpkg-genbuildinfo</B>.
|
|
<DT id="7"><B>7.</B><DD>
|
|
Exécution du point d'entrée <B>changes</B> et appel de <B>dpkg-genchanges</B> pour
|
|
créer un fichier <B>.changes</B>. Le nom du fichier <B>.changes</B> dépendra du type
|
|
de construction et sera aussi spécifique que nécessaire mais pas plus ; pour
|
|
une construction qui inclut <B>any</B>, le nom sera
|
|
<I>nom-de-source</I><B>_</B><I>version-binaire</I><B>_</B><I>architecture</I><B>.changes</B>, ou
|
|
pour une construction qui inclut <B>all</B>, le nom sera
|
|
<I>nom-de-source</I><B>_</B><I>version-binaire</I><B>_</B><B>all.changes</B>, ou pour une
|
|
construction qui inclut <B>source</B>, le nom sera
|
|
<I>nom-de-source</I><B>_</B><I>version-source</I><B>_</B><B>sources.changes</B>. De nombreuses
|
|
options de <B>dpkg-buildpackage</B> sont passées à <B>dpkg-genchanges</B>.
|
|
<DT id="8"><B>8.</B><DD>
|
|
Exécution du point d'entrée <B>postclean</B> et si <B>-tc</B> ou <B>--post-clean</B>
|
|
sont utilisés, appel de <B>fakeroot debian/rules clean</B> à nouveau.
|
|
<DT id="9"><B>9.</B><DD>
|
|
Appel de <B>dpkg-source --after-build</B>.
|
|
<DT id="10"><B>10.</B><DD>
|
|
Exécution du point d'entrée <B>check</B> et appel d'un contrôleur de paquet pour
|
|
le fichier <B>.changes</B> (dans le cas où une commande est spécifiée dans
|
|
<B>DEB_CHECK_COMMAND</B> ou avec <B>--check-command</B>).
|
|
<DT id="11"><B>11.</B><DD>
|
|
Exécution du point d'entrée <B>sign</B> et appel de <B>gpg2</B> ou de <B>gpg</B> (à
|
|
condition que ce ne soit pas une construction pour UNRELEASED, ou si
|
|
<B>--no-sign</B> est spécifié), pour signature des fichiers <B>.dsc</B> (sauf si
|
|
<B>-us</B> ou si <B>--unsigned-source</B> sont spécifiés), <B>.buildinfo</B> (sauf si
|
|
<B>-ui</B>, <B>--unsigned-buildinfo</B>, <B>-uc</B> ou <B>--unsigned-changes</B> sont
|
|
spécifiés) et <B>.changes</B> (sauf si <B>-uc</B> ou <B>--unsigned-changes</B> sont
|
|
spécifiés).
|
|
<DT id="12"><B>12.</B><DD>
|
|
Exécution du point d'entrée <B>done</B>.
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
Toutes les options longues peuvent être spécifiées à la fois sur la ligne
|
|
de commande et dans les fichiers de configuration utilisateur et de système
|
|
<B>dpkg-buildpackage</B>. Chaque ligne du fichier de configuration est soit une
|
|
option (identique à une option en ligne de commande mais sans tiret), soit
|
|
un commentaire (si elle commence par « <B>#</B> »).
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="13"><B>--build=</B><I>type</I><DD>
|
|
Indique le <I>type</I> de construction à partir d'une liste de composants
|
|
séparés par des virgules (depuis dpkg 1.18.5). Passé à <B>dpkg-genchanges</B>.
|
|
<P>
|
|
Les valeurs autorisées sont :
|
|
<DL COMPACT><DT id="14"><DD>
|
|
<DL COMPACT>
|
|
<DT id="15"><B>source</B><DD>
|
|
Construit le paquet source. Note : quand cette valeur est utilisée toute
|
|
seule et si ce que vous voulez est seulement (re)construire le paquet source
|
|
à partir d'une arborescence des sources propre, l'utilisation directe de
|
|
<B>dpkg-source</B> est toujours une meilleure option dans la mesure où cela ne
|
|
demande pas l'installation de dépendances de construction qui sont sinon
|
|
nécessaires pour pouvoir appeler la cible <B>clean</B>.
|
|
<DT id="16"><B>any</B><DD>
|
|
Construit les paquets binaires spécifiques à l'architecture.
|
|
<DT id="17"><B>all</B><DD>
|
|
Construit les paquets binaires indépendants de l'architecture.
|
|
<DT id="18"><B>binary</B><DD>
|
|
Construit les paquets binaires particuliers et indépendants de
|
|
l'architecture. C'est un alias de <B>any,all</B>.
|
|
<DT id="19"><B>full</B><DD>
|
|
Construction complète. C'est un alias de <B>source,any,all</B>, et il est
|
|
identique au cas par défaut où aucune option de construction n'est indiquée.
|
|
</DL>
|
|
</DL>
|
|
|
|
<DT id="20"><B>-g</B><DD>
|
|
Équivalent de <B>--build=source,all</B> (depuis dpkg 1.17.11).
|
|
<DT id="21"><B>-G</B><DD>
|
|
Équivalent de <B>--build=source,any</B> (depuis dpkg 1.17.11).
|
|
<DT id="22"><B>-b</B><DD>
|
|
Équivalent de <B>--build=binary</B> ou <B>--build=any,all</B>.
|
|
<DT id="23"><B>-B</B><DD>
|
|
Équivalent de <B>--build=any</B>
|
|
<DT id="24"><B>-A</B><DD>
|
|
Équivalent de <B>--build=all</B>.
|
|
<DT id="25"><B>-S</B><DD>
|
|
Équivalent à <B>--build=source</B>.
|
|
<DT id="26"><B>-F</B><DD>
|
|
Équivalent de <B>--build=full</B>, <B>--build=source,binary</B> ou
|
|
<B>--build=source,any,all</B> (depuis dpkg 1.15.8).
|
|
<DT id="27"><B>--target=</B><I>cible</I>[,...]<DD>
|
|
|
|
<B>--target </B><I>cible</I>[,...]
|
|
|
|
<B>-T</B>, <B>--rules-target=</B><I>cible</I>
|
|
Appelle <B>debian/rules</B> <I>cible</I> une fois par cible spécifiée, après avoir
|
|
mis en place l'environnement de construction (sauf pour appeler
|
|
<B>dpkg-source --before-build</B>), puis interrompt le processus de construction
|
|
(depuis dpkg 1.15.0, option longue depuis dpkg 1.18.8, pris en charge de
|
|
multiples cibles depuis dpkg 1.18.16). Si <B>--as-root</B> est également
|
|
utilisé, la commande sera exécutée avec les privilèges du superutilisateur
|
|
(voir <B>--root-command</B>). Noter que les cibles connues dont l'exécution par
|
|
root est imposée n'ont pas besoin de cette option (c'est-à-dire les cibles
|
|
<B>clean</B>, <B>binary</B>, <B>binary-arch</B> et <B>binary-indep</B>).
|
|
<DT id="28"><B>--as-root</B><DD>
|
|
N'est utile qu'avec <B>--target</B> (depuis dpkg 1.15.0). Impose d'exécuter la
|
|
cible avec les privilèges du superutilisateur.
|
|
<DT id="29"><B>-si</B><DD>
|
|
|
|
<B>-sa</B>
|
|
|
|
<B>-sd</B>
|
|
|
|
<B>-v</B><I>version</I>
|
|
|
|
<B>-C</B><I>description-des-changements</I>
|
|
|
|
<B>-m</B>, <B>--release-by=</B><I>adresse-du-responsable</I>
|
|
|
|
<B>-e</B>, <B>--build-by=</B><I>adresse-du-responsable</I>
|
|
Passé tel quel à <B>dpkg-genchanges</B>. Voir sa page de manuel.
|
|
<DT id="30"><B>-a</B>, <B>--host-arch</B> <I>architecture</I><DD>
|
|
Précise l'architecture Debian pour laquelle on construit (option longue
|
|
depuis dpkg 1.17.17). L'architecture de la machine sur laquelle on construit
|
|
est automatiquement déterminée ; c'est aussi l'architecture par défaut de la
|
|
machine hôte.
|
|
<DT id="31"><B>-t</B>, <B>--host-type</B> <I>type-de-système-gnu</I><DD>
|
|
Précise le type de système GNU pour lequel construire (option longue depuis
|
|
dpkg 1.17.17). Il peut être utilisé à la place de <B>--host-arch</B> ou en tant
|
|
que complément afin de remplacer le type de système GNU par défaut de
|
|
l'architecture Debian hôte.
|
|
<DT id="32"><B>--target-arch</B> <I>architecture</I><DD>
|
|
Précise l'architecture Debian pour laquelle les binaires compilés vont
|
|
construire (depuis dpkg 1.17.17). La valeur par défaut est l'architecture de
|
|
la machine hôte.
|
|
<DT id="33"><B>--target-type</B> <I>type-de-système-gnu</I><DD>
|
|
Précise le type de système GNU pour lequel les binaires compilés vont
|
|
construire (depuis dpkg 1.17.17). Il peut être utilisé à la place de
|
|
<B>--target-arch</B> ou en tant que complément afin de remplacer le type de
|
|
système GNU par défaut de l'architecture Debian cible.
|
|
<DT id="34"><B>-P</B>, <B>--build-profiles=</B><I>profil</I>[<B>,</B>...]<DD>
|
|
Précise le ou les profils que l'on construit, sous forme d'une liste séparée
|
|
par des virgules (depuis dpkg 1.17.2, option longue depuis dpkg 1.18.8). Le
|
|
comportement par défaut est de construire pour un profil non
|
|
spécifique. Cela les définit également (sous la forme d'une liste séparée
|
|
par des espaces) en tant que variable d'environnement <B>DEB_BUILD_PROFILES</B>,
|
|
ce qui permet, par exemple, au fichiers <B>debian/rules</B> d'utiliser cette
|
|
information pour des constructions conditionnelles.
|
|
<DT id="35"><B>-j</B>, <B>--jobs</B>[<I>jobs</I>|<B>auto</B>]<DD>
|
|
Nombre de processus simultanés qui peuvent être exécutés, nombre de
|
|
processus correspondant au nombre de processeurs en ligne si <B>auto</B> est
|
|
indiquée (depuis dpkg 1.17.10), ou un nombre illimité si <I>jobs</I> n'est pas
|
|
indiqué, équivalent à l'option <B><A HREF="/cgi-bin/man/man2html?1+make">make</A></B>(1) du même nom (depuis dpkg 1.14.7,
|
|
option longue depuis dpkg 1.18.8). S'ajoutera tout seul à la variable
|
|
d'environnement MAKEFLAGS, afin que les appels suivants de make en héritent,
|
|
forçant donc le paramètre parallèle sur l'empaquetage (et éventuellement le
|
|
système de construction amont s'il utilise make) indépendamment de leur
|
|
prise en charge des constructions parallèle, ce qui pourrait provoquer des
|
|
échecs de construction. Ajoute aussi <B>parallel=</B><I>jobs</I> ou <B>parallel</B> à la
|
|
variable d'environnement <B>DEB_BUILD_OPTIONS</B> ce qui permet aux fichiers
|
|
debian/rules d'utiliser cette information pour leurs propres besoins. La
|
|
valeur de <B>j</B> remplacera les options <B>parallel=</B><I>jobs</I> ou <B>parallel</B>
|
|
dans la variable d'environnement <B>DEB_BUILD_OPTIONS</B>. Notez que la valeur
|
|
<B>auto</B> sera remplacée par le nombre réel de processeurs actuellement
|
|
actifs, et par conséquent ne sera pas transmise à aucun processus fils. Si
|
|
le nombre de processeurs en ligne ne peut pas être déduit, alors le code
|
|
utilisera par défaut une exécution sérielle (depuis dpkg 1.18.15), même si
|
|
cela ne devrait arriver que sur des systèmes exotiques et non pris en
|
|
charge.
|
|
<DT id="36"><B>-J</B>, <B>--jobs-try</B>[=<I>tâches</I>|<B>auto</B>]<DD>
|
|
Cette option (depuis dpkg 1.18.2, option longue depuis dpkg 1.18.8) est
|
|
équivalente à l'option <B>-j</B> sauf qu'elle ne configure pas la variable
|
|
d'environnement <B>MAKEFLAGS</B> et, à ce titre, il est plus sûr de l'utiliser
|
|
avec tous les paquets y compris ceux qui ne sont pas sécurisés pour une
|
|
construction parallèle.
|
|
<P>
|
|
Le comportement par défaut est <B>auto</B> (depuis dpkg 1.18.11). Fixer le
|
|
nombre de tâches à 1 rétablira un comportement sériel.
|
|
<DT id="37"><B>-D</B>, <B>--check-builddeps</B><DD>
|
|
Vérification des dépendances de constructions et des conflits ; se termine
|
|
en cas de problèmes (option longue depuis dpkg 1.18.8). C'est le
|
|
comportement par défaut.
|
|
<DT id="38"><B>-d</B>, <B>--no-check-builddeps</B><DD>
|
|
Pas de vérification des dépendances de constructions et des conflits (option
|
|
longue depuis dpkg 1.18.8).
|
|
<DT id="39"><B>--ignore-builtin-builddeps</B><DD>
|
|
Pas de vérification des dépendances de constructions internes et des
|
|
conflits (depuis dpkg 1.18.2). Il s'agit des dépendances de construction
|
|
implicites spécifiques à la distribution habituellement requises dans un
|
|
environnement de construction, c'est l'ensemble de paquets appelé
|
|
Build-Essentiel.
|
|
<DT id="40"><B>--rules-requires-root</B><DD>
|
|
Pas de prise en compte du champ <B>Rules-Requires-Root</B>, retour à l'ancienne
|
|
valeur par défaut (depuis dpkg 1.19.1).
|
|
<DT id="41"><B>-nc</B>, <B>--no-pre-clean</B><DD>
|
|
Pas de nettoyage de l'arborescence des sources avant la construction (option
|
|
longue depuis dpkg 1.18.8). Implique <B>-b</B> si aucune des options <B>-F</B>,
|
|
<B>-g</B>, <B>-G</B>, <B>-B</B>, <B>-A</B> ou <B>-S</B> n'est utilisée). Implique <B>-d</B> avec
|
|
<B>-S</B> (depuis dpkg 1.18.0).
|
|
<DT id="42"><B>--pre-clean</B><DD>
|
|
Nettoyage de l'arborescence des sources avant la construction (depuis
|
|
dpkg 1.18.8). C'est le comportement par défaut.
|
|
<DT id="43"><B>-tc</B>, <B>--post-clean</B><DD>
|
|
Nettoyage de l'arborescence des sources (en utilisant
|
|
<I>commande-pour-obtenir-privilèges-de-root</I> <B>debian/rules clean</B>) après la
|
|
construction du paquet (option longue depuis dpkg 1.18.8).
|
|
<DT id="44"><B>--no-post-clean</B><DD>
|
|
Pas de nettoyage de l'arborescence des sources après la construction du
|
|
paquet (depuis dpkg 1.19.1). C'est le comportement par défaut.
|
|
<DT id="45"><B>-r</B>, <B>--root-command=</B><I>commande-pour-obtenir-privilèges-de-root</I><DD>
|
|
Quand <B>dpkg-buildpackage</B> doit exécuter une partie du processus de
|
|
construction en tant que root, il préfixe la commande exécutée par
|
|
<I>commande-pour-obtenir-privilèges-de-root</I>, si une a été spécifiée (option
|
|
longue depuis dpkg 1.18.8). Si ce n'est pas le cas alors <B>fakeroot</B> est
|
|
utilisé par défaut. <I>commande-pour-obtenir-privilèges-de-root</I> doit débuter
|
|
par le nom d'un programme accessible depuis <B>PATH</B> et avoir comme arguments
|
|
le nom de la commande réelle avec les arguments qu'elle doit
|
|
prendre. <I>commande-pour-obtenir-privilèges-de-root</I> peut recevoir des
|
|
paramètres (ils doivent être séparés par des espaces) mais aucun
|
|
métacaractère de l'interpréteur de commandes. Classiquement
|
|
<I>commande-pour-obtenir-privilèges-de-root</I> devrait être <B>fakeroot</B>,
|
|
<B>sudo</B>, <B>super</B> ou <B>really</B>. <B>su</B> ne va pas, puisque ce programme peut
|
|
uniquement utiliser l'interpréteur de commandes de l'utilisateur avec
|
|
l'option <B>-c</B> au lieu de passer directement les arguments à la commande qui
|
|
doit être exécutée.
|
|
<DT id="46"><B>-R</B>, <B>--rules-file=</B><I>fichier-rules</I><DD>
|
|
Construire un paquet Debian implique généralement l'invocation de
|
|
<B>debian/rules</B> comme une commande avec de nombreux paramètres standard
|
|
(depuis dpkg 1.14.17, option longue depuis dpkg 1.18.8). Avec cette option,
|
|
il est possible d'utiliser un autre programme à utiliser pour la
|
|
construction de paquet (ainsi que ses paramètres séparés par des
|
|
espaces). Une autre utilisation possible est d'exécuter le fichier rules
|
|
standard avec un autre programme make (par exemple en utilisant
|
|
<B>/usr/local/bin/make -f debian/rules</B> comme <I>fichier-rules</I>).
|
|
<DT id="47"><B>--check-command=</B><I>commande-contrôleur</I><DD>
|
|
Commande utilisée pour vérifier le fichier <B>.changes</B> lui-même et tout
|
|
objet construit référencé dans le fichier (depuis dpkg 1.17.6). La commande
|
|
peut recevoir comme argument le nom de chemin de <B>.changes</B>. Cette commande
|
|
est en général <B>lintian</B>.
|
|
<DT id="48"><B>--check-option=</B><I>opt</I><DD>
|
|
Passer l'option <I>opt</I> à <I>commande-contrôleur</I> indiquée par
|
|
<B>DEB_CHECK_COMMAND</B> ou <B>--check-command</B> (depuis dpkg 1.17.6). Peut être
|
|
utilisé plusieurs fois.
|
|
<DT id="49"><B>--hook-</B><I>nom-de-point-d'entrée</I><B>=</B><I>commande-de-point-d'entrée</I><DD>
|
|
Définir le code spécifié de l'interpréteur de commandes
|
|
<I>commande-de-point-d'entrée</I> comme point d'entrée <I>nom-de-point-d'entré</I>
|
|
qui sera exécuté aux moments spécifiés par les étapes d'exécution (depuis
|
|
dpkg 1.17.6). Les points d'entrée seront toujours exécutés même si l'action
|
|
suivante n'est pas effectuée (sauf pour le point d'entrée <B>binary</B>). Tous
|
|
les points d'entrée seront exécutés dans le répertoire source dépaqueté.
|
|
<P>
|
|
Note : Les points d'entrée sont susceptibles d'affecter le processus de
|
|
construction et provoquer des échecs de construction si leurs commandes
|
|
échouent, donc attention aux conséquences inattendues.
|
|
<P>
|
|
Les <I>nom-de-point-d'entrée</I> actuellement pris en charge sont :
|
|
<P>
|
|
<B>init preclean source build binary buildinfo changes postclean check sign
|
|
done</B>
|
|
<P>
|
|
La <I>commande-point-d'entrée</I> gère les chaînes de formatage de substitution
|
|
suivantes, qui lui sont appliquées avant exécution :
|
|
<P>
|
|
<DL COMPACT><DT id="50"><DD>
|
|
<DL COMPACT>
|
|
<DT id="51"><B>%%</B><DD>
|
|
Un caractère % seul.
|
|
<DT id="52"><B>%a</B><DD>
|
|
Une valeur booléenne (0 ou 1) qui indique si l'action suivante est
|
|
effectuée.
|
|
<DT id="53"><B>%p</B><DD>
|
|
Nom du paquet source.
|
|
<DT id="54"><B>%v</B><DD>
|
|
La version du paquet source.
|
|
<DT id="55"><B>%s</B><DD>
|
|
La version du paquet source (sans l'« epoch »).
|
|
<DT id="56"><B>%u</B><DD>
|
|
La version amont.
|
|
</DL>
|
|
</DL>
|
|
|
|
<DT id="57"><B>--buildinfo-option=</B><I>opt</I><DD>
|
|
Passer l'option <I>opt</I> à <B>dpkg-genbuildinfo</B> (depuis dpkg 1.18.11). Peut
|
|
être utilisé plusieurs fois.
|
|
<DT id="58"><B>-p</B>, <B>--sign-command=</B><I>commande-de-signature</I><DD>
|
|
Quand <B>dpkg-buildpackage</B> doit exécuter GPG pour signer un fichier source
|
|
de contrôle (<B>.dsc</B>) ou un fichier <B>.changes</B>, il exécute
|
|
<I>commande-de-signature</I> (recherchée dans <B>PATH</B> si nécessaire) au lieu de
|
|
<B>gpg2</B> ou <B>gpg</B> (option longue depuis
|
|
dpkg 1.18.1). <I>commande-de-signature</I> reçoit tous les paramètres
|
|
qu'auraient reçu <B>gpg2</B> ou <B>gpg</B>. <I>commande-de-signature</I> ne devra pas
|
|
contenir d'espace ni aucun métacaractère de l'interpréteur de commandes.
|
|
<DT id="59"><B>-k</B>, <B>--sign-key=</B><I>identifiant-clé</I><DD>
|
|
Préciser une clé pour la signature des paquets (option longue depuis
|
|
dpkg 1.18.8).
|
|
<DT id="60"><B>-us</B>, <B>--unsigned-source</B><DD>
|
|
Ne pas signer le paquet source (option longue depuis dpkg 1.18.8).
|
|
<DT id="61"><B>-ui</B>, <B>--unsigned-buildinfo</B><DD>
|
|
Ne pas signer le fichier <B>.buildinfo</B> (depuis dpkg 1.18.19).
|
|
<DT id="62"><B>-uc</B>, <B>--unsigned-changes</B><DD>
|
|
Ne signer ni le fichier <B>.buildinfo</B>, ni le fichier <B>.changes</B> (option
|
|
longue depuis dpkg 1.18.8).
|
|
<DT id="63"><B>--no-sign</B><DD>
|
|
Aucune signature de fichier, y compris du paquet source, du fichier
|
|
<B>.buildinfo</B> et du fichier <B>.changes</B> (depuis dpkg 1.18.20).
|
|
<DT id="64"><B>--force-sign</B><DD>
|
|
Forcer la signature des fichiers produits (depuis dpkg 1.17.0)
|
|
indépendamment de <B>-us</B>, <B>--unsigned-source</B>, <B>-ui</B>,
|
|
<B>--unsigned-buildinfo</B>, <B>-uc</B>, <B>--unsigned-changes</B> ou d'autres
|
|
heuristiques internes.
|
|
<DT id="65"><B>-sn</B><DD>
|
|
|
|
<B>-ss</B>
|
|
|
|
<B>-sA</B>
|
|
|
|
<B>-sk</B>
|
|
|
|
<B>-su</B>
|
|
|
|
<B>-sr</B>
|
|
|
|
<B>-sK</B>
|
|
|
|
<B>-sU</B>
|
|
|
|
<B>-sR</B>
|
|
|
|
<B>-i</B>, <B>--diff-ignore</B>[=<I>expression-rationnelle</I>]
|
|
|
|
<B>-I</B>, <B>--tar-ignore</B>[=<I>motif</I>]
|
|
|
|
<B>-z</B>, <B>--compression-level</B>=<I>niveau</I>
|
|
|
|
<B>-Z</B>, <B>--compression</B>=<I>compression</I>
|
|
Chaîne passée telle quelle à <B>dpkg-source</B>. Voir la page de manuel
|
|
correspondante.
|
|
<DT id="66"><B>--source-option=</B><I>opt</I><DD>
|
|
Passer l'option <I>opt</I> à <B>dpkg-source</B> (depuis dpkg 1.15.6). Peut être
|
|
utilisé plusieurs fois.
|
|
<DT id="67"><B>--changes-option=</B><I>opt</I><DD>
|
|
Passer l'option <I>opt</I> à <B>dpkg-genchanges</B> (depuis dpkg 1.15.6). Peut être
|
|
utilisé plusieurs fois.
|
|
<DT id="68"><B>--admindir</B>=<I>répertoire</I><DD>
|
|
|
|
<B>--admindir </B><I>rép</I>
|
|
Changer l'endroit où se trouve la base de données de <B>dpkg</B> (depuis
|
|
dpkg 1.14.0). Par défaut, c'est <I>/var/lib/dpkg</I>.
|
|
<DT id="69"><B>-?</B>, <B>--help</B><DD>
|
|
Affiche un message d'aide puis quitte.
|
|
<DT id="70"><B>--version</B><DD>
|
|
Affiche le numéro de version puis quitte.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>ENVIRONNEMENT</H2>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H3>Environnement externe</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="71"><B>DEB_CHECK_COMMAND</B><DD>
|
|
Si cette option est utilisée, elle le sera comme commande pour contrôler le
|
|
fichier <B>.changes</B> (depuis dpkg 1.17.6). Remplacée par l'option
|
|
<B>--check-command</B>.
|
|
<DT id="72"><B>DEB_SIGN_KEYID</B><DD>
|
|
Si cette option est utilisée, elle le sera pour la signature des fichiers
|
|
<B>.changes</B> et <B>.dsc</B> (depuis dpkg 1.17.2). Remplacée par l'option
|
|
<B>--sign-key</B>.
|
|
<DT id="73"><B>DEB_BUILD_OPTIONS</B><DD>
|
|
Si cette option est utilisée, elle contiendra une liste séparée par des
|
|
espaces d'options qui pourraient affecter le processus de construction dans
|
|
<I>debian/rules</I> et le comportement de certaines commandes de dpkg.
|
|
<P>
|
|
La variable <B>DEB_CHECK_COMMAND</B> sera ignorée avec <B>nocheck</B>. Avec
|
|
<B>parallel=</B><I>N</I> les tâches parallèles seront fixées à <I>N</I>, remplacée par
|
|
l'option <B>--jobs-try</B>.
|
|
<DT id="74"><B>DEB_BUILD_PROFILES</B><DD>
|
|
Si cette option est utilisée, elle sera utilisée comme profil(s) de
|
|
construction actif(s) pour le paquet à construire (depuis
|
|
dpkg 1.17.2). C'est une liste séparée par des espaces de noms de
|
|
profil. Cette option est outrepassée par l'option <B>-P</B>.
|
|
<DT id="75"><B>DPKG_COLORS</B><DD>
|
|
Définit le mode de couleur (depuis dpkg 1.18.5). Les valeurs actuellement
|
|
acceptées sont <B>auto</B> (par défaut), <B>always</B> et <B>never</B>.
|
|
<DT id="76"><B>DPKG_NLS</B><DD>
|
|
Si cette variable est définie, elle sera utilisée pour décider l'activation
|
|
de la prise en charge des langues (NLS - Native Language Support), connu
|
|
aussi comme la gestion de l'internationalisation (ou i18n) (depuis
|
|
dpkg 1.19.0). Les valeurs permises sont : <B>0</B> et <B>1</B> (par défaut).
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H3>Environnement interne</H3>
|
|
|
|
Même si <B>dpkg-buildpackage</B> exporte certaines variables, <B>debian/rules</B> ne
|
|
doit pas dépendre de leur présence, mais doit préférablement utiliser
|
|
l'interface correspondante pour retrouver les valeurs nécessaires, parce que
|
|
ce fichier est le point d'entrée principal pour la construction des paquets
|
|
et son exécution autonome devrait être prise en charge.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="77"><B>DEB_BUILD_*</B><DD>
|
|
|
|
<B>DEB_HOST_*</B>
|
|
|
|
<B>DEB_TARGET_*</B>
|
|
<B>dpkg-architecture</B> est lancé avec les paramètres de <B>-a</B> et <B>-t</B>. Toute
|
|
variable retournée par l'option <B>-s</B> est intégrée dans l'environnement de
|
|
construction.
|
|
<DT id="78"><B>DEB_RULES_REQUIRES_ROOT</B><DD>
|
|
Cette variable est fixée à la valeur obtenue du champ <B>Rules-Requires-Root</B>
|
|
ou de la ligne de commande. Lorsqu'elle est configurée, ce sera une valeur
|
|
valable pour le champ <B>Rules-Requires-Root</B>. Elle est utilisée pour
|
|
indiquer à <B>debian/rules</B> si la spécification <B>rootless-builds.txt</B> est
|
|
prise en charge.
|
|
<DT id="79"><B>DEB_GAIN_ROOT_CMD</B><DD>
|
|
Cette valeur est fixée à <I>commande-pour-obtenir-privilèges-de-root</I> si le
|
|
champ <B>Rules-Requires-Root</B> est fixé à une valeur différente de <B>no</B> ou
|
|
<B>binary-targets</B>.
|
|
<DT id="80"><B>SOURCE_DATE_EPOCH</B><DD>
|
|
Cette valeur est fixée à l'horodatage d'Unix depuis « l'epoch » de la
|
|
dernière entrée de <I>debian/changelog</I>, si elle n'a pas déjà été définie.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>FICHIERS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="81"><I>/etc/dpkg/buildpackage.conf</I><DD>
|
|
Fichier de configuration pour l'ensemble du système
|
|
<DT id="82"><I>$XDG_CONFIG_HOME/dpkg/buildpackage.conf</I> ou<DD>
|
|
|
|
<I>$HOME/.config/dpkg/buildpackage.conf</I>
|
|
Fichier de configuration propre à l'utilisateur
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>NOTES</H2>
|
|
|
|
<A NAME="lbAK"> </A>
|
|
<H3>Les drapeaux de compilation ne sont plus exportés.</H3>
|
|
|
|
Entre les versions 1.14.17 et 1.16.1, <B>dpkg-buildpackage</B> exportait les
|
|
drapeaux de compilation (<B>CFLAGS</B>, <B>CXXFLAGS</B>, <B>FFLAGS</B>, <B>CPPFLAGS</B> et
|
|
<B>LDFLAGS</B>) avec les valeurs que renvoyait <B>dpkg-buildflags</B>. Cela n'est
|
|
plus le cas.
|
|
<A NAME="lbAL"> </A>
|
|
<H3>Cibles construites par défaut</H3>
|
|
|
|
<B>dpkg-buildpackage</B> utilise les cibles <B>build-arch</B> et <B>build-indep</B>
|
|
depuis dpkg 1.16.2. Ces cibles sont donc obligatoires. Cependant, pour
|
|
éviter de casser les paquets existants et faciliter la transition, si le
|
|
paquet source ne construit pas à la fois les paquets binaires indépendants
|
|
et dépendants de l'architecture (depuis dpkg 1.18.8), la cible <B>build</B> sera
|
|
utilisée par défaut si <B>make -f debian/rules -qn</B> <I>build-target</I> renvoie
|
|
<B>2</B> comme code de retour.
|
|
<A NAME="lbAM"> </A>
|
|
<H2>BOGUES</H2>
|
|
|
|
On devrait pouvoir mettre des espaces et des métacaractères du shell et les
|
|
arguments initiaux de <I>commande-pour-obtenir-privilèges-de-root</I> et
|
|
<I>commande-de-signature</I>.
|
|
<A NAME="lbAN"> </A>
|
|
<H2>VOIR AUSSI</H2>
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+dpkg-source">dpkg-source</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+dpkg-architecture">dpkg-architecture</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+dpkg-buildflags">dpkg-buildflags</A></B>(1),
|
|
<B><A HREF="/cgi-bin/man/man2html?1+dpkg-genbuildinfo">dpkg-genbuildinfo</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+dpkg-genchanges">dpkg-genchanges</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+fakeroot">fakeroot</A></B>(1),
|
|
<B><A HREF="/cgi-bin/man/man2html?1+lintian">lintian</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+gpg2">gpg2</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+gpg">gpg</A></B>(1).
|
|
<A NAME="lbAO"> </A>
|
|
<H2>TRADUCTION</H2>
|
|
|
|
Ariel VARDI <<A HREF="mailto:ariel.vardi@freesbee.fr">ariel.vardi@freesbee.fr</A>>, 2002.
|
|
Philippe Batailler, 2006.
|
|
Nicolas François, 2006.
|
|
Veuillez signaler toute erreur à <<A HREF="mailto:debian-l10n-french@lists.debian.org">debian-l10n-french@lists.debian.org</A>>.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="83"><A HREF="#lbAB">NOM</A><DD>
|
|
<DT id="84"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="85"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="86"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="87"><A HREF="#lbAF">ENVIRONNEMENT</A><DD>
|
|
<DL>
|
|
<DT id="88"><A HREF="#lbAG">Environnement externe</A><DD>
|
|
<DT id="89"><A HREF="#lbAH">Environnement interne</A><DD>
|
|
</DL>
|
|
<DT id="90"><A HREF="#lbAI">FICHIERS</A><DD>
|
|
<DT id="91"><A HREF="#lbAJ">NOTES</A><DD>
|
|
<DL>
|
|
<DT id="92"><A HREF="#lbAK">Les drapeaux de compilation ne sont plus exportés.</A><DD>
|
|
<DT id="93"><A HREF="#lbAL">Cibles construites par défaut</A><DD>
|
|
</DL>
|
|
<DT id="94"><A HREF="#lbAM">BOGUES</A><DD>
|
|
<DT id="95"><A HREF="#lbAN">VOIR AUSSI</A><DD>
|
|
<DT id="96"><A HREF="#lbAO">TRADUCTION</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:01 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|