diff options
Diffstat (limited to 'man/pt/dpkg-architecture.pod')
-rw-r--r-- | man/pt/dpkg-architecture.pod | 461 |
1 files changed, 461 insertions, 0 deletions
diff --git a/man/pt/dpkg-architecture.pod b/man/pt/dpkg-architecture.pod new file mode 100644 index 0000000..7403121 --- /dev/null +++ b/man/pt/dpkg-architecture.pod @@ -0,0 +1,461 @@ + + ***************************************************** + * 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. + +The build architecture is always determined by either the B<DEB_BUILD_ARCH> variable if set (and B<--force> not being specified) or by an external call to L<dpkg(1)>, and cannot be set at the command line. + +You can specify the host architecture by providing one or both of the options B<--host-arch> and B<--host-type>, otherwise the B<DEB_HOST_ARCH> variable is used if set (and B<--force> not being specified). The default is determined by an external call to L<gcc(1)>, or the same as the build architecture if B<CC> or gcc are both not available. One out of B<--host-arch> and B<--host-type> is sufficient, the value of the other will be set to a usable default. Indeed, it is often better to only specify one, because B<dpkg-architecture> will warn you if your choice does not match the default. + +=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> + +Values set by existing environment variables with the same name as used by the scripts are honored (i.e. used by B<dpkg-architecture>), except if this force flag is present. This allows the user to override a value even when the call to B<dpkg-architecture> is buried in some other script (for example 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 para compilar código (ou correr emulado) para a arquitectura alvo. + +=item Arquitectura Debian + +A string de arquitectura Debian, a qual especifica a árvore binária no arquivo FTP. Exemplos: i386, sparc, hurd-i386. + +=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 + +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 + +Uma string de especificação de arquitectura consiste de duas partes separadas por um hífen: cpu e sistema. Exemplos: i586-linux-gnu, sparc-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. Exemplos: i386-linux-gnu, x86_64-linux-gnu. Exemplos de caminhos: /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. + +=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). + +=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-alpha + + dpkg-architecture -amips -elinux-mips + +=back + +Verifica se a arquitectura actual ou da máquina especificada é um sistema Linux. + +=over + + dpkg-architecture -ilinux-any + + dpkg-architecture -ai386 -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),alpha) + [...] + 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),alpha) + [...] + 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>. |