
        *****************************************************
        *           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)

The machine the compiler is building for, or the emulator will run code for.  This is only needed when building a cross-toolchain (or emulator), one that will be built on the build architecture, to be run on the host architecture, and that itself will build (or run emulated) code for the target architecture.

=item Arquitectura Debian

The Debian architecture string, used in binary packages, which specifies the binary tree in a package repository.

Examples: i386, sparc, hurd-i386.

=item Tuple de arquitectura Debian

A Debian architecture tuple is the fully qualified architecture with all its components spelled out.  This differs with Debian architectures in that at least the I<cpu> component does not embed the I<abi>.  The current tuple has the form I<abi>-I<libc>-I<os>-I<cpu>.

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

=item Wildcard de arquitectura Debian

Um wildcard de arquitectura Debian é uma string especial de arquitectura que irá corresponder a qualquer arquitectura real que faça parte dela. O formato geral é um tuple de arquitectura Debian com quatro ou menos elementos, e com pelo menos um deles a ser B<any>. Elementos em falta no tuple são prefixados implicitamente como B<any>, e assim os seguintes pares são equivalentes:

=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

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

The CPU part never contains a hyphen, while the system part might itself contain a hyphen to separate a kernel from its general ABI, where the general ABI might contain both runtime (such as libc) and executable ABI specifiers joined without a hyphen.

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

=item multiarch triplet

The clarified GNU system type, used for filesystem paths.  This triplet does not change even when the baseline ISA gets bumped, so that the resulting paths are stable over time.  The only current difference with the GNU system type is that the CPU part for i386 based systems is always i386.

Examples: i386-linux-gnu, x86_64-linux-gnu.  Example paths: /lib/powerpc64le-linux-gnu/, /usr/lib/i386-kfreebsd-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<TERMS> 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<Note>: If you are not building tools that need to run during the build, these are probably not the variables you are looking for.  Please see L</TERMS> section for the meanings of these terms.

=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<Note>: If you are not building cross-toolchains (or emulators), these are probably not the variables you are looking for.  Please see L</TERMS> section for the meanings of these terms.

=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>.
