
        *****************************************************
        *           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-architecture - define e determina a arquitectura para compilação de pacotes

=head1 RESUMO

B<dpkg-architecture> [I<option>...] [I<command>]

=head1 DESCRIÇÃO

B<dpkg-architecture> disponibiliza uma habilidade para determinar e definir a arquitectura de compilação e da máquina para compilação de pacotes.

A arquitectura de compilação é sempre determinada seja ou pela variável B<DEB_BUILD_ARCH> se definida (e se B<--force> não for especificada) ou por uma chamada externa ao L<dpkg(1)>, e não pode ser definida na linha de comandos.

Você pode especificar a arquitectura da máquina ao fornecer uma ou ambas as opções B<--host-arch> e B<--host-type>, caso contrário é usada a variável B<DEB_HOST_ARCH> se definida (e não sendo especificado B<--force>). A predefinição é determinada por uma chamada externa ao L<gcc(1)>, ou o mesmo como a arquitectura de compilação se B<CC> ou gcc estiverem ambos não disponíveis. Um de B<--host-arch> e B<--host-type> é suficiente, o valor do outro será definido para uma predefinição utilizável. De facto, é muitas vezes melhor apenas especificar um, porque B<dpkg-architecture> vai avisa-lo se a sua escolha não corresponder ao predefinido.

=head1 COMANDOS

=over 

=item B<-l>, B<--list>

Escreve as variáveis de ambiente, uma em cada linha, no formato I<VARIÁVEL=valor>. Esta é a acção predefinida.

=item B<-e>, B<--equal> I<architecture>

Verifica a igualdade da arquitectura (desde dpkg 1.13.13). Compara a actual ou a arquitectura de maquina Debian especificada com I<architecture>, para verificar se são iguais. Esta acção não irá expandir as wildcards de arquitectura. O comando termina com um estado de saída 0 de corresponderem, 1 se não corresponderem.

=item B<-i>, B<--is> I<architecture-wildcard>

Verifica a identidade da arquitectura (desde dpkg 1.13.13). Compara a actual ou a arquitectura de máquina Debian especificada com I<architecture-wildcard> após a ter expandido como uma wildcard de arquitectura, para verificar se correspondem. O comando termina com estado de saída 0 se corresponderem, 1 se não corresponderem.

=item B<-q>, B<--query> I<variable-name>

Escreve o valor de uma variável única.

=item B<-s>, B<--print-set>

Escreve um comando de exportação. Isto pode ser usado para definir as variáveis de ambiente usando a shell POSIX ou make B<eval>, dependendo do formato dos resultados.

=item B<-u>, B<--print-unset>

Escreve um comando semelhante ao B<--print-set> mas para limpar o valor de todas as variáveis.

=item B<-c>, B<--command> I<command-string>

Executa uma I<command-string> num ambiente que tem todas as variáveis definidas para o determinado valor.

Se a I<string-de-comando> conter meta-caracteres de shell, então será invocada através da shell limite do sistema.

=item B<-L>, B<--list-known>

Escreve uma lista de nomes de arquitecturas válidos. Possivelmente restringidos por uma ou mais das opções de correspondência B<--match-wildcard>, B<--match-bits> ou B<--match-endian> (desde dpkg 1.17.14).

=item B<-?>, B<--help>

Mostra a mensagem de utilização e termina.

=item B<--version>

Mostra a versão e termina.

=back

=head1 OPÇÕES

=over 

=item B<-a>, B<--host-arch> I<architecture>

Define a arquitectura da máquina Debian

=item B<-t>, B<--host-type> I<gnu-system-type>

Define o tipo de sistema GNU da máquina.

=item B<-A>, B<--target-arch> I<architecture>

Define a arquitectura Debian de destino (desde dpkg 1.17.14).

=item B<-T>, B<--target-type> I<gnu-system-type>

Define o tipo de sistema GNU do destino (desde dpkg 1.17.14).

=item B<-W>, B<--match-wildcard> I<architecture-wildcard>

Restringe as arquitectura listadas por B<--list-known> a aquelas que correspondem à wildcard de arquitectura especificada (desde dpkg 1.17.14).

=item B<-B>, B<--match-bits> I<architecture-bits>

Restringe as arquitectura listadas por B<--list-known> a aquelas com os bits de CPU especificados (desde dpkg 1.17.14). Seja B<32> ou B<64>.

=item B<-E>, B<--match-endian> I<architecture-endianness>

Restringe as arquitectura listadas por B<--list-known> a aquelas com a categoria endian especificada (desde dpkg 1.17.14). Seja B<little> ou B<big>.

=item B<--print-format> I<format>

Define o formato de resultados para B<--print-set> e B<--print-unset> (desde dpkg 1.20.6), para ou B<shell> (predefinição) ou B<make>.

