.\" 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 "NOME"
.IX Header "NOME"
dpkg-buildpackage \- compila pacotes bin\('arios ou fonte a partir de fontes
.SH "SINOPSE"
.IX Header "SINOPSE"
\&\fBdpkg-buildpackage\fR [\fIoption\fR...]
.SH "DESCRI\(,C\(~AO"
.IX Header "DESCRI\(,C\(~AO"
\&\fBdpkg-buildpackage\fR \('e um programa que automatiza os processos de compilar um pacote Debian. Consiste nos seguintes passos:
.IP "\fB1.\fR" 4
.IX Item "1."
Prepara o ambiente de compila\(,c\(~ao ao definir v\('arias vari\('aveis de ambiente. (veja \fB\s-1ENVIRONMENT\s0\fR), corre o hook \fBinit\fR, e chama \fBdpkg-source \-\-before\-build\fR (a menos que \fB\-T\fR ou \fB\-\-target\fR sejam usados).
.IP "\fB2.\fR" 4
.IX Item "2."
Verifica se as depend\(^encias de compila\(,c\(~ao e os conflitos de compila\(,c\(~ao est\(~ao satisfeitos (a menos que \fB\-d\fR ou \fB\-\-no\-check\-builddeps\fR seja especificado).
.IP "\fB3.\fR" 4
.IX Item "3."
Se um ou mais alvos espec\('ificos foram seleccionado com a op\(,c\(~ao \fB\-T\fR ou \fB\-\-target\fR, chama esses alvos e p\('ara aqui. Caso contr\('ario corre o hook \fBpreclean\fR e chama \fBfakeroot debian/rules clean\fR para limpar a \('arvore de compila\(,c\(~ao (a menos que \fB\-nc\fR ou \fB\-\-no\-pre\-clean\fR seja especificado).
.IP "\fB4.\fR" 4
.IX Item "4."
Corre o hook \fBsource\fR e chama \fBdpkg-source \-b\fR para gerar o pacote fonte. (se foi requerida uma compila\(,c\(~ao \fBsource\fR com \fB\-\-build\fR ou com op\(,c\(~oes equivalentes).
.IP "\fB5.\fR" 4
.IX Item "5."
Corre o hook \fBbuild\fR e chama \fBdebian/rules\fR \fIbuild-target\fR, depois corre o hook \fBbinary\fR seguido de \fBfakeroot debian/rules\fR \fIbinary-target\fR (a menos que tenha sido requerido uma compila\(,c\(~ao apenas-fonte com \fB\-\-build=source\fR ou op\(,c\(~oes equivalentes). Note que \fIbuild-target\fR e \fIbinary-target\fR s\(~ao ou \fBbuild\fR e \fBbinary\fR (caso predefinido, ou se uma compila\(,c\(~ao \fBany\fR e \fBall\fR foi requerida com \fB\-\-build\fR ou op\(,c\(~oes equivalentes), ou \fBbuild-arch\fR e \fBbinary-arch\fR (se uma compila\(,c\(~ao \fBany\fR e n\(~ao \fBall\fR foi requerida com \fB\-\-build\fR ou op\(,c\(~oes equivalentes), ou \fBbuild-indep\fR e \fBbinary-indep\fR (se uma compila\(,c\(~ao \fBall\fR e n\(~ao \fBany\fR foi requerida com \fB\-\-build\fR ou op\(,c\(~oes equivalentes).
.IP "\fB6.\fR" 4
.IX Item "6."
Corre o hook \fBbuildinfo\fR, e chama \fBdpkg-genbuildinfo\fR para gerar um ficheiro \fB.buildinfo\fR. V\('arias op\(,c\(~oes de \fBdpkg-buildpackage\fR s\(~ao reencaminhadas para o \fBdpkg-genbuildinfo\fR.
.IP "\fB7.\fR" 4
.IX Item "7."
Corre o hook \fBchanges\fR e chama \fBdpkg-genchanges\fR para gerar um ficheiro \fB.changes\fR. O nome do ficheiro \fB.changes\fR ir\('a depender do tipo de compila\(,c\(~ao e ser\('a t\(~ao espec\('ifico quando necess\('ario mas n\(~ao mais; para uma compila\(,c\(~ao que inclua \fBany\fR o nome ser\('a \fIsource-name\fR\fB_\fR\fIbinary-version\fR\fB_\fR\fIarch\fR\fB.changes\fR, ou caso contr\('ario para uma compila\(,c\(~ao que inclua \fBall\fR o nome ser\('a \fIsource-name\fR\fB_\fR\fIbinary-version\fR\fB_\fR\fBall.changes\fR, ou caso contr\('ario para uma compila\(,c\(~ao que inclua \fBsource\fR o nome ser\('a \fIsource-name\fR\fB_\fR\fIsource-version\fR\fB_\fR\fBsource.changes\fR. Muitas op\(,c\(~oes de \fBdpkg-buildpackage\fR s\(~ao reencaminhadas para \fBdpkg-genchanges\fR.
.IP "\fB8.\fR" 4
.IX Item "8."
Corre o hook \fBpostclean\fR e se \fB\-tc\fR ou \fB\-\-post\-clean\fR for especificado, ir\('a chamar \fBfakeroot debian/rules clean\fR outra vez.
.IP "\fB9.\fR" 4
.IX Item "9."
Chama \fBdpkg-source \-\-after\-build\fR.
.IP "\fB10.\fR" 4
.IX Item "10."
Corre o hook \fBcheck\fR e chama um verificados de pacote para o ficheiro \fB.changes\fR (se um comando for especificado em \fB\s-1DEB_CHECK_COMMAND\s0\fR ou com \fB\-\-check\-command\fR).
.IP "\fB11.\fR" 4
.IX Item "11."
Corre o hook \fBsign\fR e assina usando o backend OpenPGP (desde que n\(~ao seja uma compila\(,c\(~ao N\(~AO\-LAN\(,CADA, ou se \fB\-\-no\-sign\fR for especificado) para assinar o ficheiro \fB.dsc\fR (se algum, a menos que \fB\-us\fR ou \fB\-\-unsigned\-source\fR sejam especificados), o ficheiro \fB.buildinfo\fR (a menos que \fB\-ui\fR, \fB\-\-unsigned\-buildinfo\fR, \fB\-uc\fR ou \fB\-\-unsigned\-changes\fR sejam especificados) e os ficheiros \fB.changes\fR (a menos que \fB\-uc\fR ou \fB\-\-unsigned\-changes\fR sejam especificados).
.IP "\fB12.\fR" 4
.IX Item "12."
Corre o hook \fBdone\fR.
.SH "OP\(,C\(~OES"
.IX Header "OP\(,C\(~OES"
Todas as op\(,c\(~oes longas podem ser especificadas em ambos linha de comandos e no sistema \fBdpkg-buildpackage\fR e nos ficheiros de configura\(,c\(~ao do utilizador. Cada linha no ficheiro de configura\(,c\(~ao \('e ou uma op\(,c\(~ao (exatamente igual a uma op\(,c\(~ao de linha de comandos mas sem os h\('ifens iniciais) ou um coment\('ario (se come\(,car com \(oq\fB#\fR\(cq).
.IP "\fB\-\-build=\fR\fItype\fR" 4
.IX Item "--build=type"
Especifica o \fItype\fR de compila\(,c\(~ao a partir de uma lista separada por v\('irgulas de componentes (desde dpkg 1.18.5). Todos os componentes especificados s\(~ao combinados para selecionar o \('unico tipo de compila\(,c\(~ao a usar, o que implica uma \('unica execu\(,c\(~ao de compila\(,c\(~ao com um \('unico ficheiro \fIchanges\fR gerado. Passado para \fBdpkg-genchanges\fR.
.Sp
Os valores permitidos s\(~ao:
.RS 4
.IP "\fBsource\fR" 4
.IX Item "source"
Compila o pacote fonte.
.Sp
\&\fBNota:\fR Quando se usa este valor aut\('onomo e se o que voc\(^e quer \('e simplesmente (re\-)compilar o pacote fonte a partir de uma \('arvore fonte limpa, usar \fBdpkg-source\fR directamente \('e sempre uma melhor op\(,c\(~ao pois n\(~ao requer que sejam instaladas quaisquer depend\(^encias de compila\(,c\(~ao as quais, caso contr\('ario, s\(~ao precisas para ser capaz de chamar o alvo \fBclean\fR.
.IP "\fBany\fR" 4
.IX Item "any"
Compila os pacotes bin\('arios espec\('ificos de arquitectura.
.IP "\fBall\fR" 4
.IX Item "all"
Compila os pacotes bin\('arios independentes de arquitectura.
.IP "\fBbinary\fR" 4
.IX Item "binary"
Compila os pacotes bin\('arios independentes e espec\('ificos de arquitectura. Isto \('e um alias para \fBany,all\fR.
.IP "\fBfull\fR" 4
.IX Item "full"
Compila tudo. Isto \('e um alias para \fBsource,any,all\fR, e o mesmo que o caso predefinido quando n\(~ao \('e especificada nenhuma op\(,c\(~ao de compila\(,c\(~ao.
.RE
.RS 4
.RE
.IP "\fB\-g\fR" 4
.IX Item "-g"
Equivalente a \fB\-\-build=source,all\fR (desde dpkg 1.17.11).
.IP "\fB\-G\fR" 4
.IX Item "-G"
Equivalente a \fB\-\-build=source,any\fR (desde dpkg 1.17.11).
.IP "\fB\-b\fR" 4
.IX Item "-b"
Equivalente a \fB\-\-build=binary\fR ou \fB\-\-build=any,all\fR.
.IP "\fB\-B\fR" 4
.IX Item "-B"
Equivalente a \fB\-\-build=any\fR.
.IP "\fB\-A\fR" 4
.IX Item "-A"
Equivalente a \fB\-\-build=all\fR.
.IP "\fB\-S\fR" 4
.IX Item "-S"
Equivalente a \fB\-\-build=source\fR.
.IP "\fB\-F\fR" 4
.IX Item "-F"
Equivalente a \fB\-\-build=full\fR, \fB\-\-build=source,binary\fR ou \fB\-\-build=source,any,all\fR (desde dpkg 1.15.8).
.IP "\fB\-\-target=\fR\fItarget\fR[,...]" 4
.IX Item "--target=target[,...]"
.PD 0
.IP "\fB\-\-target\fR \fItarget\fR[,...]" 4
.IX Item "--target target[,...]"
.IP "\fB\-T\fR, \fB\-\-rules\-target=\fR\fItarget\fR[,...]" 4
.IX Item "-T, --rules-target=target[,...]"
.PD
Chama \fBdebian/rules\fR \fItarget\fR uma vez por cada alvo especificado, ap\('os ter configurado o ambiente de compila\(,c\(~ao (excepto para chamar \fBdpkg-source \-\-before\-build\fR), e p\('ara o processo de compila\(,c\(~ao do pacote aqui (desde dpkg 1.15.0, op\(,c\(~ao longa desde dpkg 1.18.8, suporte a multi-alvo desde dpkg 1.18.16). Se \fB\-\-as\-root\fR for tamb\('em fornecido, ent\(~ao o comando \('e executado como root (veja \fB\-\-root\-command\fR). Note que alvos conhecidos que s\(~ao obrigados a correr como root n\(~ao precisam desta op\(,c\(~ao (isto \('e, os alvos \fBclean\fR, \fBbinary\fR, \fBbinary-arch\fR e \fBbinary-indep\fR).
.IP "\fB\-\-as\-root\fR" 4
.IX Item "--as-root"
Apenas significativo junto com \fB\-\-target\fR (desde dpkg 1.15.0). Requer que o alvo seja corrido com direitos de root.
.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\fIchanges-description\fR" 4
.IX Item "-Cchanges-description"
.IP "\fB\-m\fR\fImaintainer-address\fR" 4
.IX Item "-mmaintainer-address"
.IP "\fB\-e\fR\fImaintainer-address\fR" 4
.IX Item "-emaintainer-address"
.PD
Passado sem altera\(,c\(~oes ao \fBdpkg-genchanges\fR. Veja o seu manual.
.IP "\fB\-\-build\-by=\fR\fImaintainer-address\fR" 4
.IX Item "--build-by=maintainer-address"
.PD 0
.IP "\fB\-\-source\-by=\fR\fImaintainer-address\fR (desde dpkg 1.21.10)" 4
.IX Item "--source-by=maintainer-address (desde dpkg 1.21.10)"
.PD
Passa como \fB\-m\fR ao \fBdpkg-genchanges\fR. Veja o seu manual.
.IP "\fB\-\-release\-by=\fR\fImaintainer-address\fR" 4
.IX Item "--release-by=maintainer-address"
.PD 0
.IP "\fB\-\-changed\-by=\fR\fImaintainer-address\fR (desde dpkg 1.21.10)" 4
.IX Item "--changed-by=maintainer-address (desde dpkg 1.21.10)"
.PD
Passa como \fB\-e\fR ao \fBdpkg-genchanges\fR. Veja o seu manual.
.IP "\fB\-a\fR, \fB\-\-host\-arch\fR \fIarchitecture\fR" 4
.IX Item "-a, --host-arch architecture"
Especifica a arquitectura Debian para qual compilamos (op\(,c\(~ao longa desde dpkg 1.17.17). A arquitectura da m\('aquina onde compilamos \('e determinada automaticamente, e \('e tamb\('em a predefinida para a m\('aquina anfitri\(~a.
.IP "\fB\-t\fR, \fB\-\-host\-type\fR \fIgnu-system-type\fR" 4
.IX Item "-t, --host-type gnu-system-type"
Especifica o tipo de sistema \s-1GNU\s0 para qual compilamos (op\(,c\(~ao longa desde dpkg 1.17.17). Pode ser usado no lugar de \fB\-\-host\-arch\fR ou como um complemento para sobrepor o tipo de sistema \s-1GNU\s0 predefinido da arquitectura Debian anfitri\(~a.
.IP "\fB\-\-target\-arch\fR \fIarchitecture\fR" 4
.IX Item "--target-arch architecture"
Especifica a arquitectura Debian para que os bin\('arios s\(~ao compilados (desde dpkg 1.17.17). O valor predefinido \('e o da m\('aquina anfitri\(~a.
.IP "\fB\-\-target\-type\fR \fIgnu-system-type\fR" 4
.IX Item "--target-type gnu-system-type"
Especifica o tipo de sistema \s-1GNU\s0 para que os bin\('arios s\(~ao compilados (desde dpkg 1.17.17). Pode ser usado no lugar de \fB\-\-target\-arch\fR ou como um complemento para sobrepor o tipo de sistema \s-1GNU\s0 predefinido da arquitectura Debian do alvo.
.IP "\fB\-P\fR, \fB\-\-build\-profiles=\fR\fIprofile\fR[\fB,\fR...]" 4
.IX Item "-P, --build-profiles=profile[,...]"
Especifica os perfil(es) que compilamos, como uma lista separada por v\('irgulas (desde dpkg 1.17.2, op\(,c\(~ao longa desde dpkg 1.18.8). O comportamento predefinido \('e compilar para nenhum perfil espec\('ifico. Tamb\('em os define (como uma lista separada por espa\(,cos) como a vari\('avel de ambiente \fB\s-1DEB_BUILD_PROFILES\s0\fR o que permite, por exemplo, ficheiros \fBdebian/rules\fR usarem esta informa\(,c\(~ao para compila\(,c\(~oes condicionais.
.IP "\fB\-j\fR, \fB\-\-jobs\fR[=\fIjobs\fR|\fBauto\fR]" 4
.IX Item "-j, --jobs[=jobs|auto]"
Especifica se o n\('umero de trabalhos permitidos para serem corridos em simult\(^aneo (desde dpkg 1.14.7, op\(,c\(~ao longa desde dpkg 1.18.8). O n\('umero de trabalhos correspondente ao n\('umero de processadores online se \fBauto\fR for especificado (desde dpkg 1.17.10), ou n\('umero ilimitado se \fIjobs\fR n\(~ao for especificado. O comportamento predefinido \('e \fBauto\fR (desde dpkg 1.18.11) em modo n\(~ao\-for\(,cado (desde dpkg 1.21.10), e como tal \('e sempre mais seguro usar com qualquer pacote incluindo aqueles que n\(~ao seguros para compila\(,c\(~ao paralela. Definir o n\('umero de trabalhos para \fB1\fR ir\('a restaurar a execu\(,c\(~ao em s\('erie.
.Sp
Ir\('a adicionar \fBparallel=\fR\fIjobs\fR ou \fBparallel\fR \(`a vari\('avel de ambiente \fB\s-1DEB_BUILD_OPTIONS\s0\fR que permite a ficheiros debian/rules optarem por usar esta informa\(,c\(~ao para os seus pr\('oprios objectivos. O valor \fBjobs\fR ir\('a sobrepor a op\(,c\(~ao \fBparallel=\fR\fIjobs\fR ou \fBparallel\fR na vari\('avel de ambiente \fB\s-1DEB_BUILD_OPTIONS\s0\fR. Note que o valor \fBauto\fR ir\('a ser substitu\('ido pelo n\('umero real de processadores actuais activos, e como tal, n\(~ao ser\('a propagado para nenhum processo filho. Se o n\('umero de processadores online n\(~ao poder ser deduzido, ent\(~ao o c\('odigo ira cair para o uso de execu\(,c\(~ao em s\('erie (desde dpkg 1.18.15), no entanto isto apenas dever\('a acontecer em sistemas ex\('oticos e n\(~ao suportados.
.IP "\fB\-J\fR, \fB\-\-jobs\-try\fR[=\fIjobs\fR|\fBauto\fR]" 4
.IX Item "-J, --jobs-try[=jobs|auto]"
Esta op\(,c\(~ao (desde dpkg 1.18.2, op\(,c\(~ao longa desde dpkg 1.18.8) \('e equivalente a \fB\-j\fR em cima.
.Sp
Como o comportamento do \fB\-j\fR alterou no dpkg 1.21.10 para o modo opt-in, voc\(^e pode usar esta op\(,c\(~ao se precisar de garantir sem\(^anticas entre s\('eries de lan\(,camento do dpkg.
.IP "\fB\-\-jobs\-force\fR[=\fIjobs\fR|\fBauto\fR]" 4
.IX Item "--jobs-force[=jobs|auto]"
Esta op\(,c\(~ao (desde dpkg 1.21.10) \('e equivalente \(`a op\(,c\(~ao \fB\-\-jobs\fR excepto que ir\('a activar o modo paralelo for\(,cado, ao adicionar a op\(,c\(~ao \fBmake\fR \fB\-j\fR com o n\('umero computado de trabalhos em paralelo para a vari\('avel de ambiente \fB\s-1MAKEFLAGS\s0\fR.
.Sp
Isto dever\('a causar que todas as invoca\(,c\(~oes make subsequentes herdam a op\(,c\(~ao assim for\(,cando a defini\(,c\(~ao paralela no empacotamento (e possivelmente o sistema de compila\(,c\(~ao do autor se isso usar \fBmake\fR\|(1)) independentemente do seu suporte para compila\(,c\(~oes paralelas, o que pode causar falhas na compila\(,c\(~ao.
.Sp
Nota: Qualquer Makefile que n\(~ao seja seguro-paralelo deve ser considerado defeituoso. Estes devem ou tornados seguro-paralelo, ou marcados como n\(~ao seguros com o alvo \fBmake\fR\|(1) \fB.NOTPARALLEL\fR.
.IP "\fB\-D\fR, \fB\-\-check\-builddeps\fR" 4
.IX Item "-D, --check-builddeps"
Verifica depend\(^encias e conflitos de compila\(,c\(~ao; aborta se n\(~ao satisfeitos (op\(,c\(~ao longa desde dpkg 1.18.8). Este \('e o comportamento predefinido.
.IP "\fB\-d\fR, \fB\-\-no\-check\-builddeps\fR" 4
.IX Item "-d, --no-check-builddeps"
N\(~ao verifica depend\(^encias e conflitos de compila\(,c\(~ao (op\(,c\(~ao longa desde dpkg 1.18.8).
.IP "\fB\-\-ignore\-builtin\-builddeps\fR" 4
.IX Item "--ignore-builtin-builddeps"
N\(~ao verifica depend\(^encias de compila\(,c\(~ao embutidas e conflitos (desde dpkg 1.18.2). Estas as depend\(^encias de compila\(,c\(~ao impl\('icitas e espec\('ificas da distribui\(,c\(~ao requeridas num ambiente de compila\(,c\(~ao, o chamado conjunto de pacotes Build-Essential.
.IP "\fB\-\-rules\-requires\-root\fR" 4
.IX Item "--rules-requires-root"
N\(~ao respeita o campo \fBRules-Requires-Root\fR, caindo para o seu valor de predefini\(,c\(~ao antiga (desde dpkg 1.19.1).
.IP "\fB\-nc\fR, \fB\-\-no\-pre\-clean\fR" 4
.IX Item "-nc, --no-pre-clean"
N\(~ao limpa a \('arvore fonte antes de compilar (op\(,c\(~ao longa desde dpkg 1.18.8). Implica \fB\-b\fR se nada mais foi seleccionado entre \fB\-F\fR, \fB\-g\fR, \fB\-G\fR, \fB\-B\fR, \fB\-A\fR ou \fB\-S\fR. Implica \fB\-d\fR com \fB\-S\fR (desde dpkg 1.18.0).
.IP "\fB\-\-pre\-clean\fR" 4
.IX Item "--pre-clean"
Limpa a \('arvore fonte antes de compilar (desde dpkg 1.18.8). Este \('e o comportamento predefinido.
.IP "\fB\-tc\fR, \fB\-\-post\-clean\fR" 4
.IX Item "-tc, --post-clean"
Limpa a \('arvore fonte (usando \fIgain-root-command\fR \fBdebian/rules clean\fR) ap\('os o pacote ter sido compilado (op\(,c\(~ao longa desde dpkg 1.18.8).
.IP "\fB\-\-no\-post\-clean\fR" 4
.IX Item "--no-post-clean"
N\(~ao limpa a \('arvore fonte ap\('os o pacote ter sido compilado (desde dpkg 1.19.1). Este \('e o comportamento predefinido.
.IP "\fB\-\-sanitize\-env\fR" 4
.IX Item "--sanitize-env"
Higieniza o ambiente de compila\(,c\(~ao (desde dpkg 1.20.0). Isto ir\('a repor ou remover vari\('aveis de ambiente, umask, e quaisquer outros atributos de processo que poderiam caso contr\('ario afectar adversamente a compila\(,c\(~ao dos pacotes. Porque o ponto de entrada oficial para compilar pacotes \('e \fBdebian/rules\fR, os pacotes n\(~ao podem confiar que estas defini\(,c\(~oes estejam no lugar, e assim devem funcionar mesmo quando elas n\(~ao est\(~ao. O que h\('a a higienizar \('e espec\('ifico do fornecedor.
.IP "\fB\-r\fR, \fB\-\-root\-command=\fR\fIgain-root-command\fR" 4
.IX Item "-r, --root-command=gain-root-command"
Quando o \fBdpkg-buildpackage\fR precisa de executar parte do processo de compila\(,c\(~ao como root, prefixa o comando que executa com \fIgain-root-command\fR se foi especificado um (op\(,c\(~ao longa desde dpkg 1.18.8). Caso contr\('ario, se nenhum foi especificado, ser\('a usado por predefini\(,c\(~ao o \fBfakeroot\fR, se o comando estiver presente. \fIgain-root-command\fR dever\('a come\(,car com o nome de um programa presente na \fB\s-1PATH\s0\fR e receber\('a como argumentos o nome do comando real a correr e os argumentos que este deve receber. O \fIgain-root-command\fR pode incluir par\(^ametros (t\(^em se ser separados por espa\(,cos) mas n\(~ao meta-caracteres da shell. O \fIgain-root-command\fRpode ser tipicamente \fBfakeroot\fR, \fBsudo\fR, \fBsuper\fR ou \fBreally\fR. O \fBsu\fR n\(~ao \('e apropriado, pois ele s\('o pode invocar a shell do utilizador com \fB\-c\fR em vez de passar argumentos individualmente aos comandos que corre.
.IP "\fB\-R\fR, \fB\-\-rules\-file=\fR\fIrules-file\fR" 4
.IX Item "-R, --rules-file=rules-file"
Compilar um pacote Debian geralmente involve invocar \fBdebian/rules\fR como um comando com v\('arios par\(^ametros standard (desde dpkg 1.14.17, op\(,c\(~ao longa desde dpkg 1.18.8). Com esta op\(,c\(~ao \('e poss\('ivel usar outra invoca\(,c\(~ao de programa para compilar o pacote (pode incluir par\(^ametros separados por espa\(,cos). Em alternativa pode ser usado para executar o ficheiro de regras standard com outro programa make (por exemplo ao usar \fB/usr/local/bin/make \-f debian/rules\fR como \fIrules-file\fR).
.IP "\fB\-\-check\-command=\fR\fIcheck-command\fR" 4
.IX Item "--check-command=check-command"
Comando usado para verificar o pr\('oprio ficheiro \fB.changes\fR e qualquer artefacto de compila\(,c\(~ao referenciado no ficheiro (desde dpkg 1.17.6). O comando deve receber o nome de caminho de \fB.changes\fR como um argumento. Este comando \('e geralmente o \fBlintian\fR.
.IP "\fB\-\-check\-option=\fR\fIopt\fR" 4
.IX Item "--check-option=opt"
Passa a op\(,c\(~ao \fIop\(,c\(~ao\fR ao \fIcomando\-de\-verifica\(,c\(~ao\fR especificado com \fB\s-1DEB_CHECK_COMMAND\s0\fR ou \fB\-\-check\-command\fR (desde dpkg 1.17.6). Pode ser usado v\('arias vezes.
.IP "\fB\-\-hook\-\fR\fIhook-name\fR\fB=\fR\fIhook-command\fR" 4
.IX Item "--hook-hook-name=hook-command"
Define o c\('odigo shell especificado \fIhook-command\fR como o hook \fIhook-name\fR, o qual vai correr nos tempos especificados nos passos de execu\(,c\(~ao (desde dpkg 1.17.6). Os hooks ir\(~ao sempre ser executados mesmo que a ac\(,c\(~ao seguinte n\(~ao seja executada (excepto para o hook \fBbinary\fR). Todos os hooks ir\(~ao correr no direct\('orio fonte desempacotado.
.Sp
\&\fBNota:\fR Os hooks podem afectar o processo de compila\(,c\(~ao, e causar falhas ao compilar se os seus comandos falharem, portanto esteja atento a consequ\(^encias indesejadas.
.Sp
Os \fInome-de-hook\fR actualmente suportados s\(~ao:
.Sp
\&\fBinit preclean source build binary buildinfo changes postclean check sign done\fR
.Sp
O \fIcomando-hook\fR suporta as seguintes strings de formato de substitui\(,c\(~ao, que lhes ser\(~ao aplicadas antes da execu\(,c\(~ao.
.RS 4
.IP "\fB%%\fR" 4
.IX Item "%%"
Um \('unico caracteres %.
.IP "\fB\f(CB%a\fB\fR" 4
.IX Item "%a"
Um valor booleano (0 ou 1), que representa se a seguinte ac\(,c\(~ao foi executada.
.IP "\fB\f(CB%p\fB\fR" 4
.IX Item "%p"
O nome do pacote fonte.
.IP "\fB\f(CB%v\fB\fR" 4
.IX Item "%v"
A vers\(~ao do pacote fonte
.IP "\fB\f(CB%s\fB\fR" 4
.IX Item "%s"
A vers\(~ao do pacote fonte (sem a \('epoca).
.IP "\fB\f(CB%u\fB\fR" 4
.IX Item "%u"
A vers\(~ao do autor.
.RE
.RS 4
.RE
.IP "\fB\-\-buildinfo\-file=\fR\fIfilename\fR" 4
.IX Item "--buildinfo-file=filename"
Define o \fInome-ficheiro\fR para o ficheiro \fB.buildinfo\fR gerado (desde dpkg 1.21.0).
.IP "\fB\-\-buildinfo\-option=\fR\fIopt\fR" 4
.IX Item "--buildinfo-option=opt"
Passa a op\(,c\(~ao \fIopt\fR ao \fBdpkg-genbuildinfo\fR (desde dpkg 1.18.11). Pode ser usado v\('arias vezes.
.IP "\fB\-\-sign\-backend=\fR\fIsign-backend\fR" 4
.IX Item "--sign-backend=sign-backend"
Especifica uma interface backend OpenPGP a usar quando se invoca o \fIsign-command\fR (desde dpkg 1.21.10).
.Sp
A predefini\(,c\(~ao \('e \fBauto\fR, onde o melhor backend actual dispon\('ivel ir\('a ser usado. Os backends OpenPGP espec\('ificos suportados em ordem de prefer\(^encia s\(~ao:
.RS 4
.IP "\fBsop\fR (qualquer implementa\(,c\(~ao conforme Stateless OpenPGP)" 2
.IX Item "sop (qualquer implementa\(,c\(~ao conforme 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\fIsign-command\fR" 4
.IX Item "-p, --sign-command=sign-command"
.PD
Quando \fBdpkg-buildpackage\fR precisa de executar comando backend OpenPGP para assinar um ficheiro de controle de fonte (\fB.dsc\fR) ou um ficheiro \fB.changes\fR ir\('a correr \fIsign-command\fR (procurando na \fB\s-1PATH\s0\fR se necess\('ario) em vez do predefinido ou do comando backend auto-detectado (op\(,c\(~ao longa desde dpkg 1.18.8). \fIsign-command\fR ir\('a obter todos os argumentos definidos por \fB\-\-sign\-backend\fR. \fIsign-command\fR n\(~ao deve conter espa\(,cos ou outros meta-caracteres de shell.
.IP "\fB\-k\fR, \fB\-\-sign\-keyid=\fR\fIkey-id\fR" 4
.IX Item "-k, --sign-keyid=key-id"
.PD 0
.IP "\fB\-\-sign\-key=\fR\fIkey-id\fR" 4
.IX Item "--sign-key=key-id"
.PD
Especifica um ID-chave OpenPGP (seja uma impress\(~ao digital ou um \s-1ID\s0 de utilizador) para a chave secreta a usar ao assinar pacotes (\fB\-\-sign\-key\fR desde dpkg 1.18.8, \fB\-\-sign\-keyid\fR desde dpkg 1.21.10).
.IP "\fB\-\-sign\-keyfile=\fR\fIkey-file\fR" 4
.IX Item "--sign-keyfile=key-file"
Especifica um \fIkey-file\fR OpenPGP que contem a chave secreta usada quando assinar pacotes (desde dpkg 1.21.10).
.Sp
Nota: Por raz\(~oes de seguran\(,ca \('e melhor o \fIkey-file\fR ser mantido bloqueado com uma palavra passe.
.IP "\fB\-us\fR, \fB\-\-unsigned\-source\fR" 4
.IX Item "-us, --unsigned-source"
N\(~ao assina o pacote fonte (op\(,c\(~ao longa desde dpkg 1.18.8).
.IP "\fB\-ui\fR, \fB\-\-unsigned\-buildinfo\fR" 4
.IX Item "-ui, --unsigned-buildinfo"
N\(~ao assina o ficheiro \fB.buildinfo\fR (desde dpkg 1.18.19).
.IP "\fB\-uc\fR, \fB\-\-unsigned\-changes\fR" 4
.IX Item "-uc, --unsigned-changes"
N\(~ao assina os ficheiros \fB.buildinfo\fR e \fB.changes\fR (op\(,c\(~ao longa desde dpkg 1.18.8).
.IP "\fB\-\-no\-sign\fR" 4
.IX Item "--no-sign"
N\(~ao assina nenhum ficheiro, isto inclui o pacote fonte, o ficheiro \fB.buildinfo\fR e o ficheiro \fB.changes\fR (desde dpkg 1.18.20).
.IP "\fB\-\-force\-sign\fR" 4
.IX Item "--force-sign"
For\(,ca o assinar dos ficheiros resultantes (desde dpkg 1.17.0), independentemente de \fB\-us\fR, \fB\-\-unsigned\-source\fR, \fB\-ui\fR, \fB\-\-unsigned\-buildinfo\fR, \fB\-uc\fR, \fB\-\-unsigned\-changes\fR ou de outras heur\('isticas internas.
.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[=\fIregex\fR]" 4
.IX Item "-i, --diff-ignore[=regex]"
.IP "\fB\-I\fR, \fB\-\-tar\-ignore\fR[=\fIpattern\fR]" 4
.IX Item "-I, --tar-ignore[=pattern]"
.IP "\fB\-z\fR, \fB\-\-compression\-level=\fR\fIlevel\fR" 4
.IX Item "-z, --compression-level=level"
.IP "\fB\-Z\fR, \fB\-\-compression=\fR\fIcompressor\fR" 4
.IX Item "-Z, --compression=compressor"
.PD
Passado sem altera\(,c\(~oes ao \fBdpkg-source\fR. Veja o seu manual.
.IP "\fB\-\-source\-option=\fR\fIopt\fR" 4
.IX Item "--source-option=opt"
Passa a op\(,c\(~ao \fIop\(,c\(~ao\fR ao \fBdpkg-source\fR (desde dpkg 1.15.6. Pode ser usado v\('arias vezes.
.IP "\fB\-\-changes\-file=\fR\fIfilename\fR" 4
.IX Item "--changes-file=filename"
Define o \fInome-ficheiro\fR para o ficheiro \fB.changes\fR gerado (desde dpkg 1.21.0).
.IP "\fB\-\-changes\-option=\fR\fIopt\fR" 4
.IX Item "--changes-option=opt"
Passa a op\(,c\(~ao \fIop\(,c\(~ao\fR ao \fBdpkg-genchanges\fR (desde dpkg 1.15.6). Pode ser usado v\('arias vezes.
.IP "\fB\-\-admindir=\fR\fIdir\fR" 4
.IX Item "--admindir=dir"
.PD 0
.IP "\fB\-\-admindir\fR \fIdir\fR" 4
.IX Item "--admindir dir"
.PD
Altera a localiza\(,c\(~ao da base de dados do \fBdpkg\fR (desde dpkg 1.14.0). A localiza\(,c\(~ao predefinida \('e \fI/var/lib/dpkg\fR.
.IP "\fB\-?\fR, \fB\-\-help\fR" 4
.IX Item "-?, --help"
Mostra a mensagem de utiliza\(,c\(~ao e termina.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
Mostra a vers\(~ao e termina.
.SH "AMBIENTE"
.IX Header "AMBIENTE"
.SS "Ambiente externo"
.IX Subsection "Ambiente externo"
.IP "\fB\s-1DEB_CHECK_COMMAND\s0\fR" 4
.IX Item "DEB_CHECK_COMMAND"
Se definido, ser\('a usado como o comando para verificar o ficheiro \fB.changes\fR (desde dpkg 1.17.6). Sobreposto pela op\(,c\(~ao \fB\-\-check\-command\fR.
.IP "\fB\s-1DEB_SIGN_KEYID\s0\fR" 4
.IX Item "DEB_SIGN_KEYID"
Se definido, ser\('a usado para assinar os ficheiros \fB.changes\fR, \fB.buildinfo\fR e \fB.dsc\fR (desde dpkg 1.17.2). Sobreposto pela op\(,c\(~ao \fB\-\-sign\-key\fR.
.IP "\fB\s-1DEB_SIGN_KEYFILE\s0\fR" 4
.IX Item "DEB_SIGN_KEYFILE"
Se definido, ser\('a usado para assinar os ficheiros \fB.changes\fR, \fB.buildinfo\fR e \fB.dsc\fR (desde dpkg 1.21.10). Sobreposto pela op\(,c\(~ao \fB\-\-sign\-keyfile\fR.
.IP "\fB\s-1DEB_BUILD_OPTIONS\s0\fR" 4
.IX Item "DEB_BUILD_OPTIONS"
Se definido, ir\('a conter uma lista de op\(,c\(~oes separadas por espa\(,cos que podem afectar o processo de compila\(,c\(~ao em \fIdebian/rules\fR, e o comportamento de alguns comandos do dpkg.
.Sp
Com \fBnocheck\fR a vari\('avel \fB\s-1DEB_CHECK_COMMAND\s0\fR ser\('a ignorada. com \fBparallel=\fR\fIN\fR os trabalhos paralelos ser\(~ao definidos para \fIN\fR, sobrepostos pela op\(,c\(~ao \fB\-\-jobs\-try\fR.
.IP "\fB\s-1DEB_BUILD_PROFILES\s0\fR" 4
.IX Item "DEB_BUILD_PROFILES"
Se definido, ser\('a usado como perfil(es) de compila\(,c\(~ao activos para o pacote a ser compilado (desde dpkg 1.17.2). \('E uma lista separada por espa\(,cos de nomes de perfis. Sobreposto pela op\(,c\(~ao \fB\-P\fR.
.IP "\fB\s-1DPKG_COLORS\s0\fR" 4
.IX Item "DPKG_COLORS"
Define o modo de cor (desde dpkg 1.18.5). Os valores actualmente aceites s\(~ao: \fBauto\fR (predefinido), \fBalways\fR e \fBnever\fR.
.IP "\fB\s-1DPKG_NLS\s0\fR" 4
.IX Item "DPKG_NLS"
Se definida, ser\('a usada para decidir se deve activar o Suporte a Linguagem Nativa. Tamb\('em como conhecido como suporte de internacionaliza\(,c\(~ao (ou i18n) (desde dpkg 1.19.0). Os valores aceites s\(~ao \fB0\fR e \fB1\fR (predefini\(,c\(~ao).
.SS "Ambiente interno"
.IX Subsection "Ambiente interno"
Mesmo que \fBdpkg-buildpackage\fR exporte algumas vari\('aveis, o \fBdebian/rules\fR n\(~ao deve confiar na sua presen\(,ca e deve em vez disso usar a interface respectiva para obter os valore que precisa, porque esse ficheiro \('e o ponto de entrada principal para compilar pacotes e deve ser suportado poder faz\(^e\-lo sozinho.
.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 \('e chamado com os par\(^ametros \fB\-a\fR e \fB\-t\fR reencaminhados. Qualquer vari\('avel que seja resultante da sua op\(,c\(~ao \fB\-s\fR \('e integrada no ambiente de compila\(,c\(~ao.
.IP "\fB\s-1DEB_RULES_REQUIRES_ROOT\s0\fR" 4
.IX Item "DEB_RULES_REQUIRES_ROOT"
Esta vari\('avel \('e definida para o valor obtido a partir do campo \fBRules-Requires-Root\fR ou a partir da linha de comandos. Quando definida, ser\('a um valor v\('alido para o campo \fBRules-Requires-Root\fR. \('E usada para notificar \fBdebian/rules\fR se a especifica\(,c\(~ao \fBrootless\-builds.txt\fR \('e suportada.
.IP "\fB\s-1DEB_GAIN_ROOT_CMD\s0\fR" 4
.IX Item "DEB_GAIN_ROOT_CMD"
Esta vari\('avel \('e definida para \fIgain-root-command\fR quando o campo \fBRules-Requires-Root\fR \('e definido para um valor diferente de \fBno\fR e \fBbinary-targets\fR.
.IP "\fB\s-1SOURCE_DATE_EPOCH\s0\fR" 4
.IX Item "SOURCE_DATE_EPOCH"
Esta vari\('avel \('e definida \(`a marca temporal de Unix desde a \('epoca da \('ultima entrada em \fIdebian/changelog\fR, se n\(~ao estiver j\('a definida.
.SH "FICHEIROS"
.IX Header "FICHEIROS"
.IP "\fI/etc/dpkg/buildpackage.conf\fR" 4
.IX Item "/etc/dpkg/buildpackage.conf"
Ficheiro de configura\(,c\(~ao geral do sistema
.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
Ficheiro de configura\(,c\(~ao do utilizador.
.SH "NOTAS"
.IX Header "NOTAS"
.SS "As bandeiras de compilador j\('a n\(~ao s\(~ao exportadas"
.IX Subsection "As bandeiras de compilador j\('a n\(~ao s\(~ao exportadas"
Entre dpkg 1.14.17 e 1.16.1, \fBdpkg-buildpackage\fR exportava as bandeiras de compilador (\fB\s-1CFLAGS\s0\fR, \fB\s-1CXXFLAGS\s0\fR, \fB\s-1FFLAGS\s0\fR, \fB\s-1CPPFLAGS\s0\fR e \fB\s-1LDFLAGS\s0\fR) com valores como retornados por \fBdpkg-buildflags\fR. Isto j\('a n\(~ao acontece.
.SS "Metas de compila\(,c\(~ao predefinidas"
.IX Subsection "Metas de compila\(,c\(~ao predefinidas"
\&\fBdpkg-buildpackage\fR est\('a a usar os alvos \fBbuild-arch\fR e \fBbuild-indep\fR desde dpkg 1.16.2. Esses alvos s\(~ao assim obrigat\('orios. Mas para evitar ruturas de pacotes existentes, e facilitar a transi\(,c\(~ao, se o pacote fonte n\(~ao compilar ambos pacotes bin\('arios independentes e dependentes da arquitectura (desde dpkg 1.18.8) ir\('a regressar ao uso de alvo \fBbuild\fR se \fBmake \-f debian/rules \-qn\fR \fIbuild-target\fR retornar 2 como c\('odigo de sa\('ida.
.SH "BUGS"
.IX Header "BUGS"
Dever\('a ser poss\('ivel especificar espa\(,cos e meta-caracteres de shell e argumentos iniciais para \fIgain-root-command\fR e \fIsign-command\fR.
.SH "VEJA TAMB\('EM"
.IX Header "VEJA TAMB\('EM"
\&\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 "TRADU\(,C\(~AO"
.IX Header "TRADU\(,C\(~AO"
Am\('erico Monteiro
.PP
Se encontrar algum erro na tradu\(,c\(~ao deste documento, por favor comunique para
Am\('erico Monteiro .