.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (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 .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . 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 2024-01-19 1.22.3 "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." It runs the \fBpreinit\fR hook before reading any source file. It prepares the build environment by setting various environment variables (see \fBENVIRONMENT\fR), runs the \fBinit\fR hook, and calls \fBdpkg-source \-\-before\-build\fR (unless \fB\-T\fR or \fB\-\-target\fR has been used). .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." It runs the \fBchanges\fR hook and calls \fBdpkg-genchanges\fR to generate a \fB.changes\fR file. The name of the \fB.changes\fR file will depend on the type of build and will be as specific as necessary but not more; the name will be: .RS 4 .IP \fIsource-name\fR\fB_\fR\fIbinary-version\fR\fB_\fR\fIarch\fR\fB.changes\fR 4 .IX Item "source-name_binary-version_arch.changes" for a build that includes \fBany\fR .IP \fIsource-name\fR\fB_\fR\fIbinary-version\fR\fB_\fR\fBall.changes\fR 4 .IX Item "source-name_binary-version_all.changes" otherwise for a build that includes \fBall\fR .IP \fIsource-name\fR\fB_\fR\fIsource-version\fR\fB_\fR\fBsource.changes\fR. 4 .IX Item "source-name_source-version_source.changes." otherwise for a build that includes \fBsource\fR .RE .RS 4 .Sp Many \fBdpkg-buildpackage\fR options are forwarded to \fBdpkg-genchanges\fR. .RE .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 \fBDEB_CHECK_COMMAND\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 UNRELEASED, 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: When using this value standalone and if what you want is simply to (re\-)build the source package from a clean source tree, using \fBdpkg-source\fR directly is always a better option as it does not require any build dependencies to be installed which are otherwise needed to be able to call the \fBclean\fR target. .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 GNU 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 GNU 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 GNU 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 GNU 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 \fBDEB_BUILD_PROFILES\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 \fBDEB_BUILD_OPTIONS\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 \fBDEB_BUILD_OPTIONS\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 \fBMAKEFLAGS\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 \&\fBNote\fR: Any Makefile that is not parallel-safe should be considered to be buggy. These should either be made parallel-safe, or marked as not being safe with the \fBmake\fR\|(1) \fB.NOTPARALLEL\fR target. .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 \fBPATH\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 \fBDEB_CHECK_COMMAND\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 Some hooks can receive addition information through environment variables (since dpkg 1.22.0). All hooks get the hook name in the \fBDPKG_BUILDPACKAGE_HOOK_NAME\fR environment variable (since dpkg 1.22.0). .Sp \&\fBNote\fR: Hooks can affect the build process, and cause build failures if their commands fail, so watch out for unintended consequences. .Sp Les \fInom\-de\-point\-d'entr\('ee\fR actuellement pris en charge sont\ : .RS 4 .IP \fBpreinit\fR 4 .IX Item "preinit" .PD 0 .IP \fBinit\fR 4 .IX Item "init" .IP \fBpreclean\fR 4 .IX Item "preclean" .IP \fBsource\fR 4 .IX Item "source" .PD Gets \fBDPKG_BUILDPACKAGE_HOOK_SOURCE_OPTIONS\fR with the space-separated lists of options that will passed to the \fBdpkg-source\fR call. .IP \fBbuild\fR 4 .IX Item "build" Gets \fBDPKG_BUILDPACKAGE_HOOK_BUILD_TARGET\fR with the name of the \fBdebian/rules\fR build target called, but only if called. .IP \fBbinary\fR 4 .IX Item "binary" Gets \fBDPKG_BUILDPACKAGE_HOOK_BINARY_TARGET\fR with the name of the \fBdebian/rules\fR binary target called, but only if called. .IP \fBbuildinfo\fR 4 .IX Item "buildinfo" Gets \fBDPKG_BUILDPACKAGE_HOOK_BUILDINFO_OPTIONS\fR with the space-separated lists of options that will passed to the \fBdpkg-genbuildinfo\fR call. .IP \fBchanges\fR 4 .IX Item "changes" Gets \fBDPKG_BUILDPACKAGE_HOOK_CHANGES_OPTIONS\fR with the space-separated lists of options that will passed to the \fBdpkg-genchanges\fR call. .IP \fBpostclean\fR 4 .IX Item "postclean" .PD 0 .IP \fBcheck\fR 4 .IX Item "check" .PD Gets \fBDPKG_BUILDPACKAGE_HOOK_CHECK_OPTIONS\fR with the space-separated lists of options that will passed to the check command call. .IP \fBsign\fR 4 .IX Item "sign" .PD 0 .IP \fBdone\fR 4 .IX Item "done" .RE .RS 4 .PD .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\ : .IP \fB%%\fR 4 .IX Item "%%" Un caract\(`ere % seul. .ie n .IP \fR\fB%a\fR\fB\fR 4 .el .IP \fR\f(CB%a\fR\fB\fR 4 .IX Item "%a" Une valeur bool\('eenne (0 ou 1) qui indique si l'action suivante est effectu\('ee. .ie n .IP \fR\fB%p\fR\fB\fR 4 .el .IP \fR\f(CB%p\fR\fB\fR 4 .IX Item "%p" Nom du paquet source. .ie n .IP \fR\fB%v\fR\fB\fR 4 .el .IP \fR\f(CB%v\fR\fB\fR 4 .IX Item "%v" La version du paquet source. .ie n .IP \fR\fB%s\fR\fB\fR 4 .el .IP \fR\f(CB%s\fR\fB\fR 4 .IX Item "%s" La version du paquet source (sans l'\(Fo\ epoch\ \(Fc). .ie n .IP \fR\fB%u\fR\fB\fR 4 .el .IP \fR\f(CB%u\fR\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 4 .IX Item "sop" (any conforming Stateless OpenPGP implementation) .IP \fBsq\fR 4 .IX Item "sq" (from Sequoia-PGP) .IP \fBgpg\fR 4 .IX Item "gpg" (from 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" When \fBdpkg-buildpackage\fR needs to execute an OpenPGP backend command to sign a source control (\fB.dsc\fR) file, a \fB.buildinfo\fR file or a \fB.changes\fR file it will run \fIsign-command\fR (searching the \fBPATH\fR if necessary) instead of the default or auto-detected backend command (long option since dpkg 1.18.8). \fIsign-command\fR will get all the backend specific arguments according to the \fB\-\-sign\-backend\fR selected. \fIsign-command\fR should not contain spaces or any other shell metacharacters. .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 \&\fBNote\fR: For security reasons the \fIkey-file\fR is best kept locked with a password. .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 \fBDEB_CHECK_COMMAND\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 \fBDEB_SIGN_KEYID\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 \fBDEB_SIGN_KEYFILE\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 \fBDEB_BUILD_OPTIONS\fR 4 .IX Item "DEB_BUILD_OPTIONS" If set, it will contain a space-separated list of options that affect the behavior of some dpkg tools involved in package building, and might affect the package build process if the code in \fIdebian/rules\fR honors them. .Sp The following are the options known and supported by dpkg tools, other options honored by \fIdebian/rules\fR might be defined by distribution specific policies. .RS 4 .IP \fBparallel=\fR\fIN\fR 4 .IX Item "parallel=N" The \fIdebian/rules\fR in the packaging might use this option to set up the build process to use \fIN\fR parallel jobs. It is overridden by the \fB\-\-jobs\fR and \fB\-\-jobs\-force\fR options. .IP \fBnocheck\fR 4 .IX Item "nocheck" \&\fBdpkg-buildpackage\fR will ignore the \fBDEB_CHECK_COMMAND\fR variable. The \fIdebian/rules\fR in the packaging is not expected to run test suites during the build. .IP \fBnoopt\fR 4 .IX Item "noopt" If \fIdebian/rules\fR calls \fBdpkg-buildflags\fR to set up the build flags, those will be set to not enable any optimizations. .IP \fBnostrip\fR 4 .IX Item "nostrip" The \fIdebian/rules\fR in the packaging should ensure that objects do not get the debugging information stripped. If \fIdebian/rules\fR includes the \fBmk/buildtools.mk\fR make fragment the \fBSTRIP\fR make variable will respect this option. .IP \fBterse\fR 4 .IX Item "terse" \&\fBdpkg-buildpackage\fR will append the \fB\-\-no\-print\-directory\fR \fBmake\fR\|(1) flag to the \fBMAKEFLAGS\fR environment variable. The \fIdebian/rules\fR in the packaging should reduce verbosity, while not being completely quiet. .RE .RS 4 .RE .IP \fBDEB_BUILD_PROFILES\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 \fBDPKG_COLORS\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 \fBDPKG_NLS\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 (NLS \(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 \fBDEB_RULES_REQUIRES_ROOT\fR 4 .IX Item "DEB_RULES_REQUIRES_ROOT" This variable is set to the value obtained from the \fBRules-Requires-Root\fR field, the dpkg-build-api level or from the command-line. When set, it will be a valid value for the \fBRules-Requires-Root\fR field. It is used to notify \fBdebian/rules\fR whether the \fBrootless\-builds.txt\fR specification is supported. .IP \fBDEB_GAIN_ROOT_CMD\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 \fBSOURCE_DATE_EPOCH\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 .ie n .IP "\fR\fI$XDG_CONFIG_HOME\fR\fI/dpkg/buildpackage.conf\fR ou" 4 .el .IP "\fR\f(CI$XDG_CONFIG_HOME\fR\fI/dpkg/buildpackage.conf\fR ou" 4 .IX Item "$XDG_CONFIG_HOME/dpkg/buildpackage.conf ou" .PD 0 .ie n .IP \fR\fI$HOME\fR\fI/.config/dpkg/buildpackage.conf\fR 4 .el .IP \fR\f(CI$HOME\fR\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 (\fBCFLAGS\fR, \fBCXXFLAGS\fR, \fBFFLAGS\fR, \fBCPPFLAGS\fR et \fBLDFLAGS\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 SECURITY .IX Header "SECURITY" Building binary or source packages should only be performed over trusted source data. .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), , \fBsq\fR\|(1), \fBgpg\fR\|(1). .SH TRADUCTION .IX Header "TRADUCTION" Ariel VARDI , 2002. Philippe Batailler, 2006. Nicolas Fran\(,cois, 2006. Veuillez signaler toute erreur \(`a .