=item B<-f>, B<--force>

Os valores definidos pelas variáveis de ambiente existentes com os mesmos nomes usados como usados pelos scripts são respeitados (isto é, usados por B<dpkg-architecture>), excepto se esta bandeira de forçar estiver presente. Isto permite ao utilizador sobrepor um valor mesmo quando a chamada a B<dpkg-architecture> está enterrada em algum outro script (por exemplo L<dpkg-buildpackage(1)>).

=back

=head1 TERMOS

=over 

=item máquina de compilação

A máquina onde o pacote é compilado.

=item máquina anfitriã

A máquina para onde o pacote é compilado.

=item máquina destino (alvo)

A maquina para a qual o compilador foi construído, ou o que emulador que irá correr código para. Isto é apenas necessário quando se compila ferramenta-corrente-cruzada (ou emulador), uma que será compilada sobre a arquitectura de compilação, para ser corrida na arquitectura anfitriã, e que ela própria irá compilar código (ou correr emulado) para a arquitectura alvo.

=item Arquitectura Debian

A Debian architecture describes a “machine” (considering it as an abstraction not necessarily tied to an actual physical device)  representing a specific execution environment, including its CPU and attributes (such as endianness and bits), an operating system (usually a kernel, but other paradigms using userland services are possible) and its interfaces towards userland including the executable format and their ABI, and a libc library and its ABI.

The special architecture B<all> denotes an architecture independent execution environment, used for things such as shell and Perl scripts or documentation.

A Debian architecture is used in binary package metadata and filenames (which specifies the binary tree in a package repository), and can appear in package relationships.

An architecture must start with an alphanumeric character (“0-9a-zA-Z”), and then gets followed by alphanumeric or dash (“-”) characters.

Examples: amd64, i386, sparc64, hurd-amd64, musl-linux-riscv64.

=item Tuple de arquitectura Debian

Um tuple de arquitectura Debian é a arquitectura totalmente qualificada com todos os seus componentes soletrados. Isto difere das arquitecturas Debian em que pelo menos o componente I<cpu> não trás embutido o I<abi>. O tuple actual tem o formato I<abi>-I<libc>-I<os>-I<cpu>.

Exemplos: base-gnu-linux-amd64, eabihf-musl-linux-arm.

=item Wildcard de arquitectura Debian

A Debian architecture wildcard is a special architecture that acts as a pattern and will match any ”machine” architecture being part of it (except for B<all>).

The general form is a Debian architecture tuple with four or less elements, and with at least one of them being B<any>.  Missing elements of the tuple are prefixed implicitly as B<any>, and thus the following pairs are equivalent:

=over 

=item B<any>-B<any>-B<any>-B<any> = B<any>

=item B<any>-B<any>-I<os>-B<any> = I<os>-B<any>

=item B<any>-I<libc>-B<any>-B<any> = I<libc>-B<any>-B<any>

=back

Exemplos: linux-any, any-i386, hurd-any, eabi-any-any-arm, musl-any-any.

=item Tipo de sistema GNU

A GNU architecture specification string consisting of two parts separated by a hyphen: CPU and system.

A parte da CPU nunca contém um hífen, enquanto a parte do sistema pode ela própria conter um hífen para separar um kernel da sua ABI geral, onde a ABI geral pode conter ambos especificadores de tempo-de-execução (como a libc) e ABI executável juntos sem um hífen.

Examples: i586-linux-gnu, sparc64-linux-gnu, i686-gnu, x86_64-netbsd.

=item multiarch triplet

O tipo de sistema GNU clarificado, usado para caminhos do sistema de ficheiros. Este triplet não altera mesmo quando a linha base ISA entra em colisão, para que os caminhos resultantes fiquem estáveis com o tempo. A única diferença actual com o tipo de sistema GNU é que a parte de CPU para os sistemas baseados em i386 é sempre i386.

Examples: i386-linux-gnu, x86_64-linux-gnu.  Example paths: /lib/powerpc64le-linux-gnu/, /usr/lib/i386-gnu/.

=back

=head1 VARIÁVEIS

As seguintes variáveis são lidas a partir do ambiente (a menos que B<--force> seja especificado) e definidas por B<dpkg-architecture> (veja a secção B<TERMOS> para uma descrição do esquema de nomeação):

=over 

=item B<DEB_BUILD_ARCH>

A arquitectura Debian da máquina de compilação.

B<Nota>: Se você não está a compilar ferramentas que precisam correr durante a compilação, estas não são provavelmente as variáveis que você procura. Por favor veja a secção L</TERMOS> para o significado destes termos.

=item B<DEB_BUILD_ARCH_ABI>

O nome ABI Debian da máquina de compilação (desde dpkg 1.18.11).

