diff options
Diffstat (limited to 'man/pt/dpkg-buildpackage.pod')
| -rw-r--r-- | man/pt/dpkg-buildpackage.pod | 631 |
1 files changed, 631 insertions, 0 deletions
diff --git a/man/pt/dpkg-buildpackage.pod b/man/pt/dpkg-buildpackage.pod new file mode 100644 index 0000000..f193e87 --- /dev/null +++ b/man/pt/dpkg-buildpackage.pod @@ -0,0 +1,631 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 NOME + +dpkg-buildpackage - compila pacotes binários ou fonte a partir de fontes + +=head1 RESUMO + +B<dpkg-buildpackage> [I<option>...] + +=head1 DESCRIÇÃO + +B<dpkg-buildpackage> é um programa que automatiza os processos de compilar um pacote Debian. Consiste nos seguintes passos: + +=over + +=item B<1.> + +Corre o hook B<preinit> antes de ler qualquer ficheiro fonte. Prepara o ambiente de compilação ao definir várias variáveis de ambiente. (veja B<ENVIRONMENT>), corre o hook B<init>, e chama B<dpkg-source --before-build> (a menos que B<-T> ou B<--target> sejam usados). + +=item B<2.> + +Verifica se as dependências de compilação e os conflitos de compilação estão satisfeitos (a menos que B<-d> ou B<--no-check-builddeps> seja especificado). + +=item B<3.> + +Se um ou mais alvos específicos foram seleccionado com a opção B<-T> ou B<--target>, chama esses alvos e pára aqui. Caso contrário corre o hook B<preclean> e chama B<fakeroot debian/rules clean> para limpar a árvore de compilação (a menos que B<-nc> ou B<--no-pre-clean> seja especificado). + +=item B<4.> + +Corre o hook B<source> e chama B<dpkg-source -b> para gerar o pacote fonte. (se foi requerida uma compilação B<source> com B<--build> ou com opções equivalentes). + +=item B<5.> + +Corre o hook B<build> e chama B<debian/rules> I<build-target>, depois corre o hook B<binary> seguido de B<fakeroot debian/rules> I<binary-target> (a menos que tenha sido requerido uma compilação apenas-fonte com B<--build=source> ou opções equivalentes). Note que I<build-target> e I<binary-target> são ou B<build> e B<binary> (caso predefinido, ou se uma compilação B<any> e B<all> foi requerida com B<--build> ou opções equivalentes), ou B<build-arch> e B<binary-arch> (se uma compilação B<any> e não B<all> foi requerida com B<--build> ou opções equivalentes), ou B<build-indep> e B<binary-indep> (se uma compilação B<all> e não B<any> foi requerida com B<--build> ou opções equivalentes). + +=item B<6.> + +Corre o hook B<buildinfo>, e chama B<dpkg-genbuildinfo> para gerar um ficheiro B<.buildinfo>. Várias opções de B<dpkg-buildpackage> são reencaminhadas para o B<dpkg-genbuildinfo>. + +=item B<7.> + +Corre o hook B<changes> e chama B<dpkg-genchanges> para gerar um ficheiro B<.changes>. O nome do ficheiro B<.changes> irá depender do tipo de compilação e será tão específico quanto necessário mas não mais; o nome irá ser: + +=over + +=item I<source-name>B<_>I<binary-version>B<_>I<arch>B<.changes> + +para uma compilação que inclua B<any> + +=item I<source-name>B<_>I<binary-version>B<_>B<all.changes> + +caso contrário para uma compilação que inclua B<all> + +=item I<source-name>B<_>I<source-version>B<_>B<source.changes>. + +caso contrário para uma compilação que inclua B<source> + +=back + +Muitas opções do B<dpkg-buildpackage> são reencaminhadas para B<dpkg-genchanges>. + +=item B<8.> + +Corre o hook B<postclean> e se B<-tc> ou B<--post-clean> for especificado, irá chamar B<fakeroot debian/rules clean> outra vez. + +=item B<9.> + +Chama B<dpkg-source --after-build>. + +=item B<10.> + +Corre o hook B<check> e chama um verificados de pacote para o ficheiro B<.changes> (se um comando for especificado em B<DEB_CHECK_COMMAND> ou com B<--check-command>). + +=item B<11.> + +Corre o hook B<sign> e assina usando o backend OpenPGP (desde que não seja uma compilação NÃO-LANÇADA, ou se B<--no-sign> for especificado) para assinar o ficheiro B<.dsc> (se algum, a menos que B<-us> ou B<--unsigned-source> sejam especificados), o ficheiro B<.buildinfo> (a menos que B<-ui>, B<--unsigned-buildinfo>, B<-uc> ou B<--unsigned-changes> sejam especificados) e os ficheiros B<.changes> (a menos que B<-uc> ou B<--unsigned-changes> sejam especificados). + +=item B<12.> + +Corre o hook B<done>. + +=back + +=head1 OPÇÕES + +Todas as opções longas podem ser especificadas em ambos linha de comandos e no sistema B<dpkg-buildpackage> e nos ficheiros de configuração do utilizador. Cada linha no ficheiro de configuração é ou uma opção (exatamente igual a uma opção de linha de comandos mas sem os hífens iniciais) ou um comentário (se começar com ‘B<#>’). + +=over + +=item B<--build=>I<type> + +Especifica o I<type> de compilação a partir de uma lista separada por vírgulas de componentes (desde dpkg 1.18.5). Todos os componentes especificados são combinados para selecionar o único tipo de compilação a usar, o que implica uma única execução de compilação com um único ficheiro F<changes> gerado. Passado para B<dpkg-genchanges>. + +Os valores permitidos são: + +=over + +=item B<source> + +Compila o pacote fonte. + +B<Nota>: Quando se usa este valor autónomo e se o que você quer é simplesmente (re-)compilar o pacote fonte a partir de uma árvore fonte limpa, usar B<dpkg-source> directamente é sempre uma melhor opção pois não requer que sejam instaladas quaisquer dependências de compilação as quais, caso contrário, são precisas para ser capaz de chamar o alvo B<clean>. + +=item B<any> + +Compila os pacotes binários específicos de arquitectura. + +=item B<all> + +Compila os pacotes binários independentes de arquitectura. + +=item B<binary> + +Compila os pacotes binários independentes e específicos de arquitectura. Isto é um alias para B<any,all>. + +=item B<full> + +Compila tudo. Isto é um alias para B<source,any,all>, e o mesmo que o caso predefinido quando não é especificada nenhuma opção de compilação. + +=back + +=item B<-g> + +Equivalente a B<--build=source,all> (desde dpkg 1.17.11). + +=item B<-G> + +Equivalente a B<--build=source,any> (desde dpkg 1.17.11). + +=item B<-b> + +Equivalente a B<--build=binary> ou B<--build=any,all>. + +=item B<-B> + +Equivalente a B<--build=any>. + +=item B<-A> + +Equivalente a B<--build=all>. + +=item B<-S> + +Equivalente a B<--build=source>. + +=item B<-F> + +Equivalente a B<--build=full>, B<--build=source,binary> ou B<--build=source,any,all> (desde dpkg 1.15.8). + +=item B<--target=>I<target>[,...] + +=item B<--target> I<target>[,...] + +=item B<-T>, B<--rules-target=>I<target>[,...] + +Chama B<debian/rules> I<target> uma vez por cada alvo especificado, após ter configurado o ambiente de compilação (excepto para chamar B<dpkg-source --before-build>), e pára o processo de compilação do pacote aqui (desde dpkg 1.15.0, opção longa desde dpkg 1.18.8, suporte a multi-alvo desde dpkg 1.18.16). Se B<--as-root> for também fornecido, então o comando é executado como root (veja B<--root-command>). Note que alvos conhecidos que são obrigados a correr como root não precisam desta opção (isto é, os alvos B<clean>, B<binary>, B<binary-arch> e B<binary-indep>). + +=item B<--as-root> + +Apenas significativo junto com B<--target> (desde dpkg 1.15.0). Requer que o alvo seja corrido com direitos de root. + +=item B<-si> + +=item B<-sa> + +=item B<-sd> + +=item B<-v>I<version> + +=item B<-C>I<changes-description> + +=item B<-m>I<maintainer-address> + +=item B<-e>I<maintainer-address> + +Passado sem alterações ao B<dpkg-genchanges>. Veja o seu manual. + +=item B<--build-by=>I<maintainer-address> + +=item B<--source-by=>I<maintainer-address> (desde dpkg 1.21.10) + +Passa como B<-m> ao B<dpkg-genchanges>. Veja o seu manual. + +=item B<--release-by=>I<maintainer-address> + +=item B<--changed-by=>I<maintainer-address> (desde dpkg 1.21.10) + +Passa como B<-e> ao B<dpkg-genchanges>. Veja o seu manual. + +=item B<-a>, B<--host-arch> I<architecture> + +Especifica a arquitectura Debian para qual compilamos (opção longa desde dpkg 1.17.17). A arquitectura da máquina onde compilamos é determinada automaticamente, e é também a predefinida para a máquina anfitriã. + +=item B<-t>, B<--host-type> I<gnu-system-type> + +Especifica o tipo de sistema GNU para qual compilamos (opção longa desde dpkg 1.17.17). Pode ser usado no lugar de B<--host-arch> ou como um complemento para sobrepor o tipo de sistema GNU predefinido da arquitectura Debian anfitriã. + +=item B<--target-arch> I<architecture> + +Especifica a arquitectura Debian para que os binários são compilados (desde dpkg 1.17.17). O valor predefinido é o da máquina anfitriã. + +=item B<--target-type> I<gnu-system-type> + +Especifica o tipo de sistema GNU para que os binários são compilados (desde dpkg 1.17.17). Pode ser usado no lugar de B<--target-arch> ou como um complemento para sobrepor o tipo de sistema GNU predefinido da arquitectura Debian do alvo. + +=item B<-P>, B<--build-profiles=>I<profile>[B<,>...] + +Especifica os perfil(es) que compilamos, como uma lista separada por vírgulas (desde dpkg 1.17.2, opção longa desde dpkg 1.18.8). O comportamento predefinido é compilar para nenhum perfil específico. Também os define (como uma lista separada por espaços) como a variável de ambiente B<DEB_BUILD_PROFILES> o que permite, por exemplo, ficheiros B<debian/rules> usarem esta informação para compilações condicionais. + +=item B<-j>, B<--jobs>[=I<jobs>|B<auto>] + +Especifica se o número de trabalhos permitidos para serem corridos em simultâneo (desde dpkg 1.14.7, opção longa desde dpkg 1.18.8). O número de trabalhos correspondente ao número de processadores online se B<auto> for especificado (desde dpkg 1.17.10), ou número ilimitado se I<jobs> não for especificado. O comportamento predefinido é B<auto> (desde dpkg 1.18.11) em modo não-forçado (desde dpkg 1.21.10), e como tal é sempre mais seguro usar com qualquer pacote incluindo aqueles que não seguros para compilação paralela. Definir o número de trabalhos para B<1> irá restaurar a execução em série. + +Irá adicionar B<parallel=>I<jobs> ou B<parallel> à variável de ambiente B<DEB_BUILD_OPTIONS> que permite a ficheiros debian/rules optarem por usar esta informação para os seus próprios objectivos. O valor B<jobs> irá sobrepor a opção B<parallel=>I<jobs> ou B<parallel> na variável de ambiente B<DEB_BUILD_OPTIONS>. Note que o valor B<auto> irá ser substituído pelo número real de processadores actuais activos, e como tal, não será propagado para nenhum processo filho. Se o número de processadores online não poder ser deduzido, então o código ira cair para o uso de execução em série (desde dpkg 1.18.15), no entanto isto apenas deverá acontecer em sistemas exóticos e não suportados. + +=item B<-J>, B<--jobs-try>[=I<jobs>|B<auto>] + +Esta opção (desde dpkg 1.18.2, opção longa desde dpkg 1.18.8) é equivalente a B<-j> em cima. + +Como o comportamento do B<-j> alterou no dpkg 1.21.10 para o modo opt-in, você pode usar esta opção se precisar de garantir semânticas entre séries de lançamento do dpkg. + +=item B<--jobs-force>[=I<jobs>|B<auto>] + +Esta opção (desde dpkg 1.21.10) é equivalente à opção B<--jobs> excepto que irá activar o modo paralelo forçado, ao adicionar a opção B<make> B<-j> com o número computado de trabalhos em paralelo para a variável de ambiente B<MAKEFLAGS>. + +Isto deverá causar que todas as invocações make subsequentes herdam a opção assim forçando a definição paralela no empacotamento (e possivelmente o sistema de compilação do autor se isso usar L<make(1)>) independentemente do seu suporte para compilações paralelas, o que pode causar falhas na compilação. + +B<Nota>: Qualquer Makefile que não seja seguro-paralelo deve ser considerado defeituoso. Estes devem ou tornados seguro-paralelo, ou marcados como não seguros com o alvo L<make(1)> B<.NOTPARALLEL>. + +=item B<-D>, B<--check-builddeps> + +Verifica dependências e conflitos de compilação; aborta se não satisfeitos (opção longa desde dpkg 1.18.8). Este é o comportamento predefinido. + +=item B<-d>, B<--no-check-builddeps> + +Não verifica dependências e conflitos de compilação (opção longa desde dpkg 1.18.8). + +=item B<--ignore-builtin-builddeps> + +Não verifica dependências de compilação embutidas e conflitos (desde dpkg 1.18.2). Estas as dependências de compilação implícitas e específicas da distribuição requeridas num ambiente de compilação, o chamado conjunto de pacotes Build-Essential. + +=item B<--rules-requires-root> + +Não respeita o campo B<Rules-Requires-Root>, caindo para o seu valor de predefinição antiga (desde dpkg 1.19.1). + +=item B<-nc>, B<--no-pre-clean> + +Não limpa a árvore fonte antes de compilar (opção longa desde dpkg 1.18.8). Implica B<-b> se nada mais foi seleccionado entre B<-F>, B<-g>, B<-G>, B<-B>, B<-A> ou B<-S>. Implica B<-d> com B<-S> (desde dpkg 1.18.0). + +=item B<--pre-clean> + +Limpa a árvore fonte antes de compilar (desde dpkg 1.18.8). Este é o comportamento predefinido. + +=item B<-tc>, B<--post-clean> + +Limpa a árvore fonte (usando I<gain-root-command> B<debian/rules clean>) após o pacote ter sido compilado (opção longa desde dpkg 1.18.8). + +=item B<--no-post-clean> + +Não limpa a árvore fonte após o pacote ter sido compilado (desde dpkg 1.19.1). Este é o comportamento predefinido. + +=item B<--sanitize-env> + +Higieniza o ambiente de compilação (desde dpkg 1.20.0). Isto irá repor ou remover variáveis de ambiente, umask, e quaisquer outros atributos de processo que poderiam caso contrário afectar adversamente a compilação dos pacotes. Porque o ponto de entrada oficial para compilar pacotes é B<debian/rules>, os pacotes não podem confiar que estas definições estejam no lugar, e assim devem funcionar mesmo quando elas não estão. O que há a higienizar é específico do fornecedor. + +=item B<-r>, B<--root-command=>I<gain-root-command> + +Quando o B<dpkg-buildpackage> precisa de executar parte do processo de compilação como root, prefixa o comando que executa com I<gain-root-command> se foi especificado um (opção longa desde dpkg 1.18.8). Caso contrário, se nenhum foi especificado, será usado por predefinição o B<fakeroot>, se o comando estiver presente. I<gain-root-command> deverá começar com o nome de um programa presente na B<PATH> e receberá como argumentos o nome do comando real a correr e os argumentos que este deve receber. O I<gain-root-command> pode incluir parâmetros (têm se ser separados por espaços) mas não meta-caracteres da shell. O I<gain-root-command>pode ser tipicamente B<fakeroot>, B<sudo>, B<super> ou B<really>. O B<su> não é apropriado, pois ele só pode invocar a shell do utilizador com B<-c> em vez de passar argumentos individualmente aos comandos que corre. + +=item B<-R>, B<--rules-file=>I<rules-file> + +Compilar um pacote Debian geralmente involve invocar B<debian/rules> como um comando com vários parâmetros standard (desde dpkg 1.14.17, opção longa desde dpkg 1.18.8). Com esta opção é possível usar outra invocação de programa para compilar o pacote (pode incluir parâmetros separados por espaços). Em alternativa pode ser usado para executar o ficheiro de regras standard com outro programa make (por exemplo ao usar B</usr/local/bin/make -f debian/rules> como I<rules-file>). + +=item B<--check-command=>I<check-command> + +Comando usado para verificar o próprio ficheiro B<.changes> e qualquer artefacto de compilação referenciado no ficheiro (desde dpkg 1.17.6). O comando deve receber o nome de caminho de B<.changes> como um argumento. Este comando é geralmente o B<lintian>. + +=item B<--check-option=>I<opt> + +Passa a opção I<opção> ao I<comando-de-verificação> especificado com B<DEB_CHECK_COMMAND> ou B<--check-command> (desde dpkg 1.17.6). Pode ser usado várias vezes. + +=item B<--hook->I<hook-name>B<=>I<hook-command> + +Define o código shell especificado I<hook-command> como o hook I<hook-name>, o qual vai correr nos tempos especificados nos passos de execução (desde dpkg 1.17.6). Os hooks irão sempre ser executados mesmo que a acção seguinte não seja executada (excepto para o hook B<binary>). Todos os hooks irão correr no directório fonte desempacotado. + +Alguns hooks podem receber informação adicional através de variáveis de ambiente (desde dpkg 1.22.0). Todos os hooks obtêm o nome de hook na variável de ambiente B<DPKG_BUILDPACKAGE_HOOK_NAME> (desde dpkg 1.22.0). + +B<Nota>: Os hooks podem afectar o processo de compilação, e causar falhas ao compilar se os seus comandos falharem, portanto esteja atento a consequências indesejadas. + +Os I<nome-de-hook> actualmente suportados são: + +=over + +=item B<preinit> + +=item B<init> + +=item B<preclean> + +=item B<source> + +Obtém B<DPKG_BUILDPACKAGE_HOOK_SOURCE_OPTIONS> com as listas de opções separadas-por-espaços que serão passadas à chamada B<dpkg-source>. + +=item B<build> + +Obtém B<DPKG_BUILDPACKAGE_HOOK_BUILD_TARGET> com o nome do alvo de compilação B<debian/rules> chamado, mas apenas se chamado. + +=item B<binary> + +Obtém B<DPKG_BUILDPACKAGE_HOOK_BINARY_TARGET> com o nome de alvo binário B<debian/rules> chamado, mas apenas se chamado. + +=item B<buildinfo> + +Obtém B<DPKG_BUILDPACKAGE_HOOK_BUILDINFO_OPTIONS> com as listas de opções separadas-por-espaços que serão passadas à chamada B<dpkg-genbuildinfo>. + +=item B<changes> + +Obtém B<DPKG_BUILDPACKAGE_HOOK_CHANGES_OPTIONS> com as listas de opções separadas-por-espaços que serão passadas à chamada B<dpkg-genchanges>. + +=item B<postclean> + +=item B<check> + +Obtém B<DPKG_BUILDPACKAGE_HOOK_CHECK_OPTIONS> com as listas de opções separadas-por-espaços que serão passadas à chamada do comando de verificação. + +=item B<sign> + +=item B<done> + +=back + +O I<comando-hook> suporta as seguintes strings de formato de substituição, que lhes serão aplicadas antes da execução. + +=over + +=item B<%%> + +Um único caracteres %. + +=item B<%a> + +Um valor booleano (0 ou 1), que representa se a seguinte acção foi executada. + +=item B<%p> + +O nome do pacote fonte. + +=item B<%v> + +A versão do pacote fonte + +=item B<%s> + +A versão do pacote fonte (sem a época). + +=item B<%u> + +A versão do autor. + +=back + +=item B<--buildinfo-file=>I<filename> + +Define o I<nome-ficheiro> para o ficheiro B<.buildinfo> gerado (desde dpkg 1.21.0). + +=item B<--buildinfo-option=>I<opt> + +Passa a opção I<opt> ao B<dpkg-genbuildinfo> (desde dpkg 1.18.11). Pode ser usado várias vezes. + +=item B<--sign-backend=>I<sign-backend> + +Especifica uma interface backend OpenPGP a usar quando se invoca o I<sign-command> (desde dpkg 1.21.10). + +A predefinição é B<auto>, onde o melhor backend actual disponível irá ser usado. Os backends OpenPGP específicos suportados em ordem de preferência são: + +=over 4 + +=item B<sop> + +(qualquer implementação em conformidade com Stateless OpenPGP) + +=item B<sq> + +(de Sequoia-PGP) + +=item B<gpg> + +(de GnuPG) + +=back + +=item B<-p>, B<--sign-command=>I<sign-command> + +Quando B<dpkg-buildpackage> precisa de executar comando backend OpenPGP para assinar um ficheiro de controle de fonte (B<.dsc>), um ficheiro B<.buildinfo> ou um ficheiro B<.changes> irá correr I<sign-command> (procurando na B<PATH> se necessário) em vez do predefinido ou auto-detectado comando backend (opção longa desde dpkg 1.18.8). O I<sign-command> irá obter todos os argumentos específicos de backend de acordo com o B<--sign-backend> selecionado. I<sign-command> não deve conter espaços ou outros meta-caracteres de shell. + +=item B<-k>, B<--sign-keyid=>I<key-id> + +=item B<--sign-key=>I<key-id> + +Especifica um ID-chave OpenPGP (seja uma impressão digital ou um ID de utilizador) para a chave secreta a usar ao assinar pacotes (B<--sign-key> desde dpkg 1.18.8, B<--sign-keyid> desde dpkg 1.21.10). + +=item B<--sign-keyfile=>I<key-file> + +Especifica um I<key-file> OpenPGP que contem a chave secreta usada quando assinar pacotes (desde dpkg 1.21.10). + +B<Nota>: Por razões de segurança é melhor o I<key-file> ser mantido bloqueado com uma palavra passe. + +=item B<-us>, B<--unsigned-source> + +Não assina o pacote fonte (opção longa desde dpkg 1.18.8). + +=item B<-ui>, B<--unsigned-buildinfo> + +Não assina o ficheiro B<.buildinfo> (desde dpkg 1.18.19). + +=item B<-uc>, B<--unsigned-changes> + +Não assina os ficheiros B<.buildinfo> e B<.changes> (opção longa desde dpkg 1.18.8). + +=item B<--no-sign> + +Não assina nenhum ficheiro, isto inclui o pacote fonte, o ficheiro B<.buildinfo> e o ficheiro B<.changes> (desde dpkg 1.18.20). + +=item B<--force-sign> + +Força o assinar dos ficheiros resultantes (desde dpkg 1.17.0), independentemente de B<-us>, B<--unsigned-source>, B<-ui>, B<--unsigned-buildinfo>, B<-uc>, B<--unsigned-changes> ou de outras heurísticas internas. + +=item B<-sn> + +=item B<-ss> + +=item B<-sA> + +=item B<-sk> + +=item B<-su> + +=item B<-sr> + +=item B<-sK> + +=item B<-sU> + +=item B<-sR> + +=item B<-i>, B<--diff-ignore>[=I<regex>] + +=item B<-I>, B<--tar-ignore>[=I<pattern>] + +=item B<-z>, B<--compression-level=>I<level> + +=item B<-Z>, B<--compression=>I<compressor> + +Passado sem alterações ao B<dpkg-source>. Veja o seu manual. + +=item B<--source-option=>I<opt> + +Passa a opção I<opção> ao B<dpkg-source> (desde dpkg 1.15.6. Pode ser usado várias vezes. + +=item B<--changes-file=>I<filename> + +Define o I<nome-ficheiro> para o ficheiro B<.changes> gerado (desde dpkg 1.21.0). + +=item B<--changes-option=>I<opt> + +Passa a opção I<opção> ao B<dpkg-genchanges> (desde dpkg 1.15.6). Pode ser usado várias vezes. + +=item B<--admindir=>I<dir> + +=item B<--admindir> I<dir> + +Altera a localização da base de dados do B<dpkg> (desde dpkg 1.14.0). A localização predefinida é I<%ADMINDIR%>. + +=item B<-?>, B<--help> + +Mostra a mensagem de utilização e termina. + +=item B<--version> + +Mostra a versão e termina. + +=back + +=head1 AMBIENTE + +=head2 Ambiente externo + +=over + +=item B<DEB_CHECK_COMMAND> + +Se definido, será usado como o comando para verificar o ficheiro B<.changes> (desde dpkg 1.17.6). Sobreposto pela opção B<--check-command>. + +=item B<DEB_SIGN_KEYID> + +Se definido, será usado para assinar os ficheiros B<.changes>, B<.buildinfo> e B<.dsc> (desde dpkg 1.17.2). Sobreposto pela opção B<--sign-key>. + +=item B<DEB_SIGN_KEYFILE> + +Se definido, será usado para assinar os ficheiros B<.changes>, B<.buildinfo> e B<.dsc> (desde dpkg 1.21.10). Sobreposto pela opção B<--sign-keyfile>. + +=item B<DEB_BUILD_OPTIONS> + +Se definido, irá conter uma lista de opções separadas por espaços que afectam o comportamento de algumas ferramentas do dpkg envolvidas na compilação de pacote, e pode afectar o processo de compilação se o código em I<debian/rules> as honrar. + +O seguinte são opções conhecidas e suportadas pelas ferramentas do dpkg, outras opções honradas por F<debian/rules> podem ser definidas por políticas específicas da distribuição. + +=over + +=item B<parallel=>I<N> + +O F<debian/rules> no empacotamento pode usar esta opção para definir o processo de compilação a usar I<N> trabalhos em paralelo. É sobreposto pelas opções B<--jobs> e B<--jobs-force>. + +=item B<nocheck> + +B<dpkg-buildpackage> irá ignorar a variável B<DEB_CHECK_COMMAND>. Não é esperado que o F<debian/rules> no empacotamento corra suites de teste durante a compilação. + +=item B<noopt> + +Se F<debian/rules> chamar B<dpkg-buildflags> para definir as bandeiras de compilação, essas serão definidas para não activar nenhumas optimizações. + +=item B<nostrip> + +O F<debian/rules> no empacotamento deve assegurar que os objectos não ficam com a sua informação de depuração removida. Se F<debian/rules> incluir o fragmento de make B<mk/buildtools.mk> a variável de make B<STRIP> irá respeitar esta opção. + +=item B<terse> + +B<dpkg-buildpackage> irá acrescentar a bandeira B<--no-print-directory> L<make(1)> à variável de ambiente B<MAKEFLAGS>. O F<debian/rules> no empacotamento deve reduzir nos detalhes, não sendo completamente silencioso. + +=back + +=item B<DEB_BUILD_PROFILES> + +Se definido, será usado como perfil(es) de compilação activos para o pacote a ser compilado (desde dpkg 1.17.2). É uma lista separada por espaços de nomes de perfis. Sobreposto pela opção B<-P>. + +=item B<DPKG_COLORS> + +Define o modo de cor (desde dpkg 1.18.5). Os valores actualmente aceites são: B<auto> (predefinido), B<always> e B<never>. + +=item B<DPKG_NLS> + +Se definida, será usada para decidir se deve activar o Suporte a Linguagem Nativa. Também como conhecido como suporte de internacionalização (ou i18n) (desde dpkg 1.19.0). Os valores aceites são B<0> e B<1> (predefinição). + +=back + +=head2 Ambiente interno + +Mesmo que B<dpkg-buildpackage> exporte algumas variáveis, o B<debian/rules> não deve confiar na sua presença e deve em vez disso usar a interface respectiva para obter os valore que precisa, porque esse ficheiro é o ponto de entrada principal para compilar pacotes e deve ser suportado poder fazê-lo sozinho. + +=over + +=item B<DEB_BUILD_*> + +=item B<DEB_HOST_*> + +=item B<DEB_TARGET_*> + +B<dpkg-architecture> é chamado com os parâmetros B<-a> e B<-t> reencaminhados. Qualquer variável que seja resultante da sua opção B<-s> é integrada no ambiente de compilação. + +=item B<DEB_RULES_REQUIRES_ROOT> + +This variable is set to the value obtained from the B<Rules-Requires-Root> field, the dpkg-build-api level or from the command-line. When set, it will be a valid value for the B<Rules-Requires-Root> field. It is used to notify B<debian/rules> whether the B<rootless-builds.txt> specification is supported. + +=item B<DEB_GAIN_ROOT_CMD> + +Esta variável é definida para I<gain-root-command> quando o campo B<Rules-Requires-Root> é definido para um valor diferente de B<no> e B<binary-targets>. + +=item B<SOURCE_DATE_EPOCH> + +Esta variável é definida à marca temporal de Unix desde a época da última entrada em I<debian/changelog>, se não estiver já definida. + +=back + +=head1 FICHEIROS + +=over + +=item I<%PKGCONFDIR%/buildpackage.conf> + +Ficheiro de configuração geral do sistema + +=item I<$XDG_CONFIG_HOME/dpkg/buildpackage.conf> ou + +=item I<$HOME/.config/dpkg/buildpackage.conf> + +Ficheiro de configuração do utilizador. + +=back + +=head1 NOTAS + +=head2 As bandeiras de compilador já não são exportadas + +Entre dpkg 1.14.17 e 1.16.1, B<dpkg-buildpackage> exportava as bandeiras de compilador (B<CFLAGS>, B<CXXFLAGS>, B<FFLAGS>, B<CPPFLAGS> e B<LDFLAGS>) com valores como retornados por B<dpkg-buildflags>. Isto já não acontece. + +=head2 Metas de compilação predefinidas + +B<dpkg-buildpackage> está a usar os alvos B<build-arch> e B<build-indep> desde dpkg 1.16.2. Esses alvos são assim obrigatórios. Mas para evitar ruturas de pacotes existentes, e facilitar a transição, se o pacote fonte não compilar ambos pacotes binários independentes e dependentes da arquitectura (desde dpkg 1.18.8) irá regressar ao uso de alvo B<build> se B<make -f debian/rules -qn> I<build-target> retornar 2 como código de saída. + +=head1 SEGURANÇA + +A compilação de pacotes binário ou fonte só deve ser executada sobre dados de fonte de confiança. + +=head1 BUGS + +Deverá ser possível especificar espaços e meta-caracteres de shell e argumentos iniciais para I<gain-root-command> e I<sign-command>. + +=head1 VEJA TAMBÉM + +I<%PKGDOCDIR%/spec/rootless-builds.txt>, L<dpkg-source(1)>, L<dpkg-architecture(1)>, L<dpkg-buildflags(1)>, L<dpkg-genbuildinfo(1)>, L<dpkg-genchanges(1)>, L<fakeroot(1)>, L<lintian(1)>, L<https://datatracker.ietf.org/doc/draft-dkg-openpgp-stateless-cli/>, L<sq(1)>, L<gpg(1)>. + + +=head1 TRADUÇÃO + +Américo Monteiro + +Se encontrar algum erro na tradução deste documento, por favor comunique para +Américo Monteiro <a_monteiro@gmx.com>. |