.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" 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 "2022-09-01" "1.20.12" "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." It runs the \fBsign\fR hook and calls \fBgpg\fR (as long as it is not an \&\s-1UNRELEASED\s0 build, or \fB\-\-no\-sign\fR is specified) to sign the \fB.dsc\fR file (if any, unless \fB\-us\fR or \fB\-\-unsigned\-source\fR is specified), the \fB.buildinfo\fR file (unless \fB\-ui\fR, \fB\-\-unsigned\-buildinfo\fR, \fB\-uc\fR or \&\fB\-\-unsigned\-changes\fR is specified) and the \fB.changes\fR file (unless \fB\-uc\fR or \fB\-\-unsigned\-changes\fR is specified). .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). Pass\('e \(`a \fBdpkg-genchanges\fR. .Sp Les valeurs autoris\('ees sont : .RS 4 .IP "\fBsource\fR" 4 .IX Item "source" Builds the source package. .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, \fB\-\-release\-by=\fR\fIadresse-du-responsable\fR" 4 .IX Item "-m, --release-by=adresse-du-responsable" .IP "\fB\-e\fR, \fB\-\-build\-by=\fR\fIadresse-du-responsable\fR" 4 .IX Item "-e, --build-by=adresse-du-responsable" .PD Pass\('e tel quel \(`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[\fIjobs\fR|\fBauto\fR]" 4 .IX Item "-j, --jobs[jobs|auto]" Nombre de processus simultan\('es qui peuvent \(^etre ex\('ecut\('es, nombre de processus 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, \('equivalent \(`a l'option \fBmake\fR(1) du m\(^eme nom (depuis dpkg 1.14.7, option longue depuis dpkg 1.18.8). S'ajoutera tout seul \(`a la variable d'environnement \s-1MAKEFLAGS,\s0 afin que les appels suivants de make en h\('eritent, for\(,cant donc le param\(`etre parall\(`ele sur l'empaquetage (et \('eventuellement le syst\(`eme de construction amont s'il utilise make) ind\('ependamment de leur prise en charge des constructions parall\(`ele, ce qui pourrait provoquer des \('echecs de construction. Ajoute aussi \fBparallel=\fR\fIjobs\fR ou \fBparallel\fR \(`a la variable d'environnement \fB\s-1DEB_BUILD_OPTIONS\s0\fR ce qui permet aux fichiers debian/rules d'utiliser cette information pour leurs propres besoins. La valeur de \fBj\fR remplacera les options \fBparallel=\fR\fIjobs\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 fils. 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 sauf qu'elle ne configure pas la variable d'environnement \fB\s-1MAKEFLAGS\s0\fR 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. .Sp Le comportement par d\('efaut est \fBauto\fR (depuis dpkg 1.18.11). Fixer le nombre de t\(^aches \(`a 1 r\('etablira un comportement s\('eriel. .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" Sanitize the build environment (since dpkg 1.20.0). This will reset or remove environment variables, umask, and any other process attributes that might otherwise adversely affect the build of packages. Because the official entry point to build packages is \fBdebian/rules\fR, packages cannot rely on these settings being in place, and thus should work even when they are not. What to sanitize is vendor specific. .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 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 : .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\-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\-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 \s-1GPG\s0 to sign a source control (\fB.dsc\fR) file or a \fB.changes\fR file it will run \fIsign-command\fR (searching the \fB\s-1PATH\s0\fR if necessary) instead of \fBgpg\fR (long option since dpkg 1.18.8). \fIsign-command\fR will get all the arguments that \fBgpg\fR would have gotten. \fIsign-command\fR should not contain spaces or any other shell metacharacters. .IP "\fB\-k\fR, \fB\-\-sign\-key=\fR\fIidentifiant\-cl\('e\fR" 4 .IX Item "-k, --sign-key=identifiant-cl\('e" Pr\('eciser une cl\('e pour la signature des paquets (option longue depuis dpkg 1.18.8). .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\-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" Affiche un message d'aide puis quitte. .IP "\fB\-\-version\fR" 4 .IX Item "--version" Affiche le num\('ero de version puis quitte. .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 et \fB.dsc\fR (depuis dpkg 1.17.2). Remplac\('ee par l'option \&\fB\-\-sign\-key\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" \&\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), \fBgpg\fR(1). .SH "TRADUCTION" .IX Header "TRADUCTION" Ariel \s-1VARDI\s0 , 2002. Philippe Batailler, 2006. Nicolas Fran\(,cois, 2006. Veuillez signaler toute erreur \(`a .