=item B<DEB_BUILD_ARCH_LIBC>

O nome libc Debian da máquina de compilação (desde dpkg 1.18.11).

=item B<DEB_BUILD_ARCH_OS>

O nome de sistema Debian da máquina de compilação (desde dpkg 1.13.2).

=item B<DEB_BUILD_ARCH_CPU>

O nome de CPU de Debian da máquina de compilação (desde dpkg 1.13.2).

=item B<DEB_BUILD_ARCH_BITS>

O tamanho do ponteiro da máquina de compilação (em bits, desde dpkg 1.15.4).

=item B<DEB_BUILD_ARCH_ENDIAN>

A classe endian da máquina de compilação (ittle / big; desde dpkg 1.15.4).

=item B<DEB_BUILD_GNU_CPU>

A parte CPU GNU de B<DEB_BUILD_GNU_TYPE>.

=item B<DEB_BUILD_GNU_SYSTEM>

A parte de system GNU de B<DEB_BUILD_GNU_TYPE>.

=item B<DEB_BUILD_GNU_TYPE>

O tipo de sistema GNU da máquina de compilação.

=item B<DEB_BUILD_MULTIARCH>

O tipo de sistema GNU clarificado da máquina de compilação, usado para caminhos do sistema de ficheiros (desde dpkg 1.16.0).

=item B<DEB_HOST_ARCH>

A arquitectura Debian da máquina anfitriã.

=item B<DEB_HOST_ARCH_ABI>

O nome ABI Debian da máquina anfitriã (desde dpkg 1.18.11).

=item B<DEB_HOST_ARCH_LIBC>

O nome libc Debian da máquina anfitriã (desde dpkg 1.18.11).

=item B<DEB_HOST_ARCH_OS>

O nome de sistema Debian da máquina anfitriã (desde dpkg 1.13.2).

=item B<DEB_HOST_ARCH_CPU>

O nome de CPU de Debian da máquina anfitriã (desde dpkg 1.13.2).

=item B<DEB_HOST_ARCH_BITS>

O tamanho do ponteiro da máquina anfitriã (em bits, desde dpkg 1.15.4).

=item B<DEB_HOST_ARCH_ENDIAN>

A classe endian da máquina anfitriã (ittle / big; desde dpkg 1.15.4).

=item B<DEB_HOST_GNU_CPU>

A parte CPU GNU de B<DEB_HOST_GNU_TYPE>.

=item B<DEB_HOST_GNU_SYSTEM>

A parte de system GNU de B<DEB_HOST_GNU_TYPE>.

=item B<DEB_HOST_GNU_TYPE>

O tipo de sistema GNU da máquina anfitriã.

=item B<DEB_HOST_MULTIARCH>

O tipo de sistema GNU clarificado da máquina anfitriã, usado para caminhos do sistema de ficheiros (desde dpkg 1.16.0).

=item B<DEB_TARGET_ARCH>

A arquitectura Debian da máquina de destino (desde dpkg 1.17.14).

B<Nota>: Se você não está a compilar ferramentas-corrente-cruzada (ou emuladores), estas não são provavelmente as variáveis que você procura. Por favor veja a secção L</TERMOS> para o significado destes termos.

=item B<DEB_TARGET_ARCH_ABI>

O nome ABI Debian da máquina alvo (desde dpkg 1.18.11).

=item B<DEB_TARGET_ARCH_LIBC>

O nome libc Debian da máquina alvo (desde dpkg 1.18.11).

=item B<DEB_TARGET_ARCH_OS>

O nome de sistema Debian da máquina de destino (desde dpkg 1.17.14).

=item B<DEB_TARGET_ARCH_CPU>

O nome de CPU de Debian da máquina de destino (desde dpkg 1.17.14).

=item B<DEB_TARGET_ARCH_BITS>

O tamanho do ponteiro da máquina de destino (em bits, desde dpkg 1.17.14).

=item B<DEB_TARGET_ARCH_ENDIAN>

A classe endian da máquina de destino (ittle / big; desde dpkg 1.17.14).

=item B<DEB_TARGET_GNU_CPU>

A parte CPU GNU de B<DEB_TARGET_GNU_TYPE> (desde dpkg 1.17.14).

=item B<DEB_TARGET_GNU_SYSTEM>

A parte de system GNU de B<DEB_TARGET_GNU_TYPE> (desde dpkg 1.17.14).

=item B<DEB_TARGET_GNU_TYPE>

O tipo de sistema GNU da máquina de destino (desde dpkg 1.17.14).

=item B<DEB_TARGET_MULTIARCH>

O tipo de sistema GNU clarificado da máquina de destino, usado para caminhos do sistema de ficheiros (desde dpkg 1.17.14).

=back

=head1 FICHEIROS

=head2 Tabelas de arquitecturas

