table of contents
- bookworm 1.21.22
- testing 1.22.2
- unstable 1.22.4
- experimental 1.22.3
dpkg-buildflags(1) | dpkg suite | dpkg-buildflags(1) |
NOME¶
dpkg-buildflags - retorna flags de compilação para usar durante a compilação de pacotes
RESUMO¶
dpkg-buildflags [option...] [command]
DESCRIÇÃO¶
dpkg-buildflags é uma ferramenta para obter flags de compilação para usar durante a compilação de pacotes Debian.
As flags predefinidas são definidas pelo fornecedor mas podem ser estendidas/sobrepostas de várias maneiras:
- 1.
- de todo o sistema com /etc/dpkg/buildflags.conf;
- 2.
- para o utilizador actual com $XDG_CONFIG_HOME/dpkg/buildflags.conf onde $XDG_CONFIG_HOME usa por predefinição $HOME/.config;
- 3.
- temporarily by the user with environment variables (see section "ENVIRONMENT");
- 4.
- dynamically by the package maintainer with environment variables set via debian/rules (see section "ENVIRONMENT").
Os ficheiros de configuração podem conter quatro tipos de directivas:
- SET flag value
- Sobrescreve a flag chamada flag para ter o valor valor.
- STRIP flag value
- Despoja da flag chamada flag todas as flags de compilação listadas em valor. Desde dpkg 1.16.1.
- APPEND flag value
- Estende a flag chamada flag ao acrescentar as opções dadas em valor. É usado um espaço a preceder o valor acrescentado se o valor da flag actual não estiver vazio.
- PREPEND flag value
- Estende a flag chamada flag ao precede-la com as opções dadas em valor. É acrescentado um espaço ao valor precedido se o valor da flag actual não estiver vazio. Desde dpkg 1.16.1.
Os ficheiros de configuração podem conter comentários nas linhas que começam com um cardinal (#). As linhas vazias também são ignoradas.
Este programa foi introduzido no dpkg 1.15.7.
COMANDOS¶
- --dump
- Escreve na saída standard todas as bandeiras de compilação e os seus valores. Escreve uma bandeira por linha separada do seu valor por um sinal de igual ("flag=value"). Esta é a acção predefinida.
- --list
- Print the list of flags supported by the current vendor (one per line). See the "SUPPORTED FLAGS" section for more information about them.
- --status
- Mostra qualquer informação que possa ser útil para
explicar o comportamento de dpkg-buildflags (desde dpkg 1.16.5):
variáveis de ambiente relevantes, fornecedor actual, estado de
todas as bandeiras de funcionalidades. Também escreve as bandeira
de compilação resultantes com as suas origens.
Isto destina-se a ser corrido a partir de debian/rules, para que os relatórios de compilação mantenham um rasto claro das bandeiras de compilação usadas. Isto pode ser útil para diagnosticar problemas relacionados com elas.
- --export=format
- Escreve na saída standard comandos que podem ser usados para exportar todas as bandeiras de compilação para alguma ferramenta particular. Se o valor format não for fornecido, é assumido sh. Apenas são incluídas bandeiras que comecem com um caractere maiúsculo, as outras são assumidas como não apropriadas para o ambiente. Formatos suportados:
- sh
- Comandos de shell para definir e exportar todas as bandeiras de compilação no ambiente. Os valores das bandeiras são citados para que o resultado esteja pronto para avaliação pela shell.
- cmdline
- Argumentos a passar para a linha de comandos dos programas de compilação para se usar todas as bandeiras de compilação (desde dpkg 1.17.0). Os valores das bandeiras são citados na sintaxe da shell.
- configure
- Este é um nome alternativo antigo para cmdline.
- make
- Faz as directivas definir e exportar todas as bandeiras de compilação no ambiente. O resultado pode ser escrito para o fragmento do Makefile e avaliado usando uma directiva include.
- --get flag
- Escreve o valor da flag na saída standard. Termina com 0 se a flag for conhecida, caso contrário termina com 1.
- --origin flag
- Escreve a origem do valor que é devolvido por --get. Termina com 0 se a flag for conhecida, caso contrário termina com 1. A origem pode ser um dos seguintes valores:
- --query
- Escreve qualquer informação que possa ser útil para
explicar o comportamento do programa: fornecedor actual, variáveis
de ambiente relevantes, áreas de funcionalidades, estado de todas
as bandeiras de funcionalidades, se uma funcionalidade é lidada
como uma predefinição de compilação pelo
compilador (desde dpkg 1.21.14), a as bandeiras de
compilação com as suas origens (desde dpkg 1.19.0).
Por exemplo:
Vendor: Debian Environment: DEB_CFLAGS_SET=-O0 -Wall Area: qa Features: bug=no canary=no Builtins: Area: hardening Features: pie=no Builtins: pie=yes Area: reproducible Features: timeless=no Builtins: Flag: CFLAGS Value: -O0 -Wall Origin: env Flag: CPPFLAGS Value: -D_FORTIFY_SOURCE=2 Origin: vendor
- --query-features area
- Escreve as funcionalidades activadas para uma dada área (desde dpkg
1.16.2). Se a funcionalidade é lidada (mesmo que apenas em algumas
arquitecturas) como predefinição de compilação
pelo compilador, então é escrito um campo Builtin
(desde dpkg 1.21.14). As únicas áreas actualmente
reconhecidas em Debian e derivados são future, qa,
reproducible, sanitize e hardening, veja a
secção ÁREAS DE CARACTERÍSTICAS para
mais detalhes. Termina com 0 se a área é conhecida caso
contrário termina com 1.
O resultado está em formato RFC822, com uma secção por característica. Por exemplo:
Feature: pie Enabled: yes Builtin: yes Feature: stackprotector Enabled: yes
- --help
- Mostra a mensagem de utilização e termina.
- --version
- Mostra a versão e termina.
FLAGS SUPORTADAS¶
- ASFLAGS
- Options for the host assembler. Default value: empty. Since dpkg 1.21.0.
- CFLAGS
- Options for the host C compiler. The default value set by the vendor includes -g and the default optimization level (-O2 usually, or -O0 if the DEB_BUILD_OPTIONS environment variable defines noopt).
- CPPFLAGS
- Options for the host C preprocessor. Default value: empty.
- CXXFLAGS
- Options for the host C++ compiler. Same as CFLAGS.
- OBJCFLAGS
- Options for the host Objective C compiler. Same as CFLAGS. Since dpkg 1.17.7.
- OBJCXXFLAGS
- Options for the host Objective C++ compiler. Same as CXXFLAGS. Since dpkg 1.17.7.
- DFLAGS
- Options for the host D compiler (ldc or gdc). Since dpkg 1.20.6.
- FFLAGS
- Options for the host Fortran 77 compiler. A subset of CFLAGS.
- FCFLAGS
- Options for the host Fortran 9x compiler. Same as FFLAGS. Since dpkg 1.17.7.
- LDFLAGS
- Options passed to the host compiler when linking executables or shared objects (if the linker is called directly, then -Wl and , have to be stripped from these options). Default value: empty.
- ASFLAGS_FOR_BUILD
- Options for the build assembler. Default value: empty. Since dpkg 1.22.1.
- CFLAGS_FOR_BUILD
- Options for the build C compiler. The default value set by the vendor includes -g and the default optimization level (-O2 usually, or -O0 if the DEB_BUILD_OPTIONS environment variable defines noopt). Since dpkg 1.22.1.
- CPPFLAGS_FOR_BUILD
- Options for the build C preprocessor. Default value: empty. Since dpkg 1.22.1.
- CXXFLAGS_FOR_BUILD
- Options for the build C++ compiler. Same as CFLAGS_FOR_BUILD. Since dpkg 1.22.1.
- OBJCFLAGS_FOR_BUILD
- Options for the build Objective C compiler. Same as CFLAGS_FOR_BUILD. Since dpkg 1.22.1.
- OBJCXXFLAGS_FOR_BUILD
- Options for the build Objective C++ compiler. Same as CXXFLAGS_FOR_BUILD. Since dpkg 1.22.1.
- DFLAGS_FOR_BUILD
- Options for the build D compiler (ldc or gdc). Since dpkg 1.22.1.
- FFLAGS_FOR_BUILD
- Options for the build Fortran 77 compiler. A subset of CFLAGS_FOR_BUILD. Since dpkg 1.22.1.
- FCFLAGS_FOR_BUILD
- Options for the build Fortran 9x compiler. Same as FFLAGS_FOR_BUILD. Since dpkg 1.22.1.
- LDFLAGS_FOR_BUILD
- Options passed to the build compiler when linking executables or shared objects (if the linker is called directly, then -Wl and , have to be stripped from these options). Default value: empty. Since dpkg 1.22.1.
Podem ser adicionadas novas bandeiras no futuro se a necessidade surgir (por exemplo para suportar outras linguagens).
ÁREAS DE CARACTERÍSTICAS¶
Cada funcionalidade de área pode ser activada ou desactivada no valor da área das variáveis de ambiente DEB_BUILD_OPTIONS e DEB_BUILD_MAINT_OPTIONS com o modificador ‘+’ e ‘-’. Por exemplo, par activar a funcionalidade "pie" de hardening e desactivar a funcionalidade “fortify” você pode fazer isto em debian/rules:
export DEB_BUILD_MAINT_OPTIONS=hardening=+pie,-fortify
A funcionalidade especial all (válida em qualquer área) pode ser usada para activar ou desactivar todas as funcionalidades de área ao mesmo tempo. Assim desactivar tudo na área hardening e activar apenas apenas “format” e “fortify” pode ser obtido com:
export DEB_BUILD_MAINT_OPTIONS=hardening=-all,+format,+fortify
abi¶
Várias opções de tempo de compilação (detalhado em baixo) podem ser usadas para activar funcionalidades que podem modificar o ABI dum pacote, mas não podem estar activas por predefinição devido a razões de compatibilidade com versões anteriores, a menos que sejam coordenadas ou verificadas individualmente.
- lfs
- Esta definição (desde dpkg 1.22.00; desactivada por
predefinição) activa Suporte Ficheiros Longos em
arquitecturas de 32-bit onde o seu ABI não inclui LFS (Large File
Support) por predefinição, ao adicionar
-D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 a CPPFLAGS.
Quando esta funcionalidade é activa irá sobrepor o valor da mesma funcionalidade na área de funcionalidades future.
- time64
- Esta definição (desde dpkg 1.22.0; desactivada por predefinição) activa suporte time_t de 64bit em arquitecturas de 32-bit onde o seu ABI não a inclui por predefinição, ao adicionar -D_TIME_BITS=64 a CPPFLAGS. Esta definição activa automaticamente a funcionalidade lfs porque a requer.
future¶
Várias opções de tempo de compilação (detalhado em baixo) podem ser usadas para activar funcionalidades que deveria estar activadas por predefinição, mas não podem estar por razões de compatibilidade com versões anteriores.
- lfs
- Esta definição (desde dpkg 1.19.0; desactivada por predefinição) é agora um nome alternativo para a funcionalidade lfs na área abi, use esta em vez da anterior. A funcionalidade da ária abi sobrepõe esta definição.
qa¶
Várias opções de tempo de compilação (detalhado em baixo) podem ser usadas para ajudar a detectar no código fonte ou no sistema de compilação.
- bug-implicit-func
- This setting (since dpkg 1.22.3; disabled by default) adds -Werror=implicit-function-declaration to CFLAGS.
- bug
- Esta definição (desde dpkg 1.17.4; desactivada por
predefinição) adiciona qualquer opção de aviso
de detecção de fiabilidade problemática no
código fonte. Os avisos são fatais. As únicas
bandeiras presentemente suportadas são CFLAGS e
CXXFLAGS com bandeiras definidas para -Werror=array-bounds,
-Werror=clobbered, -Werror=implicit-function-declaration e
-Werror=volatile-register-var.
This feature handles -Werror=implicit-function-declaration via the bug-implicit-func feature, if that has not been specified.
- canary
- Esta definição (desde dpkg 1.17.14; desactivada por predefinição) adiciona opções canary fantoches às bandeiras de compilação, para que os relatórios de compilação possam ser verificados em como as bandeiras de compilação se propagam e para permitir encontrar qualquer omissão de definições normais de bandeiras de compilação. As únicas bandeiras actualmente suportadas são CPPFLAGS, CFLAGS, OBJCFLAGS, CXXFLAGS e OBJCXXFLAGS com bandeiras definidas para -D__DEB_CANARY_flag_random-id__, e LDFLAGS definida para -Wl,-z,deb-canary-random-id.
optimize¶
Várias opções de tempo de compilação (detalhado em baixo) podem ser usadas para ajudar a optimizar um binário resultante (desde dpkg 1.21.0). Nota: ativador todas estas opções pode resultar em artefactos binários não reproduzíveis.
- lto
- This setting (since dpkg 1.21.0; disabled by default) enables Link Time Optimization by adding -flto=auto -ffat-lto-objects to CFLAGS, CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, FFLAGS, FCFLAGS and LDFLAGS.
sanitize¶
Várias opções de tempo de compilação (detalhado em baixo) podem ser usadas para ajudar a higienizar um binário resultante contra corrupções de memória, fugas de memória, utilização após livre, segmentação de dados e bugs de comportamento indefinido. Nota: estas opções não devem ser usadas para compilações de produção pois elas podem reduzir a confiança na conformidade do código, reduzir a segurança ou mesmo a funcionalidade.
- address
- Esta definição (desde dpkg 1.18.0; desactivada por predefinição) adiciona -fsanitize=address a LDFLAGS e -fsanitize=address -fno-omit-frame-pointer a CFLAGS e CXXFLAGS.
- thread
- Esta definição (desde dpkg 1.18.0; desactivada por predefinição) adiciona -fsanitize=thread a CFLAGS, CXXFLAGS e LDFLAGS.
- leak
- Esta definição (desde dpkg 1.18.0; desactivada por predefinição) adiciona -fsanitize=leak a LDFLAGS. Fica automaticamente desactivada se as funcionalidades address ou thread estiverem activas, pois elas já implicam isto.
- undefined
- Esta definição (desde dpkg 1.18.0; desactivada por predefinição) adiciona -fsanitize=undefined a CFLAGS, CXXFLAGS e LDFLAGS.
endurecimento¶
Várias opções de tempo de compilação (detalhado em baixo) podem ser usadas para ajudar a endurecer um binário resultante contra ataques de corrupção de memória, ou disponibilizar mensagens de aviso adicionais durante a compilação. Excepto como notado em baixo, estas estão activadas por predefinição para as arquitecturas que as suportam.
- format
- Esta definição (desde dpkg 1.16.1; activada por predefinição) adiciona -Wformat -Werror=format-security a CFLAGS, CXXFLAGS, OBJCFLAGS e OBJCXXFLAGS. Isto irá avisar sobre uso de strings de formato impróprias, e irá falhar quando funções de formato forem usadas em modo que representem possíveis problemas de segurança. Presentemente, isto avisa sobre chamadas a funções printf e scanf onde a string de formato não é uma string literal e não existem argumentos de formato, como em printf(foo); em vez de printf("%s", foo); Isto pode ser um buraco de segurança se a string de formato vier de uma entrada não confiável e conter ‘%n’.
- fortify
- Esta definição (desde dpkg 1.16.1; activada por
predefinição) adiciona -D_FORTIFY_SOURCE=2 a
CPPFLAGS. Durante a geração de código o
compilador sabe muita informação sobre tamanhos de buffer
(onde possível), e tenta substituir chamadas de
função buffer de comprimento ilimitadas e inseguras por umas
limitadas em comprimento. Isto é especialmente útil para
código antigo, desnecessariamente complicado. Adicionalmente, as
strings de formato em memória gravável que contêm
‘%n’ são bloqueadas. Se uma aplicação
depender de tal string de formato, isso terá que ser contornado.
Note que para esta opção ter algum efeito, a fonte tem de também ser compilada com -O1 ou superior. Se a variável de ambiente DEB_BUILD_OPTIONS conter noopt, então o suporte a fortify será desactivado, devido a novos avisos serem emitidos pelo glibc 2.16 e posterior.
- stackprotector
- This setting (since dpkg 1.16.1; enabled by default if
stackprotectorstrong is not in use) adds -fstack-protector
--param=ssp-buffer-size=4 to CFLAGS, CXXFLAGS,
OBJCFLAGS, OBJCXXFLAGS, FFLAGS and FCFLAGS.
This adds safety checks against stack overwrites. This renders many
potential code injection attacks into aborting situations. In the best
case this turns code injection vulnerabilities into denial of service or
into non-issues (depending on the application).
Esta funcionalidade requer ligação (link) a glibc (ou outro fornecedor de __stack_chk_fail), portanto precisa de ser desactivada quando se compila com -nostdlib ou -ffreestanding ou semelhante.
- stackprotectorstrong
- This setting (since dpkg 1.17.11; enabled by default) adds
-fstack-protector-strong to CFLAGS, CXXFLAGS,
OBJCFLAGS, OBJCXXFLAGS, FFLAGS and FCFLAGS.
This is a stronger variant of stackprotector, but without
significant performance penalties.
Desactivar stackprotector irá também desactivar esta definição.
Esta funcionalidade tem os mesmos requerimentos que stackprotector, e adicionalmente também requer gcc 4.9 e posterior.
- stackclash
- This setting (since dpkg 1.22.0; enabled by default) adds -fstack-clash-protection on amd64, arm64, armhf and armel to CFLAGS, CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, FFLAGS and FCFLAGS. This adds code to prevent stack clash style attacks.
- branch
- This setting (since dpkg 1.22.0; enabled by default) adds -fcf-protection on amd64 and -mbranch-protection=standard on arm64 to CFLAGS, CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, FFLAGS and FCFLAGS. This adds branch protection to indirect calls, jumps and returns to check whether these are valid at run-time.
- relro
- Esta definição (desde dpkg 1.16.1; activada por predefinição) adiciona -Wl,-z,relro a LDFLAGS. Durante o carregamento do programa, várias secções de memória ELF precisam de ser escritas pelo vinculador. Isto sinaliza ao carregador para tornar estas secções só-leitura antes de entregar o controlo ao programa. Mais notavelmente isto previne ataques de sobrescrita GOT. Se esta opção for desactivada, bindnow irá ficar também desactivado.
- bindnow
- Esta definição (desde dpkg 1.16.1; desactivada por predefinição) adiciona -Wl,-z,now a LDFLAGS. Durante o carregamento do programa, todos os símbolos dinâmicos são resolvidos, permitindo que todo o PLT seja marcado só-leitura (devido ao relro em cima). A opção pode ser activada se relro não for activado.
- pie
- This setting (since dpkg 1.16.1; with no global default since dpkg
1.18.23, as it is enabled by default now by gcc on the amd64, arm64,
armel, armhf, hurd-i386, i386, kfreebsd-amd64, kfreebsd-i386, mips,
mipsel, mips64el, powerpc, ppc64, ppc64el, riscv64, s390x, sparc and
sparc64 Debian architectures) adds the required options to enable or
disable PIE via gcc specs files, if needed, depending on whether gcc
injects on that architecture the flags by itself or not. When the setting
is enabled and gcc injects the flags, it adds nothing. When the setting is
enabled and gcc does not inject the flags, it adds -fPIE (via
/usr/share/dpkg/pie-compiler.specs) to CFLAGS,
CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, FFLAGS and
FCFLAGS, and -fPIE -pie (via
/usr/share/dpkg/pie-link.specs) to LDFLAGS. When the setting
is disabled and gcc injects the flags, it adds -fno-PIE (via
/usr/share/dpkg/no-pie-compile.specs) to CFLAGS,
CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, FFLAGS and
FCFLAGS, and -fno-PIE -no-pie (via
/usr/share/dpkg/no-pie-link.specs) to LDFLAGS.
Position Independent Executable (PIE) é necessário para tirar vantagem de Address Space Layout Randomization (ASLR), suportado por algumas versões de kernel. Enquanto ASLR já pode ser aplicada para áreas de dados na stack e heap (brk e mmap), as áreas de código têm de ser compiladas como independente-de-posição. As bibliotecas partilhadas já fazem isto (-fPIC), assim elas ganham ASLR automaticamente, mas as regiões de texto binários precisam de ser compiladas como PIE para ganhar ASLR. Quando isto acontece, os ataques ROP (Return Oriented Programming) são mais difíceis pois não são localizações estáticas para ressaltar durante um ataque de corrupção de memória.
PIE não é compatível com -fPIC, assim em geral é preciso cuidado ao compilar objectos partilhados. Mas porque as bandeiras PIE emitidas são injetadas via ficheiros specs de gcc, deverá ser sempre seguro defini-las incondicionalmente independentemente do tipo de objecto a ser compilado ou ligado em link.
Bibliotecas estáticas pode ser usadas por programas ou outras bibliotecas partilhadas. Dependendo das bandeiras usadas para compilar todos os objectos dentro de uma biblioteca estática, estas bibliotecas serão utilizáveis por conjuntos diferentes de objectos:
Se existir a necessidade de definir estas bandeiras manualmente, fazendo bypass à injeção de spec gcc, há varias coisas a ter em conta. Passar incondicionalmente e explicitamente -fPIE, -fpie ou -pie a um sistema de compilação usando libtool é seguro pois estas bandeiras irão ser despojadas quando se compila bibliotecas partilhadas. Caso contrário em projetos que compilam ambos programas e bibliotecas partilhadas você pode precisar de certificar que quando compila as bibliotecas partilhadas, -fPIC seja sempre passado em último (para que sobreponha qualquer -PIE anterior) às bandeiras de compilação tais como CFLAGS, e -shared é passado em último (para que sobreponha qualquer -pie anterior) para ligar em link bandeiras tais como LDFLAGS. Nota: Isto não deve ser necessário com a maquinaria de specs gcc predefinida.
Adicionalmente, como PIE é implementado via registo geral, algumas arquitecturas com falta de registo (mas não incluindo mais a i386 desde as optimizações implementadas no gcc >= 5) podem ver perdas de performance até aos 15% em grandes cargas de aplicações de segmentos de texto pesados; a maioria das cargas vêm menos de 1%. Arquitecturas com registos mais gerais (ex. amd64) não vêm mais alto que uma penalidade de pior caso.
reproducible¶
As opções de tempo de compilação detalhadas em baixo podem ser usadas para ajudar a melhorar a reprodutibilidade de compilação ou fornecer mensagens de aviso adicionais durante a compilação. Excepto como notado em baixo, estas estão activadas por predefinição para as arquitecturas que as suportam.
- timeless
- Esta definição (desde dpkg 1.17.14; activada por predefinição) adiciona -Wdate-time a CPPFLAGS. Isto irá causar avisos quando as macros __TIME__, __DATE__ e __TIMESTAMP__ são usadas.
- fixfilepath
- This setting (since dpkg 1.19.1; enabled by default) adds
-ffile-prefix-map=BUILDPATH=. to CFLAGS,
CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, FFLAGS and
FCFLAGS where BUILDPATH is set to the top-level directory of
the package being built. This has the effect of removing the build path
from any generated file.
Se ambas fixdebugpath e fixfilepath forem definidas, esta opção toma precedência, porque é um superconjunto do anterior.
Nota: Se o processo de compilação capturar as bandeiras de compilação para os objectos de compilação resultantes, isso irá tornar o pacote não-reproduzível. E ao desactivar esta opção poderá tornar alguns dos objectos reproduzíveis de novo isto irá também requerer desactivar fixdebugpath, o que poderá tornar quaisquer símbolos de depuração gerados não-reproduzíveis. A correção ideal é parar de capturar bandeiras de compilação.
- fixdebugpath
- This setting (since dpkg 1.18.5; enabled by default) adds
-fdebug-prefix-map=BUILDPATH=. to CFLAGS,
CXXFLAGS, OBJCFLAGS, OBJCXXFLAGS, FFLAGS and
FCFLAGS where BUILDPATH is set to the top-level directory of
the package being built. This has the effect of removing the build path
from any generated debug symbols.
Nota: Esta funcionalidade tem propriedades de reprodução semelhantes a fixfilepath.
AMBIENTE¶
Existem 2 conjuntos de variáveis de ambiente a fazer as mesmas operações, O primeiro (DEB_flag_op) nunca deve ser usada dentro de debian/rules. Destina-se a qualquer utilizador que queria recompilar o pacote fonte com bandeiras de compilação diferentes. O segundo conjunto (DEB_flag_MAINT_op) só deve ser usado em debian/rules pelos maintainers de pacotes para alterar as bandeiras de compilação resultantes.
- DEB_flag_SET
- DEB_flag_MAINT_SET (desde dpkg 1.16.1)
- Esta variável pode ser usada para forçar o valor retornado para a <flag> fornecida.
- DEB_flag_STRIP (desde dpkg 1.16.1)
- DEB_flag_MAINT_STRIP (desde dpkg 1.16.1)
- Esta variável pode ser usada para disponibilizar uma lista separada por espaços das opções que irão ser despojadas do conjunto de flags retornado para a flag fornecida.
- DEB_flag_APPEND
- DEB_flag_MAINT_APPEND (desde dpkg 1.16.1)
- Esta variável pode ser usada para acrescentar opções suplementares ao valor retornado para a flag fornecida.
- DEB_flag_PREPEND (desde dpkg 1.16.1)
- DEB_flag_MAINT_PREPEND (desde dpkg 1.16.1)
- Esta variável pode ser usada para adicionar opções suplementares ao inicio do valor retornado para a flag fornecida.
- DEB_BUILD_OPTIONS
- DEB_BUILD_MAINT_OPTIONS (desde dpkg 1.16.1)
- These variables can be used by a user or maintainer to disable/enable various area features that affect build flags. The DEB_BUILD_MAINT_OPTIONS variable overrides any setting in the DEB_BUILD_OPTIONS feature areas. See the "FEATURE AREAS" section for details.
- DEB_VENDOR
- Esta definição define o fornecedor actual. Se não definida, irá descobrir o fornecedor actual ao ler /etc/dpkg/origins/default.
- DEB_BUILD_PATH
- Esta variável define o caminho de compilação (desde dpkg 1.18.8) a usar em funcionalidades como fixdebugpath para que possam ser controladas pelo chamador. Esta variável é actualmente específica de Debian e derivados.
- DPKG_COLORS
- Define o modo de cor (desde dpkg 1.18.5). Os valores actualmente aceites são: auto (predefinido), always e never.
- 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 0 e 1 (predefinição).
FICHEIROS¶
Ficheiros de configuração¶
- /etc/dpkg/buildflags.conf
- Ficheiro de configuração geral do sistema.
- $XDG_CONFIG_HOME/dpkg/buildflags.conf ou
- $HOME/.config/dpkg/buildflags.conf
- Ficheiro de configuração do utilizador.
Suporte a empacotamento¶
- /usr/share/dpkg/buildflags.mk
- trecho do Makefile que irá carregar (e opcionalmente exportar) todas as bandeiras suportadas pelo dpkg-buildflags em variáveis (desde dpkg 1.16.1).
EXEMPLOS¶
Para passar flags de compilação a um comando de compilação dentro de um Makefile:
$(MAKE) $(shell dpkg-buildflags --export=cmdline) ./configure $(shell dpkg-buildflags --export=cmdline)
Para definir bandeiras de compilação num script de shell ou num fragmento de shell, por ser usado o eval para interpretar o resultado e para exportar as bandeiras no ambiente:
eval "$(dpkg-buildflags --export=sh)" && make
ou para definir os parâmetros posicionais a passar a um comando:
eval "set -- $(dpkg-buildflags --export=cmdline)" for dir in a b c; do (cd $dir && ./configure "$@" && make); done
Utilização em debian/rules¶
Você deve chamar dpkg-buildflags ou incluir buildflags.mk do ficheiro debian/rules para obter as bandeiras de compilação necessárias para passar ao sistema de compilação. Note que versões antigas do dpkg-buildpackage (antes do dpkg 1.16.1) exportavam estas bandeiras automaticamente. No entanto, você não deve confiar nisto, pois isto quebra a invocação manual de debian/rules.
For packages with autoconf-like build systems, you can pass the relevant options to configure or make(1) directly, as shown above.
Para outros sistemas de compilação, ou quando precisa de um controle mais afinado acerca de quais bandeiras são passadas para onde, você pode usar --get. Ou você pode incluir buildflags.mk em vez disto, o que toma conta de chamar dpkg-buildflags e guardar as bandeiras de compilação em variáveis do make.
Se você quiser exportar todas as bandeiras de compilação para o ambiente (onde elas pode ser colhidas pelo seu sistema de compilação):
DPKG_EXPORT_BUILDFLAGS = 1 include /usr/share/dpkg/buildflags.mk
Para algum controle extra sobre o que é exportado, você pode exportar manualmente as variáveis (pois nenhuma é exportada por predefinição).
include /usr/share/dpkg/buildflags.mk export CPPFLAGS CFLAGS LDFLAGS
E claro que você pode passar as bandeiras aos comandos manualmente:
include /usr/share/dpkg/buildflags.mk build-arch: $(CC) -o hello hello.c $(CPPFLAGS) $(CFLAGS) $(LDFLAGS)
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>.
2024-01-19 | 1.22.3 |