.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "dpkg-buildpackage 1"
.TH dpkg-buildpackage 1 "2023-05-11" "1.21.22" "dpkg suite"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NOM"
.IX Header "NOM"
dpkg-buildpackage \- Construire depuis les sources des paquets binaires ou sources
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBdpkg-buildpackage\fR [\fIoption\fR...]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdpkg-buildpackage\fR est un programme qui permet d'automatiser la construction d'un paquet Debian. Il comporte les \('etapes suivantes :
.IP "\fB1.\fR" 4
.IX Item "1."
Pr\('eparation de l'environnement de compilation par positionnement de diverses variables d'environnement (voir \fB\s-1VARIABLES D\s0'\s-1ENVIRONNEMENT\s0\fR), ex\('ecution du point d'entr\('ee \fBinit\fR et appel de \fBdpkg-source \-\-before\-build\fR (sauf si \fB\-T\fR ou \fB\-\-target\fR ont \('et\('e utilis\('es).
.IP "\fB2.\fR" 4
.IX Item "2."
Contr\(^ole des d\('ependances de construction et des conflits de construction (non effectu\('e si \fB\-d\fR ou \fB\-\-no\-check\-builddeps\fR sont utilis\('es).
.IP "\fB3.\fR" 4
.IX Item "3."
Si une ou plusieurs cibles particuli\(`eres ont \('et\('e indiqu\('ees avec les options \fB\-T\fR ou \fB\-\-target\fR, appel de ces cibles et arr\(^et. Dans le cas contraire, ex\('ecution du point d'entr\('ee \fBpreclean\fR et appel de \fBfakeroot debian/rules clean\fR pour nettoyage de l'arborescence source (sauf si \fB\-nc\fR ou \fB\-\-no\-pre\-clean\fR ont \('et\('e utilis\('es).
.IP "\fB4.\fR" 4
.IX Item "4."
Ex\('ecution du point d'entr\('ee \fBsource\fR et appel de \fBdpkg-source \-b\fR pour cr\('eer le paquet source (si une construction \fBsource\fR a \('et\('e demand\('ee avec \fB\-\-build\fR ou des options \('equivalentes).
.IP "\fB5.\fR" 4
.IX Item "5."
Ex\('ecution du point d'entr\('ee \fBbuild\fR et appel de \fBdebian/rules\fR \fIbuild-target\fR, puis ex\('ecution du point d'entr\('ee \fBbinary\fR suivie de \fBfakeroot debian/rules\fR \fIbinary-target\fR (sauf si une construction source seule a \('et\('e demand\('ee avec \fB\-\-build=source\fR ou des options \('equivalentes). Noter que \fIbuild-target\fR et \fIbinary-target\fR sont soit \fBbuild\fR et \fBbinary\fR (cas par d\('efaut, ou si une construction \fBany\fR et \fBall\fR a \('et\('e demand\('ee avec \fB\-\-build\fR ou des options \('equivalentes), soit \fBbuild-arch\fR et \fBbinary-arch\fR (si une construction \fBany\fR et pas \fBall\fR a \('et\('e demand\('ee avec \fB\-\-build\fR ou des options \('equivalentes), soit \fBbuild-indep\fR et \fBbinary-indep\fR (si une construction \fBall\fR et pas \fBany\fR a \('et\('e demand\('ee avec \fB\-\-build\fR ou des options \('equivalentes).
.IP "\fB6.\fR" 4
.IX Item "6."
Ex\('ecution du point d'entr\('ee \fBbuildinfo\fR et appel de \fBdpkg-genbuildinfo\fR pour cr\('eer un fichier \fB.buildinfo\fR. De nombreuses options de \fBdpkg-buildpackage\fR sont pass\('ees \(`a \fBdpkg-genbuildinfo\fR.
.IP "\fB7.\fR" 4
.IX Item "7."
Ex\('ecution du point d'entr\('ee \fBchanges\fR et appel de \fBdpkg-genchanges\fR pour cr\('eer un fichier \fB.changes\fR. Le nom du fichier \fB.changes\fR d\('ependra du type de construction et sera aussi sp\('ecifique que n\('ecessaire mais pas plus ; pour une construction qui inclut \fBany\fR, le nom sera \fInom-de-source\fR\fB_\fR\fIversion-binaire\fR\fB_\fR\fIarchitecture\fR\fB.changes\fR, ou pour une construction qui inclut \fBall\fR, le nom sera \fInom-de-source\fR\fB_\fR\fIversion-binaire\fR\fB_\fR\fBall.changes\fR, ou pour une construction qui inclut \fBsource\fR, le nom sera \fInom-de-source\fR\fB_\fR\fIversion-source\fR\fB_\fR\fBsources.changes\fR. De nombreuses options de \fBdpkg-buildpackage\fR sont pass\('ees \(`a \fBdpkg-genchanges\fR.
.IP "\fB8.\fR" 4
.IX Item "8."
Ex\('ecution du point d'entr\('ee \fBpostclean\fR et si \fB\-tc\fR ou \fB\-\-post\-clean\fR sont utilis\('es, appel de \fBfakeroot debian/rules clean\fR \(`a nouveau.
.IP "\fB9.\fR" 4
.IX Item "9."
Appel de \fBdpkg-source \-\-after\-build\fR.
.IP "\fB10.\fR" 4
.IX Item "10."
Ex\('ecution du point d'entr\('ee \fBcheck\fR et appel d'un contr\(^oleur de paquet pour le fichier \fB.changes\fR (dans le cas o\(`u une commande est sp\('ecifi\('ee dans \fB\s-1DEB_CHECK_COMMAND\s0\fR ou avec \fB\-\-check\-command\fR).
.IP "\fB11.\fR" 4
.IX Item "11."
Ex\('ecution du point d'entr\('ee \fBsign\fR et signature avec le dorsal OpenPGP (\(`a condition que ce ne soit pas une construction pour \s-1UNRELEASED,\s0 ou si \fB\-\-no\-sign\fR est sp\('ecifi\('e), pour signature des fichiers \fB.dsc\fR (sauf si \fB\-us\fR ou si \fB\-\-unsigned\-source\fR sont sp\('ecifi\('es), \fB.buildinfo\fR (sauf si \fB\-ui\fR, \fB\-\-unsigned\-buildinfo\fR, \fB\-uc\fR ou \fB\-\-unsigned\-changes\fR sont sp\('ecifi\('es) et \fB.changes\fR (sauf si \fB\-uc\fR ou \fB\-\-unsigned\-changes\fR sont sp\('ecifi\('es).
.IP "\fB12.\fR" 4
.IX Item "12."
Ex\('ecution du point d'entr\('ee \fBdone\fR.
.SH "OPTIONS"
.IX Header "OPTIONS"
Toutes les options longues peuvent \(^etre sp\('ecifi\('ees  \(`a la fois sur la ligne de commande et dans les fichiers de configuration utilisateur et de syst\(`eme \fBdpkg-buildpackage\fR. Chaque ligne du fichier de configuration est soit une option (identique \(`a une option en ligne de commande mais sans tiret), soit un commentaire (si elle commence par \(Fo \fB#\fR \(Fc).
.IP "\fB\-\-build=\fR\fItype\fR" 4
.IX Item "--build=type"
Indique le \fItype\fR de construction \(`a partir d'une liste de composants s\('epar\('es par des virgules (depuis dpkg 1.18.5). Tous les composants indiqu\('es sont combin\('es pour choisir l'unique type de construction \(`a utiliser, ce qui implique qu'une seule construction est ex\('ecut\('e avec la g\('en\('eration d'un seul fichier \fI.changes\fR. Pass\('e \(`a \fBdpkg-genchanges\fR.
.Sp
Les valeurs autoris\('ees sont :
.RS 4
.IP "\fBsource\fR" 4
.IX Item "source"
Construit le paquet source.
.Sp
\&\fBNote :\fR quand cette valeur est utilis\('ee toute seule et si ce que vous voulez est seulement (re)construire le paquet source \(`a partir d'une arborescence des sources propre, l'utilisation directe de \fBdpkg-source\fR est toujours une meilleure option dans la mesure o\(`u cela ne demande pas l'installation de d\('ependances de construction qui sont sinon n\('ecessaires pour pouvoir appeler la cible \fBclean\fR.
.IP "\fBany\fR" 4
.IX Item "any"
Construit les paquets binaires sp\('ecifiques \(`a l'architecture.
.IP "\fBall\fR" 4
.IX Item "all"
Construit les paquets binaires ind\('ependants de l'architecture.
.IP "\fBbinary\fR" 4
.IX Item "binary"
Construit les paquets binaires particuliers et ind\('ependants de l'architecture. C'est un alias de \fBany,all\fR.
.IP "\fBfull\fR" 4
.IX Item "full"
Construction compl\(`ete. C'est un alias de \fBsource,any,all\fR, et il est identique au cas par d\('efaut o\(`u aucune option de construction n'est indiqu\('ee.
.RE
.RS 4
.RE
.IP "\fB\-g\fR" 4
.IX Item "-g"
\('Equivalent de \fB\-\-build=source,all\fR (depuis dpkg 1.17.11).
.IP "\fB\-G\fR" 4
.IX Item "-G"
\('Equivalent de \fB\-\-build=source,any\fR (depuis dpkg 1.17.11).
.IP "\fB\-b\fR" 4
.IX Item "-b"
\('Equivalent de \fB\-\-build=binary\fR ou \fB\-\-build=any,all\fR.
.IP "\fB\-B\fR" 4
.IX Item "-B"
\('Equivalent de \fB\-\-build=any\fR
.IP "\fB\-A\fR" 4
.IX Item "-A"
\('Equivalent de \fB\-\-build=all\fR.
.IP "\fB\-S\fR" 4
.IX Item "-S"
\('Equivalent \(`a \fB\-\-build=source\fR.
.IP "\fB\-F\fR" 4
.IX Item "-F"
\('Equivalent de \fB\-\-build=full\fR, \fB\-\-build=source,binary\fR ou \fB\-\-build=source,any,all\fR (depuis dpkg 1.15.8).
.IP "\fB\-\-target=\fR\fIcible\fR[,...]" 4
.IX Item "--target=cible[,...]"
.PD 0
.IP "\fB\-\-target\fR \fIcible\fR[,...]" 4
.IX Item "--target cible[,...]"
.IP "\fB\-T\fR, \fB\-\-rules\-target=\fR\fIcible\fR[,...]" 4
.IX Item "-T, --rules-target=cible[,...]"
.PD
Appelle \fBdebian/rules\fR \fIcible\fR une fois par cible sp\('ecifi\('ee, apr\(`es avoir mis en place l'environnement de construction (sauf pour appeler \fBdpkg-source \-\-before\-build\fR), 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 \fB\-\-as\-root\fR est \('egalement utilis\('e, la commande sera ex\('ecut\('ee avec les privil\(`eges du superutilisateur (voir \fB\-\-root\-command\fR). Noter que les cibles connues dont l'ex\('ecution par root est impos\('ee n'ont pas besoin de cette option (c'est\-\(`a\-dire les cibles \fBclean\fR, \fBbinary\fR, \fBbinary-arch\fR et \fBbinary-indep\fR).
.IP "\fB\-\-as\-root\fR" 4
.IX Item "--as-root"
N'est utile qu'avec \fB\-\-target\fR (depuis dpkg 1.15.0). Impose d'ex\('ecuter la cible avec les privil\(`eges du superutilisateur.
.IP "\fB\-si\fR" 4
.IX Item "-si"
.PD 0
.IP "\fB\-sa\fR" 4
.IX Item "-sa"
.IP "\fB\-sd\fR" 4
.IX Item "-sd"
.IP "\fB\-v\fR\fIversion\fR" 4
.IX Item "-vversion"
.IP "\fB\-C\fR\fIdescription-des-changements\fR" 4
.IX Item "-Cdescription-des-changements"
.IP "\fB\-m\fR\fIadresse-du-responsable\fR" 4
.IX Item "-madresse-du-responsable"
.IP "\fB\-e\fR\fIadresse-du-responsable\fR" 4
.IX Item "-eadresse-du-responsable"
.PD
Pass\('e tel quel \(`a \fBdpkg-genchanges\fR. Voir sa page de manuel.
.IP "\fB\-\-build\-by=\fR\fIadresse-du-responsable\fR" 4
.IX Item "--build-by=adresse-du-responsable"
.PD 0
.IP "\fB\-\-source\-by=\fR\fIadresse-du-responsable\fR (depuis dpkg 1.21.10)" 4
.IX Item "--source-by=adresse-du-responsable (depuis dpkg 1.21.10)"
.PD
Pass\('e comme \fB\-m\fR \(`a \fBdpkg-genchanges\fR. Voir sa page de manuel.
.IP "\fB\-\-release\-by=\fR\fIadresse-du-responsable\fR" 4
.IX Item "--release-by=adresse-du-responsable"
.PD 0
.IP "\fB\-\-changed\-by=\fR\fIadresse-du-responsable\fR (depuis dpkg 1.21.10)" 4
.IX Item "--changed-by=adresse-du-responsable (depuis dpkg 1.21.10)"
.PD
Pass\('e comme \fB\-e\fR \(`a \fBdpkg-genchanges\fR. Voir sa page de manuel.
.IP "\fB\-a\fR, \fB\-\-host\-arch\fR \fIarchitecture\fR" 4
.IX Item "-a, --host-arch architecture"
Pr\('ecise 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\('etermin\('ee ; c'est aussi l'architecture par d\('efaut de la machine h\(^ote.
.IP "\fB\-t\fR, \fB\-\-host\-type\fR \fItype\-de\-syst\(`eme\-gnu\fR" 4
.IX Item "-t, --host-type type-de-syst\(`eme-gnu"
Pr\('ecise le type de syst\(`eme \s-1GNU\s0 pour lequel on construit (option longue depuis dpkg 1.17.17). Il peut \(^etre utilis\('e \(`a la place de \fB\-\-host\-arch\fR ou en tant que compl\('ement afin de remplacer le type de syst\(`eme \s-1GNU\s0 par d\('efaut de l'architecture Debian h\(^ote.
.IP "\fB\-\-target\-arch\fR \fIarchitecture\fR" 4
.IX Item "--target-arch architecture"
Pr\('ecise l'architecture Debian pour laquelle les binaires compil\('es vont construire (depuis dpkg 1.17.17). La valeur par d\('efaut est l'architecture de la machine h\(^ote.
.IP "\fB\-\-target\-type\fR \fItype\-de\-syst\(`eme\-gnu\fR" 4
.IX Item "--target-type type-de-syst\(`eme-gnu"
Pr\('ecise le type de syst\(`eme \s-1GNU\s0 pour lequel les binaires compil\('es vont construire (depuis dpkg 1.17.17). Il peut \(^etre utilis\('e \(`a la place de \fB\-\-target\-arch\fR ou en tant que compl\('ement afin de remplacer le type de syst\(`eme \s-1GNU\s0 par d\('efaut de l'architecture Debian cible.
.IP "\fB\-P\fR, \fB\-\-build\-profiles=\fR\fIprofil\fR[\fB,\fR...]" 4
.IX Item "-P, --build-profiles=profil[,...]"
Pr\('ecise le ou les profils que l'on construit, sous forme d'une liste s\('epar\('ee par des virgules (depuis dpkg 1.17.2, option longue depuis dpkg 1.18.8). Le comportement par d\('efaut est de construire pour un profil non sp\('ecifique. Cela les d\('efinit \('egalement (sous la forme d'une liste s\('epar\('ee par des espaces) en tant que variable d'environnement \fB\s-1DEB_BUILD_PROFILES\s0\fR, ce qui permet, par exemple, au fichiers \fBdebian/rules\fR d'utiliser cette information pour des constructions conditionnelles.
.IP "\fB\-j\fR, \fB\-\-jobs\fR[\fIt\(^aches\fR|\fBauto\fR]" 4
.IX Item "-j, --jobs[t\(^aches|auto]"
Sp\('ecifier le nombre de processus simultan\('es qui peuvent \(^etre ex\('ecut\('es (option longue depuis dpkg 1.18.8). Le nombre de t\(^aches correspondant au nombre de processeurs en ligne si \fBauto\fR est indiqu\('ee (depuis dpkg 1.17.10), ou un nombre illimit\('e si \fIjobs\fR n'est pas indiqu\('e. Le comportement par d\('efaut est \fBauto\fR (depuis dpkg 1.18.11) en mode non forc\('e (depuis dpkg 1.21.10) et, \(`a ce titre, il est plus s\(^ur de l'utiliser avec tous les paquets y compris ceux qui ne sont pas s\('ecuris\('es pour une construction parall\(`ele. Fixer le nombre de t\(^aches \(`a \fB1\fR r\('etablira une ex\('ecution s\('erielle.
.Sp
L'option ajoutera \fBparallel=\fR\fIt\(^aches\fR ou \fBparallel\fR \(`a la variable d'environnement \fB\s-1DEB_BUILD_OPTIONS\s0\fR ce qui permet aux fichiers debian/rules de choisir d'utiliser cette information pour leurs propres besoins. La valeur \fIjobs\fR remplacera les options \fBparallel=\fR\fIt\(^aches\fR ou \fBparallel\fR dans la variable d'environnement \fB\s-1DEB_BUILD_OPTIONS\s0\fR. Notez que la valeur \fBauto\fR sera remplac\('ee par le nombre r\('eel de processeurs actuellement actifs, et par cons\('equent ne sera pas transmise \(`a aucun processus enfant. Si le nombre de processeurs en ligne ne peut pas \(^etre d\('eduit, alors le code utilisera par d\('efaut une ex\('ecution s\('erielle (depuis dpkg 1.18.15), m\(^eme si cela ne devrait arriver que sur des syst\(`emes exotiques et non pris en charge.
.IP "\fB\-J\fR, \fB\-\-jobs\-try\fR[=\fIt\(^aches\fR|\fBauto\fR]" 4
.IX Item "-J, --jobs-try[=t\(^aches|auto]"
Cette option (depuis dpkg 1.18.2, option longue depuis dpkg 1.18.8) est \('equivalente \(`a l'option \fB\-j\fR ci-dessus.
.Sp
Dans la mesure o\(`u le comportement de \fB\-j\fR a chang\('e dans dpkg 1.21.10 pour le mode \(Fo opt-in \(Fc, vous pouvez utiliser cette option \(`a la place si vous devez garantir des s\('emantiques dans toutes les versions de dpkg.
.IP "\fB\-\-jobs\-force\fR[=\fIt\(^aches\fR|\fBauto\fR]" 4
.IX Item "--jobs-force[=t\(^aches|auto]"
Cette option (depuis dpkg 1.21.10) est \('equivalente \(`a l'option \fB\-\-jobs\fR sauf qu'elle active le mode parall\(`ele forc\('e en ajoutant l'option \fBmake\fR \fB\-j\fR avec le nombre calcul\('e de t\(^aches parall\(`eles \(`a la variable d'environnement \fB\s-1MAKEFLAGS\s0\fR.
.Sp
Cela devrait faire que les invocations ult\('erieures de make h\('eritent de cette option, for\(,cant donc une configuration parall\(`ele de l'empaquetage (et potentiellement le syst\(`eme de construction amont s'il utilise \fBmake\fR\|(1)), sans tenir compte de la prise en compte des constructions parall\(`eles, ce qui pourrait provoquer des \('echecs de constructions.
.Sp
Note : tout Makefile qui n'est pas s\('ecuris\('e pour une utilisation parall\(`ele devrait \(^etre consid\('er\('e comme bogu\('e. Ils devraient \(^etre soit rendus s\('ecuris\('es pour une utilisation parall\(`ele ou marqu\('e comme non s\(^urs avec \fBmake\fR\|(1) \fB.NOTPARALLEL\fR cible.
.IP "\fB\-D\fR, \fB\-\-check\-builddeps\fR" 4
.IX Item "-D, --check-builddeps"
V\('erification des d\('ependances de constructions et des conflits ; se termine en cas de probl\(`emes (option longue depuis dpkg 1.18.8). C'est le comportement par d\('efaut.
.IP "\fB\-d\fR, \fB\-\-no\-check\-builddeps\fR" 4
.IX Item "-d, --no-check-builddeps"
Pas de v\('erification des d\('ependances de constructions et des conflits (option longue depuis dpkg 1.18.8).
.IP "\fB\-\-ignore\-builtin\-builddeps\fR" 4
.IX Item "--ignore-builtin-builddeps"
Pas de v\('erification des d\('ependances de constructions internes et des conflits (depuis dpkg 1.18.2). Il s'agit des d\('ependances de construction implicites sp\('ecifiques \(`a la distribution habituellement requises dans un environnement de construction, c'est l'ensemble de paquets appel\('e Build-Essential.
.IP "\fB\-\-rules\-requires\-root\fR" 4
.IX Item "--rules-requires-root"
Pas de prise en compte du champ \fBRules-Requires-Root\fR, retour \(`a l'ancienne valeur par d\('efaut (depuis dpkg 1.19.1).
.IP "\fB\-nc\fR, \fB\-\-no\-pre\-clean\fR" 4
.IX Item "-nc, --no-pre-clean"
Pas de nettoyage de l'arborescence des sources avant la construction (option longue depuis dpkg 1.18.8). Implique \fB\-b\fR si aucune des options \fB\-F\fR, \fB\-g\fR, \fB\-G\fR, \fB\-B\fR, \fB\-A\fR ou \fB\-S\fR n'est utilis\('ee). Implique \fB\-d\fR avec \fB\-S\fR (depuis dpkg 1.18.0).
.IP "\fB\-\-pre\-clean\fR" 4
.IX Item "--pre-clean"
Nettoyage de l'arborescence des sources avant la construction (depuis dpkg 1.18.8). C'est le comportement par d\('efaut.
.IP "\fB\-tc\fR, \fB\-\-post\-clean\fR" 4
.IX Item "-tc, --post-clean"
Nettoyage de l'arborescence des sources (en utilisant \fIcommande\-pour\-obtenir\-privil\(`eges\-de\-root\fR \fBdebian/rules clean\fR) apr\(`es la construction du paquet (option longue depuis dpkg 1.18.8).
.IP "\fB\-\-no\-post\-clean\fR" 4
.IX Item "--no-post-clean"
Pas de nettoyage de l'arborescence des sources apr\(`es la construction du paquet (depuis dpkg 1.19.1). C'est le comportement par d\('efaut.
.IP "\fB\-\-sanitize\-env\fR" 4
.IX Item "--sanitize-env"
Nettoyage de l'environnement de construction (depuis dpkg 1.20.0). Cela remet \(`a z\('ero ou supprime les variables d'environnement, umask et tous les autres attributs de processus qui pourrait autrement affecter d\('efavorablement la construction des paquets. Parce que le point d'entr\('ee officiel pour la construction des paquets est \fBdebian/rules\fR, les paquets ne peuvent pas d\('ependre du fait que ces r\('eglages sont pr\('esents et donc devraient fonctionner m\(^eme quand ils ne le sont pas. Ce qu'il faut nettoyer est propre au fabricant.
.IP "\fB\-r\fR, \fB\-\-root\-command=\fR\fIcommande\-pour\-obtenir\-privil\(`eges\-de\-root\fR" 4
.IX Item "-r, --root-command=commande-pour-obtenir-privil\(`eges-de-root"
Quand \fBdpkg-buildpackage\fR doit ex\('ecuter une partie du processus de construction en tant que root, il pr\('efixe la commande ex\('ecut\('ee par \fIcommande\-pour\-obtenir\-privil\(`eges\-de\-root\fR, si une a \('et\('e sp\('ecifi\('ee (option longue depuis dpkg 1.18.8). Si ce n'est pas le cas alors \fBfakeroot\fR est utilis\('e par d\('efaut. \fIcommande\-pour\-obtenir\-privil\(`eges\-de\-root\fR doit d\('ebuter par le nom d'un programme accessible depuis \fB\s-1PATH\s0\fR et avoir comme arguments le nom de la commande r\('eelle avec les arguments qu'elle doit prendre. \fIcommande\-pour\-obtenir\-privil\(`eges\-de\-root\fR peut recevoir des param\(`etres (ils doivent \(^etre s\('epar\('es par des espaces) mais aucun m\('etacaract\(`ere de l'interpr\('eteur de commandes. Classiquement \fIcommande\-pour\-obtenir\-privil\(`eges\-de\-root\fR devrait \(^etre \fBfakeroot\fR, \fBsudo\fR, \fBsuper\fR ou \fBreally\fR. \fBsu\fR ne va pas, puisque ce programme peut uniquement utiliser l'interpr\('eteur de commandes de l'utilisateur avec l'option \fB\-c\fR au lieu de passer directement les arguments \(`a la commande qui doit \(^etre ex\('ecut\('ee.
.IP "\fB\-R\fR, \fB\-\-rules\-file=\fR\fIfichier-rules\fR" 4
.IX Item "-R, --rules-file=fichier-rules"
Construire un paquet Debian implique g\('en\('eralement l'invocation de \fBdebian/rules\fR comme une commande avec de nombreux param\(`etres standard (depuis dpkg 1.14.17, option longue depuis dpkg 1.18.8). Avec cette option, il est possible d'utiliser un autre programme \(`a utiliser pour la construction de paquet (ainsi que ses param\(`etres s\('epar\('es par des espaces). Une autre utilisation possible est d'ex\('ecuter le fichier rules standard avec un autre programme make (par exemple en utilisant \fB/usr/local/bin/make \-f debian/rules\fR comme \fIfichier-rules\fR).
.IP "\fB\-\-check\-command=\fR\fIcommande\-contr\(^oleur\fR" 4
.IX Item "--check-command=commande-contr\(^oleur"
Commande utilis\('ee pour v\('erifier le fichier \fB.changes\fR lui\-m\(^eme et tout objet construit r\('ef\('erenc\('e dans le fichier (depuis dpkg 1.17.6). La commande peut recevoir comme argument le nom de chemin de \fB.changes\fR. Cette commande est en g\('en\('eral \fBlintian\fR.
.IP "\fB\-\-check\-option=\fR\fIopt\fR" 4
.IX Item "--check-option=opt"
Passer l'option \fIopt\fR \(`a \fIcommande\-contr\(^oleur\fR indiqu\('ee par \fB\s-1DEB_CHECK_COMMAND\s0\fR ou \fB\-\-check\-command\fR (depuis dpkg 1.17.6). Peut \(^etre utilis\('e plusieurs fois.
.IP "\fB\-\-hook\-\fR\fInom\-de\-point\-d'entr\('ee\fR\fB=\fR\fIcommande\-de\-point\-d'entr\('ee\fR" 4
.IX Item "--hook-nom-de-point-d'entr\('ee=commande-de-point-d'entr\('ee"
D\('efinir le code sp\('ecifi\('e de l'interpr\('eteur de commandes \fIcommande\-de\-point\-d'entr\('ee\fR comme point d'entr\('ee \fInom\-de\-point\-d'entr\('e\fR qui sera ex\('ecut\('e aux moments sp\('ecifi\('es par les \('etapes d'ex\('ecution (depuis dpkg 1.17.6). Les points d'entr\('ee seront toujours ex\('ecut\('es m\(^eme si l'action suivante n'est pas effectu\('ee (sauf pour le point d'entr\('ee \fBbinary\fR). Tous les points d'entr\('ee seront ex\('ecut\('es dans le r\('epertoire source d\('epaquet\('e.
.Sp
\&\fBNote\fR : les points d'entr\('ee sont susceptibles d'affecter le processus de construction et provoquer des \('echecs de construction si leurs commandes \('echouent, donc attention aux cons\('equences inattendues.
.Sp
Les \fInom\-de\-point\-d'entr\('ee\fR actuellement pris en charge sont :
.Sp
\&\fBinit preclean source build binary buildinfo changes postclean check sign done\fR
.Sp
La \fIcommande\-point\-d'entr\('ee\fR g\(`ere les cha\(^ines de formatage de substitution suivantes, qui lui sont appliqu\('ees avant ex\('ecution :
.RS 4
.IP "\fB%%\fR" 4
.IX Item "%%"
Un caract\(`ere % seul.
.IP "\fB\f(CB%a\fB\fR" 4
.IX Item "%a"
Une valeur bool\('eenne (0 ou 1) qui indique si l'action suivante est effectu\('ee.
.IP "\fB\f(CB%p\fB\fR" 4
.IX Item "%p"
Nom du paquet source.
.IP "\fB\f(CB%v\fB\fR" 4
.IX Item "%v"
La version du paquet source.
.IP "\fB\f(CB%s\fB\fR" 4
.IX Item "%s"
La version du paquet source (sans l'\(Fo epoch \(Fc).
.IP "\fB\f(CB%u\fB\fR" 4
.IX Item "%u"
La version amont.
.RE
.RS 4
.RE
.IP "\fB\-\-buildinfo\-file=\fR\fIfichier\fR" 4
.IX Item "--buildinfo-file=fichier"
D\('efinir le \fIfichier\fR pour le fichier \fB.buildinfo\fR g\('en\('er\('e (depuis dpkg 1.21.0).
.IP "\fB\-\-buildinfo\-option=\fR\fIopt\fR" 4
.IX Item "--buildinfo-option=opt"
Passer l'option \fIopt\fR \(`a \fBdpkg-genbuildinfo\fR (depuis dpkg 1.18.11). Peut \(^etre utilis\('e plusieurs fois.
.IP "\fB\-\-sign\-backend=\fR\fIdorsal-de-signature\fR" 4
.IX Item "--sign-backend=dorsal-de-signature"
Pr\('eciser une interface de dorsal OpenPGP \(`a utiliser lors de l'invocation de la commande \fIsign-command\fR (depuis dpkg 1.21.10).
.Sp
C'est \fBauto\fR par d\('efaut, o\(`u le meilleur dorsal pr\('esent disponible sera utilis\('e. Les dorsaux sp\('ecifiques \(`a OpenPGP pris en charge sont par ordre de pr\('ef\('erence :
.RS 4
.IP "\fBsop\fR (toute impl\('ementation conforme \(`a Stateless OpenPGP)" 2
.IX Item "sop (toute impl\('ementation conforme \(`a Stateless OpenPGP)"
.PD 0
.IP "\fBsq\fR (de Sequoia-PGP)" 2
.IX Item "sq (de Sequoia-PGP)"
.IP "\fBgpg\fR (de GnuPG)" 2
.IX Item "gpg (de GnuPG)"
.RE
.RS 4
.RE
.IP "\fB\-p\fR, \fB\-\-sign\-command=\fR\fIcommande-de-signature\fR" 4
.IX Item "-p, --sign-command=commande-de-signature"
.PD
Quand \fBdpkg-buildpackage\fR doit ex\('ecuter une commande de dorsal OpenPGP pour signer un fichier source de contr\(^ole (\fB.dsc\fR) ou un fichier \fB.changes\fR, il ex\('ecute \fIcommande-de-signature\fR (recherch\('ee dans \fB\s-1PATH\s0\fR si n\('ecessaire) au lieu de la commande de dorsal par d\('efaut ou d\('etect\('ee automatiquement (option longue depuis dpkg 1.18.1). \fICommande-de-signature\fR re\(,coit tous les param\(`etres d\('efinis par le \fB\-\-sign\-backend\fR. \fIcommande-de-signature\fR ne devra pas contenir d'espace ni aucun m\('etacaract\(`ere de l'interpr\('eteur de commandes.
.IP "\fB\-k\fR, \fB\-\-sign\-keyid=\fR\fIidentifiant\-cl\('e\fR" 4
.IX Item "-k, --sign-keyid=identifiant-cl\('e"
.PD 0
.IP "\fB\-\-sign\-key=\fR\fIidentifiant\-cl\('e\fR" 4
.IX Item "--sign-key=identifiant-cl\('e"
.PD
Pr\('eciser un identifiant de cl\('e OpenPGP (soit une empreinte soit un identifiant d'utilisateur) pour la cl\('e secr\(`ete \(`a utiliser lors de la signature des paquets (\fB\-\-sign\-key\fR depuis dpkg 1.18.8, \fB\-\-sign\-keyid\fR depuis dpkg 1.21.10).
.IP "\fB\-\-sign\-key=\fR\fIfichier\-de\-cl\('e\fR" 4
.IX Item "--sign-key=fichier-de-cl\('e"
Pr\('eciser un \fIfichier\-de\-cl\('e\fR OpenPGP contenant la cl\('e secr\(`ete \(`a utiliser pour la signature des paquets (depuis dpkg 1.21.10).
.Sp
Note : pour des raisons de s\('ecurit\('e, il est pr\('ef\('erable que le \fIfichier\-de\-cl\('e\fR soit verrouill\('e par un mot de passe.
.IP "\fB\-us\fR, \fB\-\-unsigned\-source\fR" 4
.IX Item "-us, --unsigned-source"
Ne pas signer le paquet source (option longue depuis dpkg 1.18.8).
.IP "\fB\-ui\fR, \fB\-\-unsigned\-buildinfo\fR" 4
.IX Item "-ui, --unsigned-buildinfo"
Ne pas signer le fichier \fB.buildinfo\fR (depuis dpkg 1.18.19).
.IP "\fB\-uc\fR, \fB\-\-unsigned\-changes\fR" 4
.IX Item "-uc, --unsigned-changes"
Ne signer ni le fichier \fB.buildinfo\fR, ni le fichier \fB.changes\fR (option longue depuis dpkg 1.18.8).
.IP "\fB\-\-no\-sign\fR" 4
.IX Item "--no-sign"
Aucune signature de fichier, y compris du paquet source, du fichier \fB.buildinfo\fR et du fichier \fB.changes\fR (depuis dpkg 1.18.20).
.IP "\fB\-\-force\-sign\fR" 4
.IX Item "--force-sign"
Forcer la signature des fichiers produits (depuis dpkg 1.17.0) ind\('ependamment de \fB\-us\fR, \fB\-\-unsigned\-source\fR, \fB\-ui\fR, \fB\-\-unsigned\-buildinfo\fR, \fB\-uc\fR, \fB\-\-unsigned\-changes\fR ou d'autres heuristiques internes.
.IP "\fB\-sn\fR" 4
.IX Item "-sn"
.PD 0
.IP "\fB\-ss\fR" 4
.IX Item "-ss"
.IP "\fB\-sA\fR" 4
.IX Item "-sA"
.IP "\fB\-sk\fR" 4
.IX Item "-sk"
.IP "\fB\-su\fR" 4
.IX Item "-su"
.IP "\fB\-sr\fR" 4
.IX Item "-sr"
.IP "\fB\-sK\fR" 4
.IX Item "-sK"
.IP "\fB\-sU\fR" 4
.IX Item "-sU"
.IP "\fB\-sR\fR" 4
.IX Item "-sR"
.IP "\fB\-i\fR, \fB\-\-diff\-ignore\fR[=\fIexpression-rationnelle\fR]" 4
.IX Item "-i, --diff-ignore[=expression-rationnelle]"
.IP "\fB\-I\fR, \fB\-\-tar\-ignore\fR[=\fImotif\fR]" 4
.IX Item "-I, --tar-ignore[=motif]"
.IP "\fB\-z\fR, \fB\-\-compression\-level\fR=\fIniveau\fR" 4
.IX Item "-z, --compression-level=niveau"
.IP "\fB\-Z\fR, \fB\-\-compression\fR=\fIcompression\fR" 4
.IX Item "-Z, --compression=compression"
.PD
Cha\(^ine pass\('ee telle quelle \(`a \fBdpkg-source\fR. Voir la page de manuel correspondante.
.IP "\fB\-\-source\-option=\fR\fIopt\fR" 4
.IX Item "--source-option=opt"
Passer l'option \fIopt\fR \(`a \fBdpkg-source\fR (depuis dpkg 1.15.6). Peut \(^etre utilis\('e plusieurs fois.
.IP "\fB\-\-changes\-file=\fR\fIfichier\fR" 4
.IX Item "--changes-file=fichier"
D\('efinir le \fIfichier\fR pour le fichier \fB.changes\fR g\('en\('er\('e (depuis dpkg 1.21.0).
.IP "\fB\-\-changes\-option=\fR\fIopt\fR" 4
.IX Item "--changes-option=opt"
Passer l'option \fIopt\fR \(`a \fBdpkg-genchanges\fR (depuis dpkg 1.15.6). Peut \(^etre utilis\('e plusieurs fois.
.IP "\fB\-\-admindir\fR=\fIr\('epertoire\fR" 4
.IX Item "--admindir=r\('epertoire"
.PD 0
.IP "\fB\-\-admindir\fR \fIr\('ep\fR" 4
.IX Item "--admindir r\('ep"
.PD
Changer l'endroit o\(`u se trouve la base de donn\('ees de \fBdpkg\fR (depuis dpkg 1.14.0). Par d\('efaut, c'est \fI/var/lib/dpkg\fR.
.IP "\fB\-?\fR, \fB\-\-help\fR" 4
.IX Item "-?, --help"
Afficher un message d'aide puis quitter.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
Afficher le num\('ero de version puis quitter.
.SH "ENVIRONNEMENT"
.IX Header "ENVIRONNEMENT"
.SS "Environnement externe"
.IX Subsection "Environnement externe"
.IP "\fB\s-1DEB_CHECK_COMMAND\s0\fR" 4
.IX Item "DEB_CHECK_COMMAND"
Si cette option est utilis\('ee, elle le sera comme commande pour contr\(^oler le fichier \fB.changes\fR (depuis dpkg 1.17.6). Remplac\('ee par l'option \fB\-\-check\-command\fR.
.IP "\fB\s-1DEB_SIGN_KEYID\s0\fR" 4
.IX Item "DEB_SIGN_KEYID"
Si cette option est utilis\('ee, elle le sera pour la signature des fichiers \fB.changes\fR, \fB.buildinfo\fR et \fB.dsc\fR (depuis dpkg 1.17.2). Remplac\('ee par l'option \fB\-\-sign\-key\fR.
.IP "\fB\s-1DEB_SIGN_KEYFILE\s0\fR" 4
.IX Item "DEB_SIGN_KEYFILE"
Si cette option est utilis\('ee, elle le sera pour la signature des fichiers \fB.changes\fR, \fB.buildinfo\fR et \fB.dsc\fR (depuis dpkg 1.21.10). Remplac\('ee par l'option \fB\-\-sign\-keyfile\fR.
.IP "\fB\s-1DEB_BUILD_OPTIONS\s0\fR" 4
.IX Item "DEB_BUILD_OPTIONS"
Si cette option est utilis\('ee, elle contiendra une liste s\('epar\('ee par des espaces d'options qui pourraient affecter le processus de construction dans \fIdebian/rules\fR et le comportement de certaines commandes de dpkg.
.Sp
La variable \fB\s-1DEB_CHECK_COMMAND\s0\fR sera ignor\('ee avec \fBnocheck\fR. Avec \fBparallel=\fR\fIN\fR les t\(^aches parall\(`eles seront fix\('ees \(`a \fIN\fR, remplac\('ee par l'option \fB\-\-jobs\-try\fR.
.IP "\fB\s-1DEB_BUILD_PROFILES\s0\fR" 4
.IX Item "DEB_BUILD_PROFILES"
Si cette option est utilis\('ee, elle sera utilis\('ee comme profil(s) de construction actif(s) pour le paquet \(`a construire (depuis dpkg 1.17.2). C'est une liste s\('epar\('ee par des espaces de noms de profil. Cette option est outrepass\('ee par l'option \fB\-P\fR.
.IP "\fB\s-1DPKG_COLORS\s0\fR" 4
.IX Item "DPKG_COLORS"
D\('efinit le mode de couleur (depuis dpkg 1.18.5). Les valeurs actuellement accept\('ees sont \fBauto\fR (par d\('efaut), \fBalways\fR et \fBnever\fR.
.IP "\fB\s-1DPKG_NLS\s0\fR" 4
.IX Item "DPKG_NLS"
Si cette variable est d\('efinie, elle sera utilis\('ee pour d\('ecider l'activation de la prise en charge des langues (\s-1NLS\s0 \(en Native Language Support), connu aussi comme la gestion de l'internationalisation (ou i18n) (depuis dpkg 1.19.0). Les valeurs permises sont : \fB0\fR et \fB1\fR (par d\('efaut).
.SS "Environnement interne"
.IX Subsection "Environnement interne"
M\(^eme si \fBdpkg-buildpackage\fR exporte certaines variables, \fBdebian/rules\fR ne doit pas d\('ependre de leur pr\('esence, mais doit pr\('ef\('erablement utiliser l'interface correspondante pour retrouver les valeurs n\('ecessaires, parce que ce fichier est le point d'entr\('ee principal pour la construction des paquets et son ex\('ecution autonome devrait \(^etre prise en charge.
.IP "\fBDEB_BUILD_*\fR" 4
.IX Item "DEB_BUILD_*"
.PD 0
.IP "\fBDEB_HOST_*\fR" 4
.IX Item "DEB_HOST_*"
.IP "\fBDEB_TARGET_*\fR" 4
.IX Item "DEB_TARGET_*"
.PD
\&\fBdpkg-architecture\fR est lanc\('e avec les param\(`etres de \fB\-a\fR et \fB\-t\fR. Toute variable retourn\('ee par l'option \fB\-s\fR est int\('egr\('ee dans l'environnement de construction.
.IP "\fB\s-1DEB_RULES_REQUIRES_ROOT\s0\fR" 4
.IX Item "DEB_RULES_REQUIRES_ROOT"
Cette variable est fix\('ee \(`a la valeur obtenue du champ \fBRules-Requires-Root\fR ou de la ligne de commande. Lorsqu'elle est configur\('ee, ce sera une valeur valable pour le champ \fBRules-Requires-Root\fR. Elle est utilis\('ee pour indiquer \(`a \fBdebian/rules\fR si la sp\('ecification \fBrootless\-builds.txt\fR est prise en charge.
.IP "\fB\s-1DEB_GAIN_ROOT_CMD\s0\fR" 4
.IX Item "DEB_GAIN_ROOT_CMD"
Cette valeur est fix\('ee \(`a \fIcommande\-pour\-obtenir\-privil\(`eges\-de\-root\fR si le champ \fBRules-Requires-Root\fR est fix\('e \(`a une valeur diff\('erente de \fBno\fR ou \fBbinary-targets\fR.
.IP "\fB\s-1SOURCE_DATE_EPOCH\s0\fR" 4
.IX Item "SOURCE_DATE_EPOCH"
Cette valeur est fix\('ee \(`a l'horodatage d'Unix depuis \(Fo l'epoch \(Fc de la derni\(`ere entr\('ee de \fIdebian/changelog\fR, si elle n'a pas d\('ej\(`a \('et\('e d\('efinie.
.SH "FICHIERS"
.IX Header "FICHIERS"
.IP "\fI/etc/dpkg/buildpackage.conf\fR" 4
.IX Item "/etc/dpkg/buildpackage.conf"
Fichier de configuration pour l'ensemble du syst\(`eme
.IP "\fI\f(CI$XDG_CONFIG_HOME\fI/dpkg/buildpackage.conf\fR ou" 4
.IX Item "$XDG_CONFIG_HOME/dpkg/buildpackage.conf ou"
.PD 0
.IP "\fI\f(CI$HOME\fI/.config/dpkg/buildpackage.conf\fR" 4
.IX Item "$HOME/.config/dpkg/buildpackage.conf"
.PD
Fichier de configuration propre \(`a l'utilisateur
.SH "NOTES"
.IX Header "NOTES"
.SS "Les drapeaux de compilation ne sont plus export\('es."
.IX Subsection "Les drapeaux de compilation ne sont plus export\('es."
Entre les versions 1.14.17 et 1.16.1, \fBdpkg-buildpackage\fR exportait les drapeaux de compilation (\fB\s-1CFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR, \fB\s-1FFLAGS\s0\fR, \fB\s-1CPPFLAGS\s0\fR et \fB\s-1LDFLAGS\s0\fR) avec les valeurs que renvoyait \fBdpkg-buildflags\fR. Cela n'est plus le cas.
.SS "Cibles construites par d\('efaut"
.IX Subsection "Cibles construites par d\('efaut"
\&\fBdpkg-buildpackage\fR utilise les cibles \fBbuild-arch\fR et \fBbuild-indep\fR depuis dpkg 1.16.2. Ces cibles sont donc obligatoires. Cependant, pour \('eviter de casser les paquets existants et faciliter la transition, si le paquet source ne construit pas \(`a la fois les paquets binaires ind\('ependants et d\('ependants de l'architecture (depuis dpkg 1.18.8), la cible \fBbuild\fR sera utilis\('ee par d\('efaut si \fBmake \-f debian/rules \-qn\fR \fIbuild-target\fR renvoie \fB2\fR comme code de retour.
.SH "BOGUES"
.IX Header "BOGUES"
On devrait pouvoir mettre des espaces et des m\('etacaract\(`eres du shell et les arguments initiaux de \fIcommande\-pour\-obtenir\-privil\(`eges\-de\-root\fR et \fIcommande-de-signature\fR.
.SH "VOIR AUSSI"
.IX Header "VOIR AUSSI"
\&\fI/usr/share/doc/dpkg/spec/rootless\-builds.txt\fR, \fBdpkg-source\fR(1), \fBdpkg-architecture\fR(1), \fBdpkg-buildflags\fR(1), \fBdpkg-genbuildinfo\fR(1), \fBdpkg-genchanges\fR(1), \fBfakeroot\fR(1), \fBlintian\fR(1), <https://datatracker.ietf.org/doc/draft\-dkg\-openpgp\-stateless\-cli/>, \fBsq\fR(1), \fBgpg\fR(1).
.SH "TRADUCTION"
.IX Header "TRADUCTION"
Ariel \s-1VARDI\s0 <ariel.vardi@freesbee.fr>, 2002.
Philippe Batailler, 2006.
Nicolas Fran\(,cois, 2006.
Veuillez signaler toute erreur \(`a <debian\-l10n\-french@lists.debian.org>.