Todos estes ficheiros têm de estar presentes para o B<dpkg-architecture> funcionar. A sua localização pode ser sobreposta durante o funcionamento com a variável de ambiente B<DPKG_DATADIR>. Estas tabelas contêm um pseudo-campo B<Version> de formato na sua primeira linha para marcar o seu formato, para que os analisadores possam verificar se o compreendem, tal como "# Version=1.0".

=over 

=item I<%PKGDATADIR%/cputable>

Tabela de nomes de CPU conhecidas e o mapear delas para o seu nome GNU. Formato versão 1.0 (desde dpkg 1.13.2).

=item I<%PKGDATADIR%/ostable>

Tabela de nomes de sistemas operativos conhecidos e o mapear deles para o seu nome GNU. Formato versão 2.0 (desde dpkg 1.18.11).

=item I<%PKGDATADIR%/tupletable>

Mapeamento entre tuples de arquitectura Debian e nomes de arquitectura Debian. Versão de formato 1.0 (desde dpkg 1.18.11).

=item I<%PKGDATADIR%/abitable>

Tabela de sobreposições de atributos ABI de arquitectura Debian. Versão de formato 2.0 (desde dpkg 1.18.11).

=back

=head2 Suporte a empacotamento

=over 

=item I<%PKGDATADIR%/architecture.mk>

Fragmento do Makefile cuja propriedade define e exporta todas as variáveis que o B<dpkg-architecture> gera como resultado (desde dpkg 1.16.1).

=back

=head1 EXEMPLOS

B<dpkg-buildpackage> aceita a opção B<-a> e passa-a para B<dpkg-architecture>. Outros exemplos:

=over 

 CC=i386-gnu-gcc dpkg-architecture -c debian/rules build

 eval $(dpkg-architecture -u)

=back

Verifica se a arquitectura actual ou da máquina especificada é igual a uma arquitectura:

=over 

 dpkg-architecture -elinux-arm64

 dpkg-architecture -ariscv64 -elinux-riscv64

=back

Verifica se a arquitectura actual ou da máquina especificada é um sistema Linux.

=over 

 dpkg-architecture -ilinux-any

 dpkg-architecture -aamd64 -ilinux-any

=back

=head2 Utilização em debian/rules

As variáveis de ambiente definidas pelo B<dpkg-architecture> são passadas para I<debian/rules> como variáveis do make (veja a documentação do make). No entanto, você não deve confiar nelas, porque prejudicam a invocação manual do script. Em vez disso, você deve sempre inicializa-las usando B<dpkg-architecture> com a opção B<-q>. Aqui estão alguns exemplos, que também mostram como você pode melhorar o suporte a compilação cruzada no seu pacote:

Obter o tipo de sistema GNU e reencaminha-lo para ./configure:

=over 

 DEB_BUILD_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_BUILD_GNU_TYPE)
 DEB_HOST_GNU_TYPE ?= $(shell dpkg-architecture -qDEB_HOST_GNU_TYPE)
 [...]
 ifeq ($(DEB_BUILD_GNU_TYPE), $(DEB_HOST_GNU_TYPE))
  confflags += --build=$(DEB_HOST_GNU_TYPE)
  else
   confflags += --build=$(DEB_BUILD_GNU_TYPE) \
                --host=$(DEB_HOST_GNU_TYPE)
 endif
 [...]
 ./configure $(confflags)

=back

Fazer algo apenas para uma arquitectura específica:

=over 

 DEB_HOST_ARCH ?= $(shell dpkg-architecture -qDEB_HOST_ARCH)

 ifeq ($(DEB_HOST_ARCH),arm64)
   [...]
 endif

=back

ou se você apenas precisar de verificar o tipo de CPU ou SO, use as variáveis B<DEB_HOST_ARCH_CPU> ou B<DEB_HOST_ARCH_OS>

Note que você também pode confiar num retalho externo do Makefile para definir apropriadamente todas as variáveis que o B<dpkg-architecture> pode fornecer.

=over 

 include %PKGDATADIR%/architecture.mk

 ifeq ($(DEB_HOST_ARCH),arm64)
   [...]
 endif

=back

Em qualquer dos casos, você nunca deverá usar o B<dpkg --print-architecture> para obter informação de arquitectura durante uma compilação de pacote.

=head1 AMBIENTE

=over 

=item B<DPKG_DATADIR>

Se definida, será usada como o directório de dados do B<dpkg>, onde as tabelas de arquitectura estão localizadas (desde 1.14.17). A predefinição é «%PKGDATADIR%».

=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

=head1 NOTAS

Todos comandos e nomes de opções longos disponíveis apenas desde dpkg 1.17.17.

=head1 VEJA TAMBÉM

L<dpkg-buildpackage(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>.
