DH_DWZ

Section: Debhelper (1)
Updated: 2021-02-15
Page Index

NOME

dh_dwz - optimiza informação de depuração DWARF em binários ELF via dwz

RESUMO

dh_dwz [debhelper opções] [-Xitem] [-- parâmetros]

DESCRIÇÃO

dh_dwz é um programa de debhelper que irá optimizar o tamanho (não comprimido) da informação de depuração DWARF nos binários ELF. Fá-lo ao correr dwz(1) em todos os binários ELF no pacote.

OPÇÕES

--dwz-multifile, --no-dwz-multifile

Whether dwz(1) should generate a multifile from the ELF binaries in the same package. When enabled, if a package ships at least 2 ELF binaries, dh_dwz will instruct dwz(1) to generate a multifile for the package.

By default, dh_dwz will attempt to create a multifile but will continue without if dwz(1) does not create one (but succeeds anyway). This commonly happens when the debug files do not contain debug symbols (e.g. a missing -g to the compiler) or when the debug symbols are compressed (see Debian bug #931891). If --dwz-multifile is passed, then dh_dwz will abort with an error if dwz(1) does not create a multifile.

Note que estas opções podem não funcionar se um pacote conter mais binários ELF que possam caber numa única linha de comandos. Se isto for um problema, por favor passe --no-dwz-multifile para contornar este problema.

O multifile gerado será comprimido com objcopy --compress-debug-sections.

Note for udeb packages: dh_dwz will never generate multifiles for udeb packages. It will still use dwz to reduce the file size of debug files if it finds any.

-Xitem, --exclude=item

Exclui ficheiros que contenham item em qualquer ponto do seu nome de serem despojados. Você pode usar esta opção várias vezes para construir uma lista de coisas a excluir.

-- params

Passa parâmetros para dwz(1) quando processa binários ELF. Isto é maioritariamente útil para definir parâmetros relacionados com memória (ex. -l e -L).

NOTAS

Se a variável de ambiente DEB_BUILD_OPTIONS conter nostrip, nada será despojado, em conformidade com a política Debian (secção 10.1 ``Binários'').

Embora esta ferramenta tecnicamente não remover informação de depuração dos binários, é na mesma incluída quando a variável de ambiente DEB_BUILD_OPTIONS contém nostrip. Isto é assim porque nostrip é muito usado para optimizar tempos de compilação (ex. para -cycles de ``compilar e testar'') em vez de optimizar para tamanho.

VEJA TAMBÉM

debhelper(7)

Este programa é parte do debhelper.

AUTOR

Niels Thykier <niels@thykier.net>

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 ou Equipa Debian de Tradução Portuguesa traduz@debianpt.org.